...
Table of Contents | ||||||
---|---|---|---|---|---|---|
|
Overview
Use 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.
...
Info |
---|
|
Field Name | Field Type | Description | Default Value | Example Field Dependency | Description | |||||||||||||||||||||
Label* Default Value: SuccessFactors Read Advanced | StringRequired. The | 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.N/A | N/A | ||||||||||||||||||||||
Entity*
| StringRequired. This property enables you to select /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. | N/A | Foundation/Platform (PLT) – User or User | |||||||||||||||||||||
Query Type
| StringDropdown list | N/A | Specify the query type. Options available Available options include:
| N/A | N/A | |||||||||||||||||||||
Expand Level Default Value: 0 | Integer1 | 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. Option available Available options include:
The filed is only available if the query type is selected as 'Expand'. | 0 | N/A | ||||||||||||||||||||
Query
| String | Specify the custom query The filed field is only available if the query type Query Type is selected as 'Custom Query'. | N/A | N/ASpecify the custom query. | ||||||||||||||||||||||
Key parameter | Fieldset | This property enables you Use this fieldset to specify the key fields to a specific entity such as userId for the Foundation/Platform (PLT) – User entity. | N/AN/A | |||||||||||||||||||||||
Field name Default Value: N/A | String | N/A | Specify the names of key Parameter (reference parameter) fields.N/A | userId | ||||||||||||||||||||||
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. | N/A | test_id | |||||||||||||||||||||
URL parameters | Fieldset | This property enables you Use this fieldset to specify the names and values of the URL parameters. | The filed This fieldset is only available if the | query type Query Type is selected as | 'Expand | '. | N/A | N/A|||||||||||||||||||
Parameter name Default Value: fromDate | String | N/A | Specify the names of the URL parameters. | fromDate | fromDate | |||||||||||||||||||||
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. | N/A | 2020-01-01 | |||||||||||||||||||||
Filter records | Fieldset | This property enables you Use this fieldset to filter the results from the API response based on the customer-selected fields. The | filed field is only available if the | query type Query Type is selected as | 'Expand | '. | N/AN/A | |||||||||||||||||||
Field name Default Value: N/A | String/Expression/Suggestion | N/A | Specify the system parameter $filter fields to be included in the output. | N/A | userId | |||||||||||||||||||||
Operation Default Value: | Dropdown list | N/A | Specify the comparison operator for the system parameter $filter. | Equals | Equals | 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. | N/A | test123 | |||||||||||||||||||||
Condition Default Value: | Dropdown list | N/A | Specify the logical operator for the system parameter $filter. | Or | OrAvailable options include: | |||||||||||||||||||||
Output field selection | Default Value:String | This property enables you Use this fieldset to select fields to be included in the output. If not selected, all fields will be returned. | ||||||||||||||||||||||||
Element Default Value: N/A | String/Expression/Suggestion | N/A | Specify the fields that will be displayed by descending or ascending order. | |||||||||||||||||||||||
Order by | Fieldset | This property enables you Use this fieldset to order the resulting records based on specified elements. The order types to be selected are either ascending or descending. The | filed field is only available if the | query type Query Type is selected as | 'Expand | '. | N/A | N/A | ||||||||||||||||||
Element Order by type Default Value: ascending | String | Specify the fields that will be displayed by descending or ascending order. | N/A | country | Order by type Default Value: | Specify the Order Type (Ascending or Descending order). | Ascending | descending | ||||||||||||||||||
Output fields advanced options | Default Value:The field is only available if the Query Type is selected as Expand. | Add advanced options to define the limited number of output entries from a specific starting entry index | .The filed is only available if the query type is selected as 'Expand'. | N/A | N/A||||||||||||||||||||||
Output entry limit
| Integer | N/A | Add advanced options to define the limited number of output entries from a specific starting entry index. | |||||||||||||||||||||||
Output entry offset Default Value: N/A | Output entry offset | IntegerInteger | N/A | This property enables you to skip the number of records the query should return. | N/A | 10 | ||||||||||||||||||||
Automatic pagination | StringAutomatic pagination Default Value: Deselected | Checkbox | The field is only available if the Query Type is selected as Expand. | By default, SuccessFactors returns a maximum of 1000 records per page. If this field is selected, all matching records will be automatically returned (beyond the 1000 records). Note that if the field “Automatic pagination” is selected, then the field “Output entry limit” should not be set or used. Either keep the field “Output entry limit”, or check the “Automatic pagination”. In case both are used, a validation exception will be thrown. The filed is only available if the query type is selected as 'Expand'. Deselected | ||||||||||||||||||||||
Allow empty query result Default Value: Selected | Checkbox | N/A | Allow empty query result | Checkbox | This property enables you to determine if the empty result will be shown in the output views. If not selected, an error will be thrown when the empty result is found.Selected | |||||||||||||||||||||
Refresh metadata Default Value: Deselected | Checkbox | N/A | Refresh metadata | Checkbox | If selected, the Snap will refresh the cache and show refreshed metadata results including new entities/parameters added or old entities/parameters deleted. This is handy in cases where changes are made to the data set outside of SnapLogic, such as a new data set created, existing data set deleted, and so on. In such cases, enabling this property will refresh the cache and display updated content. Please be aware that after the first run and new metadata has been refreshed, please de-select this checkbox.Deselected | |||||||||||||||||||||
Pass through Default Value: Selected | Checkbox | N/A | Pass through | Checkbox | This property enables you to "pass through" the data from an incoming document and merge it into the new document being written to the output. If selected, the input document will be passed through to the output view under the key 'original'. | Selected | N/A | |||||||||||||||||||
Connection details | Configure the connection details. | |||||||||||||||||||||||||
Connection | timeouttimeout* Default Value: 300 | IntegerRequired. | N/A | This property enables you to set the connection timeout duration of seconds | 300 | N/A | ||||||||||||||||||||
Number of | retriesretries* Default Value: 3 | IntegerRequired. | N/A | This property enables you to set the maximum number of re-connections if the connection is failed or timeout.3 | N/A | |||||||||||||||||||||
Retry interval | (seconds)* Default Value: 1 | IntegerRequired. | N/A | This property enables you to set the interval in seconds between reconnections. | 1 | N/A | ||||||||||||||||||||
Snap Execution
| Dropdown list | Controls whether or not a snap executes. | N/A | N/A | Select one of the three modes in which the Snap executes. Available options are:
|
Troubleshooting
Error | Reason | Resolution |
---|---|---|
You have an empty value in the Key/Value field. | key/value parameters must not be empty. | Please enter a valid value for key/value parameters. |
The input entity does not exist. | An invalid entity has been entered. | Please click the suggestion dropdown button and select the entity. |
The fields "Automatic pagination" and "Output entry limit" cannot be used at the same time. | "Output entry limit" cannot be implemented together with "Automatic pagination". | Please either select the "Automatic pagination" or fill the "Output entry limit" field |
Empty result found. | There is no data coming back from the API call | Please enable the "Allow empty query result" checkbox. |
<Entity> with key (‘<key>’) not found! | The input key parameters entered for a specific entity is not existing in the system. | Please check your input key parameters and change the key parameters to existing ones. |
...
This example pipeline demonstrates how to read PerPerson data via Employee Central (EC) - PerPerson API entity in the Success Factors data center. The example assumes that you have configured and authorized a valid SuccessFactors Account. T. The PerPerson entity is expanded until the second navigation level.
View file | ||
---|---|---|
|
...
Step 1: Configure the SuccessFactors Read Advanced Snapas shown below:
...
Step 2: Validate . Upon validation, the Snap . The Snap displays the following output in the output preview, showing the query results.
...
SuccessFactors Read Advanced Snap Configuration | Output |
Step 32: Connect a Mapper Snap, JSON Formatter Snap, and File Writer Snaps Snap to format and save the returned data in a new file. The configuration of the File Writer is shown below.
...
Downloads
Info |
---|
|
Attachments | ||||
---|---|---|---|---|
|
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
|
...