How to use IBM App Connect with Microsoft OneNote

Connecting to Microsoft OneNote

Complete the connection fields that you see in the App Connect Designer Connect > Applications and APIs page (previously the Catalog page) or flow editor. If necessary, work with your Microsoft OneNote administrator to obtain these values.

Microsoft OneNote connection fields:

To obtain the connection values for Microsoft OneNote, see Obtaining connection values for Microsoft OneNote.

To connect to a Microsoft OneNote endpoint from the App Connect Designer Applications and APIs page for the first time, expand Microsoft OneNote, then click Connect. For more information, see Managing accounts.

General considerations

Before you use App Connect Designer with Microsoft OneNote, take note of the following considerations:

• The following table describes the service limits for the Microsoft OneNote connector:

  Limit type	Limit per app per user (delegated context)	Limit per app (app-only context)
  Requests rate	120 requests per 1 minute and 400 per 1 hour	240 requests per 1 minute and 800 per 1 hour
  Concurrent requests	5 concurrent requests	20 concurrent requests

  For more information about service limits, see OneNote service limits on the Microsoft Documentation page.
• All the supported actions in the Microsoft OneNote connector has User ID as an input field.
  • If you want to execute an action for your own notebook, then you have to provide 'me' as the input value.
  • If you want to execute an action on behalf of other users who have permitted you, then you must provide the user ID of the other user as the input value.
• Example of App Connect user interface fields that are filled for the action Create page with embedded content:
  
  In the example, you can see that the Content field contains information about the HTML content which consists of a file attachment. You can configure this field to include multiple images and file attachments. For more information about configuring this field, see the following useful resources on the Microsoft Documentation page.
  • Add a public image from the web
  • Add an image file as an attachment
  • Add an image using binary data
  Restriction: For a list of limitations while sending image and file data, see Size limitations for POST pages requests on the Microsoft Documentation page.

• (General consideration) You can see lists of the trigger events and actions that are available on the Applications and APIs page of the App Connect Designer.

  For some applications, the events and actions depend on the environment and whether the connector supports configurable events and dynamic discovery of actions. If the application supports configurable events, you see a Show more configurable events link under the events list. If the application supports dynamic discovery of actions, you see a Show more link under the actions list.

• (General consideration) If you are using multiple accounts for an application, the set of fields that is displayed when you select an action for that application can vary for different accounts. In the flow editor, some applications always provide a curated set of static fields for an action. Other applications use dynamic discovery to retrieve the set of fields that are configured on the instance that you are connected to. For example, if you have two accounts for two instances of an application, the first account might use settings that are ready for immediate use. However, the second account might be configured with extra custom fields.

Events and actions

Microsoft OneNote events

These events are for changes in this application that trigger a flow to start completing the actions in the flow.

Microsoft OneNote actions

Your flow completes these actions on this application.