回答のインポートとエクスポートの自動化
回答のインポートとエクスポートの自動化について
回答の自動化を使用すると、定期的にクアルトリクスからデータを自動的にエクスポートしたり、定期的にクアルトリクスにデータをインポートしたりできます。対応の自動化により、独自の自動化ジョブを作成、設定、更新、テスト、およびレビューすることができます。応答は Secure File Transfer Protocol (SFTP) を介して提供されます。これは、クアルトリクスとSFTPサーバーが相互に応答を渡すためのリンクを確立することを意味します。
回答のエクスポートの自動化の設定
回答のエクスポートの自動化は、クアルトリクスから回答を自動的にエクスポートし、SFTPサーバーに送信します。回答をエクスポートする頻度とエクスポートするデータを選択できます。
ヒント:SFTP接続を設定する場合、ITチームがクアルトリクスのIP範囲を許可リストに追加することをお勧めします。
- アンケートの[データと分析]タブの[データ]セクションを開いていることを確認します。
- [エクスポート; インポート] をクリックします。(&U)
- 回答の自動化をエクスポートを選択します。
注意: 応答のエクスポートの自動化の最大ファイルサイズは 500 MB に制限されています。回答の合計数がこのファイルのサイズ制限を超えると、エクスポートは処理されず、「ファイルがサイズ制限を超えています」というエラーメッセージが表示されます。この制限に達した場合は、エクスポートフィルタを使用して、エクスポートするデータのサイズを減らしてください。
- 作成をクリックします。
- [SFTP 設定] の横にある [開始] をクリックします。
- サーバのホスト名を入力します。これは SFTP サーバの URL です。
ヒント:URLは通常、sftp.example.com に似ています。 - サーバのポートを入力します。(通常はQ1です)
- クアルトリクスがに認証できるように、SFTPサーバーで設定したユーザーのユーザー名を入力します。
ヒント:クアルトリクス専用の一意の認証情報セットを作成することをお勧めします。
- ユーザのパスワードを入力します。
- ファイル名の先頭に追加する接頭辞を入力します。
ヒント:ファイルがエクスポートされたときのタイムスタンプは、YYYY-MM-DD_hhmmssSSS 形式のファイル名の末尾に自動的に追加されます。たとえば、2020 年 1 月 1 日の午前 8 時にエクスポートされたファイルには、ファイル名に “2020-01-01_080000000” が追加されます。例:SFTPサーバーでアンケートのデータファイルを簡単に識別できるように、アンケート名を前置記号として付けることができます。
- SFTP サーバでファイルが配置されるディレクトリパスを入力します。例:Central Folder/Survey Responses 2020。
ヒント:このディレクトリパスでは大文字と小文字が区別されます。これは既存のフォルダである必要があり、そうでないと自動化は失敗します。フォルダのパスも SFTP サーバのデフォルトディレクトリに対する相対パスにする必要があります。
- 必要に応じて、PGP を使用してファイルを暗号化を選択します。この追加の暗号化方法およびデータ保護の詳細については、PGP 暗号化を参照してください。
- [保存]をクリックします。
- スケジュール設定の横にある開始をクリックします。
- 自動化を実行する頻度を選択します。日次、週次、または月次を選択することができます。
ヒント:[毎週]または[毎月]を選択すると、2番目のオプションが表示され、それぞれ自動化が実行される曜日または日を選択できます。 - 自動化を実行する時刻を選択します。
ヒント:タイムゾーンを確認してください。これは、ユーザ設定のアカウントのタイムゾーンと同じになります。
- [保存]をクリックします。
- エクスポートオプションの横にある編集をクリックします。
- 必要に応じて、エクスポートされるデータにフィルタを追加します。以前に保存したフィルターのいずれかをアンケート用に選択できます。
警告:回答のエクスポートの自動化は、前回の自動化実行以降に新たに記録された回答をすべてエクスポートするように設計されています。この自動化に追加されたフィルターは、前回の自動化実行以降に新たに記録された回答にのみ適用されます。この動作のため、時間フィールド (開始日、終了日、記録日など) でフィルタリングするフィルタは使用しないでください。エクスポートしたデータセットには、期待する回答が含まれていない可能性があるためです。 - エクスポートされたファイルのファイル形式を選択します。CSV、TSV、SPSS、JSON、NDJSON、XMLのいずれかを選択できます
- 基本設定に基づいて追加のエクスポートオプションを有効化します。これには次のようなものがあります。
- 回答の選択肢の識別値をエクスポートするのではなく、回答の選択肢のテキストをエクスポートします。このオプションでは、回答の選択肢の識別値ではなく、選択した回答の選択肢のテキストとしてデータがエクスポートされます。
- エクスポートに表示順序情報を含めます。ランダム化を使用したアンケートに有用:このオプションには、回答者がランダム化された質問を見た順序に関する追加情報がデータエクスポートに含まれます。このデータの解釈については、こちらのサポートページを参照してください。
- 複数値フィールドの列への分割: 特定の質問タイプでは、1 つの質問に対して複数の回答選択肢を選択できます。このオプションは、選択されたすべての回答を1つの列にまとめるのではなく、質問に対する可能な回答をそれぞれ一意の列に分割します。
- ピリオドではなくカンマを小数点として使用します。このオプションを使用すると、数値の小数点としてカンマを使用できます。
注意: このオプションを有効にする場合は、ファイルを CSV としてエクスポートしないでください。
- この値をエクスポートの改行区切り文字として使用します。このオプションはほとんど必要ありません。エクスポートされるデータファイルで改行文字として機能する特定の文字を指定できます。改行文字は、テキストの新規行が開始されたことを示します。通常は、キーボードの Enter キーまたは Return キーを押して新しい段落を開始します。
- [閲覧のみで回答がなかった質問に識別値を割り当て]:このオプションを使用すると、回答者が見たが回答しない質問に、数値を割り当てることができます。通常の設定では、データファイル内の未回答の質問は空です。これは、未回答の質問と回答者に表示されなかった質問を区別するのに役立ちます
- 閲覧のみで回答済みの質問に識別値を割り当て:このオプションは、[閲覧のみで回答済みの質問にこの値を割り当て]オプションに似ています。このオプションを有効化する必要があるのは、複数値項目の列への分割も選択されている場合のみです。
- 保存をクリックします。
- 通知設定の横にある編集をクリックします。
-
自動化が完了したら、電子メールを受信する電子メールアドレスを入力します。
ヒント:通知の設定時に、ブランドに接続されているメールにのみ通知できます。
- 自動化に名前を付けます。
- 自動化を有効にして、実行を開始します。
- [閉じる] をクリックします。
回答のインポートの自動化の設定
回答のインポートの自動化は、定期的にSFTPサーバーからクアルトリクスにデータをインポートするために使用されます。
ヒント:SFTP接続を設定する場合、ITチームがクアルトリクスのIP範囲を許可リストに追加することをお勧めします。
- アンケートの[データと分析]タブの[データ]セクションを開いていることを確認します。
- [エクスポート; インポート] をクリックします。(&U)
- [回答の自動化をインポート]を選択します。
注意: 応答のインポートの自動化では、実行ごとに最大 200 ファイルをインポートできます。各個別ファイルのファイルサイズ制限は 100 MB、ファイルサイズの合計は 2 GB です。各ファイルには、最大 200 列を含めることができます。この制限を超えると、「インポートしようとしているファイルが、サポートされている最大サイズを超えています」、「%d 一致ファイルの合計サイズが最大サイズ (%dMB) を超えています」、「ディレクトリのプレフィクス %s に一致するファイルが多すぎます」、または「列 %d へのマッピングを作成できませんでした」というエラーメッセージが表示されます。
- [SFTP 設定] の横にある [開始] をクリックします。
- サーバのホスト名を入力します。これは SFTP サーバの URL です。
ヒント:URLは通常、sftp.example.com に似ています。 - サーバのポートを入力します。
- クアルトリクスがに認証できるように、SFTPサーバーで設定したユーザーのユーザー名を入力します。
ヒント:クアルトリクス専用の一意の認証情報セットを作成することをお勧めします。
- ユーザのパスワードを入力します。
- クアルトリクスによってインポートされるファイルを識別するプレフィックスを入力します。
例:SFTPサーバーには多くのファイルを含めることができるため、Qualtricsへのアンケートデータファイルのインポートのみを行います。インポート対象の各ファイル名の先頭に「Qualtrics」を追加し、自動化の設定時にそれを接頭辞として入力することを決定します。たとえば、1つのファイル名を「Qualtrics_Survey2_Data」とします。ファイルの接頭辞がここで入力した接頭辞と一致するため、このファイルがインポートされます。インポートされるファイルには注意してください。指定された接頭辞が付いたピックアップディレクトリのすべてのファイルがインポートされます。
- ピックアップディレクトリ、または SFTP サーバ上のファイルの場所となるディレクトリパス (Central Folder/Survey Responses 2020 など) を入力します。
ヒント:このディレクトリパスでは大文字と小文字が区別されます。これは既存のフォルダである必要があり、そうでないと自動化は失敗します。フォルダのパスも SFTP サーバのデフォルトディレクトリに対する相対パスにする必要があります。
- 必要に応じて、PGP を使用してインポートする前に Decrypt files を選択します。この追加の暗号化方法およびデータ保護の詳細については、PGP 暗号化を参照してください。
ヒント:インポートするファイルをSFTPサーバーにアップロードする前に、インポートするファイルがクアルトリクスの公開鍵で暗号化されていることを確認してください。そのためには、IT チームに問い合わせる必要がある場合があります。
- [保存]をクリックします。
- スケジュール設定の横にある開始をクリックします。
- 自動化を実行する頻度を選択します。日次、週次、または月次を選択することができます。
- 週次または月次を選択した場合は、自動化を実行する曜日または日付も選択する必要があります。
- 自動化を実行する時刻を選択します。
ヒント:タイムゾーンはアカウントのタイムゾーンに基づきます。タイムゾーンはアカウント設定で変更できます。
- [保存]をクリックします。
- 回答マッピングの横にある[開始]をクリックします。
- このステップでは、自動化によってインポートされるファイルのヘッダと書式が同じであるサンプルファイルをアップロードする必要があります。[参照] をクリックしてファイルを選択します。
ヒント:サンプルファイルの作成についてサポートが必要ですか?アンケートからデータをエクスポートし(最初に1つ以上のテスト回答を生成してください)、エクスポートされたファイルをサンプルファイルとして使用できます。 - ファイルの区切り文字を選択します。CSVファイルを使用する場合はカンマを、TSVファイルを使用している場合はタブを選択します。
- アップロードをクリックします。
- ファイルのフィールドをアンケートのフィールドにマッピングします。インポート用の回答のマッピングの詳細については、「インポートの設定」を参照してください。
ヒント:ファイルのインポートで問題が発生した場合は、「CSV/TSVのアップロードの問題」ページを参照してください。 - [設定の保存] をクリックします。
- [通知設定] の横にある [編集] をクリックします。
-
自動化が完了したら、電子メールを受信する電子メールアドレスを入力します。
- 自動化に名前を付けます。
- 自動化を有効にします。有効化すると、スケジュールされた設定に従って自動化が実行されます。
- [閉じる] をクリックします。
回答マッピング設定の再利用
応答マッピングの設定を保存して再利用し、将来の自動化をすばやく設定することができます。これは、類似している複数の調査を実行している場合、または同じ調査をコピーして複数回使用する場合に特に役立ちます。
既存の自動化
自動化の一時停止と削除
自動化の実行履歴の表示
自動化の実行履歴には、自動化が実行されるたびの情報が含まれます。特定の自動化実行を表示して、その詳細を確認することができます。
各自動化実行の名前、ステータス、および完了時刻に関する情報と、実行に関する詳細情報を表示する機能を含むテーブル
が表示されます。
- 自動化名: 完了した自動化の名前です。
- ステータス: 自動化のステータスを示します。含まれる値
- 完了: 自動化が完了しました。
- 失敗: 自動化を実行しようとしましたが、失敗し、完了できませんでした。
- タイムアウト: 自動化がタイムアウトしました。これは、クアルトリクスサーバーがサーバーから応答を受信しなかったことを意味することがよくあります。タイムアウトした自動化は、5 分ごとに試行ごとに 5 回再試行されます。再試行後も自動化がタイムアウトし続ける場合、自動化は失敗します。
- 完了時刻: 自動化が完了した日時です。
個別のエントリ
で表示をクリックすると、その自動化実行に関する詳細情報が表示されます。
このウィンドウには、完了までにかかった時間、エクスポートされた回答の数、エクスポートされたファイルの名前、自動化の確認メールを受信した人など、実行に関するさまざまな情報が表示されます。
自動化が失敗したりタイムアウトしたりした場合、このウィンドウは、自動化を完了できなかった理由のトラブルシューティングに特に役立ちます。
回答のインポートと自動化のエクスポートのトラブルシューティング
自動化が失敗
した場合、最初に自動化の実行履歴を参照し、自動化が失敗した理由を説明する特定のエラーメッセージがあるかどうかを確認します。自動化を正常に実行する際に問題が発生した場合は、以下を試してください。
- 入力した SFTP サーバの URL が有効な SFTP ホストであり、指定されたポートで到達できることを確認してください。
- ユーザ名とパスワードの認証情報が有効であることを確認してください。
- SFTPサーバーがファイアウォールの背後にないこと、または適切なクアルトリクスIPアドレスが許可リストに登録されていることを確認してください。
ヒント:アカウントがFedRAMP環境内にある場合、許可リスト登録用のIPアドレスはリンク先のページにあるアドレスとは異なります。IPアドレス情報に安全にアクセスするには、FedRAMPカスタマーサクセスハブにログインしてください。
- SFTPサーバーが、クアルトリクスがサポートする暗号化方式のいずれかを使用するよう構成されていることを確認してください。クアルトリクスがサポートしている暗号を参照してください。
- QualtricsがSFTPサーバーでコマンドを実行できることを確認してください。特に、Qualtrics用に設定したSFTPユーザーは、SFTPサーバーでcpとlsの権限を持っている必要があります。
- その他のヒントについては、SFTP のトラブルシューティングを参照してください。
この手順を実行しても自動化に問題
がある場合は、クアルトリクスサポートにお問い合わせください。
さまざまなプロジェクトタイプでの対応の自動化
回答のインポートとエクスポートの自動化は、いくつかの異なるタイプのプロジェクトで使用できます。このページで説明する手順およびオプションは、以下のプロジェクトの種類に適用されます。
これらの自動化はコンジョイントおよびMaxDiffプロジェクトで技術的に設定できますが、これはお勧めしません。コンジョイントとMaxDiff固有のデータをインポートすることはできません。デモグラフィックやスクリーンなどの追加のアンケートの質問のみをインポートできます。
インポートされたデータプロジェクトは回答の自動化と互換性がありません。