ファイル受信コネクタ

ファイル受信コネクタについて

ファイル受信コネクタを使用して、ファイルアップロードによって顧客データをロードすることができます。これらのジョブは、設定したスケジュールで繰り返されるようにスケジュールすることも、1 回限りのデータプルとして設定することもできます。

ファイル受信ジョブでは、次の形式でデータをアップロードできます:

• フラット区切りテキストファイル（CSV、TSVなど）
• XLS または XLSX
• JSON
• WebVTT

ファイル受信ジョブの設定

1. [ジョブ] ページで、[新規ジョブ] をクリックします。
   
2. ファイルを選択します。
   
3. ジョブを特定できるように、ジョブに名前を付けます。
   
4. データをロードするプロジェクトを選択します。
5. 目的がわかるように、ジョブに説明を付けます。
6. [次へ] をクリックします。
7. 使用する SFTP アカウントを選択するか、新規追加を選択して新しいアカウントを追加します。
   
8. 新しいアカウントを追加する場合は、SFTP アカウントに関する以下の情報を入力します。
   • 接続名: 後で認識できるように、接続に名前を付けます。
   • SFTP ユーザ名: SFTP サーバに接続するためのユーザ名を入力します。
   • SFTP パスワード: SFTP サーバに接続するためのパスワードを入力します。
   • SFTP ホスト: SFTP サーバのホスト URL を入力します。
   • SFTP ポート: SFTP ポートを入力します。通常は 22 です。
   • 期限切れ通知を送信：SFTP認証情報を一定時間後に期限切れにする場合は、このオプションを選択します。
   • 有効期限までの日数：有効期限に関する通知を有効にする場合は、有効期限までの通知日数を入力します。1 日から 100 日の間の値を入力することができます。
   • 有効期限: 認証情報の有効期限が切れる日付を設定します。ボックスをクリックしてカレンダを開き、日付を選択します。
9. [次へ] をクリックします。
10. アップロードするファイルのタイプを選択:
    
    • 区切り文字で区切られた「フラット」ファイル
    • Excel ファイル (XLS、XLSX)
    • JSON ファイル
    • WebVTT ファイル
11. 選択したファイルタイプに応じて、以下を選択するための追加設定があります。
    • デリミタ区切りフラットファイル: デリミタ区切りファイルの場合は、
      を選択します。
      • ファイルエンコーディング：ファイルのエンコーディングシステム（UTF-8、ASCII など）を選択します。
      • 区切り文字: データエントリの区切りに使用する文字を入力します。デフォルトでは、これは CSV ファイルのカンマです。
      • 囲み文字: データ入力を囲む文字を入力します。封入なしが選択されている場合、この項目は空白のままにします。
      • 囲みなし: ファイルに囲み文字が含まれていない場合は、このオプションを有効にします。
    • JSON：XM Discoverにアップロードするドキュメントデータが含まれるJSONパスを入力します。文書がルートレベルにある場合は、この項目を空白のままにします。
      
    • Excel および WebVTT の次のステップに進みます。
12. 参照をクリックし、アップロードするファイルを含むSFTPサーバー上のフォルダーパスを選択します。
    ヒント：フォルダーパスを選択するときに、フォルダーアイコンをクリックして、そのフォルダーを展開できます。フォルダー名をクリックしてフォルダーを選択し、完了したら［OK］をクリックします。
13. アップロードするファイルと一致するファイル名正規表現を入力します。
14. ファイルが圧縮されている場合は、Unzip ファイルを有効にし、解凍するファイルと一致する Zip ファイル名の正規表現を入力します。
    
15. ファイルが復号化された場合は、Decrypt file(s) を有効にして、次のように入力します。
    • 暗号化されたファイル名の正規表現: 復号化するファイルのファイル名の正規表現を入力します。
    • PGP/GPG キー: 暗号化に使用する PGP/GPG キーを入力します。
    • パスフレーズ: 解読のパスフレーズを入力します。
16. ファイルが圧縮と暗号化の両方である場合は、最初にどの処理を行うかを選択する必要があります。
    • 解凍してから解読: ファイルが解凍され、復号化されます。
    • 解読してから解凍: ファイルが復号化された後、解凍されます。
17. インポートするデータのタイプを選択します。
    
    • チャット：2 人以上の参加者間の複数の対話をデジタルでやり取りします。
    • コール: 2 人以上の参加者の間に複数の対話行がある成績証明書を呼び出します。
    • フィードバック: 文書は単一行、または “フラット” オブジェクトとして表示されます。
      ヒント：ファイルの種類によっては、一部のデータ型に互換性がないものがあります。たとえば、WebVTT ファイルは、コール成績証明書のアップロードにのみ使用することができます。
18. コンピュータまたは SFTP サーバに保存できるサンプルファイルを指定する必要があります。
    • サンプルファイルが SFTP サーバに保存されている場合は、ファイルストレージからサンプルをダウンロードを選択します。
    • サンプルがコンピュータに保存されている場合は、マイコンピュータからサンプルをアップロードを選択します。
19. 必要に応じて、ダウンロードするテンプレートファイルを選択することができます。ここリンクをクリックして、選択したテンプレートをダウンロードします。このファイルを使用して、XM Discoverにインポートするデータを追加します。各ファイルおよびデータ型に関する特定の書式設定情報については、「XM Discover データ形式」サポートページを参照してください。
20. サンプルファイルの選択ボタンをクリックし、コンピュータまたは SFTP サーバ上のサンプルファイルを選択します。
21. ファイルのプレビューが表示されます。プレビューではなくエラーメッセージまたはローファイルの内容が表示される場合は、選択したデータ書式オプションに問題がある可能性があります。ファイルのトラブルシューティングについては、「サンプルファイルのエラー」ページを参照してください。
22. [次へ] をクリックします。
23. 必要に応じて、データマッピングを調整します。XM Discoverのマッピングフィールドの詳細については、「データマッピング」サポートページを参照してください。デフォルトデータマッピングセクションには、このコネクタに固有のフィールドに関する情報と、会話型データのデータのマッピング方法を示す会話型フィールドのマッピングセクションがあります。
    
24. [次へ] をクリックします。
25. 必要に応じて、データ代替ルールおよび編集ルールを追加して、機密データを非表示にしたり、顧客フィードバックおよびインタラクションの特定の単語およびフレーズを自動的に置換したりすることができます。詳細については、「データの差し替えと変更」サポートページを参照してください。
    
26. [次へ] をクリックします。
27. 必要に応じて、受信データをフィルタリングするコネクタフィルタを追加して、インポートされるデータを制限することができます。
    
28. また、レコード制限の指定ボックスで数を入力して、1 つのジョブでインポートされるレコードの数を制限することもできます。すべてのレコードをインポートする場合は、”すべて” を入力します。
    ヒント：会話データの場合、上限は行ではなく会話に基づいて適用されます。
29. [次へ] をクリックします。
30. 通知を受け取るタイミングを選択します。詳細については、ジョブ通知を参照してください。
    
31. [次へ] をクリックします。
32. 重複伝票の処理方法を選択します。詳細については、重複処理を参照してください。
    
33. ジョブをスケジュールに従って定期的に実行する場合は、増分実行のスケジュールを選択します。ジョブを 1 回だけ実行する場合は、ワンタイムプル設定を選択します。詳細については、ジョブスケジュールを参照してください。
34. 処理されたファイルの保存期間を選択します。設定された期間の後にファイルが削除されます。
    
35. [次へ] をクリックします。
36. 設定をレビューします。特定の設定を変更する必要がある場合は、編集ボタンをクリックして、コネクタ設定のそのステップに移動します。
    
37. [完了] をクリックしてジョブを保存します。

デフォルトデータマッピング

このセクションでは、ファイル受信ジョブのデフォルト項目について説明します。

• feedback_type: データをそのタイプに基づいて識別します。これは、プロジェクトにさまざまなタイプのデータ（アンケートやソーシャルメディアフィードバックなど）が含まれる場合にレポートに役立ちます。デフォルトでは、この属性の値は、コール成績証明書の場合は “コール”、デジタルインタラクションの場合は “チャット”、個別フィードバックの場合は “フィードバック” に設定されます。カスタム変換を使用して、カスタム値の設定、式の定義、または別のフィールドへのマッピングを行います。
• source_value: 特定のソースから取得したデータを識別します。これは、サーベイやモバイルマーケティングキャンペーンの名称など、データの発生源を示すあらゆるものにできます。デフォルトでは、この属性の値は “Files” に設定されています。カスタム変換を使用して、カスタム値の設定、式の定義、または別のフィールドへのマッピングを行います。
• document_date: ドキュメントに関連付けられている主要な日付フィールド。この日付は、XM Discoverのレポート、トレンド、アラートなどで使用されます。伝票日付には、データセット内の任意の日付項目を使用することができます。特定の伝票日付を設定することもできます。
• natural_id: ドキュメントの一意の識別子。重複を正しく処理するには、伝票ごとに一意の ID を設定することを強くお奨めします。[Natural ID] では、データから任意のテキストフィールドまたは数値フィールドを選択できます。または、ユーザ定義項目を追加して ID を自動的に生成することもできます。
• feedback_provider: 特定のプロバイダから取得したデータを識別します。ファイルアップロードの場合、この属性の値は “ファイル” に設定され、変更できません。
• job_name: アップロードに使用されたジョブの名前に基づいてデータを識別します。設定時に各ページの上部に表示されるジョブ名フィールドを使用して、設定時にこの属性の値を変更することができます。
• loadDate：ドキュメントがXM Discoverにアップロードされた日時を示します。この項目は自動的に設定され、変更することはできません。

サンプル設定の更新

ファイル受信コネクタでは、データマッピングを生成するためのサンプルファイルが必要です。ジョブの作成後にデータマッピングを変更する場合は、以下を実行します。

1. 新しいサンプルファイルに存在しないフィールドのマッピングを解除します。
2. 新しいフィールドセットを含む新しいサンプルファイルをアップロードして、サンプル設定を更新します。サンプル設定を更新する手順は以下のとおりです。
3. 新しいサンプルファイルに従ってデータマッピングを更新します。

サンプル設定を更新しています

1. ジョブオプションメニューで、既存のファイルジョブに対してサンプル設定の更新を選択します。
   
2. クリックしてアップロードするファイルを選択を選択し、コンピュータに保存されているサンプルファイルを選択します。
   
   ヒント：ファイルにデータマッピングにないフィールドが含まれている場合は、エラーが発生します。この問題を解決するには、サンプルファイルと同じフィールドが含まれるようにデータマッピングを編集します。
3. ファイル設定を再確認してください。サンプルファイル設定の詳細については、ファイル受信コネクタページを参照してください。
4. OK をクリックします。

パスおよびファイルマスクの更新

ファイル受信コネクタでは、インポートする適切なファイルを見つけるために、パスとファイルマスク (ファイル名正規表現) が必要です。既存のファイルジョブのパスおよびファイルマスクを更新することができます。

1. ジョブオプションメニューで、既存のファイルジョブのパスおよびファイルマスクの更新を選択します。
   
2. [参照] をクリックします。
   
3. ファイルが保存されているフォルダを選択します。
   
   注意: 選択したフォルダ内のファイルのみが処理されます。サブフォルダは個別に処理する必要があります。
4. OK をクリックします。
5. ファイル名正規表現フィールドに、インポートするファイルと一致するファイルマスク (ファイル名正規表現) を入力します。
   
6. ［保存］をクリックします。

XM Discoverがサポートする鍵交換暗号方式

SFTP サーバに接続するには、サーバと自動化の間で使用される暗号化を調整するための一連の SSH ハンドシェイクが必要です。接続を確立するには、SFTP サーバに、自動化でサポートされている暗号と一致する暗号タイプごとに少なくとも 1 つの暗号が必要です。以下は、自動化でサポートされる暗号の一覧で、暗号タイプ別にグループ化されています。

XM Discover SFTPサーバーがサポートする鍵交換暗号のリストは以下のとおりです：

• ディフィー・ヘルマン・グループ14-sha256
• ディフィー・ヘルマン・グループ18-ha512
• ecdh-sha2-nistp256
• ecdh-sha2-nistp384
• ecdh-sha2-nistp521
• カーブ25519-シャ256
• curve25519-sha256@libssh.org
• ディフィー・ヘルマン・グループ16-ha512
• ecdh-nistp256-kyber-512r3-sha256-d00@openquantumsafe.org
• ecdh-nistp384-kyber-768r3-sha384-d00@openquantumsafe.org
• ecdh-nistp521-kyber-1024r3-sha512-d00@openquantumsafe.org
• x25519-kyber-512r3-sha256-d00@amazon.com