組織階層受信コネクタ
組織階層の受信コネクタについて
組織階層受信コネクタを使用して、セキュアファイル転送プロトコル (SFTP) サーバに保存されたファイルを介して組織階層を XM Discover にアップロードおよび更新することができます。この受信コネクタにより、以下が可能になります。
- 組織階層の更新をアップロードおよびスケジュールします。
- 処理前に Zip または Gzip アーカイブからファイルを抽出します。
- 処理前にファイルを復号化します。
- 拡張通知を設定します。
- 変換を適用します。
ヒント:組織階層は、作成または更新される場所(Studio またはコネクター)に関係なく、同じように機能します。
組織階層ファイル形式
組織階層受信コネクタを使用してジョブを設定する前に、サポートされている以下のファイル形式の 1 つで、関連する組織階層ファイルが準備されていることを確認してください。
- Excel ファイル (XLS、XLSX)
- 区切りテキストファイル (CSV)
Excel 形式の組織階層の要件
組織階層受信コネクタでは、単一の MS Excel スプレッドシートを使用して組織のすべての側面を定義することができます。
- 組織階層は、拡張子が XLS または XLSX の MS Excel スプレッドシートとして保存することができます。
- すべての組織階層データを Excel ファイルの最初のシートに配置することをお奨めします。
- スプレッドシートの最初の行に列名が含まれていることを確認してください。これらの名前は、組織パラメータに列をマッピングするために使用されます。
- スプレッドシートの列は任意の順序にすることができます。
- 各列は、マッピングステップで特定の組織階層パラメータに割り当てられます。
CSV 形式の組織階層の要件
組織階層受信コネクタでは、単一の CSV ファイルを使用して組織のすべての側面を定義することができます。
- 組織階層を CSV ファイルとして保存します。
- カンマを使用して列を区切ります。
- すべての行の列数は、同じ順序で同じである必要があります。
- CSV ファイルの最初の行に列名が含まれていることを確認してください。これらの名前は、組織階層パラメータに列をマッピングするために使用されます。
- 列の順序は関係ありません。
- マッピングステップ階層が CSV ファイルで定義されると、各列が特定の組織階層パラメータに割り当てられます。
XM Discover における組織階層の例およびトラブルシューティングのヒントについては、組織階層のベストプラクティス (Studio) を参照してください。
接続の設定
組織階層受信コネクタジョブの作成
接続を設定したら、以下のステップに従って、組織階層受信コネクタジョブを作成し、XM Discover に送信されるデータを設定します。
- ステップ 1: ジョブ名の入力
- ステップ 2: プロジェクトと説明の指定
- ステップ3:クアルトリクスSFTPフォルダの認証情報の指定
- ステップ 4: 階層 API トークン
- ステップ 5: 組織階層設定
- ステップ 6: ファイル設定の指定
- ステップ7:XM Discoverへの希望フィールドのマッピング
- ステップ 8: 通知設定 (オプション)
- ステップ 9: ジョブの追加オプションの設定
- ステップ 10: すべてのジョブ設定の確認
ステップ 1: ジョブ名の入力
ページの左上の
[ジョブ名] ボックスに、認識可能なジョブ名を入力します。
ステップ 2: プロジェクトと説明の指定
ステップ3:クアルトリクスSFTPフォルダーの認証情報を指定
- [クアルトリクスSFTPフォルダーに認証情報を提供する]ページで、ドロップダウンメニューから既存のSFTPサーバー認証情報のセットを選択できます。
ヒント:の手順に従って、新しいSFTP認証情報のセットを追加できます 新しい SFTP 認証情報の追加 」セクションで説明されている手順を使用して差し込むことができます。 - [次へ] をクリックします。
ステップ 4: 階層 API トークン
- 階層 API トークンページで、階層 API トークンボックスに階層認証トークンを指定します。
ヒント:ジョブ作成後の階層認証トークンの生成と階層認証トークンの更新の詳細については、「階層API」を参照してください。 - [次へ] をクリックします。
ステップ 5: 組織階層設定
- 組織階層のアップロード (デフォルト): 組織階層を登録および有効化します。詳細については、 組織階層のアップロード 」セクションで説明されている手順を使用して差し込むことができます。
ヒント:デフォルトでは、有効化された組織階層は非公開になっており、ダッシュボードのパーソナライゼーションのみが有効になります。
- 組織階層のアップロードおよび公開: 組織階層を作成、有効化、および公開します。詳細については、 組織階層のアップロードおよび公開 」セクションで説明されている手順を使用して差し込むことができます。
ヒント:組織階層を公開すると、レベル別にデータをグループ化できます。これは、ピアレポートと親レポート、およびターゲットレポートと差異レポートの前提条件です。詳細については、ピアおよび親レポートおよび目標/差異レポートを参照してください。ヒント:ジョブ作成後の組織階層設定の更新の詳細については、 組織階層受信コネクタジョブ設定の更新 」セクションで説明されている手順を使用して差し込むことができます。
- [次へ] をクリックします。
ステップ 6: ファイル設定の提供
- ファイル設定の提供ページで、以下のチェックボックスの 1 つを選択し、アップロードされるデータを含むファイルの種類を選択します。
- 選択したファイルタイプに設定オプションを適用します。
- 区切りテキストファイル (CSV): 詳細については、 区切りテキストファイル(CSV)設定 」セクションで説明されている手順を使用して差し込むことができます。
- Excel ファイル (XLS、XLSX): 詳細については、 Microsoft Excel ファイルの設定 」セクションで説明されている手順を使用して差し込むことができます。
- [ファイルの場所] セクションで [参照] をクリックして、SFTP サーバ上のファイルが保存されているフォルダを指定します。
- ファイルの保存場所を選択ウィンドウで、ファイルを保存するフォルダを選択します。
ヒント:フォルダーの名前をクリックして選択します。フォルダアイコンをクリックしてフォルダを開きます。 - ファイルが保存されているフォルダを選択したら、OK をクリックします。
注意: 選択したフォルダ内のファイルのみが処理されます。サブフォルダは個別に処理する必要があります。 - ファイル名正規表現ボックスに、名前が一致するファイルのみを処理する正規表現を入力します。
ヒント:ジョブの作成後にファイルの場所設定を更新できます。注意:カスタムコーディング機能はそのまま提供されており、実装にはプログラミングの知識が必要です。Qualtricsサポートでは、カスタムコーディングに関するサポートやコンサルティングを提供していません。ただし、 コミュニティの経験豊かなユーザー(英語) に尋ねてみることは可能です。カスタムコーディングサービスの詳細については、クアルトリクスの営業担当にお問い合わせください。 - ファイル設定の提供ページで、Decryption and compression セクションに移動します (オプション)。
- ファイルが Zip または Gzip アーカイブに保存されている場合は、ファイルの解凍チェックボックスを選択します。
- 正規表現を入力して、名前が一致するファイルのみを圧縮ファイル名正規表現ボックスに解凍します。
注意:カスタムコーディング機能はそのまま提供されており、実装にはプログラミングの知識が必要です。Qualtricsサポートでは、カスタムコーディングに関するサポートやコンサルティングを提供していません。代わりに、経験豊富なユーザーのコミュニティにいつでも質問することができます。カスタムコーディングサービスの詳細については、クアルトリクスの営業担当にお問い合わせください。
- ファイルが暗号化されている場合は、ファイル解読チェックボックスを選択します。
- 正規表現を入力して、名前が一致するファイルのみを暗号化ファイル名正規表現ボックスに復号化します。
注意:カスタムコーディング機能はそのまま提供されており、実装にはプログラミングの知識が必要です。Qualtricsサポートでは、カスタムコーディングに関するサポートやコンサルティングを提供していません。代わりに、経験豊富なユーザーのコミュニティにいつでも質問することができます。カスタムコーディングサービスの詳細については、クアルトリクスの営業担当にお問い合わせください。
- 解読用の PGP/GPG キーを PGP/GPG キーボックスに入力します。
- 解読のパスフレーズをパスフレーズボックスに入力します。
- 暗号化されていないアーカイブに暗号化されたファイルが含まれている場合は、解凍を選択してから復号化を選択します。または、暗号化されたアーカイブに暗号化されていないファイルが含まれている場合は、Decrypt Then Unzip オプションを選択します。
ヒント:これらのオプションは、[ファイルを解凍する]オプションと[ファイルを解読]オプションの両方が選択されている場合にのみ使用できます。注意: 暗号化されたファイルを含む暗号化されたアーカイブはサポートされていません。ヒント:解読と圧縮の設定は、ジョブの作成後に更新できます。
- フィールドマッピングのサンプルファイルを提供するために、以下のオプションの 1 つを選択することができます。
- ファイルストレージからサンプルをダウンロード: 詳細については、 SFTP サーバからのサンプルファイルのダウンロード 」セクションで説明されている手順を使用して差し込むことができます。
- コンピュータからファイルをアップロード: 詳細については、 コンピュータからのサンプルファイルのアップロード 」セクションで説明されている手順を使用して差し込むことができます。
ステップ7:XM Discoverへの希望フィールドのマッピング
- XM Discover への希望フィールドのマッピングページで、フィールドをソースマッピングタブの適切な階層パラメータにマッピングして、組織階層を定義します。
- 項目名: ファイルからの項目の名称。
- 使用可能な値: 使用可能な値の例。
- 変換: このオプションを使用して、データを変換します。詳細については、変換の適用を参照してください。
- マッピング: フィールドをマップする組織階層アスペクトを選択します。使用可能な値:
- レベル 1 からレベル 10階層の構造を定義します。組織構造レベルは、Excel または CSV ファイルの列によって定義されます。
ヒント:階層レベルの最大数は10です。 - ユーザ: ユーザを階層にマッピングします。
- フィルタ: 階層のフィルタを定義します。
- 強化: 階層の強化パラメータ登録です。|
ヒント:エンリッチメントの最大数は6です。ヒント:右側のプラス( + )アイコンをクリックして新しいカスタムデータフィールドを追加し、マイナス( – )アイコンをクリックしてフィールドを削除します。
- レベル 1 からレベル 10階層の構造を定義します。組織構造レベルは、Excel または CSV ファイルの列によって定義されます。
ステップ 8: 通知設定 (オプション)
- [通知設定] ページでは、以下に一覧表示されたイベントのいずれかが発生した場合に、ジョブの参照者が受信する通知を選択することができます。
ステップ 9: ジョブの追加オプションの設定
- ジョブの追加オプションの設定ページの履歴/増分ジョブのスケジュールセクションで、以下のオプションの 1 つを選択します。
- 差分実行スケジュール: 差分データインポートのスケジュールを設定します。
ヒント:追加実行のスケジュールの詳細については、「ジョブスケジュール」を参照してください。
- ワンタイムプル設定: 1 回限りのデータプルを実行します。
ヒント:詳細については、「ワンタイムプルジョブの差分実行のスケジュール」を参照してください。
- [ジョブの追加オプションの設定] ページの [保存期間] セクションで、定義した期間のジョブごとにファイルをアーカイブする保持期間を指定することができます。
ヒント:保持設定の詳細については、「保持設定の更新」を参照してください。 - [次へ] をクリックします。
ステップ 10: すべてのジョブ設定の確認
- すべてのジョブ設定の確認ページでは、データアップロードを実行する前に、ジョブのすべての設定の概要を表示し、必要に応じて設定を編集することができます。
- データアップロードを実行するには、データアップロードを実行する準備ができたら、終了ボタンをクリックします。
ジョブが正常に送信されたことを確認する確認メッセージが表示されます。終了をクリックすると、以下の処理が行われます。
- ワンタイムプルが即時に実行されます。
- [ジョブを作成するがデータを取得しない] オプションを有効にしていない場合、スケジュールされたプルはすぐに実行されてから、定義したスケジュールに従って実行されるように設定されます。ジョブの監視
の詳細については、ジョブページ概要を参照してください。
新しい SFTP 認証情報の追加
クアルトリクスSFTPフォルダの認証情報を提供ページで、新しいSFTP認証情報を追加できます。
- SFTP 認証情報の新しいセットを追加するには、資格情報ドロップダウンメニューから新規追加を選択します。
- 新しい認証情報セットの名前を CONNECTION NAME ボックスに入力します。
- SFTP ユーザ名を SFTP USERNAME ボックスに入力します。
- SFTP パスワードを SFTP PASSWORD ボックスに入力します。
- SFTP サーバアドレスを SFTP HOST ボックスに入力します。
- SFTP ポートを SFTP PORT ボックスに入力します。
ヒント:デフォルトのポートは22です。
- SFTP 認証情報は、特定の期間が経過すると有効期限が切れるように設定できます (オプション)。この認証情報セットの有効期限を定義し、すべてのジョブウォッチャに対してリマインダを設定するには、有効期限通知の送信チェックボックスを選択します。これにより、有効期限前の日数ボックスが有効になります。
- [有効期限までの日数] ボックスに値を入力して、通知が開始される有効期限までの日数を設定します。使用可能な値は 1 日から 100 日です。
ヒント:このリマインダーは、有効期限が[有効期限までの日数]ボックスで設定された日数未満になると、ジョブが実行されるたびにトリガーされます。
- カレンダ日付ピッカーから有効期限を選択します。その後、有効期限が [有効期限] ボックスに追加されます。
SFTP サーバからのサンプルファイルのダウンロード
コンピュータからのサンプルファイルのアップロード
- コンピュータから[サンプルをアップロード]を選択します。
- クリックしてアップロードするファイルを選択ボタンをクリックし、データファイルをポイントするか、灰色のキャンバスにファイルをドロップします。
- XM Discoverがサンプルファイルをアップロードしてプレビューが表示されるまで待ちます。
ヒント:考えられる検証エラーの詳細については、「サンプルファイルエラー」を参照してください。ヒント:ジョブの作成後にサンプルファイルを使用してファイルヘッダー設定を更新することで、フィールドマッピングを更新できます。
区切りテキストファイル(CSV)設定
区切り記号付きテキストファイル (CSV) の設定オプションは、[ファイルの選択] ページに適用できます。
- メニューから、ファイルで使用されているエンコードシステムを選択します。
- ファイル内のデータエントリを区切るために使用する文字を区切り文字文字ボックスに入力します。
ヒント:1文字のみ入力します。ヒント:デフォルトの区切り文字はカンマで、CSVファイルに使用できます。 - ファイル内の各データフィールドを囲むために使用する文字を囲み文字ボックスに入力します。
ヒント:2文字のみ入力します。ヒント:囲み文字がオプションの場合は、[囲み文字]チェックボックスを選択します。
- ここリンクをクリックすると、独自の組織階層を構築するための開始ポイントとして、1 つのファイルに保存されている構造、フィルタ、ユーザ、および拡張が事前定義されたデフォルトテンプレートをダウンロードして使用することができます。
組織構造の CSV テンプレートファイルは、コンピュータにダウンロードされるデフォルトの場所に保存されます。テンプレートをダウンロードしたら、組織構造に合わせて変更します。
Microsoft Excel ファイルの設定
Microsoft Excel ファイルの設定オプションは、[ファイルの選択] ページに適用できます。ここリンクをクリックすると、独自の組織階層を構築するための開始ポイントとして、1 つのファイルに保存されている構造、フィルタ、ユーザ、および拡張が事前定義されたデフォルトテンプレートをダウンロードして使用することができます。
組織構造の Excel テンプレートファイルは、コンピュータにダウンロードされる既定の場所に保存されます。テンプレートをダウンロードしたら、組織構造に合わせて変更します。
組織階層受信コネクタジョブ設定の更新
組織階層受信コネクタジョブの設定を更新して、ジョブ作成後の組織階層の処理方法を指定することができます。これらは、主に最新のものです。組織階層コネクタの増分実行ごとに、以下が実行されます。
- 元の組織階層のバージョンが登録されます。
- 登録されたバージョンが新規ファイルで編集されます。
- 構造またはフィルタが更新されると、バージョンが公開されます。ユーザと拡張のみが更新される場合、バージョンは公開されません。
- 元の組織階層が新しいバージョンに置き換えられます。
- 一時バージョンが削除されます。
- 組織階層は、有効でない場合に有効化されます。
組織階層受信コネクタジョブ設定を更新する方法
- コネクタにサインインします。
- JOBS タブが選択されていることを確認します。
- フィルタまたは検索を使用して、更新するジョブを検索します。
- ジョブの横にあるアクションメニューを展開します。
- [組織階層設定を更新]を選択します。
- 組織階層設定の更新ウィンドウで、以下のアップロードモードオプションの 1 つを選択して、組織階層の処理方法を指定することができます。
- 組織階層のアップロード (デフォルト): 組織階層を登録および有効化します。詳細については、組織階層のアップロードセクションを参照してください。
ヒント:デフォルトでは、有効化された組織階層は非公開になっており、ダッシュボードのパーソナライゼーションのみが有効になります。
- 組織階層のアップロードおよび公開: 組織階層を作成、有効化、および公開します。詳細については、組織階層のアップロードおよび公開セクションを参照してください。
ヒント:組織階層を公開すると、レベル別にデータをグループ化できます。これは、ピアレポートと親レポート、およびターゲットレポートと差異レポートの前提条件です。詳細については、ピアおよび親レポートおよび目標/差異レポートを参照してください。
- [保存]をクリックします。
これにより、ジョブが更新され、新しい設定が適用されます。
組織階層のアップロード
組織階層のアップロードモードオプションを選択した場合は、[このユーザファイルに基づいてグループを生成] チェックボックスを選択して、組織階層を含むグループを作成することができます。
組織階層のアップロードおよび公開
組織階層のアップロードおよびアップロードモード公開オプションを選択した場合は、以下を実行できます。
- [このユーザファイルに基づいてグループを生成] を選択して、組織階層でグループを作成します。
- 空のレコードを組織階層に含めるには、テキストなしのレコードを含むを選択します。
- [テキストのないレコードを含める] を選択解除して、組織階層から単語が空のレコードを除外します。
- 増分実行に組織階層モデルを含めるには、増分データフローに含めるを選択します。
- 増分実行から組織階層モデルを除外するには、増分データフローに含めるの選択を解除します。組織階層の公開が他のリアルタイムダウンストリームデータフローと競合することが予想される場合は、このオプションの選択を解除することをお奨めします。このオプションが選択されていない場合、作成されて後で分類されるモデルによって他のデータフローがブロックされることはありません。
ヒント:組織階層を公開すると、対応する非表示のカテゴリモデルが作成され、追加の使用ケースがサポートされます。作成されたカテゴリモデルは、組織階層の構造およびフィルタをミラーリングし、該当する場合はモデルのように動作します。