快速入门：使用行

概述

本指南旨在引导您完成几个示例，说明如何在 Smartsheet 中使用工作表上的行。 我们将使用以下活动：

• 列出行
• 获取行
• 获取附件
• 更新行

此工作示例使您能够获取行列表，然后遍历该行列表，首先获取该行的所有附件，然后更新该行中的值。

完成本指南中的步骤后，您将获得一个自动化序列，该连接器将执行以下操作：

1. 建立与 Smartsheet 实例的连接（Smartsheet 作用域）。
2. 获取工作表中的行列表 (列出行)。
3. 对于检索到的每一行，请执行以下操作：
4. 获取该行的附件 (列出行)。
5. 下载该行中的任何附件 获取附件。
6. 更新该行的值 “ 更新行”。

对于上面的第 4 项，我们可以选择创建一个 Row[] 对象并进行一次 Update 调用，但出于本演示的目的，将为我们要更新的每个 Row 调用一次。

以下是示例工作表的屏幕截图。

要获取工作表 ID，请转到“文件”->“属性”，然后查看工作表 ID。 它应该类似于 5903706102228868。

先决条件

在开始之前：

1. 完成 Smartsheet 设置 步骤。
2. 要将附件下载到的本地文件夹路径。

步骤

构建项目

1. 为您的 API 令牌 值创建并输入 String 变量（例如 apiToken）。
2. 添加 Smartsheet 作用域。
3. 对于身份验证类型，选择 API 令牌。
4. 输入您的 apiToken 变量作为 API 访问令牌 值的值。

创建并设置将在多个活动中使用的变量

1. 为工作 表ID 值创建并输入 Int64 变量（例如sheetId ）。
2. 创建并输入“ String ”变量作为“ 下载路径 ”值（例如，“ 下载路径”）。

获取要获取附件并进行更新的行列表，并为每个循环设置一个循环。

1. 添加“ 列出行 ”活动。
2. 单击“ 列出行 ”活动中的“配置”按钮。
3. 对于“工作 表 ID” 字段，在“值” 列 中输入您的工作表 ID。
4. 对于字段 Rows，创建一个 Row[] 变量（例如， rowsRetrieved）。
5. 单击“完成”按钮。
6. 在“列出行”活动之后添加“遍历循环”活动。
7. 对于“ 值 ” 属性，输入 rowsRetrieved 变量。
8. 对于“ 类型参数 ”属性，请使用 Smartsheet.Api.Models.Row。
9. 在“遍历循环”活动的主体中，添加“ 列出行” 活动。
10. 对于 工作表 ID， 输入 工作表 ID 变量。
11. 对于“行 ID”，输入“ item.Id.value ”。
12. 对于“ 包含 ”，选择“附件”作为选项。
13. 对于 Row，创建并输入 Row 变量（例如， rowRetrieved）
    
    

    

    
    
    
    

    

    
    

设置 If 条件检查

1. 在“ 获取行 ”活动之后添加“ If *”活动。
2. 对于“ 条件 ”，使用值“RowRetrieved.Attachments is Nothing”。
3. 在“ If 条件”活动的“其他”部分中，添加“ 遍历 循环”活动
4. 在“ 遍历循环 ”活动中，设置以下属性：
5. 对于 Values，将其设置为 rowRetrieved.Attachments（假设您使用 rowRetrieved 作为上述每 7 天的输出变量）。
6. 对于“类型参数”，将其设置为“ Smartsheet.Api.Model.Attachment ”
7. 将 ForEach 变量从 item 重命名为 attachment。

对于包含附件的每一行，下载附件并更新该行的值

1. 添加 “获取附件” 活动。
2. 对于“ 工作表 ID”，输入 工作表 ID 变量。
3. 对于 AttachmentId，输入“attachment.Id.Value”
4. 对于 下载文件夹路径，输入您的 下载 路径变量。
5. 在“ 获取附件 ”活动之后添加“分配”活动
6. 对于 To，创建一个 Row 变量（例如， rowUpdate）。
7. 对于“ 值”，创建一个新的 Row 对象，并使用类似于以下模式的代码进行设置。

   New Row() With { 
   .Id = RowRetrieved.Id,
   .Cells = New List(Of Cell) From {
       New Cell() With {.Value = '100', .ColumnId = RowRetrieved.Cells(3).ColumnId}
       }
   }

   
   

   

   
   
8. 在“ 分配 ”活动之后添加“更新行”活动。
9. 单击“ 配置 ”按钮。
10. 对于“工作 表 ID” 字段，使用 sheetId 变量。
11. 对于“ 行 ” 字段，单击“ 行 ” 链接按钮。
12. 单击“ 添加 ”按钮
13. 输入您之前创建的 rowUpdate 变量。
14. 单击“ 完成” 按钮

操作完毕！

要了解有关 Smartsheet 活动（包括示例属性输入/输出）的更多信息，请参阅“ 活动 ”页面以获取完整的活动列表以及指向活动详细信息页面的链接。

您可以通过以下链接下载此机器人的副本：

https://discourse-cloud-file-uploads.s3.dualstack.us-west-2.amazonaws.com/uipath/original/3X/2/8/28b17aad52194518cf0c4977635e8e381a68636d.zip