In this article
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.
SAP Concur Read Snap is a READ-type Snap that reads different data resources from SAP Concur.
A valid account with the required permissions to read the selected resources in SAP Concur.
Works in Ultra Pipelines.
None.
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. |
|
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:
|
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. |
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.
|