Activities
latest
false
Productivity Activities
Last updated Jul 9, 2024

Move File or Folder

UiPath.MicrosoftOffice365.Activities.Files.MoveItemConnections

Description

Moves a file or folder to the specified destination folder in OneDrive or SharePoint.

How it works

This activity can call different APIs, as follows:

  • If the driveId of the file to move equals the driveId of the Destination folder, the Move item API is used
  • If the driveId of the file to move does not equal the driveId of the Destination folder, the Copy item and Delete item are used (the original file is deleted and replaced by its copy in the destination folder).
Scopes

This activity requires the following scopes:

  • 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 move - The specific file or folder to move. 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.

  • Destination folder - The folder where to move the specified file or folder. If no folder is selected, the default option is the OneDrive root folder. 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 or select the Reload Folder Picker option if you've modified your folders and need to retrieve the latest data.

  • New name - An optional new name for the moved file or folder. If left blank, the file or folder keeps its original name. This property supports String variables and string formatted values.
  • If file/folder already exists - The expected behavior when a file/folder with the same name already exists in the destination folder. Choose one of the available options from the dropdown menu:
    • Don't replace - Fails if an existing item is found. Default option.
    • Auto rename - Auto renames the new item by appending a number.
    • Replace - Replaces the existing item.
Additional options

Output

  • File or folder - The moved file or folder retrieved by the activity. 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:
  • Description
  • Project compatibility
  • Configuration
  • Example

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.