Request Parameters Page

You can specify query parameters to control the amount of email message data returned by Microsoft Office 365 Outlook. These parameters reduce the chances of timeouts. The Request Parameters page is displayed if you select any of the Get operations on the Operations page (for example, Get Messages, Get messages of a folder, and others). The query parameters you select are displayed for mapping in the mapper.

If you prefer to continue receiving emails in one large collection, click Continue without selecting any query parameters. There are 500 emails returned for the Get messages/Get messages of a folder operations when you don't use query parameters, for backwards compatibility. When query parameters are used, the Microsoft Office 365 Outlook Adapter follows the Microsoft Graph API rules (defaults to 10 emails, with a maximum top value of 1000). If you want more than 1000 emails, you must update your integration to use a pagination algorithm.

Element Description

Query Parameters

Use to search for specific query parameters within the Available Query Parameters box. As you type, the list dynamically updates to show only the parameters that match the input. For example, if you enter t, to, or top, only the matching parameter top appears in the list.

Available Query Parameters

  • filter: Filters results (rows).
  • search: Returns results based on search criteria.
  • select: Filters properties (columns).
  • top: Sets the page size of results.
  • _nextLink: Provides pagination support. This parameter informs the client that there is more email message data to fetch. This parameter's value is a URL for the next page of data.
  • count: Retrieves the total count of matching resources.
  • orderby: Orders results.
  • skip: Indexes into a result set. It is also used by some APIs to implement paging and can be used together with top to manually page results.

These query parameters are provided with the Microsoft Graph API. See Use query parameters to customize responses.

Several use cases are provided that describe how to use these query parameters with the Microsoft Office 365 Outlook Adapter. See Implement Common Patterns Using the Microsoft Office 365 Outlook Adapter.

Selected Query Parameters

Displays the selected parameters.

After completing this wizard, you set the values for these parameters in the mapper.