DataUploader を実行する

DataUploader を実行して、入力データ ファイルを Automation Cloud の Process Mining プロセス アプリにアップロードします。

DataUploader を使用してデータを読み込むには、以下の手順に従います。

1. DataUploader をダウンロードします。
2. フォルダーを作成し、DataUploader を使用してアップロードする入力ファイルをこのフォルダーにコピーします。
3. Windows PowerShell を開きます。
4. DataUploader をダウンロードした場所に移動します。
5. 次のいずれかのコマンドを実行します。
   重要:

   各パラメーター値は引用符で囲んでください。

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 --config-file "path\to\config\file"

ファイルのアップロードそれぞれに対して進行状況バーが表示されます。

コマンド文字列の例

./process-mining-data-uploader.exe "data" "<your-sas-url>" "https://asdf.uipath.com/org/tenant/processmining_/api/v4.0/apps/a28d10b0-6822-4ffc-a197-02ed39824ad4/ingest/authenticated?AppSecretToken=<your-access-token>" "44"

増分抽出

増分同期を使用して DataUploader を実行するには、以下の手順に従います。

1. Windows PowerShell を開き、 DataUploader をダウンロードした場所に移動します。
2. すべての入力ファイルが、必要な命名形式に従っていることを確認してください。増分同期のファイル名を参照してください。
3. --tables パラメーターを指定して DataUploader を実行します。次のコードにコマンド例を示します。

   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"}]'
   

   重要:

   各パラメーター値は引用符で囲んでください。

注:

実行のたびに、 DataUploader は同期のステータスを実行ファイルと同じフォルダー内のファイルに保存します。

注:

プレフィックスが --tables パラメーターのどのエントリとも一致しないファイルは無視されます。指定しない場合 --tables 、フォルダー内のすべてのファイルがアップロードされます。

増分同期のファイル名

増分の取り込みを目的としたすべてのファイルは、次の命名形式に従う必要があります。

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

例：

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

部分	説明
<table-prefix>	--tables パラメーターで定義されたプレフィックスと一致する必要があります。アンダースコアを含めることはできません。
<any text>	説明テキスト。DataUploader では使用されません。
<yyyymmdd>T<HHMMSS>	ソースからのデータ抽出のタイムスタンプ。T は日付と時刻を区切ります。
<extension>	任意のファイル拡張子。

トラブルシューティング

最大ファイル サイズ

最大ファイル サイズ (ファイルあたり) は 5 TB です。

リトライの回数

もしアップロードが不安定な接続などを理由に失敗した場合、DataUploader はアップロードを最大で 4 回リトライします。5 回試行してもデータのアップロードが成功しなかった場合、レポートが作成されます。

警告:

特定のネットワーク構成では、自己署名証明書が原因で DataUploader が end-of-upload API に到達できず、次のようなエラーが発生します。UNABLE_TO_GET_ISSUER_CERT_LOCALLYこれは、 DataUploader が組織の証明機関 (CA) の証明書を指定することで解決できます。次の手順を実行します。

1. NODE_EXTRA_CA_CERTS という環境変数を作成します。
2. 新しい環境変数の値を CA 証明書のファイル パスに設定します。

アップロードに失敗したファイルがある場合は、同じコマンドと同じファイルを使用して DataUploader を再度開始できます。

end of upload API を呼び出す

ファイルがアップロードされたのに end of upload エンドポイントが呼び出されない場合、どうすればよいですか?

ファイルがすべてアップロードされたのに end of upload API が正常に呼び出されないことがあります。データ アップローダーからファイルをアップロードした後に以下のログが表示されない場合は、end of upload API が正常に呼び出されなかったことを意味します。

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

この場合、次のコードをコピーして PowerShell セッションで実行すると、end of upload 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

証明書

警告:

ネットワーク構成によっては、自己署名証明書が原因で DataUploader が end-of-upload API に到達できず、「 UNABLE_TO_GET_ISSUER_CERT_LOCALLY」などのエラーが発生します。有効な証明書チェーンを DataUploader に指定することで、この問題を修正できます。

有効な証明書チェーンを DataUploader に指定するには以下の手順に従います。

1. Process Mining ポータルに移動し、[プロセス アプリ] タブからプロセス アプリを開きます。

2. Web ブラウザーでアドレス バーに移動し、その左側にある [サイト情報を表示] アイコンを選択します。

   

3. [この接続は保護されています] を選択し、[証明書は有効です] を選択して証明書を表示します。

   

4. [詳細] タブに移動し、[証明書の階層] を展開します。

5. cloud.uipath.com エントリを選択し、[エクスポート...] を選択します。

   

6. コンピューター上で証明書ファイルの保存先とする場所を選択し、必ず Base64 エンコードの ASCII による証明書チェーン (*.pem;*crt) タイプとして保存されるようにします。

   選択した場所に cloud.uipath.crt ファイルが表示されます。

7. 環境変数 NODE_EXTRA_CA_CERTS を作成し、その値を、手順 6 で選択した証明書ファイルのフル パス (フォルダー パス、ファイル名、ファイル拡張子で構成するパス) に設定します。

   1. Windows の [システムのプロパティ] を開きます。
   2. [Advanced] タブに移動します。
   3. [環境変数] を選択します。
   4. [新規] を選択して、新しいシステム変数を追加します。

8. 新しい PowerShell セッションを開始して、この環境変数が DataUploader で認識されることを確認します。