data-service
latest
false
  • 入门指南
    • 简介
    • 用户界面
    • 区域和实例
  • 许可
  • 设置和配置
  • 使用 Data Service
  • 参考
    • Data Service Studio 活动
    • API 访问权限
  • 示例和教程
    • 在项目中使用实体
    • 在实体记录中上传文件字段
    • 在实体记录中下载文件字段
    • 使用批处理活动从 CSV 上传数据
重要 :
请注意此内容已使用机器翻译进行了部分本地化。
UiPath logo, featuring letters U and I in white
Data Service 用户指南
Automation CloudAutomation Cloud Public SectorAutomation Suite
Last updated 2024年5月9日

在项目中使用实体

通过使用在 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 中传递数据和更新记录。

此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo White
信任与安全
© 2005-2024 UiPath。保留所有权利。