ファイルインバウンドコネクター
このページの内容
ファイルインバウンドコネクターについて
ファイルインバウンドコネクターを使用して、ファイルのアップロード経由で顧客データを読み込むことができます。これらのジョブは、設定したスケジュールで繰り返し実行するようにスケジュールすることも、1回限りのデータプルとして設定することもできます。
ファイルインバウンドジョブでは、以下の形式でデータをアップロードできます。
- フラット区切りテキストファイル(CSV、TSVなど)
- XLSまたはXLSX
- JSON
- WebVTT
注意: この機能を使用するには、組織独自のSFTPサーバーが必要です。クアルトリクスは、お客様が利用できるSFTPサーバーを提供しています。このサービスには費用がかかりますが、これらのサーバーはクアルトリクスと互換性があることを保証します。詳細については、アカウントエグゼクティブにお問い合わせください。
ファイルインバウンドジョブの設定
ヒント：この機能を使用するには、「ジョブの管理」権限が必要です。
「ジョブ」ページで、新規ジョブをクリックします。
ファイルを選択します。
ジョブを識別できるよう、ジョブに名前を付けます。
データを読み込むプロジェクトを選択します。
ジョブの目的がわかるように、ジョブに説明を付けます。
次へをクリックします。
SFTPサーバーの認証方法を選択してください。
- 基本認証：ユーザー名とパスワードを使用して接続します。
- SSHキー：お客様が提供するセキュアシェル(SSH)キー、またはクアルトリクスが提供するキーを使用して接続します。
ドロップダウンを使用して、既存の接続を選択するか、［新規追加］を選択して新しい接続を設定します。新しい接続の作成に関する詳細は、SFTPアカウントの追加を参照してください。
次へをクリックします。
アップロードするファイルのタイプを選択してください。
- 区切り文字で区切られた「フラット」ファイル
- Excelファイル(XLS、XLSX)
- JSONファイル
- WebVTTファイル
選択したファイルタイプに応じて、追加で選択できる設定があります。
区切り文字で区切られたフラットファイル：区切り文字で区切られたファイルの場合は、以下を選択します。
- ファイルのエンコーディング：ファイルのエンコーディングシステム（例：UTF-8、ASCII）を選択します。
- 区切り文字：データエントリーを区切るために使用する文字を入力します。デフォルトでは、CSVファイルの場合はカンマになります。
- 囲み文字：データ入力を囲む文字を入力します。同封物なしが選択されている場合は、このフィールドを空白のままにしてください。
- 囲み文字なし：ファイルに囲み文字が含まれていない場合にこのオプションを有効にします。
JSON：XM Discoverにアップロードするドキュメントデータを含むJSONパスを入力します。ドキュメントがルートレベルにある場合は、このフィールドを空白のままにします。
- ExcelとWebVTTについては、次のステップに進んでください。
参照をクリックし、アップロードするファイルが含まれているSFTPサーバー上のフォルダーパスを選択します。
ヒント：フォルダーパスを選択する際、フォルダーアイコンをクリックするとそのフォルダーを展開できます。フォルダー名をクリックしてそのフォルダーを選択し、完了したらOKをクリックします。
注意：このジョブで使用されているSFTPユーザーには、ソースディレクトリに対する読み取り、削除、フォルダー作成の権限が必要です。読み取り専用の認証情報はサポートされていません。ファイルが処理されると、コネクターはソースディレクトリからそのファイルを削除し、再度取り込まれないようにします。また、コネクターはそのディレクトリーにアーカイブフォルダーと「bad」フォルダーを作成し、処理済みファイルと失敗したファイルのコピーを保存します。「フォルダーの作成」権限を付与できない場合は、ソースディレクトリーに「アーカイブ」フォルダーと「不正」フォルダーを手動で作成してください。削除する権限が引き続き必要です。
アップロードするファイルに一致するファイル名の正規表現を入力します。
ファイルが圧縮されている場合は、ファイル解凍を有効にし、解凍するファイルに一致する圧縮ファイル名の正規表現を入力します。
ファイルが復号化されている場合は、ファイルを復号化を有効にして、以下を入力します。
- 暗号化ファイル名の正規表現：復号化するファイルのファイル名の正規表現を入力します。
- PGP/GPGキー：暗号化に使用するPGP/GPGキーを入力します。
- パスフレーズ：復号化用のパスフレーズを入力してください。
ファイルが圧縮と暗号化の両方に対応している場合は、どちらを先に行うかを選択する必要があります。
- 解凍してから復号化：ファイルを解凍してから復号化します。
- 復号化してから解凍：ファイルを復号化してから解凍します。
インポートするデータのタイプを選択してください。
- チャット：2人以上の参加者間で複数行の対話が行われるDigitalインタラクション。
- 通話：2人以上の参加者による複数行の対話を含む通話の書き起こしです。
フィードバック: 単一行、または「フラット」なオブジェクトとして表示されるドキュメント。
ヒント：「フィードバック」を選択した場合、2つ目のメニューが表示され、フィードバックに含めるインタラクションデータのタイプを選択できます。通話、チャット、メール、評価、ソーシャル、アンケートなどのオプションがあります。
ヒント：ファイルの種類によっては、互換性のないデータタイプがあります。例えば、WebVTTファイルは通話のトランスクリプトのアップロードにのみ使用できます。
コンピューターまたはSFTPサーバーに保存されているサンプルファイルを提供する必要があります。
- サンプルファイルがSFTPサーバーに保存されている場合は、ファイルストレージからサンプルをダウンロードを選択します。
- サンプルがコンピューターに保存されている場合は、コンピューターからサンプルをアップロードを選択します。
必要に応じて、テンプレートファイルを選択してダウンロードできます。選択したテンプレートをダウンロードするには、こちらのリンクをクリックしてください。このファイルを使用して、XM Discoverにインポートするデータを追加します。各ファイルとデータタイプの具体的なフォーマット情報については、XM Discoverのデータフォーマットのサポートページを参照してください。
［サンプルファイルを選択］ボタンをクリックし、コンピューターまたはSFTPサーバー上のサンプルファイルを選択します。
ファイルのプレビューが表示されます。プレビューの代わりにエラーメッセージや未加工のファイルコンテンツが表示される場合は、選択したデータ形式のオプションに問題がある可能性があります。ファイルのトラブルシューティングについては、サンプルファイルのエラーページを参照してください。
次へをクリックします。
必要に応じて、データマッピングを調整します。XM Discoverでの項目のマッピングに関する詳細は、データマッピングのサポートページを参照してください。デフォルトのデータマッピングセクションにはこのコネクターに固有のフィールドに関する情報が記載されており、会話フィールドのマッピングセクションでは会話データのデータをマッピングする方法について説明しています。
次へをクリックします。
必要に応じて、データ置換および編集ルールを追加して、機密データを非表示にしたり、顧客のフィードバックやインタラクションに含まれる特定の単語やフレーズを自動的に置き換えたりすることができます。詳細については、データの置換と編集に関するサポートページを参照してください。
次へをクリックします。
必要に応じて、コネクターフィルターを追加して受信データをフィルタリングし、インポートするデータを制限できます。
また、［レコード数の上限を指定］ボックスに数値を入力すると、1回のジョブでインポートされるレコード数を制限することもできます。すべてのレコードをインポートする場合は、「All」と入力します。
ヒント：会話データの場合、制限は行ではなく会話に基づいて適用されます。
次へをクリックします。
通知を受け取るタイミングを選択してください。詳細はジョブ通知を参照してください。
次へをクリックします。
重複するドキュメントの処理方法を選択します。詳細については、重複の処理を参照してください。
ジョブを定期的にスケジュール実行する場合は［増分実行のスケジュール］を、1回だけ実行する場合は［1回限りのプルを設定］を選択します。詳細については、ジョブのスケジュールを参照してください。
処理済みファイルの保持期間を選択します。設定された期間が経過すると、ファイルは削除されます。
次へをクリックします。
設定を確認します。特定の設定を変更する必要がある場合は、編集ボタンをクリックすると、コネクター設定の該当ステップに移動します。
［完了］をクリックしてジョブを保存します。
デフォルトのデータマッピング
このセクションでは、ファイルインバウンドジョブのデフォルトフィールドに関する情報について説明します。
- feedback_type：データの種類に基づいてデータを識別します。これは、プロジェクトにさまざまな種類のデータ（アンケート調査やソーシャルメディアのフィードバックなど）が含まれている場合のレポート作成に役立ちます。デフォルトでは、この属性の値は、通話のトランスクリプトの場合は「call」、digitalインタラクションの場合は「chat」、個々のフィードバックの場合は「feedback」に設定されます。カスタム変換を使用して、カスタム値の設定、式の定義、または別のフィールドへのマッピングを行います。
- source_value：特定のソースから取得したデータを識別します。これは、アンケート名やモバイルマーケティングキャンペーンなど、データの出所を説明するものであれば何でもかまいません。デフォルトでは、この属性の値は「ファイル」に設定されています。カスタム変換を使用して、カスタム値の設定、式の定義、または別のフィールドへのマッピングを行います。
- document_date：ドキュメントに関連付けられた主要な日付フィールド。この日付は、XM Discoverのレポート、トレンド、アラートなどで使用されます。ドキュメントの日付には、データセット内の任意の日付フィールドを使用できます。特定のドキュメント日付を設定することもできます。
- natural_id：ドキュメントの一意の識別子です。重複を正しく処理するために、各ドキュメントに一意のIDを設定することを強く推奨します。Natural IDには、データから任意のテキストまたは数値フィールドを選択できます。または、カスタムフィールドを追加してIDを自動生成することもできます。
- feedback_provider：特定のプロバイダーから取得したデータを識別します。ファイルアップロードの場合、この属性の値は「ファイル」に設定されており、変更できません。
- job_name：データのアップロードに使用されたジョブ名に基づいてデータを識別します。この属性値は、セットアップ中に各ページの上部に表示されるジョブ名フィールドで変更できます。
- loadDate：ドキュメントがXM Discoverにアップロードされた日時を示します。このフィールドは自動的に設定されており、変更できません。
ヒント：会話データをマッピングする方法については、会話フィールドのマッピングを参照してください。
サンプルの設定を更新中
ファイルインバウンドコネクターでは、データマッピングを生成するためにサンプルファイルが必要です。ジョブの作成後にデータマッピングを変更する場合は、次の手順を実行してください。
サンプル設定を更新中
ヒント：ファイルにデータマッピングに含まれていないフィールドがある場合、エラーが表示されます。この問題を解決するには、サンプルファイルと同じフィールドを持つようにデータマッピングを編集してください。
パスとファイルマスクの更新
ファイルインバウンドコネクターでは、インポートする適切なファイルを見つけるために、パスとファイルマスク（ファイル名の正規表現）が必要です。既存のファイルジョブのパスとファイルマスクを更新できます。
注意: 選択したフォルダー内のファイルのみが処理されます。サブフォルダーは個別に処理する必要があります。
XM Discoverでサポートされている鍵交換暗号
ヒント：このセクションで説明されている設定については、組織のITチームと協力することをお勧めします。
SFTPサーバーに接続するには、サーバーとオートメーションの間で使用される暗号化を調整するために、一連のSSHハンドシェイクが必要です。接続を確立するには、SFTPサーバーに、オートメーションでサポートされている暗号と一致する暗号が、暗号タイプごとに少なくとも1つ必要です。以下は、暗号化タイプ別にグループ化された、オートメーションでサポートされている暗号化のリストです。
ヒント：FTPサーバーへのアクセスを中断なく安全に行うには、FTPクライアントソフトウェアを常に最新の状態に保ち、変更後はテストを実行して正常に動作することを確認することをお勧めします。
XM Discover SFTPサーバーでサポートされている鍵交換暗号のリストは以下の通りです。
- diffie-hellman-group14-sha256
- diffie-hellman-group18-sha512
- ecdh-sha2-nistp256
- ecdh-sha2-nistp384
- ecdh-sha2-nistp521
- curve25519-sha256
- curve25519-sha256@libssh.org
- diffie-hellman-group16-sha512
- 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
ヒント：セキュリティへの取り組みの一環として、rsa1024-sha1およびdiffie-hellman-group-exchange-sha256のサポートを終了しました。貴社のITチームがFTPクライアントソフトウェアを適宜更新されることを推奨します。
素晴らしい！ フィードバックありがとうございます！
フィードバックありがとうございます！