クアルトリクスファイルサービスタスクからデータを抽出する
このページの内容
クアルトリクスファイルサービスからのデータ抽出について
クアルトリクスファイルサービスは、ファイルをアップロードできる、安全で分離されたファイルストアAPIです。ワークフローを使用すると、クアルトリクスファイルサービスに保存したデータを処理して、クアルトリクスの他の場所で使用できます。例えば、会社の連絡先をクアルトリクスファイルサービスに保存し、定期的にディレクトリにインポートすることができます。
例：「クアルトリクスファイルサービスからデータを抽出」タスクを、「XMDに取引先担当者とトランザクションを追加」タスクなどの他のローダータスクと組み合わせることができます。
ヒント：ETLワークフローに適用される一般的な制限については、ワークフローの制限を参照してください。タスク固有の制限については、このページの情報を参照してください。
クアルトリクスファイルサービスに接続中
クアルトリクスファイルサービス(QFS)は、この自動化でインポートするファイルをアップロードできる、セキュリティで保護されたファイルストアAPIです。
注意: クアルトリクスファイルサービスと連携するには、IT部門またはソフトウェアエンジニアリング部門との連携が必要になる場合があります。
QFSを使用するには、マルチパートフォームデータとして、HTTPSエンドポイントにファイルをアップロードします。このエンドポイントは、グレーのボックス（以下に表示）で提供されます。
スケジュールされた日時にオートメーションが実行されると、新しくアップロードされたファイルを含め、まだオートメーションで処理されていないすべてのファイルが処理されます。
クアルトリクスファイルサービスを使用するには、提供されているHTTPSエンドポイントを呼び出す必要があります。ファイルがシステムから生成される場合は、貴社のITチームまたはソフトウェアエンジニアリングチームにAPIドキュメントと以下の実装例を提供し、Qualtricsのサービスと連携するように依頼してください。
例：この例はcURL形式です。APIトークンを生成する方法については、APIの概要サポートページを参照してください。
MacおよびUnixユーザーの場合：
curl -X POST -H "X-API-TOKEN: [APIトークン]" \-F 'file=@/path/to/import/file/sample-file.txt' \https://datacenterid.qualtrics.com/automations-file-service/automations/AU_XXXXXXXXX/files
Windowsユーザー向け：
curl -X POST -H "X-API-TOKEN: [APIトークン]" ^-F "file=@/インポートファイルのパス/sample-file.txt" ^https://datacenterid.qualtrics.com/automations-file-service/automations/AU_XXXXXXXXX/files
例：これはリクエストの例です。APIトークンを生成する方法については、APIの概要サポートページを参照してください。
POST https://datacenterid.qualtrics.com/automations-file-service/automations/AU_XXXXXXXXX/files HTTP/1.1Content-Type: multipart/form-dataX-API-TOKEN: [貴社のAPIトークン]-----------------------------Content-Disposition: form-data; name="upfile"; filename="sample-file.txt"Content-Type: text/plain[ファイルデータ]-----------------------------
APIを使用してアップロード済みファイルを手動で管理する
クアルトリクスAPIを使用して、アップロードされたファイルを手動で管理することもできます。以下のリンクでは、クアルトリクスファイルサービスAPIを操作する方法について説明しています。
- この自動化のためにアップロードされたすべてのファイルをリスト表示します。
- このオートメーションで使用するファイルをアップロードします。
- ファイルに関連付けられたメタデータを取得します。
- ファイルの内容を取得します。
- ファイルを削除します。
これらのAPIコールでは、automationIdが要求されることがあります。この情報はクアルトリクスからAU_XXXXXの形式で提供されます。
開始する前に
クアルトリクスファイルサービスからのデータ抽出を開始する前に、以下の点を考慮してください。
- データで何をしますか？利用可能なオプションの一覧については、利用可能なローダータスクをご覧ください。
ファイルは一貫した形式に適合していますか？例えば、同じワークフローでインポートするファイルは、値が異なっていても、同じヘッダー/列/フィールドを持つ必要があります。
例：クアルトリクスファイルサービスからXM Directoryに定期的にコンタクトをアップロードするワークフローを設定します。すべてのファイルには、Firstname、Lastname、メールアドレス、電話番号、UniqueID、ロケーションの列があります。
クアルトリクスファイルサービスタスクからのデータ抽出の設定
ヒント：このワークフローで処理されたファイルは、クアルトリクスファイルサービスから削除されます。
データソース(ETLエクストラクタ)を選択します。
クアルトリクスファイルサービスからデータを抽出を選択します。
ここに表示されている一意のHTTPSエンドポイントを使用して、ファイルがクアルトリクスファイルサービスにアップロードされていることを確認してください。詳細については、クアルトリクスファイルサービスを参照してください。
ファイルタイプを選択：
- CSV（コンマ区切り）
- TSV（タブ区切り）
- カスタム区切り文字：ファイル内でタブやコンマ以外の区切り文字を使用している場合に利用できるオプションです。指定のフィールドに使用する文字を入力してください。(例: ; または | )
必要に応じて、「PGPを使用してファイルを暗号化」を選択します。この追加の暗号化およびデータ保護手段についての詳細は、PGP暗号化をご覧ください。
特定の書式設定の問題がある場合に抽出されたファイルを自動的に拒否する厳密な検証を使用するかどうかを決定します。却下されるファイルの詳細については、タスク内のメッセージをお読みください。必要に応じて、不正な形式の行をスキップを有効にすると、ファイルをアップロードし、書式に問題がある行を除外できます。
注意：ワークフローが不正なファイルを処理しようとすると失敗し、そのタスク実行の後続ファイルは処理されません。
サンプルファイルをアップロードで、ワークフローが実行されるたびに処理されるファイルと同じヘッダーを持つサンプルファイルを追加します。ファイルを選択をクリックして、コンピューターからファイルをアップロードします。
ヒント：必要に応じて、タスク内のサンプルファイルをダウンロードするか、サンプルファイルセクションでファイルをダウンロードできます。サポートされているファイルエンコーディング形式はUTF-8のみです。一部の表計算ソフトでは、ファイルをUnicode UTF-8として保存しますが、これはUTF-8とは異なります。予期しないエラーが発生する場合は、この点にご注意ください。UTF-8形式でエクスポートしていること、またUnicode UTF-8ではないことを確認してください。トラブルシューティングの詳細な手順については、CSVおよびTSVのアップロードに関する問題を参照してください。
ファイル内のフィールドを確認してください。表には、列ヘッダー（個々のフィールドを表す）と、最初の2行のデータの値が表示されます。
ヒント：別のファイルをアップロードしたり、その他の変更を加えたりする場合は、［セットアップを編集］をクリックします。
完了したら、「保存」をクリックします。
ETLワークフローの構築を完了する。ローダータスクを選択すると、抽出したデータの保存先を決定することになります。利用可能なオプションの一覧については、利用可能なローダータスクを参照してください。
ヒント：ローダータスクを追加する前に、インポートされたファイルまたは行の数に基づいて条件を作成し、次のアクションを制限することもできます。
FAQs
ワークフローでXM Directoryにコンタクトをアップロードする際に使用できるカスタム区切り文字を教えてください。
ワークフローでXM Directoryにコンタクトをアップロードする際に使用できるカスタム区切り文字を教えてください。
～
&
*
"
_
素晴らしい！ フィードバックありがとうございます！
フィードバックありがとうございます！