External fax server
Integrate TotalAgility with external fax servers such as RightFax, Kofax Communication Server (KCS) and Biscom so that it can receive documents through Fax after you configure the import connection settings.
Configure the properties of import source and click Save.
The properties of POP3 import source are grouped under the following headings:
General
Field | Description |
---|---|
Type | Protocol for the import source. Select External fax server. |
Display name | Name for the import source. |
Active | By default, the import source is active. |
Error Handling | |
Message Connector service timeout | The timeout value for message processing. This value sets the timeout when calling the
Message Connector service. (Default: 1200 seconds (20 minutes). This value is suitable for processing most messages.)
To avoid timeout for messages with longer processing time, increase the timeout value. The maximum allowed value is 86400 seconds (24 hours.) |
Advanced
Field | Description |
---|---|
Normalize images and create pages | Normalizes the incoming image files to TIFF and creates pages. (Default: Clear)
|
Include complete message as EML file | Imports an EML file the same as the original email including attachments. (Default: Clear) |
Include complete message as MSG file | Imports an MSG file the same as the original email including attachments. |
Skip importing files |
Allows you to set conditions to skip specific files for import. For example, to skip the import of .png files that are less than 10 bytes, do the following:
Only the .png files that are less than 10 bytes are skipped. Files greater than or equal to 10 bytes are imported. To edit the skip import details: Select the record to edit, click , make the required changes, and then click Ok. To delete the skip import details: Select the record to delete, click , and then click Yes. |
Extract referenced MSG/EML files |
Allows the import of the nested emails and EML/MSG files along with their attachments. By default, TotalAgility allows the import of the main email and all types of attached emails in EML/MSG format. This is also applicable to the EML and MSG files which are referenced in the XML files. This option is selected when upgrading TotalAgility from a lower version. In case of an XML import, enabling the "Extract referenced MSG/EML" option when "Import content" is set to "Only body" is not a valid scenario. |
Fax users to monitor
Field | Description |
---|---|
Fax server type | Select one of the following types:
|
Poll cycle in seconds | When should the import connector check for new documents on the mail server. (Minimum/default value = 5 seconds, Maximum value = 86400 seconds) |
Host | Host name of the fax server. |
Credential storage |
Select one of the following for authentication in Credential storage.
|
Test fax server | Verify the connection between the import connector and fax server. |
Operation mode | |
Single/Multi instance |
Select how to poll the fax server.
|
|
|
Fax users to monitor |
|
|
Removes a specific user in the Selected items box. |
Remove all |
Removes all the users in the Selected items box. |
VRS processing
Field | Description |
---|---|
Scan/VRS profile |
Name of the Scan/VRS profile. |
Apply scan/VRS profile to eDocuments | Applies the selected Scan/VRS profile to the documents. (Default: Clear) |
Save page PDF data |
Splits the original PDF source file into single page PDF files. (Default: Clear) |
Notification settings
Send notification emails to the configured email addresses when the document import process is successful, partially successful, and rejected/failed.
Field | Description |
---|---|
To |
The email addresses of the recipients to whom you want to send the notification. You can use inline value, server variable, and metadata. |
CC |
The email addresses of the recipients to whom you want to send a copy of the notification. You can use inline value, server variable, and metadata. |
Bcc |
The email addresses of the recipients to whom you want to send a blind copy (the email address of the recipient is not shown to other recipients in the list) of the notification. You can use inline value, server variable, and metadata. |
From |
The email address of the sender. You can use inline value, server variable, and metadata. You can add only one value.
|
Subject |
The subject of the email notification. You can use inline value, server variable, and metadata. |
Format | Format in which the notification email is sent. Available options are:
|
Body |
The message included in the email notification. You can use inline value, server variable, and metadata. |
Include complete email message as attachment |
Attaches the original message (in EML format) to the notification mail. (Default: Clear) |
Remove email attachments |
Removes attachments from the original email. (Default: Clear)
When Remove email attachments is selected and if the original email does not contains body, an empty
email is generated.
|
Field values
You can provide an inline value, server variable, or metadata for the To, Cc, Bcc, From, Subject, and Body fields.
-
To specify an inline value
Enter the inline value in the text box provided for the To, Cc, Bcc, Subject, and Body fields. For the To, Cc and Bcc fields, delimit each email address with a semicolon when inline value is used. For the From field, use the edit button to enter an inline value.
-
To use a server variable or metadata
The server variable contains information such as server name, server ID, and server password. For more information, see Server variables. The metadata includes the data from the original message, such as Bcc, CC, and To. To select a server variable or metadata, do the following.
-
Right-click inside the text box.
A pop-up window is displayed. By default, the Server variable tab is selected on the left pane.
For the From field, use the down button to open the pop-up window. - Do the following:
-
To select a server variable, select a category and type to view the list of server variables, and then select a variable.
-
To select metadata, select Metadata on the left pane to view the list of metadata, and then select metadata.
You can use the Filter search box to search for a server variable or metadata.
-
-
The Test connection validation fails if metadata is used in the To field. However, this does not affect sending the email notification, the metadata is resolved while sending the email.
Document archiving
Configure one or more file formats for saving the successfully imported, partially imported, rejected, or failed documents.
Field | Description | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Successfully imported | |||||||||||||||||||||||
Archive folder |
Path of a local folder (such as C:\Archive) or a network folder to store the successfully imported documents. |
||||||||||||||||||||||
Format |
Supported formats for successfully imported documents are:
|
||||||||||||||||||||||
Test archive folder | Tests whether the archive folder is configured correctly. | ||||||||||||||||||||||
Subfolder and file prefix |
The name of the subfolder and prefix for the archived files. You can also add predefined Fields (metadata) as subfolder names and filename prefixes. The value of these metadata is populated at the time of saving the archived files. If you do not add the "\" character in the field, all the fields are appended to the archived file names. For example, if you add {OK}\{Process-ID}, the files are stored in the OK folder with the process ID appended to the filename. The following fields are available:
|
||||||||||||||||||||||
Partially imported | |||||||||||||||||||||||
Archive folder |
Path of a local folder (such as C:\Archive) or a network folder to store the partially imported documents. |
||||||||||||||||||||||
Format |
Supported formats for partially imported documents are:
|
||||||||||||||||||||||
Test archive folder | Tests whether the archive folder is configured correctly. | ||||||||||||||||||||||
Subfolder and file prefix |
The name of the subfolder and prefix for the archived files. You can also add predefined Fields (metadata) as subfolder names and filename prefixes. The value of these metadata is populated at the time of saving the archived files. If you do not add the "\" character in the field, all the fields are appended to the archived file names. For example, if you add {PARTIAL}\{Process-ID}, the files are stored in the PARTIAL folder with process ID appended to the filename. The following fields are available:
|
||||||||||||||||||||||
Rejected/Failed | |||||||||||||||||||||||
Archive folder |
Path of a local folder (such as C:\Archive) or a network folder to store the failed/rejected documents. |
||||||||||||||||||||||
Format | Supported formats for rejected or failed documents are:
|
||||||||||||||||||||||
Test archive folder | Tests whether the archive folder is configured correctly. | ||||||||||||||||||||||
Subfolder and file prefix |
The name of the subfolder and prefix for the archived files. You can also add predefined Fields (metadata) as subfolder names and filename prefixes. The value of these metadata is populated at the time of saving the archived files. If you do not add the "\" character in the field, all the fields are appended to the archived file names. For example, if you add {REJECTED}\{Process-ID}, the files are stored in the REJECTED folder with process ID appended to the filename. The following fields are available:
|
Scenarios when a message may be partially imported
-
"Normalize non-PDF e-documents to PDF/A" is enabled and the incoming message contains a file that cannot be normalized, such as a DAT file.
-
A fax is partially received (fax with a reception error.)
-
Documents for which the PDF/A normalization failed.
-
"Normalize non-PDF e-documents to PDF/A" and "Normalize incoming PDF documents to PDF/A" are enabled, and an email with an attached password-protected file is ingested through Message Connector.
-
“Unpack archives” is selected in the Message Connector configuration, and an email with an attached password-protected file is ingested through Message Connector.
-
The message attachment has document conversion errors.
A document with conversion errors is imported as original file and is available in the workflow. Conversion of any non-supported document (.dat,.xyz,.psz) fails with document conversion error.
Scenarios when a message import may fail
-
"Normalize non-PDF e-documents to PDF/A" and “Concatenate multiple PDF files” are enabled, and the incoming message contains a BIN/DAT file as an attachment.
-
"Normalize non-PDF e-documents to PDF/A", "Normalize incoming PDF documents to PDF/A", and “Concatenate multiple PDF files” are enabled, and an email with an attached password-protected file is ingested through Message Connector.
-
When the XML fields are mapped to the TotalAgility fields, “Map XML fields to TotalAgility fields and reject on mismatch” is enabled and there is some difference in the fields specified in the XML file.
-
"Normalize non-PDF e-documents to PDF/A", "Normalize incoming PDF documents to PDF/A", and “Concatenate multiple PDF files” are enabled, and an email with an attached password-protected file is ingested through Message Connector.
-
“Unpack archives” is selected in Message Connector configuration, "Normalize non-PDF e-documents to PDF/A", and “Concatenate multiple PDF files” are enabled in TotalAgility Designer, and an email with an attached password-protected file is ingested through Message Connector.
-
Any of the message attachment content is null.
-
The process map is not available for an import source.
Associated actions
Associate an action with the import source so that a job can be created at runtime for the Successfully imported, Partially imported, and Rejected/Failed documents.
On the Job type list, Create new job is selected by default.
-
On the
Process list, select a process or case.
If the selected process or case map has any initialization variables, the parameters appear under Initialization variables.
For rejected/failed or partially imported documents, only the metadata of the documents is passed to the relevant processes. When configuring such process maps, you can then map the metadata. Additionally, in case of rejected/failed documents, the original content of an EML is added as a document to the Job. - To map the parameters to the initialization variables, on the Mapping list of the initialization variable, select a dynamic value or click and enter a static value.