Share
AutomatR.OneDriveApp.Activities.Share
The "Share" activity in AutomatR, part of the OneDrive activities package, uses Microsoft APIs to enable the sharing option for a particular file or folder within Microsoft OneDrive. This activity streamlines the process of sharing content, enhancing the efficiency of automation workflows.
Properties
| Name | Description |
|---|---|
| Input | |
| Source Path | Specifies the path of the file or folder that you would like to share with others. String variables containing the file or folder path within OneDrive. |
| Emails | Specifies the recipient's email address to whom you would like to share the file or folder. Multiple email addresses can be provided, separated by commas or semicolons. String variables containing the recipient's email address(es). |
| Misc | |
| Display Name | Provides a customizable name for the activity displayed in the workflow. The display name enhances clarity and organization within the automation project. String variables containing the desired display name. |
| Optional | |
| Delay | Specifies the amount of time (in seconds) to wait before executing the "Share" activity. Integer variables containing the delay duration. Example: 5 seconds i.e. 5. |
| Message | Specifies the plain text that you would like to include in the sharing invitation. String variables containing the message text. |
| Output | |
| Result | Outputs the result of the "Share" operation, indicating whether the sharing process was successful (True) or encountered errors (False). Variables of relevant types (e.g., Boolean variables) to store the operation result. |
How to Use
- Drag and drop the "Share" activity onto the workflow.
- Configure the properties by specifying the source path, recipient email(s), and optional message for the sharing invitation within the OneDrive account.
- Optionally, configure the delay and customize the display name.
- Execute the workflow to share the specified file or folder within OneDrive.
Example:
Consider an example where the "Share" activity is used to share a file named "document.txt" with two recipients within OneDrive:
Share:
Display Name: "Share Document"
Source Path: "/Folder1/document.txt"
Emails: "recipient1@example.com, recipient2@example.com"
Message: "Please review the document."
Result: isSharingSuccessful
In this example, the activity shares the "document.txt" file from the "Folder1" directory within OneDrive with two recipients. The result of the operation (success or failure) is stored in the Boolean variable "isSharingSuccessful" for further handling in the workflow.