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

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

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

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

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

ワークフローが実行されると、ユーザーはクアルトリクスにインポートされ、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