ConsumeEWS

Description:

Consumes messages from Microsoft Exchange using Exchange Web Services. The raw-bytes of each received email message are written as contents of the FlowFile

Tags:

Email, EWS, Exchange, Get, Ingest, Ingress, Message, Consume

Properties:

In the list below, the names of required properties appear in bold. Any other properties (not in bold) are considered optional. The table also indicates any default values, whether a property supports the NiFi Expression Language, and whether a property is considered "sensitive", meaning that its value will be encrypted. Before entering a value in a sensitive property, ensure that the nifi.properties file has an entry for the property nifi.sensitive.props.key.

NameDefault ValueAllowable ValuesDescription
User NameUser Name used for authentication and authorization with Email server.
Supports Expression Language: true (will be evaluated using variable registry only)
PasswordPassword used for authentication and authorization with Email server.
Sensitive Property: true
Supports Expression Language: true (will be evaluated using variable registry only)
FolderINBOXEmail folder to retrieve messages from (e.g., INBOX)
Supports Expression Language: true (will be evaluated using variable registry only)
Fetch Size10Specify the maximum number of Messages to fetch per call to Email Server.
Supports Expression Language: true (will be evaluated using variable registry only)
Delete Messagesfalse
  • true
  • false
Specify whether mail messages should be deleted after retrieval.
Connection timeout30 secThe amount of time to wait to connect to Email server
Supports Expression Language: true (will be evaluated using variable registry only)
Exchange VersionExchange2010_SP2
  • Exchange2007_SP1
  • Exchange2010
  • Exchange2010_SP1
  • Exchange2010_SP2
What version of Exchange Server the server is running.
EWS URLURL of the EWS Endpoint. Required if Autodiscover is false.
Auto Discover URLtrue
  • true
  • false
Whether or not to use the Exchange email address to Autodiscover the EWS endpoint URL.
Mark Messages as Readtrue
  • true
  • false
Specify if messages should be marked as read after retrieval.
Original Headers to IncludeComma delimited list specifying which headers from the original message to include in the exported email message. Blank means copy all headers. Some headers can cause problems with message parsing, specifically the 'Content-Type' header.
Original Headers to ExcludeComma delimited list specifying which headers from the original message to exclude in the exported email message. Blank means don't exclude any headers.

Relationships:

NameDescription
successAll messages that are the are successfully received from Email server and converted to FlowFiles are routed to this relationship

Reads Attributes:

None specified.

Writes Attributes:

None specified.

State management:

This component does not store state.

Restricted:

This component is not restricted.

Input requirement:

This component does not allow an incoming relationship.

System Resource Considerations:

None specified.