Skip to content

routing-via-service-aba737f.md

Latest commit

 

History

History
144 lines (94 loc) · 4.23 KB

routing-via-service-aba737f.md

File metadata and controls

144 lines (94 loc) · 4.23 KB

Routing via Service

Maintain Route

In order to access the service instance of the ABAP environment directly, maintain a route with service com.sap.cloud.abap and endpoint abap for the path of the OData service in the xs-app.json file.

Sample Code:

"routes": [
  {
    "source": "^/sap/(.*)$",
    "target": "/sap/$1",
    "service": "com.sap.cloud.abap",
    "endpoint": "abap",
    "authenticationType": "xsuaa",
    "csrfProtection": false
  } ]

Bind ABAP Service Instance

Bind the service instance to the approuter. You can bind the service instance using the SAP BTP cockpit or by supplying the information in the multitarget application.

The following service binding parameters are supported by the ABAP service:

Binding Parameter

Description

abap_endpoint_timeout

Positive integer that defines the time in milliseconds when the communication between the approuter and service instance will be timed out. The default value is 30000, which corresponds to 30 seconds.

This default value is suitable for most applications. However, the communication with the service instance may take longer. If you experience timeouts, you can maintain a value higher than 30 seconds. The maximum value is 600000, which corresponds to 10 minutes.

create_x_sap_security_session

Boolean that defines if the approuter shall request a security session cookie by setting the x-sap-security-session: true http header. The default is true.

For more information regarding security session cookies, see SAP Note 3319136 - No implicit security session creation for API callers calling an ABAP Cloud system as of 2402.

For more information, see Binding Service Instances to Applications.

Bind Service Instance Using the Cockpit

  • Log on to the cockpit and go to the subaccount that contains the space you'd like to navigate to. See Navigate in the Cockpit.

  • In the navigation area, go to Cloud Foundry Spaces and choose your space.

  • Select service instances from the navigation area and navigate to your ABAP system service instance.

  • In the service instance details section that opens to the right, select the Actions menu and then select Bind Application.

  • In the New Binding wizard, choose the application to bind.

  • Provide the parameters for your binding by specifying the parameter in JSON format. For example:

    Sample Code:

    {
  "abap_endpoint_timeout": 600000,
  "create_x_sap_security_session": false
}

For more information, see Binding Service Instances to Applications.

Bind Service Instance in Multitarget Application

To bind the service instance to the approuter, add the service instance as a required resource in the mta.yaml file. For example:

Sample Code:

_schema-version: "3.2"
ID: my-mta
version: 1.0.
modules:
- name: my-app
  type: approuter.nodejs
  path: cf/router
  requires:
  - name: my-abap-service-instance
    parameters:      
      config:
        create_x_sap_security_session: false
        abap_endpoint_timeout: 600000
…
resources:
- name: my-abap-service-instance
  type: org.cloudfoundry.existing-service
  parameters:
    service: abap
    service-plan: standard
    service-name: my-abap-service-instance-name
…