OneDrive

Learn how to connect Engini to OneDrive.

With the OneDrive activities in Engini you can:

• Create, update, delete, and get one or more files
• Create, update, delete, and get one or more folders

To get started with the OneDrive app, create an account for free at https://www.microsoft.com.

Getting Started with OneDrive #

Prerequisites #

• A Microsoft account.

Add a connection to OneDrive in Engini #

1. Enter to your Engini account at https://app.engini.io.
2. Navigate to Connections page by clicking on the Connections on the left sidebar or by clicking here.
3. Click on the Add Connection option located at the top bar.
4. Choose the OneDrive option from the available applications.
5. Enter the following details in the “Edit Connection” for
   
   1. Connection name
   2. Click on the “Microsoft Signin” button.
   3. Sign into your Microsoft account.
   4. Click on the save button to save the connection.

Triggers #

The triggers monitor the folder, listening for files and folders created or updated in the connected OneDrive folder, based on the defined scheduled intervals.

Check for File/Folder Created/Updated #

1. Files or Folders
   Select from the dropdown list the type of content you want the trigger to monitor. You can choose between: “Files and Folders”, “Files only”, or “Folders only”.
2. OneDrive Location
   Select the location of the content you want the trigger to monitor. You can choose between: “Groups’ Drive”, “My Drive”, “Shared With Me”, or “Site’s Drive”.
3. Group/Site Id
   Enter the Group/Site Id where you want to monitor for new/updated files or folders.
   • Click on the empty field, and a tooltip will appear, displaying the groups/sites you can use.
   • From the tooltip, select the group/site, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
4. Drive Id
   Enter the Drive Id where you want to monitor for new/updated files or folders.
   • Click on the empty field, and a tooltip will appear, displaying the drives you can use.
   • From the tooltip, select the drive, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
5. Folder Id
   Enter the Folder Id you want to monitor for new/updated files or folders.
   • Click on the empty field, and a tooltip will appear, displaying the folders you can use.
   • From the tooltip, select the folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
6. Query – Search by file or folder name (not required)
7. Starting (UTC)
   Select the start date and time for the scheduled trigger.
8. Recur every
   Choose the time interval for triggering and checking emails. The minimum time interval is 15 minutes.
9. Add time frame
   You can specify a time frame during which the trigger will operate.
   
   1. Click on “Add time frame” button.
   2. Select a specific time frame to activate the trigger.
   For example, every 15 minutes from 8 AM to 5 PM.

Actions #

Add Permission to File/Folder (Send Invitation) #

This activity permits recipients to write, read, or both files or folders by invitation.

1. Location
   Select the location of the file or folder. You can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.
2. Group/Site Id
   Enter the Group/Site where you want to give permission.
   • Click on the empty field, and a tooltip will appear, displaying the groups/sites you can use.
   • From the tooltip, select the group/site, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
3. Drive Id
   Enter the drive where you want to give permissions for the file or folder.
   • Click on the empty field, and a tooltip will appear, displaying the drives you can use.
   • From the tooltip, select the drive, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
4. File/Folder Id
   Enter the file/folder Id you give permissions on.
   • Click on the empty field, and a tooltip will appear, displaying the folders you can use.
   • From the tooltip, select the file/folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
5. Recipients
   Select the recipients to whom permissions will be given to the file or folder.
   • Click on the empty field, and a tooltip will appear, displaying the recipients you can use.
   • From the tooltip, select the recipients, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
6. Role
   Select the roles you want to promote to the recipients.
   • Click on the empty field, and a tooltip will appear, displaying the roles you can choose.
   • From the tooltip, select the roles you want to give to the recipients.

Append to Recipients Array #

In this activity, you can add other recipients to the list of recipients.
Appending to an array variable allows you to dynamically add new values to the end of the array without changing the size or structure of the array.

1. Select the variable from the dropdown list you want to append to the recipients array.

Append to Roles Array #

In this activity you can add other roles to the list of roles.
Appending to an array variable allows you to dynamically add new values to the end of the array without changing the size or structure of the array.

1. Select the variable you want to append to the roles array.

Copy File/Folder #

In this activity you can copy a file or folder and place them into another folder.

1. Drive Id
   Enter the Drive where you want to copy the file or folder.
   • Click on the empty field, and a tooltip will appear, displaying the drives you can use.
   • From the tooltip, select the drive, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
2. File/Folder Id
   Enter the file/folder you want to copy.
   • Click on the empty field, and a tooltip will appear, displaying the files or folders you can choose.
   • From the tooltip, select the file/folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
3. Target location
   Select the location where the file/folder will be copied. You can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.
4. To Drive Id
   Select the Drive where the file/folder will be copied.
   • Click on the empty field, and a tooltip will appear, displaying the files or folders you can choose.
   • From the tooltip, select the file/folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
5. To Folder Id
   Enter the folder where the file/folder will be copied.
   • Click on the empty field, and a tooltip will appear, displaying the folders you can choose.
   • From the tooltip, select the file/folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).

Create Folder #

This activity creates a new folder in OneDrive.

1. Location
   Select the location of the new folder. You can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.
2. Folder name
   Enter the name of the new folder.
   • Click on the empty field, and a tooltip will appear, displaying the files or folders you can choose to copy their names.
   • From the tooltip, select the file/folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).

Create Share Link #

This activity creates a new shared link in OneDrive.

1. Location
   Select the location of the new share link. you can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.
2. Type
   Select the type of the new share link. you can choose between: “Edit”, “Embed”, or “View”.
   
   Edit – anyone with this link can edit this file/folder.
   Embed – URL that allows access to the file/folder stored in OneDrive, which can be incorporated into other platforms or documents.
   View – anyone with this link can view this file/folder.

Delete File/Folder #

This activity deletes files or folders from OneDrive.

1. Location
   Select the location of the file/folder you want to delete. You can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.
2. Group/Site Id
   Select the Group/Site where the file/folder you want to delete.
   • Click on the empty field, and a tooltip will appear, displaying the groups/sites you can use.
   • From the tooltip, select the group/site, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
3. Drive Id
   Select the Drive where the file/folder will be deleted.
   • Click on the empty field, and a tooltip will appear, displaying the drives you can choose.
   • From the tooltip, select the file/folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
4. File/Folder Id
   Select the file/folder you want to delete.
   • Click on the empty field, and a tooltip will appear, displaying the files or folders you can choose.
   • From the tooltip, select the file/folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).

Delete File/Folder Permission #

This activity deletes permission from the file/folder from OneDrive.

1. Location
   Select the location of the file/folder you want. You can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.
2. Group/Site Id
   Select the Group/Site where the file/folder you want.
   • Click on the empty field, and a tooltip will appear, displaying the groups/sites you can use.
   • From the tooltip, select the group/site, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
3. Drive Id
   Select the Drive where the file/folder.
   • Click on the empty field, and a tooltip will appear, displaying the drives you can choose.
   • From the tooltip, select the file/folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
4. File/Folder Id
   Select the file/folder you want.
   • Click on the empty field, and a tooltip will appear, displaying the files or folders you can choose.
   • From the tooltip, select the file/folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
5. Permission Id
   Select the permission you want to delete.
   • Click on the empty field, and a tooltip will appear, displaying the permissions of the files/folders you can choose.
   • From the tooltip, select the file/folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).

Download File #

This activity allows you to download a file from OneDrive.

1. Location
   Select the location of the file you want to download. You can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.
2. Group/Site Id
   Select the Group/Site where the file you want.
   • Click on the empty field, and a tooltip will appear, displaying the groups/sites you can use.
   • From the tooltip, select the group/site, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
3. Drive Id
   Select the Drive where is the file.
   • Click on the empty field, and a tooltip will appear, displaying the drives you can choose.
   • From the tooltip, select the file, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
4. File Id
   Select the file/folder you want.
   • Click on the empty field, and a tooltip will appear, displaying the files you can choose.
   • From the tooltip, select the file/, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
5. Add Fields
   Select if you want to add a certain field (not required).
6. Fields
   • Choose the field from the dropdown list.
   • Click on the empty field, and a tooltip will appear, displaying the permissions of the files/folders you can choose.
   • From the tooltip, select the file/folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).

Get Drives #

This activity allows you to get drives from OneDrive.

1. Select the location of the drives you want to get. You can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.

Get File/Folder Info #

This activity allows you to get information on files/folders from OneDrive.

1. Location
   Select the location of the file/folder you want. You can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.
2. Group/Site Id
   Select the Group/Site where the file/folder you want.
   • Click on the empty field, and a tooltip will appear, displaying the groups/sites you can use.
   • From the tooltip, select the group/site, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
3. Drive Id
   Select the Drive where the file/folder is.
   • Click on the empty field, and a tooltip will appear, displaying the drives you can choose.
   • From the tooltip, select the file/folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
4. File/Folder Id
   Select the file/folder you want.
   • Click on the empty field, and a tooltip will appear, displaying the files or folders you can choose.
   • From the tooltip, select the file/folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).

Get Files/Folders #

This activity allows you to get files/folders from OneDrive.

1. Files or Folders
   Select the type of content you want to get. You can choose between: “Files and Folders”, “Files only”, or “Folders only”.
2. OneDrive Location
   Select the location of the content you want to get. You can choose between: “Groups’ Drive”, “My Drive”, “Shared With Me”, or “Site’s Drive”.
3. Group/Site Id
   Enter the Group/Site Id you want the content from them.
   • Click on the empty field, and a tooltip will appear, displaying the groups/sites you can use.
   • From the tooltip, select the group/site, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
4. Drive Id
   Enter the Drive Id you want the content from them.
   • Click on the empty field, and a tooltip will appear, displaying the drives you can use.
   • From the tooltip, select the drive, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
5. Folder Id
   Enter the Folder Id you want the content from them.
   • Click on the empty field, and a tooltip will appear, displaying the folders you can use.
   • From the tooltip, select the folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
6. Query – Search by file or folder name (not required).

Get Permissions #

This activity allows you to get permissions of files/folders from OneDrive.

1. Location
   Select the location of the file/folder you want the permissions of. You can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.
2. Group/Site Id
   Select the Group/Site where the file/folder you want the permissions of.
   • Click on the empty field, and a tooltip will appear, displaying the groups/sites you can use.
   • From the tooltip, select the group/site, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
3. Drive Id
   Select the Drive where the file/folder the permissions of.
   • Click on the empty field, and a tooltip will appear, displaying the drives you can choose.
   • From the tooltip, select the file/folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
4. File/Folder Id
   Select the file/folder you want the permissions of.
   • Click on the empty field, and a tooltip will appear, displaying the files or folders you can choose.
   • From the tooltip, select the file/folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).

Get User Drive #

This activity allows you to get the user of OneDrive.

Initialize Recipients Array #

This activity allows you to initialize the recipients array.

1. Variable name
   • Click on the empty field, and a tooltip will appear, displaying the variable you can choose.
   • From the tooltip, select the variable, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).

Initialize Roles Array #

This activity allows you to initialize the roles array.

1. Variable name
   • Click on the empty field, and a tooltip will appear, displaying the variable you can choose.
   • From the tooltip, select the variable, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).

Move File/Folder #

This activity allows you to move files/folders in OneDrive.

1. Drive Id
   Enter the Drive from where you want to move the file or folder.
   • Click on the empty field, and a tooltip will appear, displaying the drives you can use.
   • From the tooltip, select the drive, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
2. File/Folder Id
   Enter the file/ folder Id you want to move the file or folder.
   • Click on the empty field, and a tooltip will appear, displaying the files or folders you can choose.
   • From the tooltip, select the file/folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
3. Target location
   Select from the dropdown list the location where the file/folder will be moved. You can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.
4. To Drive Id
   Select the Drive where the file/folder will be moved.
   • Click on the empty field, and a tooltip will appear, displaying the drives you can choose.
   • From the tooltip, select the file/folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
5. To Folder Id
   Enter the folder where the file/folder will be moved.
   • Click on the empty field, and a tooltip will appear, displaying the folders you can choose.
   • From the tooltip, select the file/folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).

Rename File/Folder #

This activity allows you to rename files/folders in OneDrive.

1. Files or Folders
   Select the type of content you want to get. You can choose between: “File” or “Folder”.
2. Location
   Select the location of the content you want to rename. You can choose between: “Groups’ Drive”, “My Drive”, “Shared With Me”, or “Site’s Drive”.
3. Group/Site Id
   Enter the Group/Site Id where the content you want to rename is.
   • Click on the empty field, and a tooltip will appear, displaying the groups/sites you can use.
   • From the tooltip, select the group/site, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
4. Drive Id
   Enter the Drive Id where the content you want to rename is.
   • Click on the empty field, and a tooltip will appear, displaying the drives you can use.
   • From the tooltip, select the drive, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
5. File/Folder Id
   Enter the File/Folder Id you want to rename.
   • Click on the empty field, and a tooltip will appear, displaying the folders you can use.
   • From the tooltip, select the folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
6. New name
   Enter the new name of the File/Folder.
   • Click on the empty field, and a tooltip will appear, displaying the files/folders you can use.
   • From the tooltip, select the folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).

Upload File #

This activity allows you to upload files/folders in OneDrive.

1. Location
   Select the location where you to upload the file. You can choose between: “Groups’ Drive”, “My Drive”, “Shared With Me”, or “Site’s Drive”.
2. Group/Site Id
   Enter the Group/Site Id where you want to upload the file.
   • Click on the empty field, and a tooltip will appear, displaying the groups/sites you can use.
   • From the tooltip, select the group/site, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
3. Drive Id
   Enter the Drive Id where you want to upload the file.
   • Click on the empty field, and a tooltip will appear, displaying the drives you can use.
   • From the tooltip, select the drive, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
4. Folder Id
   Enter the Folder where you want to upload the file.
   • Click on the empty field, and a tooltip will appear, displaying the folders you can use.
   • From the tooltip, select the folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
5. File name
   Enter the name of the File you want to upload.
   • Click on the empty field, and a tooltip will appear, displaying the files you can use.
   • From the tooltip, select the folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).
6. Content
   Enter the File you want to upload in base64 string.
   • Click on the empty field, and a tooltip will appear, displaying the folders you can use.
   • From the tooltip, select the folder, or you can use a static value.
     When using strings, be sure to close them in single quotes (‘).