使用通用脚本数据源

简介

UiPath Process Mining 包含的功能支持使用可在应用程序中用作数据源的外部工具（例如 R 脚本、Python、JavaScript、Ruby、Swift 等）处理数据。

作为应用程序开发者，您可以定义需要将哪些属性导出到外部流程。

注意：只有显式可用于外部处理的属性才能在外部流程中使用。

使用外部工具处理数据

概述

重新加载数据源时， UiPath Process Mining 平台会将定义的属性输出到文件中。然后，平台使用开发者提供的参数执行外部流程。

外部流程应通过从文件中读取数据并将结果写入标准输出通道来进行处理。外部流程可以通过写入其标准错误通道来显示进度指示、警告和/或错误等消息。

UiPath Process Mining 平台会将外部流程标准输出通道上的数据解释为用分号分隔并用双引号引起来的数据。

有关从 UiPath Process Mining 平台到外部流程并再返回的数据流的概述，请参见下图。

通用脚本数据源

数据源使用mvscript驱动程序，这意味着它是脚本数据源。 mvscript驱动程序使用的script参数引用通用脚本。例如，连接字符串：

‘driver={mvscript}; script=Rscript’

指的是 Rscript 数据源。

在本指南中，我们将这些数据源称为通用脚本数据源。原则上，“通用”脚本不仅支持脚本，还支持任何可执行文件，只要给定正确的参数组合：

可以从文件中读取数据，并且
将其结果输出为以分号分隔并用双引号引起来的数据。

但是，通用脚本数据源的主要目标是运行用 R、Python 等语言编写的自定义脚本。

服务器设置

在使用通用脚本数据源之前，您必须在“ 服务器设置”中配置可用的处理程序。为此，请将密钥GenericScriptHandlers添加到“ 服务器设置”。此键的值是一个对象，其中：

每个键表示脚本类型的标识符，
每个键的值表示脚本的解释器可执行文件的路径。

标识符可以是任何字符串。但是，建议使用脚本文件的扩展名，因为 UiPath Process Mining 平台将尝试从脚本文件的扩展名中自动检测正确的处理程序。以下是GenericScriptHandlers服务器设置的示例。

"GenericScriptHandlers": {
    "r": "D:/R/R.exe",
    "py": "P:/Python/bin/python.exe",
    "perl": "C:/Strawberry/perl/bin/perl.exe"
}"GenericScriptHandlers": {
    "r": "D:/R/R.exe",
    "py": "P:/Python/bin/python.exe",
    "perl": "C:/Strawberry/perl/bin/perl.exe"
}

扩展名为“.r”和“.py”的键将自动选择 R 和 Python 可执行文件。

注意：对于通常具有扩展名“.pl”的 Perl 脚本，自动检测不会选择“perl”处理程序。在这种情况下，可以指定高级查询参数scriptType来标识所需的处理程序。

权限

运行 Microsoft 的 Windows 用户（即 IIS_IUSRS ) 必须具有执行从脚本处理程序引用的可执行文件的正确权限。否则，将无法找到可执行文件。

数据源

要配置通用脚本数据源，您必须创建一个连接字符串表，该表将mvscript驱动程序与generic脚本一起使用。通用脚本具有多个参数，通常只需指定scriptFile和inputData参数，其余参数可由 UiPath Process Mining 平台推断。

参数概述

下表概述了generic脚本参数。

参数	描述	必填是/否
scriptFile	脚本的路径。例如`resources/my_script.r` 。注意：您也可以使用`scriptText`参数来代替`scriptFile` 。	N
脚本类型	用于`scriptFile`的处理程序。应该是`GenericScriptHandlers`中的处理程序之一。	N
输入数据	应传递给脚本进行处理的数据。	Y
debugPath	文件夹的绝对路径。如果指定了此参数，则 UiPath Process Mining 将输出： • 输入文件（提供给外部流程），以及 • 外部流程的输出（从外部流程的标准输出中读取）用于调试目的。	N
参数	要传递给脚本处理程序的附加参数数组，例如，在使用 Python 时，可用于传递 -I 标志以启用隔离模式。 • 至少有一个数组元素应为文本 `<SCRIPT>`，以指示应在命令行中的何处插入脚本文件的路径。 • 数组元素中至少有一个元素应为文本`<INPUT>` ，以指示应在命令行中的何处插入输入文件的路径。	N

Table Scope

脚本的位置被解释为相对于表格作用域。因此，必须将表作用域设置为“ 服务器 ”或“ 工作区”。当设置为“ 无”时，脚本文件的路径不存在，数据加载将失败。您可以在“ 高级表格选项” 中设置表格作用域。

数据

可以以对接收外部流程最方便的任何方式导出数据。

请按照以下步骤导出要在外部脚本中处理的数据。

步骤	操作
1	确定脚本中需要可用的字段。
2	在应用程序中创建一个新的全局表。
3	在全局表中为步骤 1 的每个字段创建一个查找表达式属性。

注意：然后可以导出此表格，以便脚本可以读取它。 csvtable()函数可用于将数据转换为类似 CSV 的格式。由于此函数需要（文本）记录列表，因此查找表达式的结果类型必须是文本列表，即一个记录的所有数据都编码在列表中。

API 接口

UiPath Process Mining 与通过通用脚本数据源访问的任何外部流程之间的接口定义如下。

步骤	描述
1	UiPath Process Mining 将创建一个文件，其中包含`inputData`参数指定的数据。
2	外部流程： • 从文件中读取数据； • 执行其处理； • 以分号分隔并用双引号引起来的格式将结果写入其标准输出通道。输出的第一行应该是指定列名称的标头。例如： `"Case_ID"; "Amount"` `"110553"; "73650"` `"110565"; "14420"` `"110689"; "262370"` `"110754"; "3500"` `"110939"; "50270"` `"111155"; "2400"` `"111251"; "27530"` `"111251"; "27530"` `"111397"; "123450"` `"111418"; "100"`
3	外部流程会将任何状态消息写入其标准错误通道。
4	外部流程退出时，状态代码为零（表示成功）或非零状态代码（表示失败）。
5	UiPath Process Mining 评估外部流程返回的状态代码如果状态代码为： • 零，平台会将外部流程的标准输出通道解析为用分号分隔并用双引号引起来的数据。 • 非零值，平台将显示错误消息，包括由外部流程写入标准错误通道的任何消息。表格加载已中止。