キュー アイテムを CSV ファイルを使用して一括アップロードする

この機能では、CSV ファイルを使用して、Orchestrator の特定のキューにアイテムを一括アップロードできます。そのためには、まず特定のキューの Orchestrator インスタンスにファイルをアップロードします。ファイルが正常に処理された後、選択されたストラテジに従って、含まれているアイテムがキューにアップロードされます。アップロード操作が正常に実行されるためには、あらかじめこのファイルにデータを定義済みの形式で読み込んでおく必要があります。

There is a series of predefined column headers that you can use when building your CSV file, but you can also use other custom headers. After successfully uploading the CSV file, information contained in columns with predefined headers is mapped to columns as found in Orchestrator. Information contained in columns with custom headers is placed under the Specific Data section of the corresponding item in Orchestrator. See detailed information about column mapping here and an example here.

注:

アップロードは、ファイルあたり 15,000 アイテムに制限されています。

You can lower the limit using the Upload.Queues.MaxNumberOfItems app setting.

列のマッピング

ファイルの列ヘッダー	Orchestrator のフィールド
参照 一意の参照キューの場合は必須です。 二重引用符 (") を除く、すべての特殊文字をサポートしています。	参照 References are not compatible with v2016.2 or lower versions of Orchestrator or Robot.
処理期限 使用する場合、次のいずれかの形式で日付を入力する必要があります。 YYYY-MM-DD YYYY/MM/DD YYYY MM DD YYYY-MM-DD HH:mm YYYY/MM/DD HH:mm YYYY MM DD HH:mm YYYY-MM-DD HH:mm:ss YYYY/MM/DD HH:mm:ss YYYY MM DD HH:mm:ss	処理期限
延期 使用する場合、次のいずれかの形式で日付を入力する必要があります。 YYYY-MM-DD YYYY/MM/DD YYYY MM DD YYYY-MM-DD HH:mm YYYY/MM/DD HH:mm YYYY MM DD HH:mm YYYY-MM-DD HH:mm:ss YYYY/MM/DD HH:mm:ss YYYY MM DD HH:mm:ss	延期
優先度 使用する場合、次のいずれかの形式で日付を入力する必要があります。 低 または 1 標準 または 2 高または 3 ファイル内で優先度を指定していない場合、既定では、アイテムは高優先順位でアップロードされます。	優先度 それぞれ、次の値にマッピングされます。 低 (Low) 標準 (Normal) 高 (High)
[Custom_Name] 名前には、英数字 (0-9、a-z) とアンダースコアしか使えません。	固有データ JSON 形式にマッピングされます。 例: 当行払い小切手: 5540

ファイルには、空白の列ヘッダーを含めることはできませんのでご注意ください。

注:

定義済みの列ヘッダーでは大文字と小文字が区別されます。必ず上記のマッピング ルールに従ってください。reference という名前の CSV の列は [参照] 列の代わりに [特定のデータ] セクションにマッピングされています。

ストラテジをアップロードする

アップロードの処理には、2 種類の方法があります。

• 個別にすべてを処理 - すべてのアイテムを個別に処理し、処理が正常に完了した場合は、アイテムをキューに追加します。処理に失敗したアイテムがある場合は、それらのアイテムのリストを返します。このリストは、CSV ファイルでダウンロードできます。このファイルには、当初アップロードしたファイルと同じフィールドが表示されます。
• 一括 (すべて成功/すべて失敗) で処理 - すべてのアイテムが正常に処理された場合にのみアイテムが追加されます。そうでない場合は何も追加されません。

動的型付け

スキーマ定義を伴うキューにキュー アイテムをアップロードするとき、そのスキーマ定義と一致させるために、Orchestrator で文字列が整数または Boolean 型として解釈されるようにする必要がある場合があります。

動的型付けオプションは、Orchestrator でキュー アイテムのアップロードに使用される .csv ファイル内の String 型の値がどのように解析されるかを制御できる機能です。

注:

数値データは、10 進リテラルの定義に準拠している必要があります。2⁵³ より大きい数値または -2⁵³ 未満の数値は、精度を保持するために整数に変換されません。ドットは小数点の区切り文字として、コンマは 100 桁の区切り文字として使用してください。

キュー アイテムを CSV ファイルを使用してアップロードする

このセクションでは、Orchestrator から CSV ファイルを使用してアイテムをキューに追加する方法を説明します。

1. [キュー] ページで、目的のキューに対応する [その他のアクション] ボタンをクリックし、[アイテムをアップロード] をクリックします。[アイテムをアップロード] ウィンドウが表示されます。

   図 1. アイテムをアップロード

   

2. [参照] を選択して、目的の CSV ファイルを選択します。

3. Select Open. If your file is compliant with the supported formatting rules, the upload operation is successful.

4. Select the upload strategy:

   • 個別にすべてを処理 - すべてのアイテムを個別に処理し、処理が正常に完了した場合は、アイテムをキューに追加します。処理に失敗したアイテムがある場合は、それらのアイテムのリストを返します。このリストは、CSV ファイルでダウンロードできます。このファイルには、当初アップロードしたファイルと同じフィールドが表示されます。
   • 一括 (すべて成功/すべて失敗) で処理 - すべてのアイテムが正常に処理された場合にのみアイテムが追加されます。そうでない場合は何も追加されません。

5. Select the Dynamic typing checkbox if you want Orchestrator to interpret string characters in the CSV files as integer or boolean. This is recommended when uploading queue items to queues with schema definitions when it's required to match the schema definition. Read more about dynamic typing. Leave it unselected, if you want strings to be interpreted as strings.

   図 2. 動的型付け

   

6. [アップロード] をクリックします。事前に選択したストラテジに従って、キューにアイテムが追加されます。

7. [個別にすべてを処理] オプションを使用する際に、未処理のアイテムが存在した場合は、[アップロード] ボタンが [ダウンロード] になり、未処理のアイテムを記載した CSV ファイルをダウンロードできます。

例

次に示す CSV ファイルの内容をキューにアップロードするとします。このようなファイルを容易に作成するには、データを Excel ファイルに入力して CSV ファイルとして保存します。

または、すべての列ヘッダーを入力済みの CSV ファイルをダウンロードして、ニーズに合わせてカスタマイズすることもできます。

このファイルには、Orchestrator に存在するアイテムと名前が同じ 3 つの既定の列 ([Reference]、[Deadline]、および [Priority] - 緑で強調表示) と 2 つのカスタム列 ([Customer] および [Color] - 赤で強調表示) が存在します。

図 3. CSV ファイル

1. アップロード先のキューに対する [アイテムをアップロード] をクリックして、この CSV ファイルを選択します。Orchestrator によってファイルが解析され、値がフォーマット ルールを満たしていることが確認されます。
2. 適切なアップロード ストラテジを選択して [アップロード] をクリックし、プロセスを完了します。
3. [その他のアクション] > [トランザクションを表示] を選択して、アップロードしたキュー アイテムを表示します。

[ トランザクション] ページには、ファイルからアップロードされた各アイテムが表示されます。ファイルの定義済みの列に含まれる情報は、Orchestrator で同じ名前の列 ([参照]、[処理期限]、[ 優先度] が緑色で強調表示) にマッピングされます。

図 4. [トランザクション] ページ

カスタム列の情報は、JSON 形式で各アイテムの [固有データ] セクションにマップされています。その内容を表示するには、アイテムの [詳細を表示] を選択します。

図 5. [詳細] タブ