Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In this article

...

Use this Snap to update or insert data objects from the SuccessFactors Data Center. The Snap automatically inserts the data in case the records are not available. For more information about SuccessFactors APIs, see refer to SuccessFactors Documentation.

Prerequisites

  • A valid SuccessFactors host server.
  • A valid account with the roles required to perform the Upsert operation on the selected entity.

...

Limitations and Known Issues

None.

Snap Input and Output

Input/OutputType of ViewNumber of ViewsExamples of Upstream and Downstream SnapsDescription
Input 

Document

  • Min:1
  • Max:1
  • Mapper
  • Copy
  • CSV Parser
  • JSON Parser

A document containing the data that must be created or updated, and has to be written into the SuccessFactors Data Center for the selected entity.


Output

Document

  • Min:0
  • Max:1
  • Mapper
  • Copy
  • CSV Parser
  • JSON Parser

A document containing the status data for each record in the batch input to confirm whether the data creation or update was successful. 


...

Parameter NameData TypeDescriptionDefault ValueExample 

Label

String

Required. The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your Pipeline.

N/A

N/A

Entity

String

Required. Lets you define an entity of the API.  You can either choose an entity from the suggestion drop-down or type an entity manually. The values in the suggestion drop-down are displayed dynamically from different users’ accounts.

The entity is shown as [category name] – [entity name] in the drop-down; however, you can also type just the [entity name] in this field.

N/A

Foundation/Platform (PLT) User or User


Batch size

Integer

Required. This property value is allowed to be from 1 through 10,000. Each input document forms one SuccessFactors record to be upserted. The Snap stores record in memory until the number of records reaches the batch size and sends the request to SuccessFactors in a single batch. Increasing the batch size increases the amount of memory used during the data load. Decreasing the batch size increases the number of API calls against SuccessFactors.

200

200, 1000

Refresh metadata

Check box

If selected, the Snap refreshes the cache and shows the refreshed metadata results including any entities/parameters that were added or deleted. This is useful in cases where changes are made to the dataset outside of SnapLogic, such as when a dataset has been created or deleted, or when there are changes in the metadata of SuccessFactors. 

Info

After the first run and after the metadata has been refreshed, please deselect this checkbox.


Deselected

N/A

Multiexcerpt include macro
nameSnap Execution
pageSOAP Execute

Check box

Multiexcerpt include macro
nameExecution_Detail_Write
pageSOAP Execute

Execute only

N/A

...

Successful validation of the Snap gives the following output preview, where the user ID from the source data is mapped to the key in the output response and a status of "OK" indicates a successful update operation.

Finally, an XML Formatter Snap and a File Writer Snap are added downstream to format and save the returned data in a new file. In the image below, the output is written to the SuccessFactors_Upsert.xml file. 

...