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:
Go to Administration > Inbound connectors.
Click the New connector button in the top-right corner.
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
ormanager
, 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:
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
Last updated
Was this helpful?