How to use IBM App Connect with Microsoft OneDrive for Business

Use Microsoft OneDrive for Business to access shared files and folders from any device even when you're offline.

Availability:
  • A connector in IBM App Connect Enterprise as a ServiceApp Connect Enterprise as a Service connector
  • A local connector in a Designer instance of IBM App Connect in containers (Continuous Delivery release)Local connector in containers (Continuous Delivery release) 12.0.7.0-r4 or later
  • A local connector in a Designer instance of IBM App Connect in containers (Support Cycle 2)Local connector in containers (Long Term Support Cycle-2 release)

Supported product and API versions

To find out which product and API versions this connector supports, see Detailed System Requirements on the IBM Support page.

Connecting to Microsoft OneDrive for Business

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

Microsoft OneDrive for Business connection fields:

Authorization method Connection field Description Applicability
BASIC OAUTH Access token The access token generated from the application client ID and client secret. App Connect in containers and App Connect Enterprise as a Service
Refresh token The refresh token generated from the application client ID and client secret.
Client ID The unique identifier generated after the Microsoft Azure app registration maps to the specific project requests.
Client secret The application client secret for a project-specific unique application client ID.
OAUTH 2.0 AUTH CODE
Tip: Authorize connection to Microsoft OneDrive for Business by signing in to your account.
  App Connect Enterprise as a Service

To obtain the connection values for Microsoft OneDrive for Business, see Obtaining connection values for Microsoft OneDrive for Business.

To connect to Microsoft OneDrive for Business from the App Connect Designer Applications and APIs page for the first time, under Microsoft OneDrive for Business click Connect. When prompted, grant App Connect access to your Microsoft OneDrive for Business. This creates an account in App Connect.

Tip:
  • If you are already logged in to Microsoft in the same browser window as App Connect Enterprise as a Service, App Connect displays the popup window for you to connect to that Microsoft account. To connect App Connect to a different account, you can use the option to sign in to another Microsoft account.
  • If you don't have a Microsoft account, you can join the Microsoft 365 Developer Program to try the Microsoft 365 platform for free. The developer account includes licenses for all Office 365 apps including OneDrive.

Before you use the account that is created in App Connect in a flow, rename the account to something meaningful that helps you to identify it. To rename the account on the Applications and APIs page, select the account, open its options menu (⋮), then click Rename Account.

What should I consider first?

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

  • The Create file action creates a file in a OneDrive folder that you select in the Parent folder ID: field when you configure the action. Before using the Create file action, make sure a folder exists in your Microsoft OneDrive for Business.
  • You can use the Parent folder ID filter available in the actions Retrieve folders and Retrieve folder items to retrieve information about the child folders inside a parent folder.
    Parent folder ID filter in the actions Retrieve folders and Retrieve folder items
    Note: If you add multiple filters in the actions Retrieve folders and Retrieve folder items (for example, ID and Parent folder ID), the operation gives preference to the Parent folder ID filter.
  • (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 OneDrive for Business events

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

Note: Events are not available for changes in this application. You can trigger a flow in other ways, such as at a scheduled interval or at specific dates and times.

Microsoft OneDrive for Business actions

Your flow completes these actions on this application.

Drive
Retrieve drive
Files
Create file
Retrieve all files
Rename file
Retrieve files
Delete file
Update file
Move file
Copy file
Download file
Folder item
Retrieve folder items
Folders
Create folder
Retrieve all folders
Retrieve folders
Delete folder
Copy folder
Move folder
Rename folder
Permission
Create permission
Retrieve permissions
Delete permission
Update permission
Shared link
Create sharing link
User
Retrieve users

Examples

Dashboard tile for a template that uses Microsoft OneDrive for Business
Dashboard tile for a template that uses Microsoft OneDrive for Business
Dashboard tile for a template that uses Microsoft OneDrive for Business

Use templates to quickly create flows for Microsoft OneDrive for Business

Learn how to use App Connect templates to quickly create flows that perform actions on Microsoft OneDrive for Business. For example, open the Templates gallery, and then search for Microsoft OneDrive for Business.

Microsoft OneDrive for Business flow in detailed view

Use IBM® App Connect to build flows that integrate with Microsoft OneDrive for Business.

Read the blog in the IBM Community to learn how to upload the attachments to Microsoft OneDrive for Business whenever a new issue with attachments is created in Jira. Click Read the blog to go to the blog.