アドホックファイルアップロード受信コネクタ
アドホックファイルアップロードコネクタについて
アドホックファイルアップロード受信コネクタを使用して、サポートされている形式 (Excel スプレッドシート、フラットファイル、JSON、または WebVTT) の 1 つを使用して、顧客データを 1 つのファイルから XM Discover にロードすることができます。
XM Discoverへのデータアップロード
開始する前に
アドホックファイルアップロード受信コネクタを使用してジョブを設定する前に、サポートされている以下のファイル形式のいずれかで、関連する顧客データが準備されていることを確認してください。
- 区切りテキスト (CSV) ファイル
- Microsoft Excel (XLS、XLSX) ファイル
- JavaScript Object Notation (JSON) ファイル
- Web ビデオテキストトラック (VTT) ファイル
ファイルとデータ形式の組み合わせのデータフォーマット要件については、「XM Discover データフォーマット概要」を参照してください。
接続の設定
アドホックファイルアップロードコネクタージョブの作成
接続を設定したら、以下のステップに従ってアドホックファイルアップロード受信コネクタジョブを作成し、XM Discoverに送信されるデータを設定します。
- ステップ 1: ジョブ名の入力
- ステップ 2: プロジェクトと説明の指定
- ステップ 3: ファイルの選択
- ステップ4:XM Discoverへの希望データフィールドのマッピング
- ステップ 5: データ代替および編集 (オプション)
- ステップ 6: フィルタおよびレコード制限の指定
- ステップ 7: 通知および設定 (オプション)
- ステップ 8: ジョブの追加オプションの設定
- ステップ 9: すべてのジョブ設定の確認
ステップ 1: ジョブ名の入力
ページの左上の
[ジョブ名] ボックスに、認識可能なジョブ名を入力します。
ステップ 2: プロジェクトと説明の指定
- [次へ] をクリックします。
ステップ 3: ファイルの選択
- [ファイルの選択] ページで、以下のチェックボックスの 1 つを選択し、アップロードされるデータを含むファイルの種類を選択します。
- 区切りテキスト (CSV) ファイル
- Microsoft Excel (XLS、XLSX) ファイル
- JavaScript Object Notation (JSON) ファイル
- Web ビデオテキストトラック (VTT) ファイル
- 選択したファイルタイプに設定オプションを適用します。
- 区切りテキスト (CSV) ファイル: 詳細については、 区切りテキストファイル(CSV)設定 」セクションで説明されている手順を使用して差し込むことができます。
- Microsoft Excel (XLS、XLSX) ファイル: 詳細については、 Microsoft Excel ファイルの設定 」セクションで説明されている手順を使用して差し込むことができます。
- JavaScript Object Notation (JSON) ファイル: 詳細については、 JavaScript Object Notation (JSON) ファイルの設定 」セクションで説明されている手順を使用して差し込むことができます。
- Web ビデオテキストトラック (VTT) ファイル: 詳細については、 Web ビデオテキストトラック (VTT) ファイル設定 」セクションで説明されている手順を使用して差し込むことができます。
- クリックしてアップロードするファイルを選択ボタンをクリックし、データファイルをポイントするか、灰色のキャンバスにファイルをドロップします。
- ファイルがアップロードされ、プレビューが表示されるまで待ちます。
ヒント:プレビューではなくエラーメッセージと未加工ファイルの内容が表示される場合は、選択したファイルオプションに問題がある場合があります。アドホックファイルアップロードコネクタを使用してアップロードされたサンプルファイルの検証失敗に関するエラーメッセージの詳細については、サンプルファイルエラーを参照してください。 - データが正しいことを確認します。
- [次へ] をクリックします。
ステップ4:XM Discoverに目的のフィールドをマッピング
- XM Discoverに目的のフィールドをマッピングページで、[ソースマッピング]タブを選択し、ソースデータフィールドをXM Discoverプロジェクトのデータフィールドに接続します。
- デフォルトのソースマッピングセクションで、XM Discoverのすべての文書が共有するデフォルトのデータフィールドを設定します。デフォルトソースマッピングの詳細については、を参照してください。 デフォルトソースマッピング 」セクションで説明されている手順を使用して差し込むことができます。
- ソースマッピングセクションで、ファイルからの追加データフィールドを設定します。 対話型データフィールドの設定については、「」を参照してください。 会話型データフィールド 」セクションで説明されている手順を使用して差し込むことができます。
ヒント:データマッピングの詳細については、「データマッピングの設定」を参照してください。 - [次へ] をクリックします。
ステップ 5: データ代入および編集 (オプション)
- データ置換およびレッドアクションページでは、カスタマフィードバックおよびインタラクションで、機密データを非表示にしたり、特定の単語およびフレーズを自動的に置換したりするための代替ルールと編集ルールを指定することができます。
ヒント:データの置換と編集の詳細については、「データの差し替えと削減」を参照してください。 - [次へ] をクリックします。
ステップ 6: フィルタおよびレコード制限の指定
- [フィルタの指定] ページでは、ジョブに対するフィルタ条件を定義して、それを満たすレコードのみをロードすることができます (オプション)。
ヒント:フィルターの適用の詳細については、「コネクターフィルター」を参照してください。 - [レコード制限の指定]ボックスでレコード制限を指定できます。また、すべてのレコードを 1 回のプッシュで返す場合は、レコード制限をデフォルトのすべてのままにしておくこともできます。
ヒント:レコード制限は、ジョブの実行ごとの制限です。1,000 に設定すると、ジョブは設定した任意のスケジュールで実行され、1,000 件のレコードを取得した後に停止します。日次に設定すると、1 日に 1 回実行され、1 日あたり最大 1,000 件のレコードが取得されます。ヒント:会話データの場合、上限は行ではなく会話に基づいて適用されます。
- [次へ] をクリックします。
ステップ 7: 通知設定 (オプション)
- [通知設定] ページでは、以下に一覧表示されたイベントのいずれかが発生した場合に、ジョブの参照者が受信する通知を選択することができます。
- プロジェクトにゼロのレコードがロードされたら通知します。
- 連続した欠損値が見つかった場合に通知します。
- ジョブの実行が失敗した場合に通知します。
- ジョブ実行が部分的に成功した場合に通知します。
- ジョブがタイムアウトで終了した場合に通知します。
- このジョブが失敗した場合は、サポートに通知します。
ヒント:通知の任意の組み合わせを選択するか、通知を選択しないことを決定できます。この場合、ジョブの監視は通知を受信しません。ヒント:通知設定の詳細については、「ジョブ通知」を参照してください。
- [次へ] をクリックします。
ステップ 8: ジョブの追加オプションの設定
- [ジョブの追加オプションの設定] ページの [新規および既存のドキュメントの処理中] セクションで、[新規および既存のドキュメントを処理する] セクションで以下のチェックボックスの 1 つを選択して、重複するドキュメントの処理方法を選択します。
- 既存の伝票の重複を却下し、新規伝票の新規レコードを登録します。
- 既存の文書の構造化属性を更新し、新規文書の新規レコードを登録します。
- 既存の文書の構造化属性を更新し、新規文書のレコードは登録しません。
注意: 同じ自然 ID を持つ重複ドキュメントをシステムで処理できるように、各ドキュメントには一意の Natural ID が必要です。ヒント:重複検出モードの詳細については、「重複検出」を参照してください。
- [次へ] をクリックします。
ステップ 9: すべてのジョブ設定の確認
- すべてのジョブ設定の確認ページでは、データアップロードを実行する前に、ジョブのすべての設定の概要を表示し、必要に応じて設定を編集することができます。
- データアップロードを実行するには、データアップロードを実行する準備ができたら、終了ボタンをクリックします。ジョブが正常に送信されたことを確認する確認メッセージが表示されます。終了をクリックすると、以下の処理が行われます。
- ワンタイムプルが即時に実行されます。
- [ジョブを作成するがデータを取得しない] オプションを有効にしていない場合、スケジュールされたプルはすぐに実行されてから、定義したスケジュールに従って実行されるように設定されます。
注意: アドホックファイルアップロードジョブは 1 回だけ実行され、スケジュールすることはできません。
ジョブの監視
の詳細については、ジョブページ概要を参照してください。
区切りテキストファイル(CSV)設定
区切り記号付きテキストファイル (CSV) の設定オプションは、[ファイルの選択] ページに適用できます。
- メニューから、ファイルで使用されているエンコードシステムを選択します。
- ファイル内のデータエントリを区切るために使用する文字を区切り文字文字ボックスに入力します。
ヒント:1文字のみ入力します。ヒント:デフォルトの区切り文字はCSVファイルに使用できるコンマです。 - ファイル内の各データフィールドを囲むために使用する文字を囲み文字ボックスに入力します。
ヒント:2文字のみ入力します。ヒント:囲み文字がオプションの場合は、[囲み文字]チェックボックスを選択します。
- データ書式を選択します。
- チャット: このオプションは、2 人以上の参加者間の複数のダイアログ行を含むデジタルインタラクションをアップロードする場合に選択します。
- コール: このオプションは、2 人以上の参加者間で複数のダイアログ行を含むコール成績証明書をアップロードする場合に選択します。
- フィードバック: このオプションは、単一行または “フラット” オブジェクトとして表示される文書をアップロードする場合に選択します。
- デジタルインタラクションおよびコール記録は、事前定義された書式に従う必要があります。選択したデータ書式に応じて、データ書式を選択した後、ここリンクをクリックして、サンプルデータを含む以下のテンプレートの 1 つをダウンロードすることができます。
- デジタルインタラクションのチャットテンプレート: これは、デジタルインタラクションとしてデータを取り込むための最小必須フィールド/命名規則を含むサンプル CSV ファイルテンプレートです。このテンプレートを使用して、既存の区切りファイルフィールドタイプをこれらの要件にマッピングする方法を識別することができます。必要に応じて、分析の一部としてアップロードされたファイルに含める項目を追加することができます。詳細については、CSV 形式のデジタルインタラクションを参照してください。
- コール成績証明書のテンプレートの呼出: これは、音声コールとしてデータを取り込むための最小必須項目/命名規則を含むサンプル CSV ファイルテンプレートです。このテンプレートを使用して、既存の区切りファイルフィールドタイプをこれらの要件にマッピングする方法を識別することができます。必要に応じて、分析の一部としてアップロードされたファイルに含める項目を追加することができます。詳細については、CSV 書式での成績証明書の呼出を参照してください。
- 非会話型データのフィードバックテンプレート。詳細については、CSV 形式の個別フィードバックを参照してください。
Microsoft Excel ファイルの設定
Microsoft Excel ファイルの設定オプションは、[ファイルの選択] ページに適用できます。
- データ書式を選択します。
- チャット: このオプションは、2 人以上の参加者の間に複数のダイアログ行があるデジタルインタラクションをアップロードする場合に選択します。
- コール: 2 人以上の参加者の間に複数のダイアログ行があるコール成績証明書をアップロードするには、このオプションを選択します。
- フィードバック: このオプションは、単一行または “フラット” オブジェクトとして表示される文書をアップロードする場合に選択します。
- デジタルインタラクションおよびコール記録は、事前定義された書式に従う必要があります。選択したデータ書式に応じて、データ書式を選択した後、ここリンクをクリックして、サンプルデータを含む以下のテンプレートの 1 つをダウンロードすることができます。
- デジタルインタラクションのチャットテンプレート: これは、デジタルインタラクションとしてデータを取り込むための最小必須フィールドと命名規則を含むサンプル Excel ファイルテンプレートです。このテンプレートを使用して、既存の Excel ファイルフィールドタイプをこれらの要件にマッピングする方法を識別することができます。必要に応じて、分析の一部としてアップロードされたファイルに含める項目を追加することができます。詳細については、Excel 形式のデジタルインタラクションを参照してください。
- コール成績証明書のテンプレート呼出: これは、音声コールとしてデータを取り込むための最小必須フィールドと命名規則を含むサンプル Excel ファイルテンプレートです。このテンプレートを使用して、既存の Excel フィールドの種類をこれらの要件にマッピングする方法を識別することができます。必要に応じて、分析の一部としてアップロードされたファイルに含める項目を追加することができます。詳細については、Excel 形式での成績証明書呼出を参照してください。
- 非会話型データのフィードバックテンプレート。詳細については、Excel 形式の個別フィードバックを参照してください。
JavaScript Object Notation (JSON) ファイルの設定
ファイル選択ページで JavaScript Object Notation (JSON) ファイルの設定を適用できます。
- JSON ファイルの特定の配列内に適切な XM Discover ドキュメントデータが含まれている場合は、そのデータが格納される配列の名前を JSON パスボックスに入力します。
ヒント:ドキュメントがルートノードレベルにある場合は、このボックスを空白のままにします。 - データ書式を選択します。
- チャット: このオプションは、2 人以上の参加者の間に複数のダイアログ行があるデジタルインタラクションをアップロードする場合に選択します。
- コール: 2 人以上の参加者の間に複数のダイアログ行があるコール成績証明書をアップロードするには、このオプションを選択します。
- フィードバック: このオプションは、単一行または “フラット” オブジェクトとして表示される文書をアップロードする場合に選択します。
- テンプレートメニューから、テンプレートの種類を選択します。
- デジタルインタラクションおよびコール記録は、事前定義された書式に従う必要があります。選択したテンプレートタイプに応じて、ここリンクをクリックして、サンプルデータを含む以下のテンプレートの 1 つをダウンロードすることができます。
- デジタルインタラクションのチャットテンプレート: これは、デジタルインタラクションとしてデータを取り込むための最小必須フィールドと命名規則を含むサンプル JSON ファイルテンプレートです。このテンプレートを使用して、既存の JSON ファイルフィールドタイプをこれらの要件にマッピングする方法を識別することができます。必要に応じて、分析の一部としてアップロードされたファイルに含める項目を追加することができます。詳細については、JSON 形式のデジタルインタラクションを参照してください。
- Amazon Connect チャットテンプレート: Amazon Connect チャットプラットフォームから JSON ファイルをアップロードする場合は、このテンプレートを使用することができます。
- コール成績証明書のテンプレートの呼出: これは、音声コールとしてデータを取り込むための最小必須フィールドと命名規則を含むサンプル JSON ファイルテンプレートです。このテンプレートを使用して、既存の JSON フィールドタイプをこれらの要件にマッピングする方法を識別することができます。必要に応じて、分析の一部としてアップロードされたファイルに含める項目を追加することができます。詳細については、JSON 形式での成績証明書の呼出を参照してください。
- Verint コールテンプレート: このテンプレートは、Verint プラットフォームから音声転写をアップロードする場合に選択できます。
- CB VTTコールテンプレート:XM Discoverから音声転写をアップロードする予定の場合は、このテンプレートを選択できます。
- 非会話型データのフィードバックテンプレート。詳細については、JSON 形式の個別フィードバックを参照してください。
- Dynamics 365 フィードバックテンプレート: Microsoft Dynamics 365 プラットフォームからファイルをアップロードする場合は、このテンプレートを選択できます。
Web ビデオテキストトラック (VTT) ファイル設定
Web Video Text Track (VTT) ファイルに使用できるデータ書式は、コールのみです。ファイル選択ページのここリンクをクリックして、サンプルデータを含む WebVTT (Zoom) テンプレートをダウンロードします。
このサンプルの WebVTT ファイルテンプレートには、最低限必要な項目とデータの取り込みに関する命名規則が含まれています。このテンプレートを使用して、既存の WebVTT ファイル項目タイプをこれらの要件にマッピングする方法を識別することができます。必要に応じて、分析の一部としてアップロードされたファイルに含める項目を追加することができます。詳細については、WebVTT 書式での成績証明書呼出を参照してください。
デフォルトソースマッピング
アドホックファイル受信コネクタのデフォルトデータフィールドは以下のとおりです。
- feedback-type は、データ型に基づいてデータを識別するのに役立ちます。これは、プロジェクトにさまざまなタイプのデータ(アンケートやソーシャルメディアフィードバックなど)が含まれる場合にレポートに役立ちます。デフォルトでは、この属性の値は、コール記録、デジタルインタラクション用チャット、または個別フィードバックのフィードバックを呼び出すように設定されています。カスタム変換を使用して、カスタム値の設定、式の定義、または特定のフィールドへのマッピングを行います。
- source を使用すると、特定のソースから取得したデータを識別できます。これは、サーベイやモバイルマーケティングキャンペーンの名称など、データの発生源を示すあらゆるものにできます。デフォルトでは、この属性の値はアドホックファイルアップロードに設定されています。カスタム変換を使用して、カスタム値の設定、式の定義、または特定のフィールドへのマッピングを行います。
- document_date は、ドキュメントに関連付けられている主要な日付フィールドです。この日付は、XM Discoverのレポート、トレンド、アラートなどで使用されます。伝票日付では、項目名列のデータから任意の日付項目を選択することができます。
または、ユーザ定義項目を追加して特定の日付を設定することもできます。
詳細については、特定の伝票日付の設定を参照してください。 - natural_id は、ドキュメントの一意の識別子として機能します。重複を正しく処理するには、伝票ごとに一意の ID を設定することを強くお奨めします。[自然体 ID] では、[フィールド名] 列のデータから任意のテキストフィールドまたは数値フィールドを選択できます。
または、ユーザ定義項目を追加して ID を自動的に生成することもできます。詳細については、Natural ID の自動生成を参照してください。 - feedback_provider は、特定のプロバイダから取得したデータを識別するのに役立ちます。ファイルのアップロードの場合、この属性の値はアドホックファイルアップロードに設定されます。
- job_name は、アップロードに使用されたジョブの名前に基づいてデータを識別するのに役立ちます。設定時に各ページの上部に表示されるジョブ名フィールドを使用して、この属性の値を変更することができます。
- loadDateは、ドキュメントがXM Discoverにアップロードされた日付を示します。この項目は自動的に設定されます。
ヒント:データマッピングの詳細については、「データマッピングの設定」を参照してください。
会話型データフィールド
ソースマッピングセクションでは、以下の対話型データフィールドを設定できます。
- richVerbatim:会話データ(通話やチャットインタラクションなど)の場合、XM Discover では、richVerbatim フィールドに会話形式の言葉を使用します。この形式では、会話ビジュアライゼーションのロックを解除するために必要なダイアログ固有のメタデータ (講演者回転、沈黙、会話イベントなど) および拡張 (開始時刻、期間など) がサポートされます。この完全一致フィールドには、クライアント側と代表者の会話側を追跡するための「子」フィールドが含まれます。
- clientVerbatim
- agentVerbatim
- わからない
ヒント:会話形式のフィールドでは変換がサポートされていません。ヒント:異なるタイプの会話データに同じ言葉を使用することはできません。プロジェクトで複数のタイプの会話がホストされるようにする場合は、会話タイプごとに別々の会話言語ペアを使用します。
- clientVerbatim (対話データ用): クライアント側の対話をコールおよびチャットインタラクションで追跡します。デフォルトでは、このフィールドは以下にマッピングされます。
- clientVerbatimChat (デジタルインタラクションの場合)
- clientVerbatimCall (コールインタラクション用)
ヒント:必要に応じて、このフィールドを別の単語型フィールドにマッピングできます。
- agentVerbatim (対話データ用): コールおよびチャットインタラクションで、代理人 (エージェント) 側の対話を追跡します。デフォルトでは、このフィールドは以下にマッピングされます。
- agentVerbatimChat (デジタルインタラクションの場合)
- コールインタラクションの agentVerbatimCall
ヒント:必要に応じて、このフィールドを別の単語型フィールドにマッピングできます。
- 不明 (対話データ用): コールおよびチャットインタラクションで会話の不明な側を追跡します。デフォルトでは、このフィールドは以下にマッピングされます。
- デジタルインタラクションの UnknownVerbatimChat
- コールインタラクションの unknownVerbatimCall
ヒント:必要に応じて、このフィールドを別の単語型フィールドにマッピングできます。