この機能では、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 を使用して、制限値を少なくすることができます。

列のマッピング

---

ファイルには、空白の列ヘッダーを含めることはできません。フィールドの詳細な説明については、こちらをご覧ください。

📘

重要

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

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

---

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

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

動的型付け

---

スキーマ定義を伴うキューにキュー アイテムをアップロードするとき、そのスキーマ定義と一致させるために、Orchestrator で文字列が整数または Boolean 型として解釈されるようにする必要がある場合があります。
動的型付けオプションは、Orchestrator でキュー アイテムのアップロードに使用される .csv ファイル内の String 型の値がどのように解析されるかを制御できる機能です。

Numeric data must conform to the definition of a decimal literal. Numerical values greater than 2⁵³ or less than -2⁵³ are not converted to Integer to preserve precision. Make sure to use the dot as a decimal separator and the comma as a thousand separator.

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

---

This section concerns adding items to a queue using a CSV file from Orchestrator. For details on how to add items through automation projects aka workflow design in Studio, see Managing queues in Studio.

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

2. [参照] をクリックして、目的の CSV ファイルを選択します。
3. [開く] をクリックします。ファイルがサポートされているフォーマット ルールに準拠していれば、アップロード操作は正常に完了します。
4. アップロード ストラテジを選択します。
   • 個別にすべてを処理 - すべてのアイテムを個別に処理し、処理が正常に完了した場合は、アイテムをキューに追加します。処理に失敗したアイテムがある場合は、それらのアイテムのリストを返します。このリストは、CSV ファイルでダウンロードできます。このファイルには、当初アップロードしたファイルと同じフィールドが表示されます。
   • 一括 (すべて成功/すべて失敗) で処理 - すべてのアイテムが正常に処理された場合にのみアイテムが追加されます。そうでない場合は何も追加されません。
5. Orchestrator で CSV ファイル内の文字列が整数または Boolean 型として認識されるようにするには [動的型付け] チェックボックスをオンにします。スキーマ定義を伴うキューにキュー アイテムをアップロードして、スキーマ定義を一致させる必要がある場合は、このオプションの使用をお勧めします。動的型付けの詳細については、こちらをご覧ください。文字列が文字列として解釈されるようにする場合は、オフのままにします。

6. [アップロード] をクリックします。事前に選択したストラテジに従って、キューにアイテムが追加されます。
7. [個別にすべてを処理] オプションを使用する際に、未処理のアイテムが存在した場合は、[アップロード] ボタンが [ダウンロード] になり、未処理のアイテムを記載した CSV ファイルをダウンロードできます。

例

---

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

Or you can download a CSV file with all the pre-filled column headers and customize it to your needs.

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

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

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

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