記事テンプレート

ユーザーをCXディレクトリにロードするタスクについて

Load Users into CX Directoryタスクは、CXユーザーデータをクアルトリクスに保存するために使用します。このタスクにより、Cxユーザーデータを定期的に最新の状態に保つことができます。このタスクを使用するには、まずデータ抽出タスクを使用してクアルトリクスにデータをロードする必要があります。

ユーザをCXディレクトリにロードするタスクの設定

1. ETLワークフローを作成する。
2. データソース（ETL抽出器）を選択します。このステップでは、別の宛先にロードできるデータを抽出する。詳細については、「ETLワークフローの構築」を参照してください。タスクは以下のフィールドをインポートしなければならない：
   
   • 一意の識別子
   • FirstName
   • LastName
   • Eメール
     Qtip:SFTPファイルからデータを抽出するタスクを使用することをお勧めします。ユーザーデータのサンプルファイルは、このタスクで使用するように設定されている。
     Qtip:最大ファイルサイズは100MBです。
     Qtip:組織がSSOを使用している場合は、UsernameカラムにActive Directoryの値を入力してください。#brandIDは、ファイルのアップロード時に自動的にユーザー名に追加されます。あなたの組織がSSOを使用していない場合、このカラムは一般的にEメールのカラムと一致するはずです。
3. Add a data destinationをクリックします。
   
4. ユーザをCXディレクトリにロードするタスクを選択します。
   
5. 先に設定したデータ抽出タスクを選択する。
   
6. ドロップダウンメニューを使用して、インポートしたデータフィールドをCXユーザー属性にマッピングします。印は必須項目です。ファイルアップロードでフィールドをマッピングすることもできます。
   Qtip:デフォルトでは、ライセンス内のすべての既存CXユーザー属性がマッピングに含まれます。フィールドの次へオプションメニューのDelete rowをクリックすれば、不要なフィールドを削除できます。
   Qtip：ソースフィールド名とCxディレクトリのフィールド名が完全に一致していれば、自動的にマッピングされます！
7. 必要であれば、Map valuesをクリックして、各フィールドの個々の値をマッピングすることができます。クアルトリクスで異なるデータ値を使用したい場合に便利です。個々の値のマッピングの詳細については、フィールドと値のマッピングを参照してください。
   例インポートしたデータファイルに「Europe」という値があるが、クアルトリクスでは「EMEA」として保存したい。これは、値のマッピングによって行うことができる。
8. 不要なフィールドは、フィールドの次へ行削除をクリックして削除することができます。
   Qtip:マップされていないCXユーザー属性は削除する必要があります。
9. 必要に応じて、Add fieldをクリックしてマッピングにフィールドを追加します。新しいフィールドを追加する場合、既存のCXユーザー属性にマッピングするか、新しいフィールドを作成することができます。
   Qtip:新しいフィールドを作成する場合、フィールド名をつけなければなりません。ブランド管理者に連絡先がない限り、フィールド名を編集または削除することはできませんので、フィールド名を付ける際には注意してください。
   
10. ライセンスでSSOが有効になっている場合、Import as SSO Usersを有効にすると、SSOユーザ名でこれらのユーザをインポートできます。これにより、ユーザーはSSO経由でクアルトリクスにアクセスできるようになります。
11. 終了したら、［保存］をクリックします。
    Qtip:マッピングが不完全な場合、タスクは保存できません。保存ボタンがグレーアウトしている場合は、マッピングを再確認してください。
12. ワークフローをオンに切り替える。
    

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

フィールドと値のマッピング

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

マッピング・フィールド

1. タスクを設定中に、「サンプリング・マッピングをダウンロード」をクリックする。このファイルをコンピュータの表計算エディタで開く。
2. ダウンロードしたファイルをテンプレートとして、フィールドマッピングを追加します。マッピングファイルを作成する際には、以下の点に注意してください：
   
   • ファイルの各列は1フィールドマッピングである。
   • 列の最初のセルの値がソース・フィールド名である。
   • 列の2番目のセルの値はクアルトリクスフィールド名です。
   • ファイルは100MBを超えることはできません。
   • CSVファイルとして保存します。
3. クアルトリクスのタスクで、ファイルのアップロードをクリックし、コンピュータ上のマッピングファイルを選択します。
4. その後、マッピングを手動で調整し、個々のフィールド値をマッピングすることができる。

値をマッピングする

1. フィールドをマッピングしたら、フィールドの次へOptions メニューをクリックし、Map valuesを選択します。
2. Download CSV templateをクリックします。
   
3. ダウンロードしたファイルをテンプレートとして、値のマッピングを追加します。ヘッダーの “from “と “to “は削除しないでください。マッピングファイルを作成する際には、以下の点に注意してください：
   • インポートされたフィールド値は “from “カラムに入れる。
   • クアルトリクスに保存したいフィールドの値は、「to」列に入力します。
   • ファイルには最大1000個のマッピングを含めることができる。
   • CSVファイルとして保存します。
4. タスクで、ファイルのアップロードをクリックし、マッピングファイルを選択します。
5. デフォルトでは、空白の値はインポートされない。空白の値を何かとしてインポートしたい場合は、「空白の値をデフォルト値にマップする」を有効にし、「デフォルト値」ボックスで値を指定します。
   
   例従業員をインポートする際、”Office Location “というフィールドがあるとします。従業員の中には遠隔地にいる者もいるため、このフィールドの値はありません。値のない従業員については、この現場社員をスキップする代わりに、”Remote “のような別の値を指定してインポートすることができます。
6. 必要であれば、適切なボックスに入力してマッピングを手動で調整することができます。
7. Add Row（行を追加）をクリックして、手動で値を追加できます。
8. マッピングを削除するには、マッピングの右側にあるマイナス記号（-）をクリックします。
9. 終了したら、［完了］をクリックします。

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

このセクションでは、このタスクをセットアップする際に現れうる一般的な問題を取り上げる。

• タスクを選択した後、ディレクトリが見つからないというエラーが表示されることがあります。このエラーは、ライセンスにCXユーザーadminへのアクセシビリティがない場合に表示されます。CXユーザー管理機能を有効にするには、カスタマーサクセスマネージャーに連絡先が必要です。
• タスクを選択した後、「この拡張機能を使用するには、一意のIDを有効にする必要があります。このエラーは、ライセンスに固有の識別子がない場合に表示されます。一意の識別子を有効にするには、カスタマーサクセスマネージャーにご連絡ください。
• Saveボタンがグレーアウトしている場合は、マッピングが完了していないことを意味します。タスクに含まれるフィールドが完全にマップされていることを確認する。
• すべてのフィールドを更新するためには、タスクに追加されなければならない。フィールドと値のマッピング」によってフィールドが追加されない場合、そのフィールドは追加も更新もされません。

FAQ