Process Mining 用户指南

上次更新日期 2026年5月20日

适用平台：

正在运行数据上传器

请按照以下步骤使用DataUploader加载数据。

下载 DataUploader。
创建一个文件夹，然后将要使用此文件夹中的DataUploader上传的输入文件复制到该文件夹中。
打开 Windows Powershell。
导航到下载DataUploader的位置。
运行以下命令之一：
重要提示：
将每个参数值用引号括起来。

process-mining-data-uploader.exe "<csv dir>" "<sas url>" "<end-of-upload api>"
process-mining-data-uploader.exe "<csv dir>" "<sas url>" "<end-of-upload api>"

process-mining-data-uploader.exe -c "<myfolder>" -s "<my-sas-uri>" -e "<my-end-of-upload-api>"
process-mining-data-uploader.exe -c "<myfolder>" -s "<my-sas-uri>" -e "<my-end-of-upload-api>"

process-mining-data-uploader.exe --config-file "path\to\config\file"
process-mining-data-uploader.exe --config-file "path\to\config\file"

每次上传文件时，系统都会显示一个进度条。

命令字符串示例

./process-mining-data-uploader.exe "data" "https://asdf.blob.core.windows.net/a28d10b0-6822-4xxy-a197-02zz39824ad4?sv=2020-06-12&si=sap-a58d10b0-6822-4ffc-a197-02ed649824ad4&sr=c&sig=WELk3bW8zpY5rL71lJ8pPPhlOq0odLNoQleY%2BL3nPqek%3D" "https://asdf.uipath.com/org/tenant/processmining_/api/v4.0/apps/a28d10b0-6822-4ffc-a197-02ed39824ad4/ingest/authenticated?AppSecretToken=A5B221CD00E77F02677G36H572IJKLM61N2440320O44666PQ4RS3T0U81410VW" "44"
./process-mining-data-uploader.exe "data" "https://asdf.blob.core.windows.net/a28d10b0-6822-4xxy-a197-02zz39824ad4?sv=2020-06-12&si=sap-a58d10b0-6822-4ffc-a197-02ed649824ad4&sr=c&sig=WELk3bW8zpY5rL71lJ8pPPhlOq0odLNoQleY%2BL3nPqek%3D" "https://asdf.uipath.com/org/tenant/processmining_/api/v4.0/apps/a28d10b0-6822-4ffc-a197-02ed39824ad4/ingest/authenticated?AppSecretToken=A5B221CD00E77F02677G36H572IJKLM61N2440320O44666PQ4RS3T0U81410VW" "44"

增量提取

请按照以下步骤通过增量同步运行DataUploader 。

打开 Windows Powershell 并导航到下载DataUploader的位置。
确保所有输入文件都遵循所需的命名格式。请参阅增量同步的文件命名。

使用--tables参数运行数据上传器。以下代码显示了一个命令示例。

process-mining-data-uploader.exe -c "<csv dir>" -s "<sas url>" -e "<end-of-upload api>" --tables '[{"prefix": "pfx01", "name": "Table01", "load-type": "incremental"}, {"prefix": "pfx02", "name": "Table02", "load-type": "full"}]'
process-mining-data-uploader.exe -c "<csv dir>" -s "<sas url>" -e "<end-of-upload api>" --tables '[{"prefix": "pfx01", "name": "Table01", "load-type": "incremental"}, {"prefix": "pfx02", "name": "Table02", "load-type": "full"}]'

重要提示：

将每个参数值用引号括起来。

备注：

每次运行后， “数据上传”器都会将同步状态保存到与可执行文件相同的文件夹中的文件中。

备注：

将忽略其前缀与--tables参数中的任何条目都不匹配的文件。如果未提供--tables ，则上传文件夹中的所有文件。

增量同步的文件命名

所有用于增量提取的文件必须遵循以下命名格式：

<table-prefix>_<any text>_<yyyymmdd>T<HHMMSS>.<extension>
<table-prefix>_<any text>_<yyyymmdd>T<HHMMSS>.<extension>

示例：

pfx01_filename-part-not-read-by-data-uploader_20240221T142100.csv
pfx01_filename-part-not-read-by-data-uploader_20240221T142100.csv

部分	描述
`<table-prefix>`	必须匹配`--tables`参数中定义的前缀。不得包含下划线。
`<any text>`	任何描述性文本。未由DataUploader使用。
`<yyyymmdd>T<HHMMSS>`	从源中提取数据的时间戳。`T`用于分隔日期和时间。
`<extension>`	任何文件扩展名。

故障排除

最大文件大小

（每个文件）的最大文件大小为 5TB。

重试次数

如果上传失败（例如由于连接不稳定）， DataUploader会重试上传内容，最多可重试 4 次。如果数据上传 5 次后未成功，则会创建一份报告。

警告：

在某些网络配置下，由于证书自签名， DataUploader无法访问上传结束 API，并且您将收到诸如UNABLE_TO_GET_ISSUER_CERT_LOCALLY之类的错误。可通过将数据上传器指向您组织的证书颁发机构 (CA) 证书来解决此问题。请执行以下步骤。

创建名为NODE_EXTRA_CA_CERTS的环境变量。
将新环境变量的值设置为 CA 证书的文件路径。

如果某些文件上传失败，您可以使用相同的命令并使用相同的文件重新启动DataUploader 。

调用结束上传 API

如果我的文件已上传，但未调用上传结束端点怎么办？

有时，即使是在上传所有文件之后，也可能会发生未成功调用上传结束 API 的情况。如果从数据上传器上传文件后您看不到以下日志，则表示未成功调用结束上传 API：

End-of-upload API reached successfully, data transformation started.

在这种情况下，您可以在 PowerShell 会话中复制并运行以下代码，以调用上传结束 API。

$endOfUploadUri = "*******"
$delimiter = 9 # you can change this to the ascii of the character of your choice
$fullUri = "$endOfUploadUri&dataLoadOptionsJson=%7B%22UseSampleData%22%3Afalse%2C%22FileFormatOptions%22%3A%7B%22FieldDelimiter%22%3A%22$delimiter%22%7D%7D"
$response = Invoke-WebRequest -Uri $fullUri -Method POST
Write-Output $response.StatusCode
$endOfUploadUri = "*******"
$delimiter = 9 # you can change this to the ascii of the character of your choice
$fullUri = "$endOfUploadUri&dataLoadOptionsJson=%7B%22UseSampleData%22%3Afalse%2C%22FileFormatOptions%22%3A%7B%22FieldDelimiter%22%3A%22$delimiter%22%7D%7D"
$response = Invoke-WebRequest -Uri $fullUri -Method POST
Write-Output $response.StatusCode

证书

警告：

在某些网络配置下，由于自签名证书问题， DataUploader无法访问上传结束 API，并且您将收到诸如UNABLE_TO_GET_ISSUER_CERT_LOCALLY之类的错误。您可以通过为数据上传器提供有效的证书链来解决此问题。

请按照以下步骤为数据上传器提供有效的证书链。

转到 Process Mining 门户，然后从“流程应用程序”选项卡中打开流程应用程序。
导航至网页浏览器中的地址栏，然后选择地址栏中左侧的“查看站点信息”图标。
选择“连接安全” ，然后选择“证书有效”以显示证书。
转到“详细信息”选项卡，然后展开“证书层次结构”。
选择cloud.uipath.com条目，然后选择“导出…” 。
选择计算机上证书文件的保存位置，并确保将其保存为Base64 编码的 ASCII 类型、证书链 (*.pem;*crt) 。

cloud.uipath.crt文件将出现在所选位置。
创建环境变量NODE_EXTRA_CA_CERTS ，并将此变量的值设置为在步骤 6 中所选证书的完整文件路径（包括文件夹路径、文件名和文件扩展名）
1. 打开“Windows 系统属性”。
2. Go to the Advanced tab.
3. 选择“环境变量” 。
4. 选择“新建”以添加新的系统变量。