Qualtrics Platform
Customer Journey Optimizer
XM Discover
Qualtrics Social Connect

自動化のファイルインポートソース

自動化のファイルインポートソースについて

連絡先のインポートの自動化と社員のインポートの自動化により、ディレクトリ管理を効率化できます。自動化の実行がスケジュールされると、新たにアップロードされたファイルを含め、自動化によってまだ処理されていない指定ファイルが処理されます。ただし、これを行う前に、自動化でファイルのプル元を把握する必要があります。

連絡先のインポートの自動化と社員のインポートの自動化のファイルソースは次のとおりです：

クアルトリクスファイルサービス
SFTP サーバ
OAuth ファイルストレージ (Google ドライブまたは Dropbox)

ヒント：ファイルインポートソースについて心配する前に、自動化のステップ1（連絡先は社員）を完了していることを確認してください。

クアルトリクスファイルサービス

クアルトリクスファイルサービスは、この自動化をインポートするためのファイルをアップロードできるセキュリティ保護されたファイルストアAPIです。HTTPS エンドポイントにファイルをアップロードすることができます。HTTPS エンドポイントは、multipart form-data としてグレーのボックス (下図参照) で提供されます。

自動化の実行がスケジュールされると、自動化によってまだ処理されていないファイル (新しくアップロードされたファイルを含む) が処理されます。

Qualtrics ファイルサービスを使用するには、指定された HTTPS エンドポイントを呼び出す必要があります。ファイルがシステムから生成された場合は、API 文書および以下の実装例を IT チームまたはソフトウェアエンジニアリングチームに提供し、サービスと統合する必要があります。

例: この例は cURL 形式です。API トークンの生成方法については、「API 概要」サポートページを参照してください。
Mac および UNIX ユーザの場合:

curl -X POST -H "X-API-TOKEN: [your API TOKEN]" \
 -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: [your API TOKEN]" ^
 -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: [Your API TOKEN]
 
 -----------------------------
 Content-Disposition: form-data; name="upfile"; filename="sample-file.txt"
 Content-Type: text/plain
 
 [FILE DATA]
 -----------------------------

API によるアップロード済ファイルのマニュアル管理

Qualtrics APIを使用して、アップロードしたファイルを手動で管理することもできます。次のリンクでは、クアルトリクスファイルサービスAPIの操作方法について説明します。

これらの API 呼び出しでは、automationId が要求される場合があります。クアルトリクスは、この情報を AU_XXXXX の形式で提供します。

次のステップ – XM Directory連絡先のインポートの自動化

クアルトリクスファイルサービスをインポートソースとして設定し終わったら、今すぐ、連絡先のインポートの自動化の作成を終了します。

次のステップ – 社員ディレクトリのユーザーインポートの自動化

SFTPサーバー

セキュアファイル転送プロトコル（SFTP）を使用して、自分の連絡先レコードをクアルトリクスにインテグレーションできます。たとえば、ホストされた日次ファイルドロップからコンテンツをインポートしてから、それらの連絡先のアンケート配信をインポートおよびスケジュールできます。これらはすべて、最も安全で安全な転送方法で行います。

自動化の実行がスケジュールされると、自動化によってまだ処理されていないファイル (新しくアップロードされたファイルを含む) が処理されます。ファイルが処理されると、SFTP サーバから削除されます。

ヒント：クアルトリクスの自動化は、ファイルをクアルトリクスに正常に転送する前に、サーバー上で複数回ファイルに「タッチ」（アクセス）する必要があります。SFTP サーバがファイルへの複数タッチを許可するように設定されていることを確認してください。ワンタッチ後にファイルを削除するようにサーバが設定されている場合、自動化は失敗します。

Configure Import Source ステップでは、Username &amp、Password and Username &amp、SSH Key の 2 つの SFTP オプションがあります。

Configure Import Source ステップで、SFTP サーバの 1 つを選択します。
続行をクリックします。
ホスト URL を入力します。

ヒント：URLは通常、sftp.example.com に似ています。
[ユーザー名] を入力します。大文字と小文字が区別されます。
ポートを入力します。これはオプションです。デフォルトとして 22 が入力されます。
［続行］をクリックします。

パスワードと SSH キーのどちらを選択したかによって、次のステップは異なります。

ユーザ名 & パスワードによる設定

パスワードを入力します。

ヒント：正確なホスト、ユーザー名、ポートがすでに指定されている場合、パスワードの入力を求められません。
［続行］をクリックします。

ヒント：SFTP接続の確立で問題が発生した場合は、SFTPのトラブルシューティングで追加のガイダンスを参照してください。

ユーザ名による設定 & SSH キー

キーがまだ存在しない場合は、新規 SSH キーペアを生成するためのオプションを選択します。

ヒント：［SSHキーペアを新規生成］は、キーがすでに生成されている場合でも存在します。このオプションは、新しいキーを作成する場合に選択できますが、新しい自動化に同じ SFTP 認証情報を使用する場合は必要ありません。キーペアは、単一のユーザアカウント内の同じ SFTP 認証情報を使用して、すべての自動化間で共有されます。
[公開鍵をダウンロード] をクリックします。
公開鍵を SFTP サーバにアップロードします。

ヒント：Qualtricsサポートは、SFTPサーバーの設定をサポートできません。SSH キーに関する問題が発生した場合は、追加のガイダンスについては SSH キー認証を参照するか、SFTP サービスプロバイダに連絡してください。

サポートされている暗号

SFTP サーバに接続するには、サーバと自動化の間で使用される暗号化を調整するための一連の SSH ハンドシェイクが必要です。接続を確立するには、SFTP サーバに、自動化でサポートされている暗号と一致する暗号タイプごとに少なくとも 1 つの暗号が必要です。以下は、自動化でサポートされる暗号の一覧で、暗号タイプ別にグループ化されています。

サポートされているキー交換暗号:

curve25519-sha256@libssh.org
diffie-hellman-group14-sha1
diffie-hellman-group1-sha1
diffie-hellman-group-exchange-sha256
ecdh-sha2-nistp256
ecdh-sha2-nistp384
ecdh-sha2-nistp521

サポートされている Mac 暗号:

hmac-sha2-256
hmac-sha2-512

サポートされる暗号化暗号:

aes128-ctr
aes192-ctr
aes256-ctr
aes128-cbc
Arcfour256
Arcfour128
Arcfour
3des-cbc

サポートされている暗号スイート:

chacha20-poly1305@openssh.com: Chacha20は対称暗号化アルゴリズムであり、Poly1305は認証暗号である。
aes128-gcm@openssh.com: Galois/Counter Mode (GCM) を使用した 128 ビットキーによる Advanced Encryption Standard (AES)。

SFTP サーバで適切な暗号がサポートされていない場合は、このページに示されている他のインポートソースのいずれかを使用することをお奨めします。

次のステップ – XM Directory連絡先のインポートの自動化

インポートソースとしてSFTPサーバーを設定し終わったら、連絡先インポートの自動化の作成を終了します。

次のステップ – 社員ディレクトリのユーザーインポートの自動化

Google ドライブ Dropbox(&A)

Google ドライブまたは Dropbox アカウントを連絡先のインポートの自動化のファイルストレージとして使用できます。これらのサービスのログイン情報は非公開のままです。OAuthファイルストレージを使用すると、ユーザーのパスワードを公開することなく、エンドユーザーのアカウント情報をQualtricsで使用できます。このアカウント情報は、SFTP設定と同様に動作し、XM Directoryの自動化からファイルストレージに接続するために使用されます。

自動化の実行がスケジュールされると、自動化によってまだ処理されていないファイル (新しくアップロードされたファイルを含む) が処理されます。処理されたファイルは、OAuth ファイルストレージから削除されます。

Configure Import Source ステップで、Google Drive または Dropbox を選択します。
［続行］をクリックします。
[サインイン] をクリックして、Google または Dropbox アカウントにサインインする必要があります。これにより、OAuth を使用してサインインできる新しいウィンドウにリダイレクトされます。
サインインが成功すると、設定を完了するか、必要に応じてアカウントを別の OAuth ユーザに切り替えるようにリダイレクトされます。また、データソースで変更をクリックし、代替データソースを選択することで、OAuth アカウントを削除することもできます。
インポートソースを設定したら、インポートファイルソースの選択セクションに進みます。ここでは、フォルダパスを宣言することができます (例: “FolderName/Folder2”)。