In this article
...
- Use valid SharePoint Online tenant and associated site in account and snap settings respectively.
- Valid application in Azure portal with necessary permissions to the application. To learn more about how to choose permissions, see Permissions.
Support for Ultra Pipelines
...
Limitations and Known Issues
N/A
Snap Input and Output
Input/Output | Type of View | Number of Views | Examples of Upstream and Downstream Snaps | Description |
---|---|---|---|---|
Input | Document |
|
| A document containing the metadata of the permission to be created. |
Output | Document |
|
| A document containing the created (or shared) permissions on the item with the recipients. |
...
Parameter Name | Data Type | Description | Default Value | Example | |||||
---|---|---|---|---|---|---|---|---|---|
Label | String | Required. The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline. | N/A | SharePoint Online - Create Permission | |||||
Site | String | Required. This property enables you to define the name of a site, which contains the list of document library to be used in the subsequent settings. | N/A | MySite | |||||
Document Library | String | Required. This property enables you to select Drive representing the top-level container for a file system, such as OneDrive or SharePoint document libraries. This field will be populated dynamically from different sites from the suggestion dropdown. Users are allowed either to choose a document library from suggestion dropdown or type an entity manually.
| N/A | Shared Documents | |||||
Source item relative path | String | Required. The driveItem resource path that represents a file, folder, or other item stored in a document library on which we want to create the permission. | N/A | testFile.pdf | |||||
Roles | String | Required.Specify the roles that are to be granted to the recipients of the invitation. | Read | Write | |||||
Recipients | String | Required. Comma-separated recipients who will receive access and the sharing invitation to the selected item. | N/A | user@company.com | |||||
Message | String | Optional. A plain text formatted message that is included in the sharing invitation. Maximum length 2000 characters. | N/A | ||||||
Require signin | boolean | Optional. Enable this property to send the invitation to sign-in to view the shared item with the recipients. | Disabled | ||||||
Send invitation | boolean | Optional. Enable to send a sharing link to the recipient. Otherwise, a permission is granted directly without sending a notification. | Disabled | ||||||
Connection details | N/A | Settings to influence connection properties to the SharePoint Online APIs. | N/A | N/A | |||||
Connection timeout | int | Required. This property enables you to set the connection timeout duration in seconds. | 30 | 30 | |||||
Number of retries | int | Required. This property enables you to set the maximum number of re-connections in case of connection failure or timeout. | 0 | 0 | |||||
Retry interval (seconds) | int | Required. This property enables you to set the time interval in seconds between connection attempts. | 1 | 1 | |||||
Snap Execution | DropDown | Specifies the execution type:
| Execute only | N/A |
...
The example assumes that you have configured & authorized a valid SharePoint Online Account (see Sharepointonline SharePoint Online Account).
The following SharePoint Online - Create Item Permission snap and pipeline shows how to create a permission on a specified item.
...