Microsoft OneDrive for Business

Microsoft OneDrive is a file hosting service to store, share, and synchronize files. This document describes how to connect IBM watsonx Orchestrate to Microsoft OneDrive for Business and use its skills on watsonx Orchestrate.

Before you begin

  1. Enable the pop-up window on your browser.
  2. If your Microsoft admin has blocked apps from accessing data in your organization, you need to work with your admin to allow watsonx Orchestrate to connect to Microsoft OneDrive. Otherwise, the message Need admin approval is shown.

Connecting to Microsoft OneDrive

Important:
- A credential type must be set for apps that are a part of team skill sets and AI assistants. Skill-based actions in AI assistants support only shared credentials.
- If a credential type of an app is not specified, an error message is displayed when users attempt to run the skills of the app. To resolve the error, an admin must set the credential type for the app. For more information, see Managing connections.

An app can be connected either through the skill catalog or through the watsonx Orchestrate chat. Use the method that suits you to connect to an app.

Connect to the app through the skill catalog when you add that skill to your skill set:

  1. On the watsonx Orchestrate chat page, click Add skills from the catalog.
  2. Search and click the app tile.
  3. Click Connect app.
  4. Configure the connection. For more information, see Configuring the connection.
  5. Click Connect app.

Otherwise, connect to that app through the watsonx Orchestrate chat when you use the skill:

  1. Open the watsonx Orchestrate chat.
  2. On the chat, start the skill.
  3. Click Connect app.
  4. Configure the connection. For more information, see Configuring the connection.
  5. Click Connect app.

Configuring the connection on watsonx Orchestrate SaaS

To connect watsonx Orchestrate to Microsoft OneDrive, complete the following steps:

  1. Click Connect app. It redirects you to sign in to a Microsoft account and authorize the connection.
  2. Set your Microsoft OneDrive account email and click Next.
  3. Set your Microsoft OneDrive account password and click Sign in.
  4. Check the Consent on behalf of your organization and click Accept.

After you accept, watsonx Orchestrate connects to it automatically.

Note: If you already have an active Microsoft OneDrive connection in your browser, that connection is used for the authentication. To connect to a different Microsoft OneDrive, log out of watsonx Orchestrate first.

Configuring the connection on watsonx Orchestrate on-premises

To connect watsonx Orchestrate to Microsoft OneDrive, complete the following steps:

  1. Click Connect app.
  2. You are prompted to enter the following connection details:
    • Access token: Specify the access token generated from the application client ID and client secret.
    • Refresh token: Specify the refresh token generated from the application client ID and client secret.
    • Client ID: Specify the unique identifier generated after the Microsoft Azure app registration maps to the specific project requests.
    • Client secret: Specify the application client secret for a project-specific unique application client ID.
  3. Click Connect app.
Note: The icon A green check icon appears to show that the app is connected. indicates that the connection was successfully established.

Technical parameters

The following table contains the technical parameters required by some skills of this app and instructions to retrieve them.

Parameters Details
Drive ID To get the Drive ID, use the Get all drives skill.

What to do next

After you connect to the app, you can use the app’s skills. For more information see, Using the chat. To know what skill you can use, see the skills and skill flow column of List of prebuilt apps, skills and skill flows.

Parent topic:

→ Connecting to apps