diff --git a/misc/s4hana/README.md b/misc/s4hana/README.md index dae48af..b18b8b8 100644 --- a/misc/s4hana/README.md +++ b/misc/s4hana/README.md @@ -1,23 +1,19 @@ # SAMLAssertion destination configured to point SAP S/4HANA Cloud Public tenant # Prerequisites -1. You have completed Step 2 and Step 3 https://developers.sap.com/tutorials/abap-custom-ui-bas-connect-s4hc.html as this will create the System to System trust required to enable SAML between the respective systems. -1. You have administrative access to your S/4HANA Cloud system to allow to configure and debug connectivity issues. -1. You are subscribed to SAP Business Application Studio, follow this [tutorial](https://help.sap.com/docs/SAP%20Business%20Application%20Studio/9d1db9835307451daa8c930fbd9ab264/6331319fd9ea4f0ea5331e21df329539.html) for more information -1. You have reviewed the FAQ on [SAP S/4HANA Cloud, Public Edition](https://me.sap.com/notes/3445942) documentation -1. You have reviewed the [SAP Business Application Studio Integration with SAP S/4HANA Cloud](https://me.sap.com/notes/3297481) documentation +1. Steps 1, 2, and Step 3 from https://developers.sap.com/tutorials/abap-custom-ui-bas-connect-s4hc.html are completed. +2. You have administrative access to your SAP S/4HANA Cloud system so you can configure and debug connectivity issues. +3. You are subscribed to SAP Business Application Studio. For more information, see [Subscribe to Business Application Studio](https://help.sap.com/docs/SAP%20Business%20Application%20Studio/9d1db9835307451daa8c930fbd9ab264/6331319fd9ea4f0ea5331e21df329539.html). +4. You have reviewed [SAP S/4HANA Cloud, Public Edition FAQ](https://me.sap.com/notes/3445942). +5. You have reviewed the [SAP Business Application Studio Integration with SAP S/4HANA Cloud](https://me.sap.com/notes/3297481) documentation ## Create a SAP BTP SAMLAssertion Destination to consume V2 and V4 OData Catalogs -1. Open [s4hana-cloud_saml](s4hana-cloud_saml) file using any text editor or browser -1. Replace all instances of `my1111111` with your specific hostname -1. Log in to your SAP BTP subaccount, select the `Destinations` tab, and select `Import Destination` -1. You have now created a SAB BTP subaccount destination using `odata_abap` to reflect the type of destination created -1. Login to your SAP Business Application Studio to consume the new destination to validate that your connectivity is working +1. Open the [s4hana-cloud_saml](s4hana-cloud_saml) file using a text editor or browser. +2. Replace all instances of `my1111111` with your specific hostname. +3. Log in to your SAP BTP subaccount, select the `Destinations` tab, and select `Import Destination`. +4. Log in to SAP Business Application Studio to consume the new destination to validate that the connection works. -You can refer to this link to confirm your destination is configured correctly; -https://help.sap.com/docs/SAP_S4HANA_CLOUD/0f69f8fb28ac4bf48d2b57b9637e81fa/31876c06f99645f289d802f9c95fb62b.html - -__Note: In some cases, you might want to create an `odata_gen` SAP BTP destination to consume a specific OData service, then refer to this [tutorial](https://ga.support.sap.com/dtp/viewer/index.html#/tree/3046/actions/45995:48363:53594:54336) to create a Full or Partial URL destination. This scenario is typical where a user does not have access to the Catalog but only individual services__ +For more information, see [Create a Destination to Connect to SAP Business Application Studio](https://help.sap.com/docs/SAP_S4HANA_CLOUD/0f69f8fb28ac4bf48d2b57b9637e81fa/31876c06f99645f289d802f9c95fb62b.html). ## How SAMLAssertion Works @@ -168,11 +164,11 @@ Append V4 Catalog to base URL; https://mytrial-account.launchpad.cfapps.us10.hana.ondemand.com/dynamic_dest/mys4hc-destination/sap/opu/odata4/iwfnd/config/default/iwfnd/catalog/0002/ServiceGroups?$expand=DefaultSystem($expand=Services) ``` -For more information, please refer to this [site](https://ga.support.sap.com/dtp/viewer/index.html#/tree/3046/actions/45995:48363:53594:54336:51208) +For more information, see [Validate Destination Configuration](https://ga.support.sap.com/index.html#/tree/3046/actions/45995:48363:53594:54336:51208). -## Debugging Deployment Issues +## Debugging Connectivity and Deployment Issues -### Issue 1. Deployment fails with `The use of Gateway OData V2 Service Z_MY_SERVICE 0001 is not permitted` +### Issue 1: The Deployment Fails with `The use of Gateway OData V2 Service Z_MY_SERVICE 0001 is not permitted.` ```bash error abap-deploy-task YY1_Some_Service The use of Gateway OData V2 Service Z_MY_SERVICE 0001 is not permitted. @@ -242,6 +238,13 @@ For more information about how to troubleshoot this issue, see [Recommend Servic For more information, see [Exposing an OData Service from SAP S/4HANA Cloud Public Edition to the SAP BTP](https://community.sap.com/t5/technology-blog-posts-by-sap/exposing-an-odata-service-from-sap-s-4hana-cloud-public-edition-to-the-sap/ba-p/13628248). +### Issue 8: All HTTP API Requests from SAP Business Application Studio to SAP S/4HANA Cloud Fail + +The most common root cause of why HTTP request fail are due to: + +1. The communication system for SAP Business Application Studio is not active. For more information, see [Create a Communication System for SAP Business Application Studio](https://help.sap.com/docs/SAP_S4HANA_CLOUD/0f69f8fb28ac4bf48d2b57b9637e81fa/79ed4173a0e44a5085c2d236d14b5ab8.html). +2. The user logged into SAP Business Application Studio does not have the required `Business Role` assigned to allow the user to consume OData services. The user must have the `SAP_BR_DEVELOPER` role assigned to allow the user to consume OData services. For more information, see [Authorization Requirements](./README.md#authorization-requirements). + ## Related Links Integrating SAP Business Application Studio - [https://help.sap.com/docs/SAP_S4HANA_CLOUD/0f69f8fb28ac4bf48d2b57b9637e81fa/22bc724fd51a4aa4a4d1c5854db7e026.html](https://help.sap.com/docs/SAP_S4HANA_CLOUD/0f69f8fb28ac4bf48d2b57b9637e81fa/22bc724fd51a4aa4a4d1c5854db7e026.html)