OMailMessage
LTools.Office.Model.OMailMessage is a mail message model. It is used in the elements that work with Outlook, Exchange, Lotus Notes mail clients.
Model properties
Property | Type | Description |
---|---|---|
ID | String | Message identifier. Provides a way to access a specific message by its ID. The IDs can be obtained by reading messages using appropriate Studio elements. For example, the result of using Read mail will be a list of messages, each of which has its own ID. |
MailFormat | Message format. An example of its value is | |
MessageType | LTools.Office.Model.OMailMessage.MailTypes | Only for Outlook. Examples: |
From | String | Email address of the sender, for example, |
To | List<String> | List of message recipients’ email addresses |
Сс | List<String> | List of message copy recipients’ email addresses |
Всс | List<String> | List of message Bcc (blind carbon copy) recipients’ email addresses |
CreateDate | Date and time when the message was created, for example, | |
ReceiveDate | System.DateTime | Date and time when the message was received. Does not exist in Lotus Notes |
Subject | String | Message subject |
ConversationTopic | String | Only for Outlook. A conversation includes all messages in the same thread with the same subject line. Usually, the Conversation topic is the subject line of the first email in a thread. More information about conversations can be found here. When a message is read in Outlook, it can have both the Subject and the ConversationTopic. An example for a sent message: Subject - |
Body | String | Message body text. In Exchange, the body text will be read as HTML only, and in Outlook it can also be read as plain text (PLAIN). Plain text does not support images, hyperlinks (they will be displayed as plain links) and other similar elements. Example for PLAIN: |
HTMLBody | String | Message body text in HTML format |
MessageProperties | LTools.Office.Model.OMailMessage.OMailProperties | Only for Outlook. Message properties are displayed if the element Read mail has Read properties flag. Message properties can be used, for example, to find out the display name of the sender or recipient |
Element | - | Represents an email message. Data type depends on the mail client used: for Exchange it is EmailMessage, for Outlook - MailItem, for Lotus - Domino.NotesDocument. To get access to class properties, it should first be manually cast as the necessary type. More details about it are provided in the subsection below. |
Attachments | Email attachments |
🔹 Note. All properties that begin with the word Send, as well as ReplyAll property, contain only technical information and are not intended for users. This applies to such properties as: SendTo, SendСс, SendВсс, SendOnBehalf, ReplyAll.
Details
CreateDate
CreateDate/ReceiveDate model property has the following set of properties::
Example of obtaining the day of the month when the message was created: var_list_mails[0].CreateDate.Day
, where:
var_list_mails - nominal name of the variable;
[0] - index of the message whose property we want to obtain.
If the result is output via the Add log element, make sure to cast the value as a string. Example result: 13
.
Element
Element model property represents an email message. Data type depends on the email client:
for Exchange - it is Microsoft.Exchange.WebServices.Data.EmailMessage;
for Outlook - it is Microsoft.Office.Interop.Outlook.MailItem;
for Lotus - it is Domino.NotesDocument.
The list of properties will correspond to the message class.
‼️ To obtain the value of any Element property, it has to be manually cast as the necessary class.
For example, to obtain the sender name for an Exchange message, it should first be cast as EmailMessage:
(var_list_mails[0].Element as Microsoft.Exchange.WebServices.Data.EmailMessage).Sender
.
MessageProperties
MessageProperties model property (only Outlook) has the following set of properties:
Their descriptions can be found in this section, by selecting in the left menu the name of the canonical property.
Example of obtaining the displayed sender name: var_list_mails[0].MessageProperties.PR_SENDER_NAME
.
It should be noted that the sender name may not be displayed - that depends on the mail server settings.
Last updated