Support

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.

Querying execution logs with NQL

Using NQL, you can retrieve detailed insights into the execution of the SAP SuccessFactors connector instances by querying the following table:

Field
Type
Description

time

datetime

Timestamp of the connector execution log entry.

status

enumeration

Execution status: • success: All rows received and processed • partial: Some rows ignored due to row limit • failure: Connector could not receive or process data

details.name

string

Name of the connector instance

details.description

string

Description of the error(s), if any. Includes description such as: • "Too many rows received..." • "Invalid JSONata expression for field "

details.connector

string

Name of the connector template used

details.credentials

string

Label of the credentials used in the instance

details.credentials_id

string

A unique identifier of the credentials

details.nql_id

string

NQL ID of the connector instance.

details.number_of_received_rows

number

Total number of rows received from the source

details.number_of_processed_rows

number

Total number of rows processed by the connector (may differ from imported rows)

Run platform.inbound_connector_logs query to retrieve comprehensive logging information about all inbound connector executions.

To access this table, you must have the View platform logs in NQL permission.

NQL examples

Retrieve failed imports for the last 24h
platform.inbound_connector_logs during past 24h | where status == failure | list time, details.connector, details.name, details.error_description | sort time desc
Retrieve last imports for the last 24h (including status and number of processed rows)
platform.inbound_connector_logs during past 24h | list time, details.connector, details.name, details.number_of_processed_rows | sort time desc

Last updated

Was this helpful?