--- parser: v2 auto_validation: true primary_tag: products>sap-btp--abap-environment <<<<<<< HEAD tags: [ tutorial>beginner, programming-tool>abap-development, products>sap-business-technology-platform, tutorial>license ] ======= tags: [ tutorial>beginner, programming-tool>abap-development, products>sap-business-technology-platform, tutorial>license, software-product-function>s-4hana-cloud-abap-environment ] >>>>>>> 59f95048a11e62962d5c8eb49e89b6f027533a25 time: 15 author_name: Niloofar Flothkoetter author_profile: https://github.com/niloofar-flothkoetter slug: abap-environment-communication-arrangement canonical_url: https://developers.sap.com/tutorials/abap-environment-communication-arrangement --- # Maintain a Communication Arrangement for Inbound Communication Create a communication user and a communication system for an OData service in SAP Business Technology Platform ABAP Environment. ## Prerequisites - You have the business catalog **communication management (`SAP_CORE_BC_COM`)** assigned to your business user. ## You will learn - How to create a communication user - How to create a communication system - How to create a communication arrangement ## Intro <<<<<<< HEAD ======= This tutorial was written for SAP BTP ABAP Environment. However, you should also be able to use it in SAP S/4HANA Cloud Environment in the same way. >>>>>>> 59f95048a11e62962d5c8eb49e89b6f027533a25 Always replace `XXX` with your initials or group number. --- ### Overview In case you want to expose developed ABAP services for technical communication, you are expected to bundle them into a Communication Scenario. This Communication Scenario can then be consumed as a whole by different Communication Systems, represented by Communication Users. The combination of a Scenario, a System and a User is represented by a Communication Arrangement. ![click on New](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/Picture21.png) ### Login to SAP Fiori Launchpad 1. Open Eclipse and do right click your system and navigate to **Properties**. ![Open Eclipse](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/Picture17.png) 2. Navigate to **ABAP Development** and copy the **System URL**. ![System URL](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/Picture18.png) <<<<<<< HEAD ======= >>>>>>> 59f95048a11e62962d5c8eb49e89b6f027533a25 ### Create communication user 1. Navigate to **Maintain Communication User**. ![Navigate to application](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/Picture3.png) 2. Create a new user by clicking **New**. ![click on New](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/Picture4.png) ### Add communication user data 1. Enter user name `TEST_XXX`, where `XXX` is your group number, and description for your user. 2. Use **propose password** button since the password has to be 20 characters and save the generated password in a text file for the following exercises. 3. Click **Create**. ![Add Communication User data](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/Picture5.png) ### Create communication system 1. Navigate back to Home and then to **Communication System**. ![communication system app](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/Picture6.png) 2. Create a new communication system by clicking **New**. ![click on New button](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/Picture7.png) ### Add system ID 1. Add a system ID and system name. - System ID: `WEBIDE_BASIC_XXX` - System Name: `WEBIDE_BASIC_XXX` 2. Click **Create**. A new communication system will be registered. ![Add system ID](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/Picture8.png) ### Add communication system data 1. You can retrieve the system host name by right-clicking on your ABAP Cloud Project, selecting **Properties** from the context menu and clicking on **ABAP Development** in the hierarchy of properties. Copy the system URL and remove `https://` at its beginning. ![Add hostname](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/Picture18.png) 2. Click  **+** button to add the created communication user for inbound communication. Inbound communication means that the here defined system is used from a communication partner to call from external into the SAP S/4HANA system. 3. Click **Save**. ![Add data](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/Picture9.png) ![Add communication user](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/Picture10.png) ### Create communication arrangement 1. Navigate back to Home and then to **Communication Arrangement**. ![Communication Arrangement application](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/Picture11.png) 2. Create a new communication arrangement by clicking **New**. ![click on new](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/Picture12.png) ### Select scenario Select your communication scenario that you created in the last tutorial, `Expose a Standard Core Data Service for ABAP Environment`, and click **Create**. ![Select Scenario](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/Picture13.png) ### Add communication arrangement data 1. Add your communication system and select the communication user which you created in the first step in this tutorial. 2. Copy this service URL / service interface from created communication arrangement, you will need it in next steps. 3. Click **Save**. The URL from the communication arrangement should look as followed: `https://.abap.eu10.hana.ondemand.com/sap/opu/odata/sap/Z_BIND_XXX` (where XXX is your group number) ![Enter Data](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/Picture14.png) ### Check the service URL via Postman You can check your service URL via Postman. In Step 12 you'll learn how to check your communication scenario via SAP BTP Cockpit. 1. Paste your service URL in a browser or in Postman. 2. Use the communication user and password. 3. Check if you can connect to the service and there is no error. ![check Service](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/Picture15b.png) ![check Service](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/Picture16.png) ### Check communication scenario via SAP BTP Cockpit 1. Logon to your [SAP BTP Cockpit](https://account.hana.ondemand.com). ![check scenario](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/signIn.png) 2. Select your global account. ![check scenario](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/global.png) 3. Select Subaccounts. ![check scenario](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/subaccounts.png) 4. Select your subaccount. ![check scenario](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/subaccount.png) 5. Select Service Instances and find your Instance and open it by clicking the arrow. ![check scenario](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/serviceInstances.png) 6. Click Actions to create Service Key. ![check scenario](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/actions.png) 7. Create Service key with the following parameters: - Name: ADT - Configuration Parameters (JSON): ```JSON { "scenario_id":"Z_COMMU_XXX", "type":"basic" } ``` ![check scenario](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-communication-arrangement/serviceKey.png) 8. Now, your new service key is listed under Service Keys. The successful creation of the service key proves the existence of the communication scenario. ### Test yourself ---