ファイル送信コネクタ

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

ファイル送信コネクターを使用して、XM Discoverから組織のSFTPサーバーにエンリッチ済みデータをエクスポートできます。

センテンスおよびドキュメントレベルでデータをエクスポートし、新しいレコードと更新されたレコードに制限して、エクスポートするフィールド、エンリッチメント、および分類を選択することができます。エクスポートされたデータは、CSV 形式と JSON 形式の両方で利用できます。

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

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. XM DiscoverのエクスポートAPIエンドポイントを指定します。
    
11. [次へ] をクリックします。
12. エクスポートするデータのレベルを選択します。
    
    • 文: 文レベルのデータを使用します。
    • ドキュメント: ドキュメントレベルのデータを使用します。
      ヒント：［照会構成］ページの残りの手順は任意であり、エクスポートされるデータを絞り込むのに役立ちます。
13. 検索クエリを指定して、送信データをフィルタリングします。Designer でデータを検索する場合と同じ構文を使用します。すべてのデータを含めるには、このフィールドを空白のままにします。
    例: 1 つまたは複数の調査 ID を指定して、構文 surveyid:sv_01 を使用して選択した調査レコードのみを更新することができます。
14. 送信データに適用するプロジェクトからのフィルタの名称を入力します。データをフィルタリングしない場合は、この項目を空白のままにします。
15. インポートするレコードを選択します。
    • 新規レコードのロード: 送信ジョブが最後に実行されてから登録されたレコード。
    • 新規レコードおよび更新済レコードのロード: 送信ジョブの最終実行時以降に作成または更新されたレコード。
    • 更新されたレコードのロード: 送信ジョブが最後に実行された後に更新されたレコード。
16. ドロップダウンメニューを使用して、データに含める分類モデルを選択します。プロジェクトで利用可能なすべてのモデルの分類データを含めるには、すべてのモデルチェックボックスを選択します。
17. 分類によるデータフィルタリングへの影響を選択します。
    • 無視: 選択したモデルに基づくフィルタリングは適用されません。
    • 現在分類済: 最新の分類実行中に選択されたモデルによって分類されたレコードを返します。
    • 分類済: 任意の時点で選択したモデルによって分類されたレコードを返します。
18. 使用する追加のエクスポートオプションを選択します。
    • カテゴリ名の代わりにカテゴリ ID (true) を返すかどうか (false): カテゴリ名の代わりにカテゴリ ID をエクスポートします。
    • すべてのリーフノードパスを含むフィルタクエリを適用して結果をフィルタリングします。エクスポート API 呼び出しに “leaf_only” パラメータを使用して複数のモデルを追加します。
19. [次へ] をクリックします。
20. エクスポートするファイルのタイプを選択：
    
    • 区切り文字で区切られた「フラット」：形式は、CSV や TSV などの区切り記号付きテキストファイルです。
    • JSON ファイル: 形式は JSON ファイルです。
21. デリミタ区切りフラットファイルにエクスポートする場合は、ファイル設定を選択します。
    • ファイルエンコーディング: ファイルのエンコード (UTF-8、ASCII など) を選択します。
    • 区切り文字: エントリを区切るために使用される文字 (カンマやタブなど)。
    • 囲み文字: データを囲むために使用される文字。封入が必要ない場合は、この項目を空白のままにします。
    • 囲みなし: データが余分な文字で囲まれないようにするには、このオプションを有効にします。
22. 参照をクリックし、SFTP フォルダを選択します。
    
    ヒント：フォルダーパスを選択するときに、フォルダーアイコンをクリックして、そのフォルダーを展開できます。フォルダー名をクリックしてフォルダーを選択し、完了したら［OK］をクリックします。
23. エクスポートされたファイルに接頭辞を添付する場合は、接頭辞のファイル名を指定してくださいを有効にし、必要な接頭辞をボックスに入力します。
    ヒント：プレフィックスは[ ] \ / を含むことができず、100文字を超えることはできません。
24. エクスポートしたファイルに接尾辞を添付する場合は、[接尾辞のファイル名を指定する] を有効にして、ボックスに必要な後置記号を入力します。
    ヒント：後置記号には[ ] \ / を含めることはできず、100文字を超えてはなりません。
25. データを暗号化する場合は、［XM Discoverによって提供されるファイルの暗号化］を有効にして、ボックスに PGP/GPG キーを入力します。
26. [次へ] をクリックします。
27. XM Discoverのフィールドをクアルトリクスにマッピングします。空のボックスをクリックし、クアルトリクスに送信するXM Discover属性を選択します。
    
28. フィールドをエクスポートするデータ型として
    を選択します。
    • マッピングしない: 変数タイプが指定されていません。
    • 数値属性: 数値変数タイプ。
    • テキスト属性: テキストセット変数タイプ。
    • 日付属性: 日付変数タイプ。
    • バーベイタム: テキスト変数タイプ。
29. この項目の属性名を入力します。これは、エクスポート時のフィールド名になります。
30. 必要に応じて項目を追加および削除するには、プラス ( + ) 符号とマイナス ( – ) 符号を使用します。
31. [次へ] をクリックします。
32. 必要に応じて、受信データをフィルタリングするコネクタフィルタを追加して、インポートされるデータを制限することができます。
    
33. また、レコード制限の指定ボックスで数を入力して、1 つのジョブでインポートされるレコードの数を制限することもできます。すべてのレコードをインポートする場合は、”すべて” を入力します。
    ヒント：会話データの場合、上限は行ではなく会話に基づいて適用されます。
34. [次へ] をクリックします。
35. 通知を受け取るタイミングを選択します。詳細については、ジョブ通知を参照してください。
    
36. [次へ] をクリックします。
37. ジョブがいつ実行されるかを選択します。1 回限りのプルを実行することも、定期的なデータインポートを設定することもできます。詳細については、ジョブスケジュールを参照してください。
    
38. [次へ] をクリックします。
39. 設定をレビューします。特定の設定を変更する必要がある場合は、編集ボタンをクリックして、コネクタ設定のそのステップに移動します。
    
40. [完了] をクリックしてジョブを保存します。