Information
  • Author: Appian Corporation
  • Type: Plug-in (Connected System)
  • Support: This plug-in or utility is not supported by the author. The content is free to use with a licensed product, but it is made available as-is and Community supported.
  • Industry: All Industries
  • Compatible Version(s): 22.1
  • First Released:
  • Last Updated:
  • Cost: Free
Resources
Share
Home » AppMarket » MS Graph Utilities

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 

  • in reply to brendanm0004

    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

  • in reply to brendanm0004

    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

Comment
  • in reply to brendanm0004

    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

Children
No Data

© 2024 Appian. All rights reserved.