General tab

Configure options to required to communicate with the email server.

Option Description
Server Enter the name or IP address of the mail server from which email messages will be retrieved.
The server must support the POP3 protocol.
User Name Enter the name of the user account that will be used to connect to the mail server. In practice, this represents the name of an electronic mailbox, and can be represented by the following string: account@serverdomain, where:
  • account: a unique name of an electronic mailbox. The account name is mandatory.
  • @serverdomain: a name of the domain to which the mailbox belongs; it can be omitted.

For example, if the desired account email address is adriana.dubois@tlain.com, then the following strings are valid user names:

  • adriana.dubois
  • adriana.dubois@tlain.com

The component will retrieve email messages from the account specified in this field. The component will poll email messages from all folders which allow capturing messages through POP3 protocol.

This field is enabled for credential-based authentication only, when the Use OAuth2 authentication method option is switched off.
Password Enter the password of the user account specified in User Name.
This field is enabled for credential-based authentication only, when the Use OAuth2 authentication method option is switched off.
Port Number Specify the port number that will be used by the component to establish a TCP connection to the mail server.

The default port for an unencrypted POP3 connection is 110. The default port for an encrypted connection using SSL is 995.

Use OAuth2 authentication method

Select this check box to turn on Modern Authentication / OAuth2 method.

This method allows the component to capture email messages from online Microsoft 365 email accounts using Modern Authentication / OAuth2.

Token Vault URL

Enter the fully qualified Token Vault URL with port number.

This field is enabled for Modern Authentication / OAuth2 mode only.

Provider ID

Enter the ID of that Authorization Provider, which was set up in Token Vault to work with this AutoStore component.

This field is enabled for Modern Authentication / OAuth2 mode only.

Local user account

In this text box, specify a domain user account that will be used by the workflow.

The accepted format is UPN (User Principal Name) – testuser@test.domain.corp

Make sure that the account specified in this text box has completed the authorization and consent process through Token Vault. Otherwise, the component will fail to process files through this account.

You may use RRTs in this text box. When you use an RRT, make sure that it is replaced with a domain user account in UPN format; otherwise, the component will fail to process files and they will be rejected.

This field is enabled for Modern Authentication / OAuth2 mode only.

This server requires an encrypted connection (SSL) Select this check box if the server requires an encrypted Secure Sockets Layer (SSL) connection.
Save message body as a file Select this check box to save the email as a text file that will be created by the component and passed to the workflow in a job created for the message. The will contain only the email header and body content.

When this check box is cleared, the body of the email message is not passed into the workflow, but can be got using RRTs.

This option does not affect email file attachments: in any case, all email attachments are captured and passed into the workflow in a single job for each email message.

Keep raw message content Select this check box to keep the message content in a local directory. When this check box is selected, the text box is enabled: specify the path to a directory where you want to keep messages in it. You can specify the path manually or using the browse button (...) to browse for a desired folder.
The component stores captured messages in a file of raw format with all their metadata retrieved from the user account; attachments are stored in the same file as a Base64 encoded string.