Data Service
2023.10
False
    • 简介
    • 用户界面
    • Data Service 配置清单
    • 安装 Automation Suite
    • Data Service Studio 活动
    • API 访问权限
    • 在项目中使用实体
    • 在实体记录中上传文件字段
    • 在实体记录中下载文件字段
    • 使用批处理活动从 CSV 上传数据
Using Entities in Projects - Automation Suite 2023.10
横幅背景图像
徽标
Data Service 用户指南
上次更新日期 2023年11月3日

在项目中使用实体

通过使用在 Data Service 中创建的实体,您可以管理和操作聚集在单个对象中的数据,而无需以细粒度的方式使用。为此,您需要 Studio v2020.8 或更高版本。

以下示例检索奥运会各个项目所获奖牌数前 10 名的国家/地区的相关数据,以及它们获得的奖牌。

Data Service 中的实体

按照 创建实体 页面中详述的步骤,我们创建了一个实体,用于存储有关参与国家/地区、开幕日期和闭幕日期及其所获奖牌的信息。

“奥运会”实体具有以下字段:“名称”、“国家/地区”、“开幕日期”和“闭幕日期”。“奖牌”实体具有以下字段:“国家/地区”、“金牌”、“银牌”、“铜牌”以及奖牌总数。这两个实体通过“关系”标签相互关联。



在 Studio 中导入的实体

在 Studio 的工作流中导入实体。

以下工作流将抓取有关某届奥运会的信息,将数据映射到参数,并将其传递到主工作流。



为此,我们为要收集的每种信息类型定义了一个参数,从而生成了 5 个导入的参数。



通过使用实体,我们只需导入并使用两个参数即可收集数据。

注意:在使用实体之前,必须使用New 运算符初始化实体,从 Data Service 读取实体或通过输入参数在工作流中传递实体,否则分配或读取实体的值可能会导致错误。


收集的数据映射到两个参数(inOlympics YearoutOlympics)、其各自的属性和实体中定义的字段。通过使用实体,我们通过将数据正确映射到其各自的实体字段,减少了传递信息所需的参数个数。

创建数据记录

收集数据后,您可以使用“创建实体记录”活动将信息添加到 Data Service 中。

在本示例中,我们使用导入的参数将收集的信息传递到 Data Service。“输入”记录和“输出”记录是用于传递数据的“Olympics”类型变量的值。



运行项目后,在 Data Service 中创建了以下记录:



创建包含结构化数据的记录

可以使用“遍历行”活动将数据表中的结构化记录传递到 Data Service。在本示例中,我们调用一个工作流,该工作流收集有关每个国家/地区所获奖牌数的结构化数据,并将这些记录传递到 Data Service。



运行工作流后,以下数据将存储在 Data Service 中:



通过在“奥运会”实体和“奖牌”实体之间设置关系,两者中的数据记录都可以在另一个实体中使用。例如,“奖牌”实体中的“奥运会”字段的值与相关实体中的值相同。

与查询相关的记录

“查询实体记录”活动可用于从 Data Service 拉取记录列表。在以下示例中,我们使用该活动来查询“奥运会”实体中的数据记录,允许用户选择奥运会届别,然后在“奖牌”实体中写入每个参与国家/地区所获奖牌数。



在查询“奥运会”表格时,我们在查询生成器中使用了 Name != NULL 条件。这将遍历“名称”列中的所有记录,并在 listOlympics 变量中输出这些记录,以在“输入对话框”活动中使用。
为了将记录列表显示为选项,我们在“ 输入对话框 活动中使用了以下 Lambda 表达式 。listOlympics.Select(Function (o as Olympics) o.Name).ToArray或者,也可以使用“遍历循环” 活动。
系统会将所选内容映射到 selectedOlympics 变量,并在另一个“查询实体记录”活动中使用所选内容来遍历在特定一届奥运会上所获奖牌的列表。此条件是通过在查询生成器中使用 equals 选项设置的。


可对选定实体和相关的实体记录执行查询。

分页

Data Service 可能会存储大量记录。要仅查询一定数量的记录,请使用“查询实体记录”活动中的“分页”属性。“前”属性支持的最大数目为 1,000,这意味着一次可以查询 1,000 个记录。

本示例先查询前五个记录,然后再查询接下来的五个记录,直到抓取列表中的最后一个记录为止。



为此,我们为 skip Int64 变量分配了初始值 0,然后在每个循环后将其值递增,直到抓取最后一个记录为止。


抓取前五枚奖牌后,使用“遍历循环”活动将参与国家/地区及其所获奖牌数写入到记事本文件。

更新实体记录

以下场景说明了更新 Data Service 中的实体记录,然后与 Studio 同步数据的步骤。

在 Data Service 中,转到“奖牌”实体,单击“新建字段”,然后添加类型为“是/否”的新列“主办国家”。单击“保存”。



在 Studio 中,单击“管理实体”,然后单击“刷新”按钮。如“更改”列中所示,检测到“奖牌”实体发生更改。单击“保存”,实体将在 Studio 中更新。



查询和更新记录

“更新实体记录”活动可用于将记录从工作流直接更新到 Data Service 中。

在本示例中,我们将从“奖牌”实体查询某些记录,并使用上述活动自动更新这些记录。

“奖牌”实体中,每届奥运会的主办国家名称旁边标有星号。例如,对于 2012 奥运会,主办国家在“奥运会”列中记录为“英国 (GBR)*”。



通过使用“查询实体记录”活动,遍历所有包含星号 (*) 的记录,在 listMedals 变量中抓取记录,使用“遍历循环”活动遍历循环每个项目,并在“主办国家”列中在主办特定一届奥运会的国家旁边分配“True”值。

“更新实体记录”活动可以在许多其他场景中用于传递数据和更新 Data Service 中的记录。

支持和服务图标
获取您需要的帮助
UiPath Academy 图标
了解 RPA - 自动化课程
UiPath 论坛图标
UiPath Community 论坛
Uipath 白色徽标
信任与安全
© 2005-2024 UiPath. All rights reserved.