Skip to main content

Example

What you'll build​

Build an integration that connects to SAP SuccessFactors Employee Central and retrieves employee time sheet records through the SAP SuccessFactors Employee Central Payroll Time Sheets 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 Employee Time Sheets : Queries the EmployeeTimeSheet 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 Payroll Time Sheets 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 Payroll Time Sheets connector​

Step 1: Open the connector palette​

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

SAP SuccessFactors Employee Central Payroll Time Sheets connector palette open before selection

Step 2: Select the SAP SuccessFactors Employee Central Payroll Time Sheets connector​

  1. Enter ecpayrolltimesheets in the search field.
  2. Select the Ecpayrolltimesheets connector card.

Configuring the SAP SuccessFactors Employee Central Payroll Time Sheets 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 Payroll Time Sheets connection form with all parameters bound before saving

Step 4: Save the connection​

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

SAP SuccessFactors Employee Central Payroll Time Sheets 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 Payroll Time Sheets List Employee Time Sheets 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 Employee Time Sheets operation​

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

SAP SuccessFactors Employee Central Payroll Time Sheets connection expanded to display operations before selection

  1. Select List Employee Time Sheets. The operation has no required parameters, so review the auto-generated result variable.
  • Result : Name of the variable that stores the returned EmployeeTimeSheet records.

SAP SuccessFactors Employee Central Payroll Time Sheets List Employee Time Sheets 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 Payroll Time Sheets 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.