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
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 HTML. It can also be PLAIN (plain text) or Rich Text
MessageType
LTools.Office.Model.OMailMessage.MailTypes
Only for Outlook. Examples: Message or Report (delivery report)
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, 13.07.2023 18:21:25. Does not exist in Lotus Notes
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 - "Re: Vacation", ConversationTopic - "Vacation"
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: "Text\n". When a conversation is displayed, the body will contain all emails in the conversation
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.
🔹 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