设置自动化数据刷新

简介

如果要为 UiPath Process Mining 执行频繁或间歇性数据加载，可以设置自动数据刷新。 本指南介绍如何使用批处理脚本设置自动数据刷新。

运行脚本时，首先使用您指定的数据集名称生成数据集的文件夹结构。 然后，将为指定模块重新加载并缓存连接器中的所有表。 这些缓存的表用于从连接器导出输出表。 输出数据集用于为指定环境中的应用程序生成缓存。

先决条件

您需要有权访问包含 UiPath Process Mining 安装的服务器或虚拟机。

您还需要在工作区中具有连接器。

注意： 该脚本将模拟您的工作区。 您应该为连接器创建一个工作区，并确保该工作区保持最新状态。 数据刷新将按原样使用指定的工作区，并使用所有未提交的更改（如果有）。 因此，建议使用专门的工作区来刷新数据。

重要提示：

此批处理脚本要求工作区的内部版本和超级管理员相同。 如果您更新超级管理员的内部版本而不更改工作区的内部版本（反之亦然），则脚本将失败，从而不会刷新数据。

因此，建议同时在所有位置（超级管理员、连接器和其他应用程序）更新内部版本。

第 1 步：准备

从下面的代码示例中创建要用于自动刷新数据的批处理脚本，并将其保存在 UiPath Process Mining 安装的根文件夹中。

注意： 建议在批处理文件名中包含流程名称和系统名称。

set MAINDIR=%~dp0
set DATASET=FullData
set ENVIRONMENT=production
set WORKSPACE=Peter/Connector
mkdir "%MAINDIR%\datax\_datasets\%DATASET%"
mkdir "%MAINDIR%\datax\_datasets\%DATASET%\_org"
echo. > "%MAINDIR%\datax\_datasets\%DATASET%\nomodcodes.marker"
for %%M in (..) do (
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -CCDB app="%%M" o= refreshmvncaches=true
              mkdir "%MAINDIR%\datax\_datasets\%DATASET%\_org\MVNCache" 
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -export app="%%M" out="%MAINDIR%\datax\_datasets\%DATASET%\_org\MVNCache" o= refreshmvncaches=false reusecache=true onlymarked=true
)
call "%MAINDIR%\builds\processgold.bat" -dataserver -skipmail -env "%ENVIRONMENT%" -CCDB o=* dataset="%DATASET%" p=*

步骤 2：在脚本中设置参数

以下是您需要在脚本中指定的参数的说明。

参数	描述
数据集	要从脚本生成的输出数据集的名称。 此数据集将显示在“ 超级管理员开发数据 ”选项卡中。
环境	要为其生成缓存的环境。 注意： 通常，这将是您的流程的 AppOne 处于活动状态的环境。
工作区	连接器所在工作区的路径。 这是您的 登录名 ，后跟 工作区名称。 如果脚本找不到正确的工作区，请尝试使用正斜杠代替反斜杠。

WorkSpace 名称

请按照以下步骤确定工作区的路径。

步骤	操作
1	转到 UiPath Process Mining 安装文件夹。
2	转到“ 工作区”文件夹。
3	转到 [您的登录名] 文件夹。 该文件夹包含每个工作区的文件夹。

重要提示：

当您的 登录名 包含特殊字符时，系统会将用户名文件夹编码为 HTML。 但是，要在脚本中使用，需要使用三个额外的 %s 对 % 进行转义。

例如：如果您的用户名是[e-mail] ，则此文件夹将变为test%2Eexample%40uipath%2Ecom文件夹。 在脚本中，用户名应指定为test%%%%2Eexample%%%%40uipath%%%%2Ecom 。 如果用户名包含下划线 (“_”)，则需要使用%%%%5F对该下划线进行转义。

步骤 3：添加连接器模块代码

某些连接器具有多个模块，因此您需要为要实现自动数据刷新的连接器指定模块代码。

在for %M in (…) do循环中添加连接器的模块代码。

请按照以下步骤查找模块代码并将其添加到脚本中。

步骤	操作
1	在开发环境中打开连接器。
2	单击徽标图标，然后选择“ 模块...”。
3	复制“ 应用程序代码” 字段中的模块代码。
4	单击“ 取消 ”以关闭“模块”对话框。
5	关闭连接器。
6	在脚本中，将 () 中的“...”替换为for %M in (…) do循环中连接器的模块代码。

步骤 4：计划同步任务

您可以使用 Windows 任务计划程序计划运行批处理脚本以自动刷新数据的任务。

注意：在 Windows 计划程序中创建任务时，建议选择本地系统用户帐户来运行任务，并在“创建任务”窗口中选择“以最高优先级运行”。

此任务所需的时间在很大程度上取决于通过连接器移动的数据量。 如果任务运行时间过长，建议您按顺序考虑以下事项：

• 最小化进入连接器的数据量；
• 检查是否存在导致数据重复的错误联接条件；

• 删除连接器中所有未使用的属性（连接器中的每个附加属性都会增加脚本的运行时间）。

  重要提示： 强烈建议在任务运行 3 天以上后取消该任务。

数据集的格式

与 Process Mining 一起使用的数据集具有特定的格式，具体取决于标记。 此标记存储在数据集的根目录中。 有关示例，请参见下图。

标记只是一个空文件，仅用于其名称。 有两个不同的标记： nomodcodes.marker和usemodcodes.marker 。

仅当使用数据分片来确定数据范围时， usemodcodes.marker才适用。

Nomodcodes.marker

nomodcodes.marker使用如下所示的数据结构。

<DATASET NAME>\<ORGANIZATION CODE>\MVNCache

以下是 nomodcodes.marker 元素的说明。

元素	说明
<DATASET NAME>	超级管理员中显示的名称 “开发数据 ”选项卡。
<ORGANIZATION CODE>	默认值为： _org ，这将适用于 99% 的情况

使用 modcodes.marker

usemodcodes.marker使用如下所示的数据结构。

<DATASET NAME>\<ORGANIZATION CODE>\<MODULE CODE>\MVNCache

以下是 usemodcodes.marker 元素的说明。

元素	说明
<DATASET NAME>	超级管理员中显示的名称 “开发数据 ”选项卡。
<ORGANIZATION CODE>	默认值为： _org ，这将适用于 99% 的情况
<MODULE CODE>	在应用程序中设置的代码。 请参阅 模块。 此选项使您可以在一个应用程序中使用多个应用程序代码。

步骤 1. 中提供的脚本适用于nomodcodes.marker 。 对于usemodcodes.marker ，您应该使用以下脚本。

set MAINDIR=%~dp0
set DATASET=FullData
set ENVIRONMENT=production
set WORKSPACE=Peter/Connector
mkdir "%MAINDIR%\datax\_datasets\%DATASET%"
mkdir "%MAINDIR%\datax\_datasets\%DATASET%\_org"
echo. > "%MAINDIR%\datax\_datasets\%DATASET%\usemodcodes.marker"
for %%M in (..) do (
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -CCDB app="%%M" o= refreshmvncaches=true
              mkdir "%MAINDIR%\datax\_datasets\%DATASET%\_org\%%M\MVNCache" 
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -export app="%%M" out="%MAINDIR%\datax\_datasets\%DATASET%\_org\%%M\MVNCache" o= refreshmvncaches=false reusecache=true onlymarked=true
)
call "%MAINDIR%\builds\processgold.bat" -dataserver -skipmail -env "%ENVIRONMENT%" -CCDB o=* dataset="%DATASET%" p=*