Mail Link

The 'MIME Type' property indicates the media type of the email message as handled by Grooper. For IMAP-linked messages, this is always message/rfc822, which is the standard MIME type for email messages.

This property is used by Grooper to determine how to process, display, or export the file. It is especially important for integration scenarios or when configuring downstream export or conversion activities.

The 'Full Path' property provides a logical path to the email message within the IMAP server context, constructed from the 'Mailbox Name', 'Folder', and 'Object Name' properties. The format is: MailboxName/Folder/ObjectName.

This property is useful for identifying the precise location of the message on the server, for audit, troubleshooting, or integration purposes.

The 'Error Message' property is populated if Grooper encounters an error when accessing, loading, or updating the external content referenced by this link. This can help diagnose connectivity issues, permission problems, or missing content in external systems.

Specifies the address of the IMAP server to connect to for accessing email messages. This can be a DNS host name (e.g., imap.example.com) or an IP address (e.g., 192.168.1.10).

Ensure that the value matches the address of your organization's mail server and that the server is accessible from the Grooper environment.

Specifies the account name used to authenticate with the IMAP server. This user must have permission to access the mailbox and folder containing the target email.

The domain name may be required to access mailboxes, for example: domain\username.

Specifies whether SSL encryption should be enabled when connecting to the IMAP server. Enabling SSL is recommended for secure transmission of credentials and email content, especially when working with sensitive or confidential information.

Set this property to true to use IMAPS (IMAP over SSL/TLS), or false to use standard IMAP.

Specifies the network port used to connect to the IMAP server. The default port for SSL-enabled IMAP is 993; for non-SSL connections, the default is 143.

Adjust this value if your mail server uses a non-standard port.

Specifies the mailbox (account) name where the email message is stored. If not specified, the default mailbox associated with the login user is assumed.

This property is useful for environments with multiple mailboxes or shared accounts.

Specifies the folder within the mailbox where the email message is located (e.g., Inbox, Sent Items). This value is required to uniquely identify the message within the mailbox.

Specifies the unique identifier of the email message within the folder. This value is assigned by the IMAP server and is used to retrieve, process, or delete the specific message.

The 'Message ID' is required for all operations that target a specific email.

The 'Mailbox Account Name' property provides the effective account name used to access the email message on the IMAP server. If the 'Mailbox Name' property is set, its value is returned; otherwise, the value of 'User Name' is used. This allows for flexible configuration in environments where a user may have access to multiple mailboxes or shared accounts.

Use this property to confirm which account context is being used for IMAP operations, especially when troubleshooting access or permissions issues. In most cases, this will match the login credentials, but may differ if a specific mailbox is targeted.

The 'Date Sent' property displays the date and time when the email was originally sent, as reported by the IMAP server. This value is extracted from the message headers and is useful for sorting, filtering, or auditing email content within Grooper.

The format of the date string is determined by the message source and may vary depending on the sending mail client or server. Use this property to track the chronological order of messages or to drive workflow decisions based on message timing.

The 'From' property displays the sender's email address and, if available, the display name as specified in the message headers. This information is essential for identifying the origin of the email and can be used for filtering, routing, or validation within document-centric workflows.

If the sender's name is present, it will be included in the value, typically in the format: Display Name <email@domain.com>.

The 'To' property lists the primary recipients of the email message, as specified in the message headers. This value may include one or more email addresses, separated by commas, and may also include display names.

Use this property to determine the intended recipients for workflow routing, auditing, or extraction of contact information.

The 'CC' property lists the email addresses included as carbon copy (CC) recipients in the message. Like the 'To' property, this may include multiple addresses and display names.

This property is useful for tracking additional parties who received the message and for extracting contact information or auditing communication flows.

The 'Subject' property displays the subject line of the email message, as entered by the sender. This value is often used for indexing, searching, or categorizing messages within Grooper.

Use this property to extract key information, drive classification, or present a summary of the message content in user interfaces.

The 'Object Name' property provides the file name assigned to the email message when it is loaded or exported from Grooper. The value is constructed from the 'Message ID' property, with a .eml extension (e.g., 12345.eml).

This property is useful for referencing the message as a file, for export, or for integration with external systems that require a file-based representation.

The 'Link Name' distinguishes this Content Link from others attached to the same Batch Folder. Common values include "Import" for links created during import, and "Export" for links created during export. This property is used to track the origin or purpose of the link, and is referenced by the 'ImportLink' and 'ContentLink' properties on Batch Folder.

The 'Path' property returns the directory or container path of the external content, excluding the item name itself. This is useful for understanding the organization of content in external systems, and for display or navigation purposes.

If available, this property provides the user or account that originally created the external content. This information is typically populated for repository-based links (such as CMIS Repository), and may be null for file system links.

Indicates when the external content was originally created. This value is useful for auditing and tracking purposes, and is populated when available from the external system.

If available, this property provides the user or account that most recently modified the external content. This is typically available for repository-based links, and may be null for file system links.

Indicates the last modification date and time for the external content. This value is useful for tracking changes and is populated when available from the external system.

The 'Filename' property provides the name of the external file referenced by this Document Link, excluding any directory information. This value is useful for display, logging, and when exporting or processing files.

The filename is typically derived from the external file's path and is used throughout Grooper to identify the document in user interfaces, reports, and export operations.

For example, if the external file path is /invoices/2024/invoice.pdf, the 'Filename' will be invoice.pdf.

This property is read-only and is determined automatically from the linked file.

The 'MIME Type' property indicates the media type of the external document, such as application/pdf or image/tiff. This value is used by Grooper to determine how to process, display, or export the file.

The MIME type is typically inferred from the file extension, but may also be set explicitly by the import or export provider.

Correct configuration of the MIME type ensures that the document is handled appropriately throughout the Grooper workflow, including extraction, conversion, and export scenarios.

The 'Size' property provides the total size of the external document referenced by this Document Link, measured in bytes. This value is useful for storage planning, validation, and reporting.

The size is determined from the external file's metadata and is updated whenever the link is refreshed or the file is modified.

For example, a 2 MB PDF file will have a 'Size' value of 2,097,152 bytes.

This property is read-only and always reflects the current size of the file as reported by the external system.