- 05 Jul 2022
- 2 Minutes to read
SAP AppGyver BTP Destinations Integration
- Updated on 05 Jul 2022
- 2 Minutes to read
BTP Destinations feature is only available for BTP customers! See Getting a SAP BTP account to gain access.
BTP Destinations enable you to use SAP Systems as the Data resource in SAP AppGyver. Due to a direct connection to the SAP Authentication services, the integration does not require access configuration.
Creating a project
Open the SAP AppGyver Subscription in BTP Cockpit.
Create a new AppGyver Project.
SAP BTP Authentication
Next, to make it possible to seemingly use BTP Integrations, you have to enable SAP Authentication for your app.
Navigate to the 'Auth' tab and click on 'Enable Authentication'. Choose 'SAP BTP authentication' from the three options and confirm your choice in a pop-up. Click on 'Save BTP configuration' to enable the authentication.
Adding Data endpoints
Navigate to the 'Data' tab. You should see the following view:
Click 'Add Integration' and choose 'BTP Destinations'. From here, you should see all available connections, including ones configured by you*. In further two sections you will find example cases of configuring the integrations. The process is similar/same for other connections.
*Destinations configured with the
HTML5.DynamicDestination = true &
AppgyverEnabled = true tags.
Example Case 1: Integrate with S/4 HANA Cloud
The S/4 Hana instance should include a
IsCatalog = true metadata prop to be available.
Choose 'catalog_onpremise_basic (S/4 HANA Cloud)' from the list of options and look for 'Bank' via the Search bar above.
Click 'Browse Data' to enter data visualization view.
Here, you can optionally add or modify data entries before installing the integration. To add a new entry, click on the 'New Record' button in the top right corner. Fill in the fields and press on 'Save Record'. To Delete a record, scroll to the bottom of the properties and press 'Delete'. Upon finalizing the configuration, close the view.
Click 'Install Integration' and 'Enable Data Entity'.
Example Case 2: Direct OData Integration
Choose 'Northwind' from the list of services.
Select 'Products' from the 'Data entities' list
Optionally Add/Modify data via the 'Browse Data' view. Click 'Install Integration' and 'Enable Data Entity'.
Using the BTP Integration
The easiest way to utilize the configured BTP Integration is to use a Data Component. Install a 'Basic list' from the Component Market. You can do so by searching it via the name ('Basic List'), or the sharing token: B04nyWpatmoJ7P4YrEq2Mw.
Upon installing, you will find it under the 'Installed' tab above the Component Market. Drag it onto the view canvas.
In the 'Properties' tab on the right, click 'Configure' to enter a Data Component configuration view. It allows you to map the fields of the component with the fields from the installed integration without having to enable data variables nor configuring any logic.
Begin the configuration by choosing a Data resource. In this case, 'Products' refers to the OData integration, and 'MasterData' is S/4 HANA.
Here, connect the Data Resource fields on the left to Component's fields on the right via dragging them to a desired location. Note, that only fields of the same data type (i.e text or number) can be connected together.
In the 'Properties' tab, set the required 'Authentication' field to 'Object with properties', and set 'Authentication type' to be public:
Save and Exit the configuration via the breadcrumb button in the top right corner. Preview the app and you should be presented with the data.
Check out the Using BTP Authentication and Destinations with SAP AppGyver blog on SAP Community!