快速入门

概述

以下是有关如何使用 Amazon Textract 活动的分步说明的链接。 这些指南可帮助您创建不同活动的工作示例，以便您可以验证与 AWS 资源的连接并熟悉输入/输出数据类型。

快速入门	描述
Analyze Single Page Document	完成本指南中的步骤后，您将获得一个自动化序列，该连接器将执行以下操作： 建立与 AWS 资源的连接 (Amazon 作用域)。 分析单个 JPEG 或 PNG 文件（分析单页文档）。 根据找到的数据类型 ( If ) 输出分析结果。 如果文件包含表单数据（ FormField[] ），则将PageDetail.FormFields.Items().Key和PageDetail.FormFields.Items().Value值写入输出窗口（ “遍历循环”和“写入行”）。 如果文件包含表格数据（ DataTable ），则PageDetail.Tables值将写入输出窗口（“输出数据表”和“写入行”）。
启动并获取分析	完成本指南中的步骤后，您将获得一个自动化序列，该连接器将执行以下操作： 建立与 AWS 资源的连接 (Amazon 作用域)。 启动 Amazon Textract 分析作业 (启动文档分析)。 检索并输出已启动的分析作业的状态（“后条件循环” 、 “获取 Document Analysis 状态” 、“写入行” 和“延迟”）。 如果分析作业（“ If ”、 “获取文档分析”、 “遍历循环”和“写入行”）成功，则检索并输出分析结果。

快速入门 - 分析单页文档

概述

本指南旨在帮助您创建使用 Amazon Textract 分析单页文档 活动的工作示例。

此工作示例使您能够快速验证与 AWS 资源的连接，并熟悉活动的输入/输出数据类型。

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

1. 建立与 AWS 资源的连接 (Amazon 作用域)。
2. 分析单个 JPEG 或 PNG 文件（分析单页文档）。

3. 根据找到的数据类型 ( If ) 输出分析结果。

   • 如果文件包含表单数据（ FormFields ），则将PageDetail.FormFields.Items().Name和PageDetail.FormFields.Items().Value值写入输出窗口（ “遍历循环”和“写入行”）。
   • 如果文件包含表格数据（ DataTable ），则PageDetail.Tables值将写入输出窗口（“输出数据表”和“写入行”）。
     
     

     

     
     

先决条件

在开始之前：

1. 完成 Amazon Textract 设置 步骤。
2. 将 JPEG 或 PNG 文件上传到 S3 存储桶或保存在本地，使其可用。

步骤

构建您的项目

1. 将 Amazon 作用域 活动添加到您的项目中。

2. 输入要用于 Amazon Textract 活动的 IAM 用户的 ID、密码和 区域 。

   • 有关更多信息，请参阅设置指南中的 “ 创建 IAM 用户 ”部分。
3. 在“ Amazon 作用域”活动中添加“ 分析单页文档 ”活动。
4. 输入要分析的 JPEG 或 PNG 文件的 文档 路径或 存储桶 和 文档 名称。
5. 为“ 页面” 值创建并输入 PageDetail 变量（例如， pageDetail）。
   • 创建变量时，选择 UiPath.Amazon.Textract.Client.Models.PageDetail 作为变量类型。
6. 在“ 分析单页文档” 活动之后添加“IF 条件 ”活动。
7. 在 条件 属性中，输入您在上述步骤中创建的 PageDetail 变量 和 .HasFormData.ToString.Equals("True") 以确定文件是否包含 FormField 对象（例如， pageDetail.HasFormData.ToString.Equals("True")） "True") )

8. 在“ Then语句”框中，添加“遍历循环”活动。

   1. 在“类型参数”属性中，选择“ _UiPath.Amazon.Textract.Client.Models.FormFields ”
   2. 在 值 属性中，输入您为获取消息活动创建的变量的 FormFields.Items 属性（例如， pageDetail.FormFields.Items）。

   3. 在“遍历循环”活动中，添加“写入行”活动。

      1. 在“ 文本 ” 属性中，输入 item.Name+" | "+item.Value+" | "+item.confidence ，以输出表单数据的 KeyValuePair 值。
   4. 在“ Else 语句”框中，添加“ 写入行 ”活动。
   5. 在“ 文本 ”属性中，输入 “未找到表单数据”。
9. 在第一个“ IF 条件”活动之后添加另一个“IF 条件 ”活动。
10. 在 条件 属性中，输入您在上述步骤中创建的 PageDetail 变量 和 .HasTableData.ToString.Equals("True") 以确定文件是否包含 DataTable 对象（例如， pageDetail.HasTableData.ToString.Equals( "True"))

11. 在“ Then语句”框中，添加“输出数据表”活动。

    1. 在“ 数据表 ”属性中，输入您为“ 分析单页文档” 活动创建的 PageDetail 变量，并 输入 .Tables(0) 以指定文件中的“数据表”对象（例如， pageDetail.Tables(0)）
    2. 对于“ 文本 ”属性，为 DataTable 内容创建并输入 String 变量（例如 数据表）。

    3. 在“ 输出数据表 ”活动之后添加“写入行”活动。

       1. 在 文本 属性中，输入您在上述步骤中创建的 String 变量，以输出 DataTable 内容。
    4. 在“ Else 语句”框中，添加“ 写入行 ”活动。
    5. 在“ 文本 ”属性中，输入 “未找到表格数据”。

12. 单击 “运行” 并验证“ 输出 ”窗口是否包含预期的表单数据和表格数据。

    
    

    

    
    
    
    

    

    
    

操作完毕！

准备就绪后，请尝试其他 快速入门 指南，以更熟悉不同的 Amazon Textract 活动。

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

快速入门 - 启动并获取分析

概述

本指南旨在帮助您创建一个使用 Amazon Textract 启动文档分析、 获取文档分析状态和 获取文档分析 活动的工作示例。

此工作示例使您能够快速验证与 AWS 资源的连接，并熟悉活动的输入/输出数据类型。

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

1. 建立与 AWS 资源的连接 (Amazon 作用域)。
2. 启动 Amazon Textract 分析作业 (启动文档分析)。
3. 检索并输出已启动的分析作业的状态（“后条件循环” 、 “获取 Document Analysis 状态” 、“写入行” 和“延迟”）。

4. 如果分析作业（“ If ”、 “获取文档分析”、 “遍历循环”、 “遍历循环”和“写入行”）成功，则检索并输出分析结果。

   
   

   

   
   

先决条件

在开始之前：

1. 完成 Amazon Textract 设置 步骤。
2. 将 JPEG 或 PNG 文件上传到 S3 存储桶或保存在本地，使其可用。

步骤

构建您的项目

1. 将 Amazon 作用域 活动添加到您的项目中。

2. 输入要用于 Amazon Textract 活动的 IAM 用户的 ID、密码和 区域 。

   • 有关更多信息，请参阅设置指南中的 “ 创建 IAM 用户 ”部分。
3. 在Amazon 作用域活动中添加 启动文档分析 活动。
4. 输入要分析的 JPEG 或 PNG 文件的 存储桶 和 文档 名称。
5. 为 作业 ID 值创建并输入 String 变量（例如， jobId）。
6. 在“ 启动文档分析 ”活动之后添加 “ 后条件循环”活动。
7. 在“后 条件循环” 活动中，添加“ 获取文档分析状态” 活动。
8. 在“ 作业 ID ” 属性中，输入您 为上述作业 ID 创建的 String 变量（例如， jobId ）。
9. 为 JobStatus 值创建并输入 String 变量（例如， jobStatus）。

10. 在“后条件循环”活动的 “ 条件” 属性中，输入“作业状态”变量和条件值（例如， jobStatus = "IN_PROGRESS"）

    • 有关可能的作业状态值的列表，请参阅获取文档分析状态详细信息页面的 作业 状态属性部分。
11. 在“ 获取 Document Analysis 状态” 活动之后添加“ 写入行 ”活动。
12. 在 文本 属性中，输入您在上面为 作业状态值创建的 String 变量（例如， jobStatus ）。
13. 在“ 写入行 ”活动之后添加“ 延迟 ”活动。

14. 在“ 持续时间 ”属性中，输入处理文档所需的预计时间。 在我们的示例中，我们输入 00:00:20 以演示 作业状态 输出值的更改（对于非演示场景，我们为单个表单文档输入 00:00:55 ）。

    注意： 在上述场景中，您的机器人每 20 秒检索并输出一次分析作业的状态，此时状态为 IN_PROGRESS。 此条件使机器人能够检索并输出状态，直到状态发生更改。
15. 在“后条件循环”活动之后添加“IF 条件”活动。
16. 在“ 条件” 属性中，输入“作业状态”变量以及条件值（例如， jobStatus = "SUCCEEDED" 或 jobStatus="PARTIAL_SUCCESS"）

17. 在“ Then 语句”框中，添加“ 获取文档分析” 活动。

    1. 在 作业 ID 属性中，输入您在 启动文档分析 活动中为作业ID属性创建的 String 变量。 （例如， jobId）。
    2. 创建并输入 PageDetail[] 变量作为“ 页面 ”值（例如， pageDetails）。
    • 创建变量时，选择 UiPath.Amazon.Textract.Client.Models.PageDetail[] 作为变量类型。
18. 在下面的示例中，我们将仅评估“ 页面 ”属性的 PageDetail[] 数组中的第一个文档。
    1. 创建并输入PageDetail 变量，以存储数组中的第一个项目，并在“ 获取 Document Analysis ”活动之后使用“ 赋值 ”活动（例如， “ 页面详细信息” ）。
    2. 将 PageDetail(0) 作为值分配给您刚才创建的变量 (pageDetail)

19. 在“ 分配 ” 活动之后添加“ 遍历 循环” 活动。

    1. 在“类型参数”属性中，选择 “UiPath.Amazon.Textract.Client.Models.FormFields”
    2. 在 值 属性中，输入您为 分配 活动创建的变量的 FormFields.Items 属性（例如， pageDetail.FormFields.Items）。

    3. 在“遍历循环”活动中，添加“写入行”活动。

       1. 在“ 文本 ”属性中，输入 item.Name+" | "+item.Value+" | "+item.confidence ，以输出表单值。
    4. 在“ Else 语句”框中，添加“ 写入行 ”活动。
    5. 在“ 文本 ” 属性中，输入失败作业的消息（例如，_“作业失败，请重试。”）

20. 运行序列并验证“ 输出 ”窗口是否包含作业状态和预期的表单数据值。

    
    

    

    
    
    
    

    

    
    

操作完毕！

准备就绪后，请尝试其他 快速入门 指南，以更熟悉不同的 Amazon Textract 活动。

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