获取单元格颜色

UiPath.MicrosoftOffice365.Activities.Excel.GetCellColor

描述

使用 Microsoft Graph 获取范围格式 API 检索工作簿 (Workbook) 工作表 (SheetName) 中指定单元格 ( CellAddress ) 的颜色属性。 检索颜色属性后，该活动将单元格颜色 (Color) 作为十六进制值 (例如 # FFFFFF) 返回。

作用域

此活动需要以下作用域：

• 文件。读取

或

• Files.ReadWrite

或

• 文件读取全部

或

• Files.ReadWrite.All

或

• 站点。只读。全部

或

• Sites.ReadWrite.All

项目兼容性

Windows - Legacy | Windows

配置

属性

常见

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

输入

• “单元格地址 ” - 单元格的地址。 以 A1 样式表示法输入单个单元格的地址。 此属性不支持单元格区域（例如， “A1:A5”）。 此属性支持 String 变量和字符串格式的值。
• “工作表名称”- 从中读取数据的工作表的名称。此属性支持 String 变量和字符串格式的值。
• 工作簿 - 读取其数据的 DriveItem 。 可以使用“ 查找文件和文件夹” 活动检索此对象。 使用 “ 查找文件和文件夹” （ “第一个 ”或 “ 结果”）或 “ 创建 Workbook （Workbook”）活动中的输出属性变量。 使用“ 查找文件和文件夹” 活动的“结果”输出属性时，请务必在数组中指定要使用的项目（例如， myWorkbooks(0)）。

其他

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

输出

• “颜色 ” - 给定单元格的颜色，采用 HEX 格式。 如果您计划在后续活动中使用输出数据，则为必需。

工作方式

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

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

7. 运行活动。

   • 您的输入属性值将发送到 GetRangeFormat API。
   • API 会将 String 值返回到您的输出属性变量。