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 code

   Copy code

   Switch to dark mode

   Switch to dark mode

   1234567891011121314151617181920
   <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
       <soapenv:Header/>
       <soapenv:Body>
           <List>
               <Product>
                   <ProductID>HT-1000</ProductID>
               </Product>
               <Product>
                   <ProductID>HT-1020</ProductID>
               </Product>
               <Product>
                   <ProductID>HT-1023</ProductID>
               </Product>
               <Product>
                   <ProductID>HT-1035</ProductID>
               </Product>
           </List>
           
       </soapenv:Body>
   </soapenv:Envelope>

Iterate over the Product List.

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

   

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 code

   Copy code

   Switch to dark mode

   Switch to dark mode

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

   Code Snippet

   Copy code

   Copy code

   Switch to dark mode

   Switch 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 will be returned.

   Code Snippet

   Copy code

   Copy code

   Switch to dark mode

   Switch 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 with the following URL.

   Code Snippet

   Copy code

   Copy code

   Switch to dark mode

   Switch 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

2. A feed is provided as a response. Below is an example with one entry.

   

3. There may well be several thousand entries.

4. The important properties are SalesOrderId and ItemPosition.

   

5. You can determine the number in advance with the following URL.

   Code Snippet

   Copy code

   Copy code

   Switch to dark mode

   Switch 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

Iterate over the SalesOrderLineItems result.

1. Each SalesOrderLineItems entry is processed individually, one after the other.

   

2. Configuration of the iteration.

   

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

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

   Code Snippet

   Copy code

   Copy code

   Switch to dark mode

   Switch 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 CustomerID of the orderer.

   

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

1. Select the CustomerID and write it to the data base.

   

2. As a result, a Data Store is created in cloud integration that links Customer IDs 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 Customer ID, 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 pre-defined integration scenarios here, just as you would 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 manage:

   • Monitor Message Processing
   • Manage Integration Content
   • Manage Security
   • Manage Stores
   • Access Logs
   • Manage Locks
   • 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

   

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.