クアルトリクスファイルからのデータ抽出サービスタスク

スイート

Customer Experience Employee Experience Strategy & Research

製品

Qualtrics

このページの内容

クアルトリクスファイルサービスからのデータ抽出について

クアルトリクスファイルサービスは、安全で隔離されたファイルストアAPIで、ファイルをアップロードすることができます。ワークフローを使用すると、クアルトリクスファイルサービスに保存したデータを処理し、クアルトリクス内の他の場所で使用することができます。例えば、会社の連絡先をクアルトリクスファイルサービスに保存し、定期的にディレクトリにインポートすることができます。

例: クアルトリクスファイルサービスからデータを抽出」タスクを、XMDへの連絡先やトランザクションの追加タスクなど、他のローダータスクと組み合わせることができます。

ヒント：ETLワークフローに適用される一般的な制限については、ワークフローの制限を参照してください。タスク固有の制限については、このページの情報を参照のこと。

クアルトリクスファイルサービスへの接続

クアルトリクスファイルサービス(QFS)は、セキュアなファイルストアAPIで、このオートメーションでインポートするファイルをアップロードすることができます。

注意: クアルトリクスファイルサービスとの統合には、ITまたはソフトウェアエンジニアリングチームとの連携が必要な場合があります。

QFSを使用するには、HTTPSエンドポイントにファイルをアップロードします。このファイルは、マルチパートのフォームデータとして、グレーのボックス（下図）で提供されます。

オートメーションが実行されるようにスケジュールされると、新しくアップロードされたものを含め、オートメーションによってまだ処理されていないすべてのファイルが処理される。

クアルトリクスファイルサービスを利用するには、提供されているHTTPSエンドポイントを呼び出す必要があります。ファイルがシステムから生成される場合は、apiドキュメントと以下の実装例をITまたはソフトウェア・エンジニアリング・チームに提供し、当社のサービスと統合してください。

例: この例は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=@/path/to/import/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.1 Content-Type: multipart/form-data X-API-TOKEN: [あなたのAPIトークン] ----------------------------- Content-Disposition: form-data; name="upfile"; filename="sample-file.txt" -----------------------------

APIでアップロードされたファイルを手動で管理する

クアルトリクスAPIを使用して、アップロードされたファイルを手動で管理することもできます。以下のリンクでは、クアルトリクスファイルサービスAPIとのやり取りについて説明しています：

タイミングによっては、これらのAPIコールはautomationIdを要求する。クアルトリクスはこの情報をAU_XXXXXXのフォーマットで提供します。

始める前に

クアルトリクスファイルサービスからのデータ抽出を始める前に、以下の点を考慮してください：

データを使って何をしたいのか？オプションのリストについては、利用可能なローダータスクを見てください。
ファイルの形式は統一されていますか？例えば、同じワークフローでインポートしたいファイルは、たとえ値が異なっていても、同じヘッダー／カラム／フィールドを持つべきです。
例: クアルトリクスファイルサービスからXM DIRECTORYに定期的に連絡先をアップロードするワークフローを設定します。どのファイルにもFIRSTNAME、LASTNAME、Email、Phone、UniqueID、Locationのカラムがあります。

クアルトリクスファイルサービスからのデータ抽出タスクの設定

QTip:このワークフローで処理されたファイルは、クアルトリクスファイルサービスから削除されます。

ETLワークフローを作成する。

データソース（ETL抽出器）を選択します。

クアルトリクスファイルサービスからデータを抽出を選択します。

ここに表示されている固有のHTTPSエンドポイントを使用して、クアルトリクスファイルサービスにファイルがアップロードされていることを確認してください。詳しくは、クアルトリクスファイルサービスをご覧ください。

ファイルタイプを
選択します：

CSV（コンマ区切り）
TSV（タブ区切り）
カスタム区切り文字：このオプションは、ファイルにタブやカンマ以外の区切り文字を使用する場合に使用できます。使用する文字を入力欄に入力してください。(例：;または｜）。

必要であれば、「Pgpを使用してファイルを暗号化する」を選択します。この暗号化とデータ保護の追加手段について詳細を見るには、PGP暗号化をご覧ください。

厳密な検証を使用するかどうかを決定します。厳密な検証を使用すると、特定のフォーマットに問題がある場合、抽出されたファイルは自動的に拒否されます。どのファイルが拒否されるかについての詳細はタスクのメッセージを読んでください。必要であれば、「Skip malformed rows」を有効にしてファイルをアップロードし、書式に問題のある行を除外します。

サンプルファイルのアップロード］の下に、ワークフローが実行されるたびに処理されるファイルと同じヘッダーを持つサンプルファイルを追加します。ファイルを選択してください] をクリックして、コンピュータからファイルをアップロードします。

Qtip:もしよろしければ、タスクにあるサンプルファイルをダウンロードするか、Example Filesセクションにあるファイルをダウンロードしてください。サポートされているファイルエンコーディング形式はUTF-8のみです。表計算ソフトの中には、UTF-8とは異なるUnicode UTF-8としてファイルを保存するものがあり、予期せぬエラーが発生する場合があります。UnicodeのUTF-8ではなく、UTF-8形式でエクスポートしていることを確認してください。その他のトラブルシューティングステップについては、CSV &; TSV Upload Issuesを参照してください。

ファイルのフィールドを確認する。テーブルには、最初の2行のデータについて、カラムヘッダー（個々のフィールドを表す）とその値が表示される。

Qtip:別のファイルをアップロードしたり、その他の変更を加えたい場合は、Edit the setupをクリックしてください。

終了したら、Saveをクリックします。

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

Qtip:次へ起こることを制限するために、ローダータスクを追加する前に、インポートされたファイルまたは行の数に基づいて条件を作成することもできます。

FAQs

What custom delimiters can I use to upload contacts to XM Directory with workflows?

You may have noticed that the different extraction tasks support custom delimiters. (For example, the Qualtrics File Service.) While you can technically enter whatever delimiters you want into these tasks, not all delimiters are supported by XM Directory, meaning the task may fail. We recommend avoiding the following delimiters:


~
&
*
"
_

当サポートサイトの日本語のコンテンツは英語原文より機械翻訳されており、補助的な参照を目的としています。機械翻訳の精度は十分な注意を払っていますが、もし、英語・日本語翻訳が異なる場合は英語版が正となります。英語原文と機械翻訳の間に矛盾があっても、法的拘束力はありません。

この記事は役に立ちましたか

いただいたフィードバックはこのページの改善の目的のみに利用します。

素晴らしい！フィードバックありがとうございます！

フィードバックありがとうございます！

クアルトリクスファイルからのデータ抽出 サービスタスク