Share File/Folder

UiPath.MicrosoftOffice365.Activities.Files.ShareItemConnections

Description

Shares a file or folder with the specified recipients.

Scopes

This activity requires the following scopes:

• Files.ReadWrite
• Files.ReadWrite.All
• Sites.ReadWrite.All

Project compatibility

Windows | Cross-platform

Configuration

• Microsoft OneDrive & SharePoint connection - The connection for the Microsoft 365 account to use in the activity.
• File or folder to share - The specific file or folder to share. The method to specify the file or folder to be retrieved: File or folder picker, Enter Id, Enter Url.
  • File or folder picker option - Browse the OneDrive or SharePoint folders and select the file or folder. This field accepts IResource input. Use the See more button menu to use a variable as the input mode.

  • Enter Id option:

    • File or folder Id - The ID of the file or folder. To retrieve the ID, open the file in OneDrive Web and retrieve its URL. The ID is encoded in the URL. For example: if the URL is https://yourcompany.sharepoint.com/Doc.aspx?sourcedoc=%7BA1CA7E78-BA59-4DD4-A6B9-5F5BBC37FA85%7D&file=Merge_sheets.xlsx`, the decoded file ID is A1CA7E78-BA59-4DD4-A6B9-5F5BBC37FA85. %7B and %7D are the delimiters around the file ID. This property supports String variables and string formatted values.
    • SharePoint site address - The URL of the SharePoint site that contains the file or folder. Open your SharePoint site in a browser and retrieve the URL, e.g., https://yourCompany.sharepoint.com/sites/Marketing. This property supports String variables and string formatted values.
    • SharePoint document library - The document library within the indicated SharePoint site that contains the file or folder. Open your SharePoint site in a browser, go to the Documents tab, then retrieve the URL, e.g., https://yourCompany.sharepoint.com/sites/Marketing/Shared%20Documents/Forms/AllItems.aspx. This property supports String variables and string formatted values.

  • Enter Url option:

    • File or folder Url - The URL of the file or folder. Open the file or folder in the browser and retrieve its URL. This property supports String variables and string formatted values.

  • Use the See more button menu to use a variable or select the Reload Folder Picker option if you've modified your folders and need to retrieve the latest data.

• Share with - The type of recipient for which the permissions are granted: People in organization, Specific people, Anyone.

  • People in organization option:

    • Permission - The type of permission to grant: View, Edit.

  • Specific people option:

    • Permission - The type of permission to grant: View, Edit.
    • Recipients - The email addresses of the recipients which will receive access to the file or folder, separated by pressing the Enter or Tab key. Optionally, the recipients can also receive a sharing invitation email. This property supports String[] variables and string array formatted values.
    • Message - The plain text included in the sharing invitation. This property supports String variables and string formatted values.
    • Send sharing invitation email - Boolean value. Set to True to send a sharing invitation email to the recipients.
    • Requires sign in - Boolean value. Set to True to indicate if the recipient needs to sign in to their Microsoft 365 account to view a shared file. Sharing a folder requires the value to be set to True.

  • Anyone option:

    • Permission - The type of permission to grant: View, Edit.
    • Password for the sharing link - An optional password to access the sharing link. This option is available on premium personal OneDrive accounts. This property supports String variables and string formatted values.
    • Expiration date - An optional expiration date and time for the sharing link. Use the calendar widget to select a date and time. This option is available on premium personal OneDrive accounts. This property supports DateTime variables and DateTime formatted values.

Additional options

Output

• Access Url - The web URL of the sharing link or of the drive item. Automatically generated output variable. You can use it as it is or save it with a different name. You can use this in other activities.

Example

See also:

• Files activities

• For Each File/Folder
• Download File
• Create folder