MS Graph Utilities

Overview

MS Graph Utilities provides features to integrate with the Microsoft Graph API that cannot be achieved using an Appian Integration Object.

Key Features & Functionality

Connected Systems

  • OAuth 2.0 Client Credentials
    • Used to get access to the Graph API without a user via Application Permissions. See here for more details.
  • OAuth 2.0 Authorization Code
    • Used to get access to the Graph API on behalf of a user via Delegated Permissions. See here for more details.

Integrations

Large File Upload

  • This plug-in provides 2 Integrations for large file upload via the Graph API, one for each type of Connected System. Each Large File Upload Integration provides the same functionality, but uses different authorization methods
  • Enables large files to be uploaded via the Graph API. Files are uploaded in chunks of roughly 5MB. The standard Graph REST API for uploading a file is limited to files of up to 4MB.
  • For files under 4MB, it is recommended to use an HTTP Integration object to upload the file rather than using this plug-in.

On success, this Integration returns the following data in the Result object:

  • id (Text) - the Drive Item Id for the uploaded document.
  • eTag (Text) - the eTag for the uploaded document.
  • name (Text) - the file name (including extension) of the uploaded document (which may differ from the Appian document's filename, e.g. when using Conflict Behavior "Rename").
  • webUrl (Text) - the webUrl for the uploaded document.

See accompanying readme PDF document for more details and design considerations

Anonymous
Parents
  • For benefit of others (not familiar with the SharePoint GraphAPI), questions are

    1. Target Folder Drive Items Id - would be useful to document what this property is for + usage 

    2. Target Document Drive Item Id - - would be useful to document what this property is for + usage 

    Potentially a brief comment in the documentation would be adequate to cover this 

  • Hi Brendan,

    The Large File Upload integration in this plug-in operates within the Files > Drives entities within the Graph API. Full documentation about Drive Items can be found here.

    All uploads must specify a target folder drive item id -> this is the drive item (a folder in this case) to which to upload the document.

    If uploading a new version of an existing document, you should specify a target document drive item id (the drive item id of the document to overwrite).

    Regards,

    David

  • Hi Brendan,

    As the supporting readme document explains, this plugin provides features to integrate with the Microsoft Graph API that cannot be achieved using an Appian Integration Object. For simple functions such as creating a folder, a plugin is not required and Appian OAuth Connected Systems and Integration Objects should be used to interact with the Graph API.

    Regards,

    David

  • Thanks David, sorted out those clarifications, all good.  One other question, is there any thought to extending the plugin to expose additional GraphAPI operations?  Eg, one immediate UC would be the ability to create sub-folders in SharePoint (as required). For context, would be similar to how we typically create sub-folders for docs in Appian eg. on a Case basis  

Comment
  • Thanks David, sorted out those clarifications, all good.  One other question, is there any thought to extending the plugin to expose additional GraphAPI operations?  Eg, one immediate UC would be the ability to create sub-folders in SharePoint (as required). For context, would be similar to how we typically create sub-folders for docs in Appian eg. on a Case basis  

Children