View a markdown version of this page

依存フィールドオプションの CSV アップロード - Amazon Connect

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

依存フィールドオプションの CSV アップロード

ケーステンプレートの依存フィールドオプションを設定すると、CSV ファイルをアップロードできます。ファイルには、フィールドオプションマッピングが含まれています。このアプローチにより、Amazon Connect 管理ウェブサイトから各関係を手動で入力するよりも時間が節約されます。この機能は、階層関係の大規模なデータセットがある場合に便利です。例としては、地理的階層 (国 → 州 → 市) や製品分類 (カテゴリ → サブカテゴリ) などがあります。

依存フィールドオプションの CSV アップロードとは

CSV アップロードは、Amazon Connect Cases の依存フィールドオプションの一括設定方法です。依存フィールドオプションは、カスケードドロップダウンメニューを作成します。1 つのフィールド (ターゲットフィールド) で使用可能な選択肢は、別のフィールド (ソースフィールド) で選択された値によって異なります。

マッピングは CSV ファイルで準備し、アップロードできます。これにより、Amazon Connect 管理ウェブサイトを通じて各ソースとターゲット値の関係を手動で設定するよりも時間が節約されます。システムは CSV ファイルを解析し、ケーステンプレートに対してフィールド名と値を検証します。次に、システムによってルール作成フォームにデータが事前入力されます。標準ワークフローを使用してルールを作成します。

CSV アップロードの仕組み

CSV ファイル構造

CSV ファイルは、次のヘッダーを含む 4 列形式を使用します。

  • 親フィールド名 - 関係を制御するソースフィールドの名前

  • 子フィールド名 - オプションがソースフィールドに依存するターゲットフィールドの名前

  • 親値 - ソースフィールドからの特定の値

  • 子値 - 親値が選択されたときにターゲットフィールドに表示されるオプション

CSV の各行は、1 つのソースとターゲット値の関係を表します。異なる親子フィールド名の組み合わせを使用して、1 つの CSV ファイルに複数のフィールドペアを含めることができます。たとえば、国と状態の関係と製品カテゴリとサブカテゴリの関係の両方を同じファイルに含めることができます。保存できるエントリの数は、アカウントのクォータ制限によって異なります。

Amazon Connect 管理ウェブサイトから CSV テンプレートをダウンロードできます。テンプレートは、プレースホルダーヘッダーを含む正しい形式を提供します。

アップロードと検証のプロセス

CSV ファイルをアップロードすると、システムはいくつかの検証チェックを実行します。

  • ファイル形式の検証 - CSV 構造と必要な列を検証します

  • フィールドの存在 - CSV のフィールド名が、選択したケーステンプレートのフィールドと一致することを確認します

  • フィールドタイプの検証 - ソースフィールドとターゲットフィールドの両方が単一選択型のフィールドであることを確認します

  • 値の検証 - ソースフィールド値がテンプレートに存在することを確認し、存在しない子フィールド値を特定します。

CSV のソースフィールド値がテンプレートに存在しない場合、システムはエラーを表示します。子フィールド値が存在しない場合、システムはそれらの値をスキップし、情報メッセージを表示します。

検証後、システムは CSV 行を一意のフィールドペアでグループ化します。検出された各ペアが選択可能なオプションとして表示されます。CSV に複数のフィールドペアが含まれている場合は、設定するペアを選択します。

CSV データからのルールの作成

アップロードした CSV からフィールドペアを選択すると、ルール作成フォームにファイルからのフィールド名と値マッピングが自動的に入力されます。

フォームの入力後にルールを明示的に作成する必要があります。アップロードプロセスでは、ルールは自動的に作成されません。ルールを作成する前に新しい CSV ファイルをアップロードすると、新しいファイルのデータは以前に入力されたオプションを上書きします。

CSV アップロードごとに、一度に 1 つのルールが作成されます。CSV に複数のフィールドペアが含まれている場合は、ペアごとにルールを個別に作成します。異なるペアを選択し、それぞれのルール作成ワークフローを完了します。

制限と要件

CSV アップロードには、次の制限と要件があります。

  • 単一選択フィールドのみ - ソースフィールドとターゲットフィールドの両方が単一選択タイプフィールドである必要があります

  • 既存のフィールドは必須です - CSV 内のすべてのフィールド名が、既に存在するフィールドと一致する必要があります

その他のリソース

次の APIsを使用して、プログラムでフィールドオプション条件を作成します。

  • CreateCaseRule: fieldOptions」ルールタイプを使用してフィールドオプション条件を作成します。

  • CreateTemplate または UpdateTemplate: フィールドオプション条件をケーステンプレートに関連付けます。