移动文件/文件夹

UiPath.MicrosoftOffice365.Activities.Files.MoveItem

描述

使用 Microsoft Graph 移动项目 API 将指定的文件或文件夹移动到新的父文件夹（目标文件夹），并可以选择更改其名称。

将项目移动到目标文件夹后，该活动将返回一个 DriveItem 对象（引用为），您可以在后续活动中将其用作输入变量。

作用域

此活动需要以下作用域：

• Sites.ReadWrite.All

项目兼容性

Windows - Legacy | Windows

配置

在活动正文中

• 要移动 的文件或文件夹 - 要作为 DriveItem移动的文件或文件夹。 可以使用“ 查找文件和文件夹” 活动检索此对象。 使用“ 查找文件和文件夹” （“名字 ”或“ 结果”）中的输出属性变量。 如果您使用的是 查找文件和文件夹 活动的结果输出属性，请在数组中指定要使用的项目（例如， myWorkbooks(0)）。
• 目标文件夹 - 此项目作为 DriveItem移动到的目录。 如果留空，则使用根文件夹。 可以使用“ 查找文件和文件夹” 活动检索此对象。 使用“ 查找文件和文件夹” （“名字 ”或“ 结果”）中的输出属性变量。 如果您使用的是 查找文件和文件夹 活动的结果输出属性，请在数组中指定要使用的项目（例如， myFolders(0)）。

• 新名称（可选） - 此项目移动后的名称。 如果移动文件，请包括要移动的项目的文件类型扩展名（例如， “MoveItem.docx”）。

  注意： 您可以使用“ 获取文件/文件夹 ”活动保存文件或文件夹，以供以后在自动化中使用。

属性面板

常见

• “显示名称”- 设计器面板中活动的名称。此属性支持 String 变量和字符串格式的值。

输入

• 请在活动正文中查看选项。

选项

• “帐户”- 拥有 OneDrive 的用户的 ID 或用户主体名称。必须为“应用程序 ID 和密码”和“应用程序 ID 和证书”身份验证类型设置此参数。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。该字段仅支持“布尔值”。

输出

• “引用为” - 在其他活动中用于引用移动的文件或文件夹的名称。 单击 “加号” ，然后选择“ 保存以备后用 ” 以保存该文件夹以供以后在自动化中使用。 或者，选择 “使用保存的值 ”以选择先前保存以备后用在项目中的文件或文件夹，或选择 “在高级编辑器中打开” 以输入 VB 表达式。

工作方式

以下步骤和消息序列图是活动从设计时（即活动依赖项和输入/输出属性）到运行时如何工作的示例。

1. 完成步骤。
2. 将“ Microsoft Office 365 作用域 ”活动添加到您的项目中。
3. 添加活动或运行输出 DriveItem 对象的外部流程（例如，查找文件和文件夹、创建 workbook、复制文件/文件夹）。
4. 在 Microsoft Office 365 作用域活动中添加移动文件/文件夹活动。
5. 输入“输入”属性的值。
6. 为“输出”属性创建并输入 DriveItem 变量。

7. 运行活动。

   • 您的输入属性值将发送到移动驱动器项目 API。
   • API 会将 DriveItem 值返回到您的输出属性变量。
     
     

     

     
     

此活动可以调用不同的 API，如下所示：

• 如果要移动的文件的 driveId 等于目标文件夹的 driveId，则使用移动项目 API。
• 如果要移动的文件的 driveId 不等于目标文件夹的 driveId ，请使用复制项目 API 和删除项目 API（原始文件将被删除，并替换为目标文件夹中的副本）。