Email endpoint settings

Use the following settings to configure an email endpoint.

Name:
A mandatory setting that identifies the endpoint. Do not include a < character because it truncates the name displayed in Workspace. If you’re entering a URL as the name of the endpoint, ensure that it conforms with the syntax rules specified in RFC1738.

Description:
A description of the endpoint. Do not include a < character because it truncates the description displayed in Workspace.

Cron Expression:
Enter a cron expression if the email must be scheduled by using a cron expression.

Repeat Count:
Number of times the email endpoint scans the folder or directory. A value of -1 indicates indefinite scanning. The default value is -1.

Repeat Interval:
The scanning rate that the receiver uses for checking for incoming mail.

Delay when job starts:
The time to wait to scan after the scheduler starts.

Batch Size:
The number of emails the receiver processes per scan for optimum performance. A value of -1 indicates all emails. The default value is 2.

User Name:
A mandatory setting, which is the user name that is used when invoking a target service from email. The default value is SuperAdmin.

Domain Name:
A mandatory setting, which is the user’s domain. The default value is DefaultDom.

Domain Pattern:
Specifies the domain patterns of incoming email that the provider accepts. For example, if adobe.com is used, only email from adobe.com is processed; email from other domains is ignored.

File Pattern:
Specifies the incoming file attachment patterns that the provider accepts. This includes files that have specific extensions (*.dat, *.xml), specific names (data), or composite expressions in the name and extension (*.[dD][aA][Tt]).

Successful Job’s Recipients:
An email address to which messages are sent to indicate successful jobs. By default, a successful job message is always sent to the sender. If you type sender, email results are sent to the sender. Up to 100 recipients are supported. Specify additional recipients with email addresses, separated by commas (,).

To turn off this setting, leave the setting blank. In some cases, you want to trigger a process and do not want an email notification of the result.

Failed Job’s Recipients:
An email address to which messages are sent to indicate failed jobs. By default a failed job message is always sent to the sender. If you type sender, email results are sent to the sender. Up to 100 recipients are supported. Specify additional recipients with email addresses, separated by commas (,).

To turn off this setting, leave the setting blank. In some cases, you want to trigger a process and do not want an email notification of the result.

Inbox Host:
The inbox host name or IP address for the email provider to scan.

Inbox Port:
The port that the email server uses. The default value for POP3 is 110 and the default value for IMAP is 143. If SSL is enabled, the default value for POP3 is 995 and the default value for IMAP is 993.

Inbox Protocol:
The email protocol for the email endpoint to use to scan the inbox. The values are IMAP or POP3. The inbox host mail server must support these protocols.

Inbox Time Out:
The time-out, in seconds, for the email provider to wait for inbox responses.

Inbox User:
The user name that is required to log in to the email account. Depending on the email server and configuration, this value may be only the user name portion of the email or it may be the full email address.

Inbox Password:
The password for the inbox user.

POP3/IMAP SSL Enabled:
Select this setting to force the email provider to use SSL to scan the inbox. Ensure that your mail server supports SSL.

SMTP Host:
The host name of the mail server the email provider uses to send results and error messages.

SMTP Port:
The default value for the SMTP port is 25.

SMTP User:
The user account for the email provider to use when it sends email notifications of results and errors.

SMTP Password:
The password for the SMTP account. Some mail servers do not require an SMTP password.

Send From:
The email address (for example, user@company.com) used to send email notifications of results and errors. If you do not specify a Send From value, the email server attempts to determine the email address by combining the value specified in the SMTP User setting with a default domain configured on the email server. If your email server does not have a default domain and you do not specify a value for Send From, errors may occur. To ensure that the email messages have the correct from address, specify a value for the Send From setting.

SMTP SSL Enabled:
Select this setting to force the email provider to use SSL to scan the inbox. Ensure that your mail server supports SSL.

Failed Email Sent Folder:
Specifies a directory in which to store results if the SMTP mail server is not operational.

asynchronous:
When set to synchronous, all input documents are processed and a single response is returned. When set to asynchronous, a response is sent for each document that is processed.

For example, an email endpoint is created for a service that takes a single Word document and returns that document as a PDF file. An email can be sent to the endpoint’s inbox that contains multiple (3) Word documents. When all three documents are processed, if the endpoint is configured as synchronous, a single response email is sent with all three documents attached. If the endpoint is asynchronous, a response email is sent after each Word document is converted to PDF. The result is three emails, each with a single PDF attachment.

The default value is asynchronous.

Include the original email body as an attachment:
By default, when you send an email to the LiveCycle server, the original text of the message is included in the body of the message. To instead include the text as an attachment, select this option.

Use the original subject line for result emails:
By default, LiveCycle server uses the values specified in the Success Email Subject and Error Email Subject settings as the subject line when sending result email messages. To instead use the same subject line as the original email sent to the server, select this option.

Success Email Subject:
After you send an email to an email endpoint to start or continue a process, you receive a return email message from the LiveCycle server. If your email succeeds, you receive a success email. If your email fails, you receive a failure email informing why it failed. This setting enables you to specify the subject line of success email messages sent for this endpoint.

Success Email Body:
Enables you to specify the body text of success email messages sent for this endpoint.

Error Email Subject Prefix:
Enables you to specify the text used at the beginning of the subject line of failure email messages sent for this endpoint.

Error Email Subject:
Enables you to specify the subject line of failure email messages sent for this endpoint. This text is displayed after the Error Email Subject Prefix.

Error Email Body:
Enables you to specify the first line in the body text of failure email messages sent for this endpoint.

Email Summary Info:
Each success or failure message includes a section containing the original email text that you sent to the LiveCycle server. This setting specifies the text that appears above that section.

Validate Inbox before creating/updating this endpoint:
When this option is selected, the LiveCycle server checks whether your SMTP/POP3 settings are correct before creating the endpoint. When you click Add, a message displays, stating whether the inbox account is valid. If this option is not selected, the LiveCycle server creates the endpoint without validating the inbox.

Operation Name:
This setting is mandatory. A list of operations that can be assigned to the email endpoint. The operation that you select here determines which fields are displayed in the Input Parameter Mappings and Output Parameter Mappings sections.

Input Parameter Mappings:
Used to configure the input that is required to process the service and operation. The two types of input are literal and variable:
Literal:
The email uses the value that is entered in the field as it is displayed.

Variable:
You can map a string from the email subject, body, header, or sender's email address. To do this, use one of the following keywords: %SUBJECT%, %BODY%, %HEADER%, or %SENDER%. For example, if you use %SUBJECT%, the email subject content is used as the input parameter. To pick up attachments, enter a file pattern that the email endpoint can use to select the attached documents. For example, entering *.pdf selects any attached document that has a .pdf filename extension. Entering * selects any attached document. Entering example.pdf selects any attached document named example.pdf.

Output Parameter Mappings:
Used to configure the output of the service and operation. The following characters in the output parameter mapping values are expanded in the attachment filename:
%F
Represents the source file’s filename (not including an extension).

%E
Represents the source file’s extension.

\
Any occurrence of the backslash (\) is replaced with %%.
Note: If the service request message includes multiple file attachments, you cannot use the %F and %E parameters for the Output Parameter Mappints property of the endpoint. If the services response returns multiple file attachments, you cannot specify the same file name for more than one attachment. If you do not follow these recommendations, the invoked service create the names for the returned files, and the names are not predictable.

The following values are available:

Single Object:
The email provider does not have the source folder destination; results are returned as attachments. The pattern is Result/%F.ps and returns Result%%sourcefilename.ps as the filename attachment.

List:
The pattern is Result/%F/ and returns Result%%sourcefilename%%file1 as the filename attachment.

Map:
The pattern is Result/%F/ and the source destination is Result%%sourcefilename%%file1 and Result%%sourcefilename%%file2. If the map contains more than one object and the pattern is Result/%F.ps, the response file attachments are Result%%sourcefilename1.ps (output 1) and Result%%sourcefilename2.ps (output 2).

// Ethnio survey code removed