Office365 List Mails lists emails in a selected folder (e.g., Inbox, Sent Items). It is used to display the user's inbox or specific folders on the application screen.

Technical Specifications

Mail Listing: Returns emails in the specified folder. The returned data type is Office365MailResult (One).

Parameters:

• settings (Object – required): Office365 connection settings. The Office365 API connection defined via Config Manager must be selected.
• includeHiddenMessages (Boolean – optional): Includes hidden or system messages in the list (true/false).
• search (String – optional): Can be used to search emails based on subject, content, or sender. E.g.: “invoice”.
• filter (String – optional): Used to filter emails. E.g.: Can be used to retrieve only “unread” emails.

Office365 List Mails Application Steps

1. Action Definition in UI Design

• Add a Table element to the screen where you will display the mailbox.
• To provide data to this list, select + ADD ACTION → Office365 → Office365 List Mails.

2. Configuring Parameters

• settings: Select Office365 integration from Configuration Manager.
• includeHiddenMessages: If you select true, system/hidden emails will also be listed.
• search: You can search for a specific word (e.g., “Meeting”).
• filter: You can list specific types of emails as needed (e.g., isRead eq false).

3. Using the Returned Data

The resulting data is of type Office365MailResult:

• id: Email ID
• subject: Subject
• from: Sender
• toRecipients: Recipients
• receivedDateTime: Received date
• isRead: Read status
• bodyPreview: Short summary of the content
• and other fields.

These fields can be linked to the list component in the UI to create a “Mailbox View”.

Usage Scenario: Listing the Inbox

We want to list the user's inbox in an application.

Steps:

1. After the user logs in, the folders are listed with Office365 List Mail Folders.
2. The user selects the “Inbox” folder.
3. The ID of the selected folder is sent as a parameter to the Office365 List Mails action.
4. As a result, all emails in the Inbox are listed in the application.
5. When the user selects an email from the list, the relevant messageId is sent to the Office365 Get Mail action, and the details are opened.

Office 365 List Mails Advanced Customizations

• Search: The user types a word in the search box (e.g., “Invoice”), and the action returns filtered results using the search parameter.
• Show Unread Emails: Only unread emails can be listed by entering isRead eq false in the filter parameter.
• Dynamic Refresh: The list can be refreshed at specific intervals to stay up to date.

Technical Risks and Controls

• settings must be configured correctly. If the connection settings are incorrect, no results will be returned.
• When search and filter are used simultaneously, the results returned from the API are narrowed down, so the correct combination must be used.
• Authorization restrictions: Users can only view folders and emails they have access to.