Sftpファイルからのデータ抽出タスク

Sftpファイルからのデータ抽出タスクについて

SFTPファイルからデータを抽出タスクでは、SFTPサーバーからデータをインポートしてクアルトリクスで使用することができます。このタスクを使って、一度に1つまたは複数のファイルだけを処理することができる。このタスクと他のタスク（Load data to XM DIRECTORYタスクなど）を組み合わせることで、クアルトリクス内の他の場所にデータをインポートすることができます。

SFTP アカウントの接続

SFTPファイルからデータを抽出タスクを使用する前に、クアルトリクスがデータを抽出するためのSFTPアカウントを接続する必要があります。アカウントは、ブランド管理者がブランドの他のユーザーに使用させるために追加することも、個人ユーザーが個人的に使用するために追加することもできます。

認証機能は3種類あります：

• パスワード：ユーザー名とパスワードで認証すること。
• SSHキー：自分が用意したSecure Shell（SSH）キー、またはクアルトリクスが用意したキーを使って認証機能を行います。
• 暗号化された SSH 鍵：暗号化された SSH 鍵を使用して認証機能。

ブランド管理者としてのアカウントの追加

ブランド管理者の場合は、このセクションの手順に従って、ライセンス内の一部またはすべてのユーザーが使用する SFTP アカウントを追加してください。

1. 左上のナビゲーションメニューを使って、「Admin」に進みます。
   
2. エクステンションに行く。
3. Sftpファイルからデータを抽出]拡張子をクリックします。
4. ［アカウントを追加］をクリックします。
   
5. アカウントに名前をつける。この名前は、組織上の目的およびアカウントの識別のために使用されます。
   
6. 関連する SFTP サーバのホスト名を入力します。
   例：一般的には、sftp.example.comの形式です。
7. ポート番号を入力します。（通常はQ1です）
8. 自分らしくいられることを認証機能を選択します。オプションは次のとおりです。
   • パスワード：認証用のユーザー名とパスワードを入力します。
   • SSHキー：認証のためにユーザー名と SSH キーを提供するか、クアルトリクスが生成した SSH キーを使用します。
   • 暗号化されたSSHキー：自分らしくいられることを認証するために、パスフレーズ付きの暗号化されたSSHキーを提供します。
9. passwordを選択した場合は、SftpアカウントのUsernameと Passwordを入力します。
   
10. SSH鍵で認証する場合は、以下のいずれかを行う：
    • クアルトリクスが生成したSSHキーを使用する場合は、「Username」を入力し、「Generate SSH keypair」をクリックします。
      公開SSH鍵のダウンロード」をクリックすると、公開鍵を.pemファイルとしてコンピュータにダウンロードできます。関連する秘密鍵はクアルトリクスが保管します。Copy to clipboard（クリップボードにコピー）をクリックし、キーのフィンガープリントをクリップボードにコピーします。この2つを安全な場所に保存し、必要に応じて参照できるようにする。
    • 自分の SSH 鍵を使用する場合は、「秘密鍵を提供する」をクリックします。
      次に、ユーザー名とSSHキーを入力します。
      Qtip:このボックスには、パスワードで保護されていない秘密鍵を入力する必要があります。公開鍵は、SFTPサーバーで認証されている必要があります。
      この鍵はPEMエンコード形式でなければならない。その他の形式（PuTTY秘密鍵など）はサポートされていません。
      例PEMエンコードされた鍵は通常、人間が読むことができる。
      —–BEGIN RSA PRIVATE KEY—–
      a1b2c3d4…
      —–END RSA PRIVATE KEY—– 通常、鍵はこのようになる(RSA鍵の開始行と終了行を含む)。
11. 暗号化SSH鍵で認証する場合は、鍵に関連付けられたユーザー名、暗号化SSH鍵、パスフレーズを入力します。
12. 完了したら、アカウントの接続をクリックします。

個人ユーザーとしてのアカウントの追加

このセクションの手順に従って、個人用の SFTP アカウントを追加します。接続したアカウントは、あなただけが使用できます。

1. 使用するアカウントを選択するステップまでは、「SFTPファイルからのデータ抽出タスクの設定」セクションのフォローアップ手順に従います。
2. ユーザーアカウントの追加をクリックします。
   
3. アカウント接続の詳細については、上記の「ブランド管理者としてアカウントを追加する」サブセクションの指示に従ってください。個人ユーザーとしてアカウントを追加する場合も、同じ認証オプションと設定が利用できます。

接続のテスト

アカウントを追加したら、Sftp ファイルからデータを抽出するタスクで接続をテストできます。タスクの下部で、Test connectionをクリックする。これは小さなテストファイルをサーバーにアップロードし、その内容を読み込んでからファイルを削除する。 

公開SSH鍵のダウンロード

クアルトリクスが生成したSSHキーを使用している場合は、接続用の公開キーをダウンロードできます。使用する SFTP アカウントのリストを表示したら、アカウントの右側にある 3 つのドット メニューをクリックし、「Download public SSH key」を選択します。これで鍵が.pemファイルとしてあなたのコンピュータにダウンロードされます。

クアルトリクスが生成したSSHキーの更新

クアルトリクスが生成したSSHキーを使用している場合、必要に応じてキーを再生成することができます。これは、鍵が漏洩していると思われる場合や、会社で一定期間経過後に鍵のローテーションを義務付けられている場合に有効である。

1. 使用する SFTP アカウントのリストを表示したら、アカウントの右側にある 3 つのドット メニューをクリックし、「Edit account（アカウントの編集）」をクリックします。
2. ハイパーリンクをクリックして、新しいキーペアを生成します。
   

SFTPファイルからのデータ抽出」タスクのトラブルシューティング

このタスクでファイルを処理するためのベストプラクティス、制限、トラブルシューティングのアドバイスを紹介します：

• ファイルサイズの制限： SFTPファイルからのデータ抽出タスクには、1回の実行につき200ファイルの制限があり、各ファイルには5GBのファイルサイズ制限があり、すべてのファイルの合計ファイルサイズ制限は10GBです。ファイルがこれらの制限を超えた場合、タスクは失敗し、どのファイルも処理されない。
• ヘッダーが必要です：ファイルの処理には1行のヘッダーが必要です。ファイルにヘッダー行がない場合、そのファイルは無効とみなされる。
• タスク失敗の原因となるファイル 複数のファイルを抽出しようとして、そのうちの1つがタスクの失敗の原因となる場合、ワークフローがそのファイルを再度処理しようとして失敗するのを防ぐために、ファイルを変更する必要があります。たとえば、ファイルをSftpの別のディレクトリに移動したり、削除したり、ファイルの接頭辞を別のものに変更したりできます。
• エスケープされた引用符：CSVファイルのエスケープ引用符：CSVファイルのエスケープ引用符は、逆スラッシュ( ˶´⚰`˵ )は無効です。必ずストレートクォーテーション（“”）を使用してください。タイポグラフィ引用符 (” “) は使用しないでください。
• 改行：改行：キャリッジ・リターン（改行コード）のみの改行コードを持つファイルを使用している場合、改行コードに置き換えられます。
• UTF-8エンコードCSV：CSVを使用している場合、このタスクでサポートされているファイルエンコーディング形式はUTF-8のみです。表計算ソフトによっては、UTF-8とは異なるUnicode UTF-8として保存するものもあり、予期せぬエラーが発生する場合があります。UnicodeのUTF-8ではなく、UTF-8形式でエクスポートしていることを確認してください。

SFTP接続のトラブルシューティングについては、SFTPトラブルシューティングを参照してください。

Sftpファイルからのデータ抽出タスクの設定

1. ETLワークフローを作成する。
2. データソース（ETL抽出器）を選択します。
   
3. SFTP ファイルからデータを抽出するタスクを選択します。
   
4. ファイルを抽出する SFTP アカウントを選択します。ブランド管理者が追加したアカウントや、あなた自身が追加したアカウントは、ここにリストアップされます。
   
5. 新しい SFTP アカウント認証情報を追加する場合は、「Add a user account (ユーザアカウントの追加)」をクリックし、「connect an SFTP account (SFTP アカウントの接続)」セクションの手順に従ってください。
6. 次へをクリックします。
7. ファイル名のパターンを入力します。これは、ファイルの接頭辞を見て、処理するファイルを特定するために使用します。指定した接頭辞を持つすべてのファイルが処理されます。希望の接頭辞をボックスに入力します。プレフィックスの最後にアスタリスク（*）を付ける必要はない。
   
   例例えば、クアルトリクス-DataImport.csvというファイルがあるとします。処理したいファイルがサーバー内にあるかどうかによって、接頭辞として「Q」または「クアルトリクス」を入力することができる。
   Qtip:ファイル名パターンに正規表現を使用する場合は、正規表現を使用するチェックボックスをクリックしてください。
8. Pickupディレクトリまたはサーバー上のファイルを探すディレクトリパスを入力します。相対パスでも絶対パスでも入力できます。
   Qtip:このディレクトリパスは大文字と小文字を区別し、既存のフォルダを指していなければワークフローは失敗します。クアルトリクスは、ピックアップディレクトリで指定されたディレクトリよりも上位のディレクトリにあるファイルにはアクセスできません。

   例入力したパスによって、ピックアップ・ディレクトリの候補は以下のようになる：

   • /ホーム/ユーザー名/マイフォルダ（絶対パス）
   • myFolder (相対パス)
9. ファイル名パターンに正規表現を使用する場合は、正規表現を使用するチェックボックスをクリックします。
   ヒント: 指定された正規表現にマッチするファイルのみが抽出されます。RE2正規表現構文を使用してください。
10. ファイルが圧縮されている場合は、Are you extracting from a zip fileオプションを有効にしてください。次に、zipファイルからインポートする正しいファイルを見つけるために使用されるzip内のファイルのプレフィックスを入力します。
    Qtip:.zip圧縮のみがサポートされています。.zipファイル内のファイルは暗号化できますが、.zipファイル自体は暗号化できません（例えば、filename.csv.pgp.zipはサポートされていますが、filename.csv.zip.pgpはサポートされていません）。
11. 必要であれば、Is unschematized fileを選択する。
    

    ヒント：標準的な書式に従っていないファイルは、「非図式化」とみなされます。例：

    • ファイルはサポートされていないファイルタイプです（サポートされているファイルタイプについては手順15を参照してください）。
    • ファイルにヘッダーがありません。
    • ファイルにはその他のフォーマットエラーがあります。
    ヒント：“Is unschematized file “を選択すると、ファイルタイプ、デリミター、サンプルファイルの設定が削除されます。
12. 必要に応じて、PGPを使用してインポートする前にファイルを復号化するを選択します。この暗号化とデータ保護の追加手段について詳細を見るには、PGP暗号化をご覧ください。
    qtip:インポートするファイルがクアルトリクスの公開鍵で暗号化されていることを確認してから、Sftpサーバーにアップロードしてください。そのためには、ITチームに相談する必要があるかもしれません。
13. 処理できないファイルをスキップしたい場合は、Skip bad filesを選択してください。このオプションが選択されていない場合、ワークフロー全体が不良ファイルを処理しようとして失敗します。
    Qtip:「不良ファイルをスキップ」は、最大ファイルサイズを超えるファイルや、何らかの方法で破損しているファイルなど、開くことができないファイルは処理しません。この設定により、ワークフローが失敗する可能性は低くなりますが、不正なヘッダーやフォーマットなど、開くことができるファイルで発生する可能性のある問題はアカウントされません。
14. データを会話形式にするかどうかを設定し、チャットかEメールかを設定します。詳細については、SFTPから会話データを抽出するを参照してください。
    ヒント：タスクを会話データに設定すると、ファイルタイプと区切り文字の設定が削除されます。
15. ファイルタイプを選択します。
    
    オプションは以下の通りです：CSV、TSV、JSON、またはExcel（.xlsxまたは.xls）。
    注意Excelファイルタイプが選択された場合、タスクはドキュメントの最初のタブのみを読み込む。また、.xlsxファイルは1ギガバイト以下、.xlsファイルは5メガバイト以下でなければなりません。

    Qtip:JSONファイルは、その内容を角括弧[]で囲む必要があります。例：

    [
      {
          "fruit": "Apple",
          "size": "Large",
          "color": "Red"
      }
    ].

    注意BOMのないUTF-8ファイルのみ使用可能です。カラムヘッダには通常のスペース（改行しないスペース）を使用する。区切りのないスペースは同じように見えるが、マッチングに失敗する。エクセルのエクスポートでは、しばしば区切りのないスペースが作成されます。
16. CSV を処理する場合は、ファイルの区切り文字を選択します。オプションには、コンマ、セミコロン、タブ、パイプがあります。
17. ファイル処理後の処理を選択します。オプションは次のとおりです。
    • 処理したファイルを削除します：処理後、クアルトリクスはSftpサーバーからファイルを削除します。このオプションはデフォルトで有効になっています。
      Qtip:複数のワークフローが同じファイルにアクセスしている場合でも、これは同じであることを覚えておいてください。つまり、あるワークフローがファイルを削除し、別のワークフローが同じロジッ クで実行しようとすると、そのファイルはすでに SFTP から削除されており、追加 のワークフローでは処理されません。
    • 処理したファイルを別のディレクトリに移動します：このオプションを選択すると、処理されたファイルを保存する別のフォルダのURLを記述するフィールドが表示されます。
    • 処理したファイルを保持します：処理後、クアルトリクスはファイルをSftpサーバーに残します。
    注意Sftpサーバーが、タッチ後にファイルを自動的に削除または移動するように設定されている場合、選択した後処理オプションが意図したとおりに機能しないことがあります。
18. 厳密な検証を使用するかどうかを決定します。厳密な検証を使用すると、特定のフォーマットに問題がある場合、抽出されたファイルは自動的に拒否されます。どのファイルが拒否されるかについての詳細はタスクのメッセージを読んでください。
    
    Qtip:ファイルをアップロードし、書式に問題のある行を除外するには、不正な行をスキップするを有効にします。
19. Skip malformed rowsを有効にしてファイルをアップロードし、書式に問題のある行を除外します。
20. Choose fileをクリックし、サンプルファイルをアップロードします。これにより、インポートしたいフィールドがクアルトリクスに伝えられ、このタスクで使用できる後続タスクが決まります。アップロードするファイルには、このタスクの一部としてインポートするフィールドを含める必要があります。
    
    Qtip:タスクのサンプルファイルをダウンロードするか、サンプルファイルのセクションにあるファイルをダウンロードして、ユースケースに基づいたデータ構造のテンプレートをご覧ください。
21. ファイルが正しくデータをインポートしていることを再確認してください。設定を変更する必要がある場合は、タスクの一番上にある「戻る」をクリックする。
    

    Qtip:全てのデータが1つの列としてインポートされる場合、間違った区切り文字を使用しています。以下のスクリーンショットは、タスクウインドウでどのように見えるかを示している。

    

22. データが正しければ、Saveをクリックします。
23. ETLワークフローの構築を完了します。ローダータスクを選択するとき、抽出したデータの行き先を決めることになる。オプションのリストについては、利用可能なローダータスクを参照のこと。
    

ファイル例

以下は、インポートしたいデータの種類に応じた、インポートするためのデータ構造の例です。サンプルファイルをダウンロードするには、ファイル名をクリックしてください。

• 従業員データ
• アカウントデータ
• コンタクトデータ
• アンケート調査回答データ
• ユーザーデータ
• セールスフォースアカウントチームメンバーデータ
• チャットの会話データ
• メールの会話データ

SFTPファイルから会話データを抽出する

会話データとは、チャットやEメールからのデータである。例えば、顧客やサポートとのやり取りの記録があれば、それは会話データとなる。このような情報には、充実した自由形式のフィードバックが含まれるだけでなく、顧客に最も適したサービスを提供する方法について、顧客担当者を指導する機会を提供することもできます。データがサーバーからクアルトリクスに移動された後は、オムニチャネルリスニング機能を使って、このような会話分析を行うことができます。

会話データのフォーマット

会話データは文書形式でなければならない。例えば、書き起こされたチャットのトランスクリプトは、会話分析に使用するためにクアルトリクスに移動することができます。しかし、オーディオファイルはそうはいかない。

ファイルはスプレッドシート形式であること（下記のサポートされるファイル形式を参照）。ファイルのすべての行は別々のレコードでなければならず、すべての列は同じレコード内の別のフィールド、または項目でなければならない。サンプル・ファイルにはヘッダーが必要です。

SFTPファイルから会話データを抽出する

以下では、クアルトリクスで分析できるように、SFTPから会話データを引き出す方法の概要を説明します：

1. 以下の手順に従って、オムニチャネル・リスニング・プログラムを開始しましょう。
2. ワークフローを作成し SFTPファイルからのデータ抽出 タスクがある。
3. 必要に応じてファイルパスを設定する。
   
4. 必要なファイルのインポート設定を選択します。
   注意未修正のファイルは会話データと互換性がありません。そうでなければ、他のすべてのファイルインポート設定は互換性があります。
5. この会話データを選択する必要がある。
6. 以下のいずれかを選択する：
   • チャット：データは一連のオンラインチャットとしてフォーマットされている。これらは自動化されたエージェントと人間のエージェントのどちらでも可能だ。
   • 電子メール：データは一連の電子メールとしてフォーマットされます。
     ヒント:チャットかEメールのどちらを選択するかによって、データをチャットプロジェクトにロードするかEメールプロジェクトにロードするかが決まります。
7. 必要に応じて後処理を設定する。
8. 必要に応じて検証を設定する。
   
9. サンプルファイルをアップロードする場合は、私たちのサンプルファイルのいずれかを使用することをお勧めします。
10. タスクを完了する。
11. あとは、チャットかEメールのプロジェクトにデータをロードするだけです。手順はリンク先のページを参照。
    
12. 会話データの分析とレポートの方法については、オムニチャネルリスニングマネージャーのページをご覧ください。

よくある質問