CXディレクトリタスクにユーザーをロード

CXディレクトリへのユーザーのロードタスクについて

CXディレクトリにユーザーをロードタスクは、CXユーザーデータをQualtricsに保存するために使用されます。このタスクでは、CXユーザーデータを定期的に最新の状態に保つことができます。このタスクを使用するには、最初にデータ抽出機能タスクを使用してデータを Qualtrics にロードする必要があります。

CXディレクトリへのユーザーのロードタスクの設定

1. ETL ワークフローを作成します。
2. データソース (ETL 抽出機能) を選択します。このステップでは、別の宛先にロードできるデータを抽出します。詳細については、ETL ワークフローの作成の使用を参照してください。 タスクで以下のフィールドをインポートする必要があります。
   
   • 一意の識別子
   • FirstName
   • LastName
   • メール。
     ヒント：SFTPファイルからデータを抽出するタスクを使用することをお勧めします。ユーザデータサンプルファイルは、このタスクで使用できるように設定されています。
     ヒント：最大ファイルサイズは100MBです。
     ヒント：組織でSSOを使用している場合、ユーザー名属性に渡すActive Directoryの値が入力される［ユーザー名］列を含めます。#brandIDは、ファイルのアップロード時に自動的にユーザー名に追加されます。組織でSSOを使用していない場合、この列は通常、［メール］列と一致する必要があります。
3. [データの出力先の追加] をクリックします。
   
4. CXディレクトリにユーザーをロードタスクを選択します。
   
5. 以前に設定したデータ抽出タスクを選択します。
   
6. ドロップダウンメニューを使用して、CXユーザー属性にインポートしたデータフィールドのマッピングを開始します。アスタリスクの付いたフィールドは必須です。ファイルアップロードを使用してフィールドをマッピングすることもできます。
   ヒント：デフォルトでは、ライセンスの既存のすべてのCXユーザー属性がマッピングに含まれます。不要なフィールドを削除するには、フィールドの横にある [オプション] メニューで [行の削除] をクリックします。
   ヒント：ソースフィールドとCXディレクトリのフィールド名が完全に一致する場合は、自動的にマッピングされます。
7. 必要に応じて、[値をマッピング] をクリックして、各フィールドの個々の値をマッピングすることができます。これは、クアルトリクスで異なるデータ値を使用する場合に役立ちます。個別値のマッピングの詳細については、項目と値のマッピングを参照してください。
   例：インポートされたデータファイルには値「Europe」がありますが、これをクアルトリクスに「EMEA」として保存する必要があります。これは、マッピング値によって行うことができます。
8. 不要なフィールドを削除するには、フィールドの横にある [行の削除] をクリックします。
   ヒント：マップされていないCXユーザー属性をすべて削除する必要があります。
9. 必要に応じて、[フィールドの追加] をクリックして、マッピングにフィールドを追加します。新しいフィールドを追加する場合、既存のCXユーザー属性にマッピングするか、新しいCXユーザー属性を作成できます。
   ヒント：新しいフィールドを作成する場合は、フィールドに名前を付ける必要があります。ブランド管理者に連絡しないとフィールドを編集または削除できないため、フィールドに名前を付ける場合は注意してください。
   
10. ライセンスで SSO が有効になっている場合は、SSO ユーザとしてインポートを有効化して、SSO ユーザ名でこれらのユーザをインポートすることができます。これにより、ユーザーはSSOを介してQualtricsにアクセスできます。
11. 終了したら、［保存］をクリックします。
    ヒント：マッピングが完了していない場合、このタスクでは保存できません。保存ボタンが灰色表示されている場合は、マッピングを再確認します。
12. ワークフローをオンに切り替えます。
    

ワークフローが実行されると、ユーザーはクアルトリクスにインポートされ、CXユーザー管理者に保存されます。

マッピング項目と値

このタスクの設定時に、ファイルアップロードによってインポートされたデータフィールドをマッピングすることができます。このセクションでは、ファイルを使用して項目および個別項目値をマッピングする方法について説明します。

マッピング項目

1. タスクの設定時に、[サンプルマッピングのダウンロード] をクリックします。コンピュータ上のスプレッドシートエディタでこのファイルを開きます。
2. ダウンロードしたファイルをテンプレートとして使用して、項目マッピングを追加します。マッピングファイルの作成時には、以下の点に注意してください。
   
   • ファイルの各列は、1 つのフィールドマッピングです。
   • 列の最初のセルの値は、ソースフィールド名です。
   • 列2番目のセルの値は、クアルトリクスフィールド名です。
   • ファイルは 100MB を超えることはできません。
   • ファイルを CSV ファイルとして保存します。
3. クアルトリクスのタスクで［ファイルをアップロード］をクリックし、コンピューター上のマッピングファイルを選択します。
4. その後、マッピングをマニュアルで調整し、個別の項目値をマッピングすることができます。

値をマッピングする

1. フィールドをマッピングしたら、フィールドの横にある［オプション］メニューをクリックし、［値をマッピング］を選択します。
2. [CSV テンプレートのダウンロード] をクリックします。
   
3. ダウンロードしたファイルをテンプレートとして使用して、値マッピングを追加します。”from” ヘッダと “to” ヘッダは削除しないでください。マッピングファイルの作成時には、以下の点に注意してください。
   • インポートされたフィールド値は、”開始” 列に入力される必要があります。
   • Qualtricsに保存するフィールド値は、［保存先］列に移動する必要があります。
   • ファイルには最大 1000 のマッピングを含めることができます。
   • ファイルを CSV ファイルとして保存します。
4. タスクで、[ファイルのアップロード] をクリックし、マッピングファイルを選択します。
5. デフォルトでは、空白の値はインポートされません。空白値を何らかの値としてインポートする場合は、[空白の値をデフォルト値にマッピングする] を有効にしてから、[デフォルト値] ボックスで値を指定します。
   
   例：社員をインポートし、「事業所の所在地」のフィールドがあるとします。一部の従業員はリモートであるため、この項目には値がありません。値のない社員に対してこのフィールドをスキップする代わりに、これらの社員に対してインポートされる “リモート” などの別の値を指定することができます。
6. 必要に応じて、適切なボックスに入力することで、マッピングをマニュアルで調整することができます。
7. 行追加をクリックして、追加の値をマニュアルで追加することができます。
8. マッピングを削除するには、マッピングの右側にあるマイナス記号 ( – ) をクリックします。
9. 終了したら、［完了］をクリックします。

トラブルシューティングのヒント

このセクションでは、このタスクの設定時に発生する可能性がある一般的な問題について説明します。

• タスクを選択した後、ディレクトリが見つかりませんページを再ロードしてみてください。というエラーが表示される場合があります。このエラーは、ライセンスに CX ユーザー管理へのアクセス権がない場合に表示されます。CXユーザー管理を有効にするには、XMサクセスマネージャーにお問い合わせください。
• タスクを選択すると、この拡張を使用するためには一意 ID が必要ですというエラーが表示される場合があります。このエラーは、ライセンスにユニークな識別子がない場合に表示されます。一意の識別子を有効にするには、XMサクセスマネージャーにお問い合わせください。
• 保存ボタンが灰色表示されている場合は、マッピングが完了していないことを意味します。タスクに含まれているフィールドがすべて完全にマッピングされていることを確認してください。
• 項目を更新するには、すべての項目をタスクに追加する必要があります。マッピング項目および値を使用して項目が追加されない場合、その項目は追加または更新されません。

FAQ