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

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

この機能では、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 件に制限されています。アプリの設定の Upload.Queues.MaxNumberOfItems を使用して、制限値を少なくすることができます。

列のマッピング

ファイルの列ヘッダー	Orchestrator のフィールド
参照 一意の参照キューの場合は必須です。 二重引用符 (") を除く、すべての特殊文字をサポートしています。	参照 注: 参照は、2016.2 以前のバージョンの Orchestrator または 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. In the Queues page, Select the corresponding More Actions button for the desired queue, and then Upload Items. The Upload Items window is displayed.

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

   

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

3. [ 開く] を選択します。サポートされている書式設定ルールにファイルが準拠している場合、アップロード操作は成功しています。

4. アップロード ストラテジを選択します。

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

5. Orchestrator で CSV ファイル内の文字列が整数または Boolean 型として認識されるようにするには [動的型付け] チェックボックスをオンにします。スキーマ定義を伴うキューにキュー アイテムをアップロードして、スキーマ定義を一致させる必要がある場合は、このオプションの使用をお勧めします。動的型付けの詳細は、こちらをご覧ください。文字列が文字列として解釈されるようにする場合は、オフのままにします。

   図 2. 動的型付け

   

6. Select Upload. The items are added to your queue according to the previously selected strategy.

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

例

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

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

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

図 3. CSV ファイル

1. Select Upload Items for the desired queue, and select the CSV file. Orchestrator parses the file to confirm it meets formatting rules.
2. Select the desired upload strategies and Select Upload to finish the process.
3. [その他のアクション] > [トランザクションを表示] を選択して、アップロードしたキュー アイテムを表示します。

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

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

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

図 5. [詳細] タブ