SAP Concur Read
In this article
Overview
You can use this Snap to read or fetch the data resources from SAP Concur. For more information about SAP Concur APIs, refer to SAP Concur API Documentation.
Snap Type
SAP Concur Read Snap is a READ-type Snap that reads different data resources from SAP Concur.
Prerequisites
A valid account with the required permissions to read the selected resources in SAP Concur.
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 SAP Concur. |
Output | Document |
|
| A document containing the data retrieved from a SAP Concur. |
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 field set.
Remove icon ( ): Indicates that you can remove fields from the field set.
Upload icon ( ): Indicates that you can upload files.
Field Name | Field Type | Field Dependency | Description | |
---|---|---|---|---|
Label*
Default Value: SAP Concur Read | String | None. | Specify a unique name for the Snap.
| |
API Version
Default Value: v3.0 | Dropdown list | None. | Specify the API version of the SAP Concur. For more information about the API refer to Swagger API Explorer. Available values are:
| |
Entity*
Default Value: N/A | String/Expression/Suggestion | Depends upon the selected API version. | Specify an entity or data objects to read. You can specify a static value or pass the value dynamically. This field populates suggestions of entities available in the chosen version of API. | |
Operation*
Default Value: N/A | String/Expression | Depends on the selected entity. | Define the Action (SAP Concur Endpoint). | |
Required parameters | Use this field set to specify the required fields for a selected operation. If there is any suggestion it means these parameters are required for the selected endpoint. | |||
Parameter
Default Value: N/A | String | None. | Specify the names of the required parameters. | |
Value
Default Value: N/A | String | None. | Specify the values of the required parameters. The data type of this field depends on what parameter name you selected or entered which can be String, Integer, Boolean, etc. | |
Optional parameters | Use this fieldset to specify the names and values of optional parameters defined in SAP concur API Documentation. | |||
Parameter
Default Value: N/A | String | None. | Specify the names of the optional parameters. | |
Value
Default Value: N/A | String, Integer, Boolean | None. | Specify the values for optional parameters. The data type of this field depends on what parameter name you selected or entered which can be String, Integer, Boolean, etc. | |
Output entry offset
Default Value: N/A | Integer | None. | Specify the number to skip the records until a given entity ID. You can leave it empty if you don’t want to skip any records. | |
Output entry limit
Default Value: N/A | Integer | None. | Specify the number of records the query should return. You can leave it empty to retrieve the default number of records. | |
Automatic pagination
Default Value: Deselected | Checkbox | None. | Select if you want results of all the records matching to be acquired automatically beyond the limit. By default, SAP Concur returns a limit of records depending on the entity. | |
Connection Timeout*
Default Value: 30 | Integer | None. | Specify the connection timeout duration in seconds. | |
Number of Retries*
Default Value: 3 | Integer | None. | Specify the maximum number of reconnections if the connection is failed or timeout. | |
Retry Interval (seconds)*
Default Value: 3 | Integer | None. | Specify the interval in seconds between reconnections. | |
Snap Execution
Default Value: Validate & Execute | Dropdown list | None. | Select one of the following three modes in which the Snap executes:
|
Troubleshooting
Error | Reason | Resolution |
---|---|---|
Missing required parameters. | There is a parameter required for the selected operation and that was not provided. | Check the required parameters and add missing ones. |
Examples
Retrieve Vendor data from SAP Concur
The SAP Concur Read Snap is here used to retrieve all the user or Employee data from SAP Concur. The example assumes that you have configured and authorized a valid Concur Account. For more information, refer to SAP Concur OAuth2 account. The following SAP Concur Read Snap shows how you can query and retrieve records from SAP Concur.
The configuration of the SAP Concur Read Snap for this example is shown below.
A successful validation of the Snap displays the query results in the output preview.
Downloads
Download and import the Pipeline into SnapLogic.
Configure Snap accounts, as applicable.
Provide Pipeline parameters, as applicable.