Introducing Cloud Integration

Send a list with ProductIDs as a SOAP message to the integration flow.

1. Send an XML message list via HTTPS and SOAP message to the deployed integration flow. The Message Exchange Pattern is One-Way (asynchron, fire, and forget).

   

2. The XML message contains the ProductIDs, for example HT-1000.

   Code Snippet

   Copy codeSwitch to dark mode

   1234567891011121314151617181920212223242526272829303132333435363738394041
   
   <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Header/>
   <soapenv:Body>
   <List>
   <Product>
   <ProductID>HT-2001</ProductID>
   </Product>
   <Product>
   <ProductID>HT-1020</ProductID>
   </Product>
   <Product>
   <ProductID>HT-1035</ProductID>
   </Product>
   <Product>
   <ProductID>HT-6101</ProductID>
   </Product>
   <Product>
   <ProductID>HT-7000</ProductID>
   </Product>
   <Product>
   <ProductID>HT-2026</ProductID>
   </Product>
   <Product>
   <ProductID>HT-6100</ProductID>
   </Product>
   <Product>
   <ProductID>HT-9994</ProductID>
   </Product> 
   <Product>
   <ProductID>HT-1254</ProductID>
   </Product>
   <Product>
   <ProductID>HT-1031</ProductID>
   </Product>
   <Product>
   <ProductID>HT-1036</ProductID>
   </Product>
   </List>
   </soapenv:Body>
   </soapenv:Envelope>

Iterate over the Product List.

1. Each ProductID from the list is processed individually, one by one.

   

2. For example, if the list has five ProductIDs, the following processing steps are executed five times (loop five times).

Check each ProductID to see if it is available in the database.

1. Call the following URL:

   Code Snippet

   Copy codeSwitch to dark mode

   1
   https:// < your host >/v1/GWSAMPLE_BASIC/ProductSet('< ProductID >')

   Code Snippet

   Copy codeSwitch to dark mode

   123
   
   for example:
   https://group00-xxxxxxxx-yyyyyy.prod.apimanagement.eu10.hana.ondemand.com/v1/GWSAMPLE_BASIC/ProductSet('HT-1000')

2. The ProductID comes from the product list.

   

3. If a ProductID, for example, HT-1000 exists in the database, the following response is returned.

   Code Snippet

   Copy codeSwitch to dark mode

   1234567
   <ProductSet>
   <Product>
   <Category>Notebooks</Category>
   <ProductID>HT-1000</ProductID>
   <Name>Notebook Basic 15</Name>
   </Product>
   </ProductSet>

Decide whether the ProductID exists in the database or not.

1. If the response is empty, the current loop will be terminated and the next one will be started.

   

2. If the ProductID is available, then the response will be further processed.

Get the SalesOrderLineItems (SalesOrderID, ItemPosition) as a feed for each ProductID.

1. Get the SalesOrderLineItems (SalesOrderID, ItemPosition) as a feed for each ProductID.

   

   If the ProductID is available, then the response is further processed.

2. Check that the following feed for each ProductID with the following URL displays:

   Code Snippet

   Copy codeSwitch to dark mode

   1234
   https://< host >/v1/GWSAMPLE_BASIC/ProductSet('< ProductId >')/ToSalesOrderLineItems?$select=SalesOrderID,ItemPosition,DeliveryDate
   
   for example:
   https://group00-cld900-d052537.prod.apimanagement.eu10.hana.ondemand.com/v1/GWSAMPLE_BASIC/ProductSet('HT-1035')/ToSalesOrderLineItems?$select=SalesOrderID,ItemPosition,DeliveryDate

3. Check that the feed is provided as a response. Below is an example with one entry:

   

   There can well be several thousand entries.

4. Check that the important properties are SalesOrderId and ItemPosition.

   

5. Determine the number in advance with the following URL:

   Code Snippet

   Copy codeSwitch to dark mode

   1234
   https://< your host >/v1/GWSAMPLE_BASIC/ProductSet('< ProductID >')/ToSalesOrderLineItems/$count
   
   for example:
   https://group00-cld900-d052537.prod.apimanagement.eu10.hana.ondemand.com/v1/GWSAMPLE_BASIC/ProductSet('HT-1035')/ToSalesOrderLineItems/$count

Enter the SalesHeader (CustomerID) for every SalesOrderLineItems (SalesOrderID, ItemPosition).

1. Call the following URL. The SalesOrderID and ItemPosition came from the last API call.

   Code Snippet

   Copy codeSwitch to dark mode

   1234
   https://< host >v1/GWSAMPLE_BASIC/SalesOrderLineItemSet(SalesOrderID='< SalesOrderId >',ItemPosition='< ItemPositoion >')/ToHeader?$select=CustomerID,CustomerName,DeliveryStatus
   
   e.g:
   https://group00-cld900-d052537.prod.apimanagement.eu10.hana.ondemand.com/v1/GWSAMPLE_BASIC/SalesOrderLineItemSet(SalesOrderID='0500000001',ItemPosition='0000000040')/ToHeader?$select=CustomerID,CustomerName,DeliveryStatus

   

2. An XML is provided as a response. Below is an example with one entry.

   

3. The important response property is CustomerName of the orderer.

   

In every SalesHeader, select the CustomerName, and write it to a datastore.

1. Select the CustomerName and write it to the database.

   

2. As a result, a Data Store is created in cloud integration that links the Customer Names to the list of delivered ProductIds.

3. Below is the Data Store with the customer IDs matching the list.

   

4. The generated list can now undergo further processing, with the API used to identify the products and communication data associated with each CustomerID and CustomerName, allowing the customers to be promptly informed of any potential delays.

Log on to the Integration Suite.

1. Navigate to your subaccount to Instances and Subscriptions → Integration Suite.

   

2. Now, navigate to the individual areas.

Explore the Discover area.

1. Navigate to Discover → Integrations.

2. You will find all available predefined integration scenarios here, just as you do in the SAP Business Accelerator Hub.

   

Explore the Design area.

1. Navigate to Design → Integrations and APIs.

   

2. This is the most important development area, where you can create, deploy, and manage integration flows and other artifacts.

   

Explore the Monitor area.

1. Navigate to Monitor → Integrations and APIs.

   

2. Here, you can:

   • Monitor Message Processing
   • Manage Integration Content
   • Manage Security
   • Manage Stores
   • Access Logs
   • Manage Locks
   • View Usage Details

   

Explore the Settings area.

1. Navigate to Settings → Integrations.

   

2. Here, you can manage:

   • Runtime Profiles
   • Transport
   • System
   • Custom Tags
   • Malware Scanner
   • Software Updates
   • Design Guidelines

   

Find more information within the online guide.

1. Access the online guide via user symbol → Online Guide.

   

2. You can navigate through every area here to access further information.