SAP Business ByDesign

SAP Business ByDesign is a cloud-based on-demand business management solution designed for small or midsize businesses. SAP Business ByDesign is a full-featured cloud ERP software solution that allows customers to enjoy the power of large-scale business applications without the need for IT infrastructure.

SAP Business ByDesign can also by used by subsidiaries of larger companies to take advantage of head office resources, while keeping their flexibility. In this case an integration with on-premise solutions is almost always necessary.

Integration Scenario

For SAP Business ByDesign the following integration scenarios are possible: 


The different scenarios contain the following exceptions and point-to-point connections:

  1. Integrating ABAP backend with the SAP Business ByDesign mediated via SAP Integration Suite - Cloud Integration: 1, 3, 4
  2. Integrating ABAP backend with the SAP Business ByDesign mediated via SAP Process Integration: 1, 2, 4

  Scenario ComponentMonitored ContentMonitoring Category
Systems: ABAP on-premise systemWeb Service errors and performanceWeb Service Messages (ABAP), Web Service (Performance)
Systems: SAP PI on-premise systemPI messages

ABAP: PI Messages

Java: PI Communication Channels, PI Messages

Cloud Services: SAP Integration Suite - Cloud IntegrationExceptions in SAP Integration Suite - Cloud Integration IFlowsSAP Integration Suite
Cloud Services: SAP Business ByDesignExceptions in SAP Business ByDesignSAP ByDesign 

When you set up the exception collection and monitoring you first need to know or identify which Web Service end-points and PI or Cloud Integration messages flows are relevant for your scenario. You can find this information here:


Configure Cloud Service

Preparations for SAP Busines ByDesign

Create a communication arrangement in SAP Business ByDesign:

  1. Navigate to the 'Administrator' view in you SAP ByD UI
  2. Select 'Communication Systems' under Integration
  3. Create a new communication system
    • Host Name: Enter the host of SAP Focused Run
    • System Access Type: Select 'Internet'
  4. Maintain System Instances
    • Choose '5 - Web Service' as the preferred application protocol
  5. Set the communication system to active via 'Actions' → 'Set to Active'
  6. Navigate back to the 'Administrator' view and select Integration → 'Communication Arrangements'
  7. Create a new Communication Arrangement
  8. Scenario: Select 'Query Webservice Message for Monitoring'
  9. Define Business Data: Select the SAP Focused Run communication system
  10. Define Technical Data:
    • Communication Method: Direct Connection
    • Application Protocol: Web Service
    • Authentication Method: SSL Client Certificate
    • User ID: Click 'Edit Credentials' to either maintain user and password or to download the certificate
  11. Review and Confirm. 

Input Values for SAP Business ByDesign

  • Tenant: Tenant name of your tenant
  • Root URL: Root URL  ( e.g. )
  • Description: (optional)


Input Values for SAP Business ByDesign

  • User: The user created for the communication arrangement
  • Password: Password of the user

Advanced Integration Monitoring Setup

Available Monitoring Categories

For SAP ByDesign the following monitoring category is available.

  • SAP ByDesign: Collects exceptions that happen in the ByDesign system 

Available Filter Options

SAP ByDesign

For ByDesign you can collect all exceptions or you can create filters to only collect certain exceptions:

  • Adapter Type: Adapter type (HTTP, SOAP, RNIF, XI, IDoc ...). Use the input help to select the correct value.
  • Document ID: Business Document UUID
  • Document Msg ID: Message UI (GUID)
  • Local Party ID: Local party internal ID
  • Remote Party ID: Remote Party Internal ID
  • Message Direction: The direction of the document flow. Incoming (into ByD) or Outgoing (from ByD) 

Available Metrics

For SAP Business ByDesign the following metrics are collected:

SAP ByDesign

  • SAP ByDesign exceptions: Indicates that new exceptions were collected during the last data collection interval