--- title: Deploy and Run the Incident Management Application in the SAP BTP, Cloud Foundry Runtime with SAP S/4HANA Cloud Backend description: This tutorial shows you how to prepare your application, deploy it as a Multitarget Application (MTA), and test it with SAP S/4HANA Cloud connectivity. parser: v2 auto_validation: true time: 45 tags: [ tutorial>intermediate, tutorial>license, software-product-function>sap-cloud-application-programming-model, programming-tool>node-js, software-product>sap-business-technology-platform] primary_tag: software-product-function>sap-cloud-application-programming-model author_name: Svetoslav Pandeliev author_profile: https://github.com/slavipande slug: remote-service-deploy-to-cf canonical_url: https://developers.sap.com/tutorials/remote-service-deploy-to-cf --- ## You will learn - How to connect to your SAP S/4HANA Cloud system. - How to extend the existing MTA build file with the settings for the SAP S/4HANA Cloud extension service. - How to test the application with your SAP S/4HANA Cloud system. ## Prerequisites - You've set up the connection to an SAP S/4HANA Cloud system. Follow the steps in the [Configure Connectivity Between SAP S/4HANA Cloud and SAP Business Technology Platform](remote-service-configure-connectivity) tutorial that is part of the [Consume Remote Services from SAP S/4HANA Cloud in Your Full-Stack CAP Application Following the SAP BTP Developer's Guide and Deploy in SAP BTP, Cloud Foundry Runtime](https://developers.sap.com/group.sap-s4hana-consume-remote-services.html) tutorial group. - You have an [enterprise global account](https://help.sap.com/docs/btp/sap-business-technology-platform/getting-global-account#loiod61c2819034b48e68145c45c36acba6e) in SAP BTP. To use services for free, you can sign up for an SAP BTPEA (SAP BTP Enterprise Agreement) or a Pay-As-You-Go for SAP BTP global account and use the free tier services only. See [Using Free Service Plans](https://help.sap.com/docs/btp/sap-business-technology-platform/using-free-service-plans?version=Cloud). - You have a platform user. See [User and Member Management](https://help.sap.com/docs/btp/sap-business-technology-platform/user-and-member-management). - You're an administrator of the global account in SAP BTP. - You have a subaccount in SAP BTP to deploy the services and applications. - You have one of the following browsers that are supported for working in SAP Business Application Studio: - Mozilla Firefox - Google Chrome - Microsoft Edge > **OUT OF MAINTENANCE** > > This tutorial is no longer maintained. For an up-to-date version and support with any issues, refer to the [Develop a Side-by-Side CAP-Based Extension Application Following the SAP BTP Developer's Guide](https://discovery-center.cloud.sap/missiondetail/4426/4712/?tab=overview) mission in the [SAP Discovery Center](https://discovery-center.cloud.sap/). ### Prepare the Incident Management application First, you create a service instance for the SAP S/4HANA Cloud Extensibility service with plan `api-access`. The SAP S/4HANA Cloud system provides pre-defined communication scenarios that contain one or multiple APIs. When creating the service instance, the communication scenario needs to be specified along with some configuration. Under the hood, a communication arrangement based on the given scenario is created in the SAP S/4HANA Cloud system. 1. Create a new file **bupa.json** in the root folder of the project and paste the following code snippet in it: ```json { "systemName": "", "communicationArrangement": { "communicationArrangementName": "", "scenarioId": "SAP_COM_0008", "inboundAuthentication": "BasicAuthentication", "outboundAuthentication": "BasicAuthentication", "outboundServices": [ { "name": "Replicate Customers from S/4 System to Client", "isServiceActive": false }, { "name": "Replicate Suppliers from S/4 System to Client", "isServiceActive": false }, { "name": "Replicate Company Addresses from S/4 System to Client", "isServiceActive": false }, { "name": "Replicate Workplace Addresses from S/4 System to Client", "isServiceActive": false }, { "name": "Replicate Personal Addresses from S/4 System to Client", "isServiceActive": false }, { "name": "Business Partner - Replicate from SAP S/4HANA Cloud to Client", "isServiceActive": false }, { "name": "Business Partner Relationship - Replicate from SAP S/4HANA Cloud to Client", "isServiceActive": false }, { "name": "Business Partner - Send Confirmation from SAP S/4HANA Cloud to Client", "isServiceActive": false }, { "name": "BP Relationship - Send Confirmation from SAP S/4HANA Cloud to Client", "isServiceActive": false } ], "communicationSystem": { "communicationSystemHostname": "default.com", "outboundCommunicationUser": { "username": "DefaultUser", "password": "DefaultPassword" } } } } ``` - For **systemName**, enter the name of your registered SAP S/4HANA Cloud system. For example, `SAP S/4HANA DEV System`. - For **communicationArrangementName**, enter a name for the communication arrangement that is created for the SAP S/4HANA Cloud tenant. For example, `INCIDENT_MANAGEMENT_0008`. > For more information, see [Communication Arrangement JSON/YAML File - Properties](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Cloud/en-US/553a4c6b98be4c1ba7d1dfa0e9df8669.html). 2. Navigate to the **package.json** file in the root folder of the application. Add the `[production]` profile `credentials` (`destination` and `path`) to the settings for **API_BUSINESS_PARTNER**: ```json "API_BUSINESS_PARTNER": { "kind": "odata-v2", "model": "srv/external/API_BUSINESS_PARTNER", "[production]": { "credentials": { "destination": "incidents-api-access", "path": "/sap/opu/odata/sap/API_BUSINESS_PARTNER" } } } ``` 2. Open the **mta.yml** file and add the following code snippet to the **resources** section: ```yaml - name: incidents-api-access type: org.cloudfoundry.managed-service parameters: path: ./bupa.json service: s4-hana-cloud service-plan: api-access system-name: ``` > For **system-name**, enter the name of your registered SAP S/4HANA Cloud system. For example, `SAP S/4HANA DEV System`. 4. In the **mta.yml** file, make sure that the line `- name: incident-management-destination` is added to the **requires** section of the **incident-management-srv** module: ```yaml - name: incident-management-srv type: nodejs path: gen/srv requires: - name: incident-management-auth - name: incident-management-db - name: incident-management-destination .... ``` ### Deploy the application 1. Log in to your subaccount in SAP BTP: ```bash cf api cf login cf target -o -s ``` > You can find the API endpoint in the **Overview** section of your subaccount in the SAP BTP cockpit. 5. Run the following commands to build and deploy your project in the SAP BTP, Cloud Foundry runtime: ```bash mbt build cf deploy mta_archives/incident-management_1.0.0.mtar ``` ### Test the Incident Management application When creating new entries in the Incident Management application, you see all values from your SAP S/4HANA Cloud system in the value help of the **Customer** field. > Before you continue with this step, don’t forget to perform the steps from the tutorials [Assign the User Roles](https://developers.sap.com/tutorials/user-role-assignment.html) and [Integrate Your Application with SAP Build Work Zone, Standard Edition](https://developers.sap.com/tutorials/integrate-with-work-zone.html). 1. Open your SAP Build Work Zone, standard edition site as described in [Integrate Your Application with SAP Build Work Zone, Standard Edition](https://developers.sap.com/tutorials/integrate-with-work-zone.html). 6. Choose the Incident Management tile. ![Incident Management tile on the launchpage](https://raw.githubusercontent.com/sap-tutorials/btp-dev-guidance/main/tutorials/remote-service-deploy-to-cf/incident-management-tile.png) 9. Choose **Create** to start creating a new incident. ![Create a new incident](https://raw.githubusercontent.com/sap-tutorials/btp-dev-guidance/main/tutorials/remote-service-deploy-to-cf/create-new-incident.png) 11. Open the value help for the **Customer** field. ![Value help for Customer field](https://raw.githubusercontent.com/sap-tutorials/btp-dev-guidance/main/tutorials/remote-service-deploy-to-cf/value-help-customer.png) 12. Verify that customer data is fetched from the SAP S/4HANA Cloud system. ![Data in value help](https://raw.githubusercontent.com/sap-tutorials/btp-dev-guidance/main/tutorials/remote-service-deploy-to-cf/value-help-data1.png) Congratulations! You have successfully developed, configured, and deployed the Incident Management application using an external service and an SAP S/4HANA Cloud system.