Skip to main content

Example

What you'll build​

Build an integration that connects to SAP SuccessFactors Employee Central and retrieves secondary assignment item records through the SAP SuccessFactors Employee Central Global Assignment connector. The integration exposes an automation entry point that calls the operation and stores the result in a variable you can process further.

Operations used:

  • List Secondary Assignments Items : Queries the SecondaryAssignmentsItem collection and returns a page of entities, optionally filtered, sorted, and paged through OData query options.

Architecture​

Prerequisites​

  • Access to a SAP SuccessFactors OData API server (see the setup guide)
  • A company ID, username, and password, or OAuth 2.0 credentials

Setting up the SAP SuccessFactors Employee Central Global Assignment integration​

New to WSO2 Integrator? Follow the Create a New Integration guide to set up your integration first, then return here to add the connector.

Adding the SAP SuccessFactors Employee Central Global Assignment connector​

Step 1: Open the connector palette​

  1. Select Add Artifact.
  2. Select Connection to open the connector search palette.

SAP SuccessFactors Employee Central Global Assignment connector palette open before selection

Step 2: Select the SAP SuccessFactors Employee Central Global Assignment connector​

  1. Enter ecglobalassignment in the search field.
  2. Select the Ecglobalassignment connector card.

Configuring the SAP SuccessFactors Employee Central Global Assignment connection​

Step 3: Bind the connection parameters to configurable variables​

Bind every required connection field to a configurable variable.

  • Config : Expression containing the auth credentials for the SAP SuccessFactors OData server — bind username to a sfUsername configurable variable and password to a sfPassword configurable variable.
  • Hostname : The SAP SuccessFactors OData API server hostname — bind to a sfHostname configurable variable.

SAP SuccessFactors Employee Central Global Assignment connection form with all parameters bound before saving

Step 4: Save the connection​

Select Save Connection and verify that ecglobalassignmentClient appears in the Connections section.

SAP SuccessFactors Employee Central Global Assignment connection visible after saving

Step 5: Set actual values for your configurables​

  1. Select Configurations at the bottom of the project tree under Data Mappers.
  2. Enter a value for each configurable listed below before you run the integration.
  • sfUsername (configurable string) : The SAP SuccessFactors login username, formatted as <username>@<companyID>.
  • sfPassword (configurable string) : The SAP SuccessFactors login password.
  • sfHostname (configurable string) : The SAP SuccessFactors OData API server hostname, for example api68sales.successfactors.com.

Configuring the SAP SuccessFactors Employee Central Global Assignment List Secondary Assignments Items operation​

Step 6: Add an automation entry point​

  1. Select Add Artifact.
  2. Select Automation.
  3. Select Create to accept the default settings.

Step 7: Expand the connection and configure the List Secondary Assignments Items operation​

  1. Select the + icon between Start and Error Handler.
  2. Expand ecglobalassignmentClient to display its operations.

SAP SuccessFactors Employee Central Global Assignment connection expanded to display operations before selection

  1. Select List Secondary Assignments Items. The operation has no required parameters, so review the auto-generated result variable.
  • Result : Name of the variable that stores the returned SecondaryAssignmentsItem records.

SAP SuccessFactors Employee Central Global Assignment List Secondary Assignments Items operation with all values entered before saving

  1. Select Save. The operation step appears in the automation flow between Start and Error Handler.

Completed SAP SuccessFactors Employee Central Global Assignment flow with the configured operation

Try it yourself​

Try this sample in WSO2 Integration Platform.

Deploy to Devant

View source on GitHub

More code examples​

The SAP SuccessFactors Employee Central connectors provide practical examples illustrating usage in various scenarios. Explore these examples, covering use cases like syncing employee data and sending notifications.

  1. Google Sheets to SuccessFactors : Read employee records from a Google Sheets roster and create Personal Information records in SuccessFactors.
  2. SuccessFactors to Slack : Poll SuccessFactors for newly onboarded employees and send welcome notifications to a Slack channel.