Office365 List Mails By Folder lists emails within a specific folder (mailFolderId) on Office365. When a user selects a folder (e.g., Inbox, Sent, Archive), it displays the emails in that folder.

Technical Specifications

Folder-Based Mail Listing: Returns emails in the folder with the specified mailFolderId value. The returned data type is Office365MailResult (One).

Parameters:

• settings (Object – required): Office365 connection settings. The Office365 integration defined in Configuration Manager must be selected.
• mailFolderId (String – required): The ID of the folder whose emails will be listed. (E.g., Inbox folder ID).
• search (String – optional): Searches can be performed based on subject, sender, or content.
• filter (String – optional): Emails can be filtered according to specific conditions (e.g., only unread emails).

Office365 List Mails By Folder Application Steps

1. Action Definition in UI Design

• Add a Select Box to the screen.
• Connect this component to the Office365 List Mail Folders action to get the ID of the folder selected by the user.
• Then select + ADD ACTION → Office365 → Office365 List Mails By Folder.

2. Configuring Parameters

• settings: Select the Office365 integration from the Configuration Manager.
• mailFolderId: The ID value of the folder selected by the user must be linked here.
• search: For example, if “project meeting” is entered, only emails containing this word will be returned.
• filter: For example, if isRead eq false is entered, only unread emails will be listed.

3. Using the Returned Data

The resulting Office365MailResult type data contains the following:

• id: Mail ID
• subject: Mail subject
• from: Sender
• toRecipients: Recipient list
• receivedDateTime: Received time
• isRead: Whether read or unread
• bodyPreview: Short summary of content

This information can be displayed to the user by linking it to the list in the UI.

Usage Scenario: Listing Emails in the Inbox

Steps:

1. The Office365 List Mail Folders action is executed, showing the user folders such as Inbox, Sent, Archive.
2. The user selects the Inbox.
3. The id value of the selected folder → goes to the Office365 List Mails By Folder action as a parameter.
4. The emails in the Inbox are listed.
5. When the user selects an email, the messageId is sent to the Office365 Get Mail action and the details are opened.

Office365 List Mails By Folder Advanced Customizations

• Dynamic Mailbox: As the user selects different folders, emails in the relevant folder are automatically listed.
• Filtering: You can display only unread emails or emails after a specific date.
• Search: With the search parameter, the user can search the folder based on the keyword they enter.

Technical Risks and Controls

• mailFolderId must be correct. If an incorrect ID is entered, no results will be returned.
• settings link: Office365 integration must be configured correctly.
• search + filter combination may return empty results if too restrictive.