Last updated: 2021-12-22

Source: https://support.freshservice.com/support/solutions/articles/50000003893-installaton-guide-microsoft-onedrive

Overview

Perform operations on Microsoft OneDrive via the Workflow Automator.

Description

Orchestration apps let you automate repeatable tasks and actions that span across a diverse set of systems and applications using workflows. The list of actions supported for this app include:

File and Folder Management

1. Get File Or Folder

2. Rename File Or Folder

3. Move File Or Folder

4. Create Folder

5. Delete File Or Folder

6. Attach OneDrive File to Ticket

7. Upload Ticket Attachments to OneDrive

Permission Management

1. Create Permission

2. Create Sharing Link

Prerequisites

To install and authenticate the app, you need to provide the following input:

  • Config Name
  • The config name is the unique identifier for the account credentials added to the app.
  •  Client ID
  • Navigate to “Azure Active Directory”
  • Go to App Registrations (if you don’t have an existing App, create a new app registration)
  • Then open your App
  • Copy “Application (client) ID.”

  • Key (Secret Key)
  • Navigate to Azure Active Directory
  • Go to App Registrations
  • Then click “Certificates & secrets” on the left panel
  • Click on “New client secret”
  • Copy the Secret Key given as “Value.”

  • Active Directory Domain
  • Navigate to  Azure Active Directory
  • Go to Overview
  • Copy Primary Domain / Tenant Id.

  • Freshservice Domain -
  • The domain of your Freshservice tenant. Example: yourcompany.freshservice.com
  • Freshservice API Key -
  • Login to your Freshservice tenant.
  • Click on your profile icon then "Profile Settings" on the right-side pane. Under "Your API Key" complete the captcha and copy your API key.

    • Steps to assign permissions

    1. Navigate to Azure Active Directory

    2. Go to App Registrations

    3. Select your app

    4. Go to API Permissions

    5. Click on “Add Permissions”

    6. Click on “Microsoft Graph”

    7. Click on  “Application Permissions”

    8. Assign the following permissions to your app:

  • Files.Read.All
  • Files.ReadWrite.All

    • 9. Ensure you "Grant admin consent" for all the permissions you assign.

    Concepts

    Addressing resources in a drive on OneDrive

    Path-based addressing

    MS OneDrive orchestration app supports path-based addressing for OneDrive. This allows you to use a friendly URL syntax to address items relative to the hierarchy of items visible in OneDrive. If you know the hierarchy of an item, you can directly address that item without spending any time making repeated calls to discover each level of the hierarchy.

    However, since path-based addressing is based on the name of the item, renaming or moving the item to a new location will cause the path of the item to change.

    Path-based addressing can be used relative to any item in OneDrive, which enables some very useful scenarios.

    Examples

    These examples show the different paths that can be used to access data. All of these paths are logically equivalent to MyFile.xlsx.

    PathDescription
    MyFile.xlsxSpecified by filename relative to the root of a drive.
    Employee Ref/MyFile.xlsxSpecified by filename in the Employee Ref folder.