Connector for SAP SuccessFactors

The Success Factors: User Attributes connector imports user attributes into Nexthink from SAP SuccessFactors using the User Management API. This connector allows you to enrich custom fields on the User object in Nexthink, enabling advanced targeting and personalization within Nexthink Adopt.

Use this connector to import custom user attributes such as role, department or location.

Prerequisites

Before configuring the Success Factors: User Attributes ensure you:

  • Configure basic authentication in SAP SuccessFactors.

  • Set up connector credentials using Basic authentication. Refer to the Nexthink connector credentials documentation for more information

Configuring authentication in SAP SuccessFactors

To integrate SAP SuccessFactors with Nexthink, configure connector credentials in the Nexthink interface using HTTP Basic authentication. Refer to the official HTTP Basic Authentication – SAP SuccessFactors OData API guide for more information.

Configuring the Success Factors: User Attributes connector

From the Nexthink web interface:

  1. Go to Administration > Inbound connectors.

  2. Click the New connector button in the top-right corner.

  3. Select Success Factors: User Attributes from the connector list.

The General tab includes:

  • Name: A meaningful name for the connector. This name appears on the Administration page.

  • NQL ID: A unique identifier for the connector used when referencing the Success Factors: User Attributes connector in NQL queries. You can initially modify the suggested NQL ID, but once you save the connector, you can no longer change the NQL ID.

  • Description: A short description of the purpose and behavior of the connector.

  • Scheduling:

    • Recurrence: Set the execution time and recurrence. Executions start at the scheduled time and distribute over the hour.

  • Connection:

    • Credentials: Select preconfigured credentials from the Connector credentials page. The connector only supports Basic authentication. Refer to the Connector credentials documentation for more information.

    • URL: The system automatically populates this URL when you select credentials.

The Parameters tab includes:

  • Select: Enter a comma-separated list of fields to import. Be sure to include a unique user identifier, such as an email address or user name. Refer to the official SAP Business Accelerator Hub documentation for available fields.

  • Expand (optional): Include related objects, such as hr or manager, if needed.

  • Filter (optional): Define a filter clause to restrict the data set. Refer to the official OData v4 protocol documentation for syntax.

The Data mapping tab includes:

  • Identification: Select a field from the API response to be used to identify users.

    • Source identifier (JSONata): Enter the field name returned by the API response that identifies users. Use JSONata if needed to transform the value.

    • Nexthink identifier: Select either UPN—requires UPN collection via Collector—or Email address —requires the Entra ID connector.

  • Field Mapping: Click Add mapping to match custom fields defined on the user object.

    • Source identifier (JSONata): Enter the field name returned by the API response that identifies users. Use JSONata if needed to transform the value.

    • Nexthink field: Select the custom field to import the value.

Known limitations

  • If employees share the same UPN, the UPN-based identification only processes the first 1,000 user records.

  • User Principal Name (UPN) requires configuration in Collector.

  • Email address requires the Entra ID (Azure AD) connector.

Last updated

Was this helpful?