Insert Record

UiPath.SuccessFactors.Activities.SuccessFactorsInsertRecordActivity

The Insert Record activity uses the [SAP SuccessFactors])(https://api.sap.com) OData API to insert a specific record.

After inserting the record, the activity outputs the status of the request (success/failure information) in a ResponseStatus object (ResponseStatus) that you can use in subsequent activities (e.g., conditional logic).

This activity also returns the sys_id value of the new record object.

How it works

The following steps are an example of how the activity works from design time (i.e., the activity dependencies and input/output properties) to run time.

1. Complete the Setup steps.
2. Add the SuccessFactors Scope activity to your project.
3. Add the Insert Record activity inside the SuccessFactors Scope activity.
4. Click the Configure button inside the Insert Record activity (this opens the Object Wizard).
5. Select the Object you want to insert and add the fields (with values) you want to populate.
6. Create and enter a ResponseStatus variable for the Output property.
   • Your input property values are sent to the SAP SuccessFactors OData API.
   • The API returns the ResponseStatus value to your output property variable.

In the Body of the Activity

To enter your Insert Record property values, you must use the Object Wizard by clicking the Configure button.

To learn more about the Object Wizard, see the Business Activity Frameworks page.

• sys_id - The id of the ServiceNow record that gets created. Enter a String variable. The sys_id is auto-generated by SuccessFactors when you insert your new record. To retrieve this value for use in other activities, create and enter a String variable in the object wizard (example shown below).

Properties

Advanced

• AdditionalFields - A DataRow that includes the columns and values that you want to update. Enter a DataRow variable. The column names must match the names as they appear in the SuccessFactors database for the record type. Properties updated via the Object Wizard will override any that are also in AdditionalParameters.

Common

• DisplayName - The display name of the activity. This field supports only Strings or String variables.

Misc

• Private - If selected, the values of variables and arguments are no longer logged at Verbose level.

Output

• ResponseStatus - The status of the request (success/failure information). Enter a ResponseStatus variable (UiPath.BAF.Models.ResponseStatus). The ResponseStatus object includes three properties that you can use in other activities.
  • Success - Boolean - Specifies whether the API request was successful.
  • ErrorCode - String - The response error if the API request is unsuccessful (Success=False).
  • Message - String - The error message.