The following article shows how to use the Nintex Employee Onboarding scenario template with yunIO to create new employees in SAP.

About #

The Employee Onboarding scenario template provided by Nintex includes a form for filling in employee details. Based on the input, the workflow generates and sends the new hire their ‘Employee Contract’. Once the contract is signed, the workflow automatically stores the employee contract in a file storage system, starts user provisioning with Active Directory, and sends the new hire a welcome email.

This article leads you through all necessary steps to add a yunIO Xtension to the Employee Onboarding workflow to create the new employee in SAP.

Setup in yunIO #

yunIO is the connector that reads and writes data from and to SAP. For more information on yunIO, see Theobald Software: yunIO.

Note: The parameters that are needed to create new employees are dependent on your customized SAP settings.

  1. Define a connection to your SAP system in yunIO.
  2. Create a new service in yunIO. The depicted example uses the integration type Transaction for the service.
  3. Record SAP transactions to create a new employee in SAP, see Working with Transaction PA40. Example:
    PA40
  4. Parameterize all mandatory SAP fields in the yunIO service. For information on how to parameterize services, see yunIO Help: Parameterize Transactions.
    The depicted example uses the following input parameters: EntryDate, FirstName, LastName, BirthDate, BirthPlace, Language, Nationality, Street, City, PostalCode.
    The input parameters can be adjusted according to your individual scenario requirements. PA40
  5. Click run to testrun the service in yunIO (1). For more information, see Online Help: Testing a Service.
  6. Click download-file to download the service definition (2).
    yunio-Services-Function-Download

Setup in Nintex #

  1. Integrate the yunIO service created in Setup in yunIO as an Xtension in Nintex, see Integrating a yunIO Service with Nintex: Configuring a yunIO Xtension in Nintex.
  2. Import the Nintex template for Employee Onboarding to your tenant, see Nintex Gallery: Employee Onboarding.
  3. Open the imported Nintex workflow.
  4. Add the yunIO Xtension from step 1 after the contract is signed.
    personnel-actions-nintex
  5. Edit the start form to include input fields for SAP (EntryDate, FirstName, LastName, BirthDate, BirthPlace, Language, Nationality, Street, City, PostalCode):
    personnel-actions-nintex-form2
  6. Create a new variable for every Date/Time field to change the date to the format “DD.MM.YYYY”. This format is required by SAP.
    personnel-actions-nintex-date
  7. Map the parameters of the input form to the input fields of the yunIO Xtension.
    personnel-actions-nintex-parameters
  8. Optional: Add a Log to instance details action after the yunIO Xtension to monitor any returned error messages.
  9. Test the workflow.