SuccessFactors Read Advanced
In this article
Overview
You can use this Snap to retrieve data objects from SuccessFactors Data Center. The Snap provides the ability to read the navigation property by expanding the navigation level. Learn more about SuccessFactors APIs: SuccessFactors Documentation.
Snap Type
SuccessFactors Read Advanced is Read-type Snap that
Prerequisites
Valid SuccessFactors Host server.
Valid User Id.
Valid Password.
Support for Ultra Pipelines
Works in Ultra Pipelines.
Limitations and Known Issues
None.
Snap Views
Type | Format | Number of Views | Examples of Upstream and Downstream Snaps | Description |
---|---|---|---|---|
Input | Document |
|
| A document containing data that can be used to filter entities that need to be retrieved in SuccessFactors.
|
Output | Document |
|
| A document containing the data retrieved from a SuccessFactors entity. |
Error | Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can handle the errors that the Snap might encounter when running the Pipeline by choosing one of the following options from the When errors occur list under the Views tab:
Learn more about Error handling in Pipelines. |
Snap Settings
Asterisk ( * ): Indicates a mandatory field.
Suggestion icon (): Indicates a list that is dynamically populated based on the configuration.
Expression icon ( ): Indicates the value is an expression (if enabled) or a static value (if disabled). Learn more about Using Expressions in SnapLogic.
Add icon ( ): Indicates that you can add fields in the fieldset.
Remove icon ( ): Indicates that you can remove fields from the fieldset.
Upload icon ( ): Indicates that you can upload files.
Field Name | Field Type | Field Dependency | Description | |
Label* Default Value: SuccessFactors Read Advanced | String | N/A | Specify 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. | |
Entity*
| String/Expression | N/A | Specify a business object from the list of business objects for SuccessFactors API. SuccessFactors stores data in multiple table structures, which are commonly known as Entities, there are various entities for Foundation as well as Personal/Employment Objects. This field will be shown dynamically from different users’ accounts from the suggestion dropdown. Users are allowed either to choose an entity from suggestion dropdown or type an entity manually. The entity is shown as [category name] – [entity name] in the dropdown. But it is also allowed to type only [entity name] in this field. | |
Query Type
| Dropdown list | N/A | Specify the query type. Available options include:
| |
Expand Level
Default Value: 0 | Dropdown list | The field is only available if the Query Type is selected as Expand. | Specify the sublevel of the business object you want to access. The business object would be expanded until the sublevel selected. Available options include:
| |
Query
| String | The field is only available if the Query Type is selected as Custom Query. | Specify the custom query.
| |
Key parameter | Use this fieldset to specify the key fields to a specific entity such as userId for the Foundation/Platform (PLT) – User entity. | |||
Field name
Default Value: N/A | String | N/A | Specify the names of key Parameter (reference parameter) fields. | |
Field value
Default Value: N/A | Any | N/A | Specify the values of key Parameter (reference parameter) fields. The data type of this field depends on what Field name you selected or entered which can be String, Integer, Boolean, etc. | |
URL parameters | Use this fieldset to specify the names and values of the URL parameters. This fieldset is only available if the Query Type is selected as Expand. | |||
Parameter name
Default Value: fromDate | String | N/A | Specify the names of the URL parameters. | |
Parameter value
Default Value: N/A | Any | N/A | Specify the values for service operation fields. The data type of this field depends on what Field name you selected or entered which can be String, Integer, Boolean, etc. | |
Filter records | Use this fieldset to filter the results from the API response based on the customer-selected fields. The field is only available if the Query Type is selected as Expand. | |||
Field name
Default Value: N/A | String/Expression/Suggestion | N/A | Specify the system parameter $filter fields to be included in the output. | |
Operation
Default Value: | Dropdown list | N/A | Specify the comparison operator for the system parameter $filter. Available options include: | |
Field value
Default Value: N/A | String/Expression | N/A | Enter the values of specified input $filter fields. The data type of this field depends on what Field name you selected or entered which can be String, Integer, Boolean, etc. | |
Condition
Default Value: | Dropdown list | N/A | Specify the logical operator for the system parameter $filter. Available options include: | |
Output field selection | Use this fieldset to select fields to be included in the output. If not selected, all fields will be returned. | |||