Google ドライブタスクからデータを抽出
Google ドライブからのデータ抽出タスクについて
Google ドライブアカウントからクアルトリクスにデータをインポートして、XM Directoryユーザー、社員、CXダッシュボードユーザーを自動的に追加するために使用できます。必要に応じて、このインポートをスケジュールベースで実行することも、1 回だけ実行することもできます。
この機能は、ワークフローおよび Google ドライブアカウントにアクセスできる Qualtrics のお客様が使用できます。
開始する前に
Google ドライブからクアルトリクスへのデータのインポートを開始する前に、次の点を考慮してください。
- Qualtricsで Google ドライブのデータをどのように処理しますか?オプションの一覧については、利用可能なローダタスクを参照してください。
- どの Google ドライブアカウントを使用しますか? クアルトリクスにインポートするファイルが、このアカウントで所有または共有されていることを確認してください。処理後にファイルを削除または移動する場合は、ファイルの所有権が必要であることに注意してください。
- インポートするファイルはどこにありますか。それらが “マイドライブ” の下だけでなく、個別のフォルダにあることを確認します。
- スケジュールに基づいて特定のファイルまたは複数のファイルをインポートしますか?1 つのファイルのみをインポートする場合は、の設定に進むことができます。それ以外の場合は、以下の点を考慮してください。
- ファイルは一貫した書式に適合していますか。たとえば、同じワークフローにインポートするファイルには、値が異なる場合でも、同じヘッダ/列/項目が必要です。
例:Google ドライブからXM Directoryに連絡先を定期的にアップロードするワークフローを設定します。すべてのファイルには、[Firstname]、[Lastname]、[Email]、[Phone]、[UniqueID]、および [Location] の列があります。
- インポートするファイルに特別な命名規則はありますか。これは必須ではありませんが、特にファイルが未処理ファイルと同じファイルに含まれている場合に、インポート対象のファイルを明確に区別する場合に推奨されます。
- 処理後のファイルの処理方法を指定してください。これは、QualtricsにすでにアップロードされているGoogleドライブファイルを特定するためだけでなく、変更がない場合に再度アップロードされないようにするためのものです。たとえば、処理されたファイル名を編集しますか。その場合は、名称に追加する接頭辞があるかどうかを検討してください。ファイルを別のフォルダに移動しますか? その場合は、必ず新しいフォルダを作成してください。
Google ドライブアカウントの接続
[Google ドライブからデータを抽出]タスクを使用するには、クアルトリクスのGoogleドライブアカウントに接続してデータを抽出する必要があります。アカウントは、ブランド内の他のユーザーが使用するためにブランド管理者が追加することも、個人的に使用するために個々のユーザーが追加することもできます。
Google ドライブからデータを抽出タスクの接続は、Google カレンダーや Google シートなどの他の Google 拡張の接続とは分離されています。
ブランド管理者としてのアカウントの追加
ブランド管理者の場合、使用するライセンスの一部またはすべてのユーザーにGoogleドライブアカウントを追加できます。
- 最初に、アプリを検索してインストールします。他の Google オプションではなく、Google ドライブからデータを抽出を選択してください。
- 次に、アカウントを追加します。
このアカウントにアクセスできるユーザの管理の
詳細については、拡張アカウントを使用できるユーザの決定を参照してください。
個別ユーザとしてのアカウントの追加
このセクションの手順に従って、個人用の Google ドライブアカウントを追加します。接続したアカウントを使用できるのは自分だけです。
- 使用するアカウントを選択するステップに進むまで、Google ドライブタスクからデータを抽出の設定の手順に従います。
- [ユーザーアカウントの追加] をクリックします。
- アカウントに名前を付けます。この名称は組織的な目的で使用され、顧客を識別するために使用されます。
- [アカウントの接続] をクリックします。
- Google アカウントにログインします。
- すると、Google の承諾画面にリダイレクトされ、Google ドライブアカウントのファイルにアクセスするために必要な権限が要約されます。説明を読み、[Allow] をクリックします。
Google ドライブタスクからデータを抽出する設定
- ETL ワークフローを作成します。
- データソース (ETL 抽出機能) を選択します。
- Google ドライブからデータを抽出を検索して選択します。
- ファイルを抽出する Google ドライブアカウントを選択します。ブランド管理者が追加したすべてのアカウント、および自分が追加したアカウントがここに表示されます。
- 新しい Google ドライブアカウント認証情報を追加する場合は、ユーザアカウント追加をクリックして、Google ドライブアカウントの接続セクションの手順に従います。
- [次へ] をクリックします。
- クアルトリクスがインポートするファイルを検索する[Google ドライブ]フォルダを選択します。フォルダを選択するには、以下の 2 つの方法があります。
- 選択したフォルダが正しいことを確認します。
ヒント:別のフォルダーを選択する場合は、[フォルダーを変更]をクリックします。 - クアルトリクスにインポートするファイルを選択します。これらのファイルを設定するには、以下の 2 つの方法があります。
- ファイル名パターンに一致するファイルのインポート: これは、スケジュールに基づいて実行するインポートに最適なオプションです。ファイル名の一部を指定することは、関連ファイルのみを識別し、フォルダ内にある可能性がある他のファイルを無視する優れた方法です。選択したフォルダに追加されたすべてのファイルがアップロードに適格である場合は、この項目を空白のままにすることもできます。ファイル名を決定したら、ファイルタイプを選択します。CSV、TSV、Googleシートの中から選択できます。
例:
定期的にコンタクトをインポートします。すべての連絡先ファイルには、プリフィックス、日付の順に「連絡先」が含まれているため、簡単に識別できます。 - 特定のファイルのインポート: ソースフォルダで特定のファイルを選択します。これは、定期的にスケジュールされたインポートではなく、1 回限りのインポートを実行する良い方法です。インポートできるのは、CSV、TSV、Googleシートファイルのみです。ファイルを名称で検索することができます。
- ファイル名パターンに一致するファイルのインポート: これは、スケジュールに基づいて実行するインポートに最適なオプションです。ファイル名の一部を指定することは、関連ファイルのみを識別し、フォルダ内にある可能性がある他のファイルを無視する優れた方法です。選択したフォルダに追加されたすべてのファイルがアップロードに適格である場合は、この項目を空白のままにすることもできます。ファイル名を決定したら、ファイルタイプを選択します。CSV、TSV、Googleシートの中から選択できます。
- インポートオプションで、この Google ドライブワークフローで処理された後のファイルの処理を決定します。いくつかのオプションがあります。
- 処理されたファイルを削除します。これがデフォルトの選択です。Qualtricsにインポートしたファイルは、Googleドライブから削除されます。
- 処理されたファイルを保持し、名前を変更します。ファイルを削除する代わりに、名称が変更されます。処理時にファイル名に追加されるファイル接頭辞を指定します。また、重複を避けるため、ファイルが処理された時刻を名称に追加します。
例: 接頭辞が “processed-” の場合、employee-data という名称のファイル名は processed-employee-data_2021-06-09_093039 に変更されます。
- 処理されたファイルを保持し、別のフォルダに移動します。処理されたファイルを別のフォルダに移動します。リンクに貼り付けるか、ドロップダウンから選択して、ソースフォルダと同じ方法で移動先フォルダを選択できます。
- 処理されたファイルを保持します。インポート後、ファイルは元のフォルダに残ります。ワークフロー実行サイクル間でそのコンテンツが更新されるか、同じファイルがすべて再度インポートされるようにしてください。
- 必要に応じて、PGP を使用してファイルを暗号化を選択します。この追加の暗号化方法およびデータ保護の詳細については、PGP 暗号化を参照してください。
- サンプルファイルのアップロードで、ワークフローが実行されるたびに処理されるファイルと同じ構造のサンプルファイルをインポートする必要があります。このサンプルファイルを設定するには、次の 2 つの方法があります。
- Google ドライブからサンプルファイルを選択: Google ドライブからサンプルファイルを直接選択します。ここには CSV、TSV、および Google シートのみが表示され、最大ファイルサイズは CSV および TSV では 100MB、Google シートでは 10 MB です。ファイル形式を提出する前に、[フィールドを照合] をクリックしてドキュメントが正しいことを確認する必要があります。
ヒント:1つの特定のファイルをアップロードしていますか?サンプルファイルに対してこのファイルを再度選択します。 - コンピューターからサンプルファイルをアップロード:コンピューターからCSVまたはTSV(最大サイズ100MB)をアップロードします。
ヒント:必要に応じて、タスクのサンプルファイルをダウンロードするか、[サンプルファイル]セクションでファイルをダウンロードできます。サポートされているファイルエンコーディング形式は UTF-8 のみです。一部のスプレッドシートでは、予期しないエラーが発生する場合に、UTF-8 とは異なる Unicode UTF-8 としてファイルが保存されます。Unicode UTF-8 ではなく UTF-8 形式でエクスポートしていることを確認してください。
- Google ドライブからサンプルファイルを選択: Google ドライブからサンプルファイルを直接選択します。ここには CSV、TSV、および Google シートのみが表示され、最大ファイルサイズは CSV および TSV では 100MB、Google シートでは 10 MB です。ファイル形式を提出する前に、[フィールドを照合] をクリックしてドキュメントが正しいことを確認する必要があります。
- ファイル内の項目を確認します。テーブルには、(個別の項目を表す) 列ヘッダと、データの最初の 2 行の値が表示されます。
- Google ドライブの設定を完了する準備ができたら、[保存]をクリックします。
- ETL ワークフローの作成を終了します。ローダタスクを選択すると、抽出したデータの宛先が決定されます。オプションの一覧については、利用可能なローダタスクを参照してください。
抽出されたデータに基づく条件
Google ドライブタスクの設定が完了したら、抽出されたデータに基づいて条件を設定できます。これにより、ワークフローの次の処理について具体的に説明することができます。
以下は、”Google ドライブからデータを抽出” タスクの後にワークフローに追加できる条件の種類の一覧です。
- インポート済ファイル数
- インポートされた行数
その後、正確な番号または範囲 (より大きい、より小さいなど) を指定することができます。たとえば、ファイルがCXディレクトリにアップロードされるのは、行数が100行未満の場合のみです。