SAP SuccessFactors用コネクター

SuccessFactors: ユーザー属性コネクタでは、SAP SuccessFactors から Nexthink に User Management API を使用してユーザー属性をインポートできます。 このコネクタを使用すると、Nexthink の「ユーザー」オブジェクトにカスタムフィールドを追加して、Nexthink Adopt での高度なターゲティングとパーソナライゼーションを可能にします。

役職、部署、所在地などのカスタムユーザー属性をインポートするためにこのコネクタを使用してください。

前提条件

SuccessFactors: ユーザー属性の設定前に以下を確認してください。

  • SAP SuccessFactors で基本認証を設定します。

  • 基本認証を使用してコネクタの資格情報を設定します。 詳細については Nexthink コネクタ資格情報 ドキュメンテーションを参照してください。

SAP SuccessFactors での認証の設定

SAP SuccessFactors を Nexthink と統合するには、HTTP基本認証を使用して Nexthink インターフェースでコネクタ資格情報を設定します。 公式 HTTP基本認証 – SAP SuccessFactors OData API ガイドを参照してください。

SuccessFactors: ユーザー属性コネクタの設定

Nexthink web インターフェースから:

  1. Administration > Inbound connectors に移動します。

  2. ページの右上隅にある 新しいコネクタ ボタンをクリックします。

  3. コネクタリストから Success Factors: ユーザー属性 を選択します。

一般 タブには次を含みます:

  • 名前:コネクタの意味のある名前。 この名前は管理ページに表示されます。

  • NQL ID:NQL クエリで Success Factors: ユーザー属性コネクタを参照するときに使用されるコネクタの一意の識別子。 提案されたNQL IDを最初に変更することができますが、コネクタを保存するとNQL IDを変更することはできません。

  • 説明:コネクタの目的と動作の短い説明。

  • スケジューリング

    • 再発: 実行時間と再発を設定します。 実行は指定された時間に開始し、1時間にわたって分散します。

  • 接続:

    • 資格情報:コネクタ資格情報ページで事前に設定された資格情報を選択します。 コネクタは基本認証のみをサポートします。 詳細については、コネクタ資格情報 ドキュメントを参照してください。

    • 資格情報を選択すると、システムは自動的にこの URL を入力します。

パラメーター タブには次が含まれます:

  • 選択:フィールドをカンマで区切って入力します。 メールアドレスやユーザー名など、一意のユーザー識別子を必ず含めてください。 使用可能なフィールドについては、公式 SAP ビジネスアクセラレータハブ ドキュメンテーションを参照してください。

  • 必要に応じて hrmanager などの関連オブジェクトを含めます。

  • データセットを制限するためのフィルター句を定義します。 構文については公式 OData v4 プロトコル ドキュメンテーションを参照してください。

データマッピング タブには次が含まれます:

  • API 応答からユーザーを識別するフィールドを選択します。

    • API 応答で返されるフィールド名を入力してユーザーを識別します。 必要に応じて JSONata を使用して値を変換します。

    • Nexthink 識別子: UPN を選択—Collector 経由の UPN コレクションを必要とする—または メールアドレス —Entra ID コンネクタを必要とする。

  • カスタムフィールドのマッピングを追加するには、マッピングを追加 をクリックします。

    • API 応答で返されるフィールド名を入力してユーザーを識別します。 必要に応じて JSONata を使用して値を変換します。

    • Nexthink フィールド:インポートするカスタムフィールドを選択します。

既知の制限事項

  • 同じ UPN を持つ従業員がいる場合、UPN ベースの識別では最初の 1,000 ユーザーレコードのみが処理されます。

  • ユーザープリンシパルネーム (UPN) には Collector での設定が必要です。

  • メールアドレスには Entra ID (Azure AD) コネクタが必要です。

NQL を用いた実行ログのクエリ

NQL を使用すると、次のテーブルをクエリすることで SAP SuccessFactors コネクタインスタンスの実行に関する詳細なインサイトを取得できます。

フィールド
タイプ
説明

時間

日付時刻

コネクター実行ログエントリのタイムスタンプ。

ステータス

列挙型

実行状況: • 成功: すべての行が受信され、処理されました。 • 部分的に成功: 行数制限のため一部の行が無視されました。 • 失敗: コネクターがデータを受信または処理できませんでした。

詳細.名前

文字列

コネクターインスタンスの名前。

詳細.説明

文字列

エラーの説明(ある場合)。 以下のような説明を含む: • 受信した行が多すぎます...フィールド用の無効なJSONata式

詳細.コネクター

文字列

使用されたコネクターテンプレートの名前。

詳細.資格情報

文字列

インスタンスで使用された認証情報のラベル。

詳細.資格情報_id

文字列

認証情報の一意の識別子。

詳細.nql_id

文字列

コネクターインスタンスの NQL ID。

詳細.受信行数

数値

ソースから受信した行数の合計。

詳細.処理された行数

数値

コネクターによって処理された行数の合計—インポートされた行と異なる場合があります。

platform.inbound_connector_logs クエリを実行して、すべてのインバウンドコネクター実行に関する詳細なログ情報を取得します。

NQL の例

過去24時間の失敗したインポートを取得する
platform.inbound_connector_logs 過去24時間 | 状態 == 失敗 | 順番: 時間、詳細.コネクタ、詳細.名前、詳細.エラー説明をリスト|時間の降順に並び替え
直近24時間のインポートを取得(ステータスと処理された行数を含む)
platform.inbound_connector_logs 過去24時間 | 時間、details.connector、details.name、details.number_of_processed_rows をリスト | 時間の降順でソート

Last updated

Was this helpful?