SFTP ファイルからのデータ抽出タスク
SFTP ファイルからのデータ抽出タスクについて
[SFTPファイルからデータを抽出]タスクを使用すると、SFTPサーバーからデータをインポートして、クアルトリクスで使用できます。このタスクを[XM Directoryにデータをロード]タスクなどの他のタスクと組み合わせて、アカウント管理コマンドセンターやクアルトリクスの他の場所にデータをインポートできます。
SFTP アカウントの接続
[SFTPファイルからデータを抽出]タスクを使用する前に、クアルトリクスのSFTPアカウントに接続してからデータを抽出する必要があります。アカウントは、ブランド内の他のユーザーが使用するためにブランド管理者が追加することも、個人的に使用するために個々のユーザーが追加することもできます。
以下の 3 つの異なる認証オプションがあります。
- パスワード: ユーザ名とパスワードで認証します。
- SSH キー: 指定したセキュアシェル (SSH) キー、または Qualtrics によって提供されるキーを使用して認証します。
- 暗号化された SSH キー: 暗号化された SSH キーを使用して認証します。
ヒント:SFTP接続を設定する場合、ITチームがクアルトリクスのIP範囲を許可リストに追加することをお勧めします。
ブランド管理者としてのアカウントの追加
ブランド管理者の場合、このセクションのステップに従って、ライセンスの一部またはすべてのユーザーが使用する SFTPアカウントを追加します。
- 左上のナビゲーションメニューを使用して、管理に移動します。
- Extensions に移動します。
- [SFTP ファイルからデータを抽出] 拡張子をクリックします。
- [アカウントを追加]をクリックします。
- アカウントに名前を付けます。この名称は組織的な目的で使用され、顧客を識別するために使用されます。
- 関連する SFTP サーバのホスト名を入力します。
例: 通常、これらは sftp.example.com の形式です。
- ポート番号を入力します。(通常はQ1です)
- 認証方法を選択します。オプションは次のとおりです。
- パスワード: 認証用のユーザ名とパスワードを指定します。
- SSHキー:認証用のユーザー名とSSHキーを入力するか、クアルトリクスが生成したSSHキーを使用します。
- 暗号化された SSH キー: 認証用のパスフレーズを含む独自の暗号化 SSH キーを指定します。
- パスワードを選択した場合は、SFTP アカウントのユーザ名とパスワードを入力します。
- SSH キーで認証する場合は、
のいずれかを実行します。- クアルトリクスによって生成されたSSHキーを使用する場合は、[ユーザー名]を入力し、[SSHキーペアを生成]をクリックします。
公開鍵 SSH キーのダウンロードをクリックして、公開鍵を .pem ファイルとしてコンピュータにダウンロードすることができます。関連する秘密鍵は Qualtrics によって保存されます。クリップボードにコピーをクリックして、キーのフィンガープリントをクリップボードにコピーします。これらの両方を安全な場所に保存し、必要に応じて参照できるようにします。 - 独自の SSH キーを使用する場合は、秘密鍵を提供をクリックします。
次に、ユーザ名および SSH キーを入力します。ヒント:このボックスには、パスワードで保護されていない秘密鍵を入力する必要があります。さらに、SFTP サーバで公開鍵を認証する必要があります。例:
SSH キーは、通常 (RSA キー行の開始および終了を含む) のようになります:
—–BEGIN RSA PRIVATE KEY—–
a1b2c3d4…
—–END RSA PRIVATE KEY—–
- クアルトリクスによって生成されたSSHキーを使用する場合は、[ユーザー名]を入力し、[SSHキーペアを生成]をクリックします。
- 暗号化された SSH キーで認証する場合は、ユーザ名、暗号化された SSH キー、およびキーに関連付けられたパスフレーズを入力します。
- 終了したら、[アカウントを接続]をクリックします。
個人ユーザとしてのアカウントの追加
このセクションの手順に従って、個人用の SFTP アカウントを追加します。接続したアカウントを使用できるのは自分だけです。
- SFTP ファイルからのデータ抽出の設定タスクセクションのステップに従って、使用するアカウントを選択するステップに進みます。
- [ユーザーアカウントの追加] をクリックします。
- アカウントの接続に関する詳細については、上記の「ブランド管理者としてのアカウントの追加」サブセクションの指示に従ってください。アカウントを個別ユーザとして追加するときに、同じ認証オプションおよび設定を使用できます。
公開 SSH キーのダウンロード
Qualtrics によって生成された SSH キーを使用している場合は、接続の公開鍵をダウンロードできます。使用する SFTP アカウントのリストを表示する場合は、アカウントの右側にある 3 つのドットのメニューをクリックし、公開 SSH キーのダウンロードを選択します。これにより、キーがコンピュータに .pem ファイルとしてダウンロードされます。
クアルトリクス生成SSHキーを更新しています
クアルトリクスによって生成されたSSHキーを使用している場合は、必要に応じてキーを再生成できます。これは、キーが改ざんされていると思われる場合や、会社が一定の時間後にキーを回転させる必要がある場合に役立ちます。
- 使用する SFTP アカウントのリストを表示するときに、アカウントの右側にある 3 つのドットのメニューをクリックし、[アカウントの編集] をクリックします。
- ハイパーリンクをクリックして、新しいキーペアを生成します。
SFTP ファイルからデータを抽出タスクの設定
- 左上のナビゲーションメニューをクリックします。
- ワークフローを選択します。
- [ワークフローを作成] をクリックします。
- 特定の時刻に開始を選択します。
- 必要に応じて、上部にあるワークフロー名をクリックしてワークフロー名を変更します。
- スケジュールされたワークフローが起動されるタイミングを決定します。スケジュール済ワークフローの設定の詳細については、スケジュール済ワークフローを参照してください。
- プラス記号 ( + ) をクリックし、 タスク を選択します。
- SFTP ファイルからデータを抽出タスクを選択します。
- ファイルを抽出する SFTP アカウントを選択します。ブランド管理者が追加したすべてのアカウント、および自分が追加したアカウントがここに表示されます。
- 新しい SFTP アカウント認証情報を追加する場合は、[新しいアカウントを追加]をクリックし、SFTP アカウントの接続セクションの手順に従います。
- [次へ] をクリックします。
- ファイル名パターンを入力します。このパターンは、ファイルの接頭辞を確認することで、処理するファイルを識別するために使用されます。指定した接頭辞のファイルがすべて処理されます。該当する接頭辞をボックスに入力します。
例:Qualtrics-DataImport.csv というファイルがあるとします。処理したいファイルがサーバーにあるかどうかに応じて[Q]または[Qualtrics]をプレフィックスとして入力できます - ピックアップディレクトリまたはディレクトリパスを入力して、サーバ上のファイルを検索します。相対パスまたは絶対パスのいずれかを入力することができます。
ヒント:このディレクトリパスは大文字と小文字が区別され、既存のフォルダーを指す必要があります。指定しないとワークフローが失敗します。クアルトリクスは、ピックアップディレクトリで指定されたディレクトリよりも上位レベルのディレクトリにあるファイルにアクセスすることはできません。
例: 入力するパスに応じて、ピックアップディレクトリは以下のようになります。
- /home/username/myFolder (絶対パス)
- myFolder (相対パス)
- 処理する SFTP ファイルの区切り文字を選択します。オプションには、カンマ、セミコロン、タブ、およびパイプがあります。
- 必要に応じて、PGP を使用してインポートする前に Decrypt files を選択します。この追加の暗号化方法およびデータ保護の詳細については、PGP 暗号化を参照してください。
ヒント:インポートするファイルをSFTPサーバーにアップロードする前に、インポートするファイルがクアルトリクスの公開鍵で暗号化されていることを確認してください。そのためには、IT チームに問い合わせる必要がある場合があります。
- ファイルが処理された後の処理を選択します。オプションは次のとおりです。
- 処理済みのファイルを削除:ファイルの処理後、QualtricsはSFTPサーバーからファイルを削除します。このオプションはデフォルトで有効になっています。
- 処理済みファイルを保持:ファイルの処理後、QualtricsはSFTPサーバーにファイルを残します。
- [ファイルを選択]をクリックしてサンプルファイルをアップロードします。これにより、インポートするフィールドがクアルトリクスに通知され、このタスクで使用できる後続タスクが決定されます。アップロードするファイルには、このタスクの一部としてインポートする項目が含まれている必要があります。
ヒント:タスクのサンプルファイルをダウンロードするか、使用ケースに基づいてデータを構成する方法のテンプレートの[サンプルファイル]セクションのファイルをダウンロードします。サポートされているファイルエンコーディング形式は UTF-8 のみです。一部のスプレッドシートソフトウェアでは、予期しないエラーが発生すると、UTF-8 とは異なる Unicode UTF-8 として保存されます。Unicode UTF-8 ではなく UTF-8 形式でエクスポートしていることを確認してください。
- アップロードをクリックします。
- ファイルがデータを正しくインポートしていることを再確認します。設定を変更する必要がある場合は、タスクの上部にある前画面をクリックします。
- データが正しい場合は、保存をクリックします。
- プラス記号( + )をクリックし、[タスク]を選択して、SFTPデータ抽出に続くタスクを設定します。これはデータローダタスクである必要があります。オプションの一覧については、利用可能なローダタスクを参照してください。
サンプルファイル
以下は、インポートするデータのタイプに応じて、インポート用にデータを構造化する方法のサンプルファイルです。ファイル名をクリックして、サンプルファイルをダウンロードします。