組織階層受信コネクタ

組織階層の受信コネクタについて

組織階層を使用すると、組織構造をXM Discoverにアップロードして、データアナリティクス、ユーザーのパーソナライゼーション、データアクセス制御を改善できます。組織階層受信コネクタを使用して、組織階層をアップロードおよび更新することができます。

組織階層ファイルの準備

組織階層受信ジョブを設定する前に、組織階層データが適切な形式であり、組織構造が含まれていることを確認する必要があります。

組織階層は、CSV または Excel (XLS または XLSX) ファイルを使用してアップロードできます。

各ファイルタイプの例および書式設定ガイドラインについては、組織階層のベストプラクティスを参照してください。

例: 以下は、ホテル会社の組織構造の例を示す Excel ファイルです。

組織階層受信ジョブの設定

以下のステップに従って、組織階層受信ジョブを設定します。この設定では、Studio で階層 API トークンを生成する必要があります。以下のステップを完了する前に生成することをお奨めします。

1. [ジョブ] タブで、[新しいジョブ] をクリックします。
   
2. 組織階層を選択します。
   
3. ジョブを特定できるように、ジョブに名前を付けます。
   
4. データをロードするプロジェクトを選択します。
5. 目的がわかるように、ジョブに説明を付けます。
6. [次へ] をクリックします。
7. 使用する SFTP アカウントを選択するか、新規追加を選択して新しいアカウントを追加します。
   
8. 新しいアカウントを追加する場合は、SFTP アカウントに関する以下の情報を入力します。
   • 接続名: 後で認識できるように、接続に名前を付けます。
   • SFTP ユーザ名: SFTP サーバに接続するためのユーザ名を入力します。
   • SFTP パスワード: SFTP サーバに接続するためのパスワードを入力します。
   • SFTP ホスト: SFTP サーバのホスト URL を入力します。
   • SFTP ポート: SFTP ポートを入力します。通常は 22 です。
   • 期限切れ通知を送信：SFTP認証情報を一定時間後に期限切れにする場合は、このオプションを選択します。
   • 有効期限までの日数：有効期限に関する通知を有効にする場合は、有効期限までの通知日数を入力します。1 日から 100 日の間の値を入力することができます。
   • 有効期限: 認証情報の有効期限が切れる日付を設定します。ボックスをクリックしてカレンダを開き、日付を選択します。
9. [次へ] をクリックします。
10. を入力 階層 API トークン.
    
11. [次へ] をクリックします。
12. 組織階層に名前を付けます。
    
13. 組織階層を公開するかどうかを選択します。
    • 組織階層のアップロード: 組織階層を作成および有効化します。デフォルトでは、有効化された組織階層は未公開であり、ダッシュボードのパーソナライゼーションのみが有効化されます。
    • 組織階層のアップロードおよび公開: 組織階層を作成、有効化、および公開します。組織階層を公開すると、データをレベル別にグループ化することができます。これは、ピアレポートと親レポート、およびターゲットレポートと差異レポートの前提条件です。
      ヒント：組織階層を公開すると、対応する非表示のカテゴリモデルが作成され、追加の使用ケースがサポートされます。作成されたカテゴリモデルは、組織階層の構造およびフィルタをミラーリングし、該当する場合はモデルのように動作します。
14. 設定に応じて、追加の階層オプションを選択します。
    • ユーザーファイルに基づいてグループを生成: 組織階層ファイルに基づいてグループを作成します。
    • テキストのないレコードを含める: 組織階層に空の単語を含むレコードを含めます。このオプションは、組織階層を公開する場合にのみ使用できます。
    • 増分データフローに含める: 増分データフロー実行に組織階層を含めます。このオプションは、組織階層を公開する場合にのみ使用できます。
      ヒント：組織階層の公開が他のデータフローと競合することが予想される場合は、このオプションの選択を解除することをお勧めします。このオプションが無効化されている場合、作成されてから分類されるモデルでは、他のデータフローがブロックされません。
15. [次へ] をクリックします。
16. アップロードするファイルのタイプを選択:
    
    • 区切り文字で区切られた「フラット」ファイル
    • Excel ファイル (XLS、XLSX)
17. デリミタ区切りフラットファイルについては、以下を選択するための追加設定があります。
    
    • ファイルエンコーディング：ファイルのエンコーディングシステム（UTF-8、ASCII など）を選択します。
    • 区切り文字: データエントリの区切りに使用する文字を入力します。デフォルトでは、これは CSV ファイルのカンマです。
    • 囲み文字: データ入力を囲む文字を入力します。”封入なし” が選択されている場合、この項目は空白のままにします。
    • 囲みなし: ファイルに囲み文字が含まれていない場合は、このオプションを有効にします。
18. 参照をクリックし、アップロードするファイルを含むSFTPサーバー上のフォルダーパスを選択します。
    ヒント：フォルダーパスを選択するときに、フォルダーアイコンをクリックして、そのフォルダーを展開できます。フォルダー名をクリックしてフォルダーを選択し、完了したら［OK］をクリックします。
19. アップロードするファイルと一致するファイル名正規表現を入力します。
20. ファイルが圧縮されている場合は、Unzip ファイルを有効にし、解凍するファイルと一致する Zip ファイル名の正規表現を入力します。
    
21. ファイルが復号化された場合は、Decrypt file(s) を有効にして、次のように入力します。
    • 暗号化されたファイル名の正規表現: 復号化するファイルのファイル名の正規表現を入力します。
    • PGP/GPG キー: 暗号化に使用する PGP/GPG キーを入力します。
    • パスフレーズ: 解読のパスフレーズを入力します。
22. ファイルが圧縮と暗号化の両方である場合は、最初にどの処理を行うかを選択する必要があります。
    • 解凍してから解読: ファイルが解凍され、復号化されます。
    • 解読してから解凍: ファイルが復号化された後、解凍されます。
23. コンピュータまたは SFTP サーバに保存できるサンプルファイルを指定する必要があります。
    
    • サンプルファイルが SFTP サーバに保存されている場合は、ファイルストレージからサンプルをダウンロードを選択します。
    • サンプルがコンピュータに保存されている場合は、マイコンピュータからサンプルをアップロードを選択します。
      ヒント：必要に応じて、ジョブ設定に表示される［ここ］リンクをクリックしてテンプレートファイルをダウンロードできます。
24. デフォルトでは、組織階層の生成にサンプルファイルは使用されません。最初のジョブ実行でサンプルファイルを使用する場合は、［初期ジョブ実行でアップロードされたサンプルファイルを使用する］を有効にします。
25. ファイル選択ボタンをクリックし、コンピュータまたは SFTP サーバ上のサンプルファイルを選択します。
26. ファイルのプレビューが表示されます。プレビューではなくエラーメッセージまたはローファイルの内容が表示される場合は、選択したデータ書式オプションに問題がある可能性があります。ファイルのトラブルシューティングについては、「サンプルファイルのエラー」を参照してください。
27. [次へ] をクリックします。
28. XM Discoverで、サンプルファイルから組織階層フィールドへのフィールドのマッピングを開始します。［マッピング］列のボックスをクリックして、XM Discoverの組織階層フィールドを選択し、インポートしたフィールドにマッピングします。使用可能な組織階層項目は以下のとおりです。
    
    • レベル 1 からレベル 10: 階層の構造を定義します。階層レベルの最大数は 10 です。
    • ユーザ: ユーザを階層にマッピングします。
    • フィルタ: 階層のフィルタを定義します。
    • エンリッチメント: 階層のエンリッチメントパラメータを作成します。拡張の最大数は 6 です。
29. 必要に応じて、変換列の歯車アイコンをクリックすることで、入力データを変換できます。
30. プラス記号 (+) をクリックして項目を追加したり、項目のマイナス符号 ( – ) をクリックして項目を削除したりすることができます。
31. フィールドのマッピングが終了したら、［次へ］をクリックします。
32. 通知設定を選択します。
    
33. [次へ] をクリックします。
34. ジョブをスケジュールに従って定期的に実行する場合は、増分実行のスケジュールを選択します。ジョブを 1 回だけ実行する場合は、ワンタイムプル設定を選択します。詳細については、ジョブスケジュールを参照してください。
    
35. 処理されたファイルの保存期間を選択します。設定された期間の後にファイルが削除されます。
36. [次へ] をクリックします。
37. 設定をレビューします。特定の設定を変更する必要がある場合は、編集ボタンをクリックして、コネクタ設定のそのステップに移動します。
    
38. [完了] をクリックしてジョブを保存します。