メインコンテンツにスキップ
Skip to article
  • Customer Experience
    Customer Experience
  • Employee Experience
    Employee Experience
  • Brand Experience
    Brand Experience
  • Core XM
    Core XM
  • Design XM
    Design XM

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

Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!

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

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

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

  1. クアルトリクスファイルサービス
  2. SFTP サーバ
  3. OAuth ファイルストレージ (Google ドライブまたは Dropbox)
ヒント：ファイルインポートソースについて心配する前に、自動化のステップ1（連絡先は社員）を完了していることを確認してください。

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

インポートソースの設定ステップで、最初のオプションの Qualtrics ファイルサービスが選択されます。

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

HTTPS エンドポイント

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

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 の形式で提供します。

灰色のボックス内の AU ID

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

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

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

SFTPサーバー

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

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

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

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

  1. Configure Import Source ステップで、SFTP サーバの 1 つを選択します。
    インポートソースの設定ステップで SFTP が選択されています。
  2. 続行をクリックします。
  3. ホスト URL を入力します。
    続行ボタンを使用すると、項目の次のいくつかのステップが画面に表示されます。

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

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

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

  1. パスワードを入力します。
    sftp サーバのパスワード。

    ヒント：正確なホスト、ユーザー名、ポートがすでに指定されている場合、パスワードの入力を求められません。
  2. ［続行］をクリックします。
ヒント：SFTP接続の確立で問題が発生した場合は、SFTPのトラブルシューティングで追加のガイダンスを参照してください。

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

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

    ヒント：［SSHキーペアを新規生成］は、キーがすでに生成されている場合でも存在します。このオプションは、新しいキーを作成する場合に選択できますが、新しい自動化に同じ SFTP 認証情報を使用する場合は必要ありません。キーペアは、単一のユーザアカウント内の同じ SFTP 認証情報を使用して、すべての自動化間で共有されます。
  2. [公開鍵をダウンロード] をクリックします。
    公開鍵をダウンロードします。
  3. 公開鍵を 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 ファイルストレージから削除されます。

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

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

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

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

 

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