サポート (英語のみ)

SAP SuccessFactors用コネクター

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

このコネクタを使用して、役割、部門、または場所などのカスタムユーザー属性をインポートします。 このコネクタは基本認証方式のみをサポートしています。

前提条件

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

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

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

Nexthinkインターフェースで証明書を作成する

SAP SuccessFactorsでOAuth 2.0クライアントアプリケーションを作成する前に、Nexthinkで証明書を作成します。

  1. NexthinkのWebインターフェースで、管理 > コネクタ資格情報に移動します。

  2. 新しい資格情報をクリックします。

  3. 次のフィールドに入力します:

    • 名前: 意味のある名前を入力します。 例: SAP SuccessFactors OAuth 2.0 – SAML。

    • プロトコル: HTTPS (Hypertext Transfer Protocol Secure) を選択します。

    • URLアドレス: サブスクライバーから提供されたSAP SuccessFactors URLを入力します。

    • 認証: OAuth 2.0 – SAML を選択します。

  4. 資格情報を保存します。 証明書が正常に作成されましたのモーダルが表示されます。

  5. 証明書の値をコピーします。

この証明書は、SAP SuccessFactorsでOAuth 2.0クライアントアプリケーションを登録するときに使用します。

SAP SuccessFactors での認証の設定

NexthinkとSAP SuccessFactorsを統合するには、以下のいずれかの認証方法を使用してコネクタ資格情報を設定します。

  • 基本認証。 詳細については、公式のHTTP基本認証 - SAP SuccessFactors OData APIガイドを参照してください。

  • OAuth 2.0認証。 詳しくは、公式のOAuth 2.0を使用した認証ドキュメントをご覧ください。 SAP SuccessFactorsでOAuth 2.0クライアントアプリケーションを登録する際は、Nexthinkで新しい資格情報を作成した後にコピーした証明書を使用してください。

OAuth 2.0認証のためのコネクタ資格情報を設定する

SAP SuccessFactorsでOAuth 2.0クライアントアプリケーションを登録した後、Nexthinkで資格情報の設定を完了します。

  1. NexthinkのWebインターフェースで、管理 > コネクタ資格情報に移動します。

  2. 該当する資格情報にカーソルを合わせ、編集（鉛筆アイコン）をクリックします。

  3. SAML設定配下で、自分のSAP SuccessFactors設定から提供された値で次のフィールドを入力します。

    • NameID: SAP SuccessFactorsでOAuth 2.0クライアントアプリケーションにアクセスする権限のあるユーザーのSAP SuccessFactorsユーザーIDを入力します。

    • Recipient: OAuthトークンを要求するAPIサーバーのURLを入力します。 SuccessFactorsは、次の形式でアクセストークンを生成します:\https:///oauth/token。

      • あなたのSuccessFactorsデータセンターが<success-factors-api-server>の値を決定します。

      詳しくは、公式のSAP SuccessFactorsデータセンターURLリストドキュメントをご覧ください。

    • Issuer: SAMLアサーションの発行者情報を入力します。例えば、https://www.nexthink.com。

    • Audience: SAMLアサーションの受取人の値を入力します。 非空の任意の値が許可されています。例えば、https://www.successfactors.com。

  4. SAML属性の下で、新しい属性を追加します:

    • 名前: api_key

    • 値: SAP SuccessFactorsでOAuth 2.0クライアントアプリケーションを登録した際に生成されたclient_id APIキーを貼り付けます。

  5. OAuthトークンリクエストの下で、新しいエントリリクエストのためにトークンリクエストを追加をクリックします:

  • エントリ1

    • 名前: client_id

    • 値: SAML属性で使用した同じclient_id APIキーを貼り付けます。

  • エントリ2

    • 名前: company_id

    • 値: SAP SuccessFactorsのcompany_id値を入力します。

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

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

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

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

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

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

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

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

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

  • スケジューリング：

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

  • 接続:

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

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

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

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

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

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

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

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

    • API 応答で返されるフィールド名を入力してユーザーを識別します。 必要に応じて JSONata を使用して値を変換します。 空白やJSONata予約文字（例: ., +, -, *, /, { など）を含むフィールド名はバックティック（\`）で囲む必要があります。

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

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

    • API 応答で返されるフィールド名を入力してユーザーを識別します。 必要に応じて JSONata を使用して値を変換します。 空白やJSONata予約文字（例: ., +, -, *, /, { など）を含むフィールド名はバックティック（\`）で囲む必要があります。

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

既知の制限事項

  • コネクタは、同期ごとに300万レコードを超えて処理することはできません。

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

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

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

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

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

フィールド
タイプ
説明

時間

日付時刻

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

ステータス

列挙型

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

詳細.名前

文字列

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

詳細.説明

文字列

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

詳細.コネクター

文字列

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

詳細.資格情報

文字列

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

詳細.資格情報_id

文字列

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

詳細.nql_id

文字列

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

詳細.受信行数

数値

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

詳細.処理された行数

数値

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

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

このテーブルにアクセスするには、データモデルの可視性でPlatform ログの許可が有効になっている必要があります。

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?