...
The following describes in general, the synchronous call between VSS and DSW.
...
...
No. | Process | Application | Description |
|---|---|---|---|
Trigger | DSW | The activity (i.e.: creation of sales offer or business partner) is triggered in DSW. A message is sent to the integration layer (ODIL) which will then call VSS. | |
2. | Authenticate the call | VSS | The call is authenticated failing which, an error message is returned to ODIL/DSW. |
3. | Receive response | DSW | DSW receives the unauthorized error message and re-process or retry accordingly. |
4. | Read and de-serialize JSON | VSS | Once the authentication is successful, VSS reads and de-serialize the JSON file. |
5. | Process | VSS | Depending on the business object, VSS processes the information received in the JSON file. |
6. | Generate JSON file | VSS | Once the information has been processed, VSS will generate the response JSON file. At the same time, an IDoc is generated for monitoring and trouble-shooting purposes. |
7. | Send data to DSW | VSS | JSON file is sent to DSW. |
8. | Process/Update | DSW | ODIL receives the JSON file and send the VSS response to DSW for further processing and status updates. |
Asynchronous call
The following describes in general, the asynchronous call between VSS and DSW.
...
No. | Process | Application | Description |
|---|---|---|---|
Trigger | DSW | The activity (i.e.: creation of sales offer or business partner) is triggered in DSW. A message is sent to the integration layer (ODIL) which will then call VSS. | |
2. | Authenticate the call | VSS | The call is authenticated failing which, an error message is returned to ODIL/DSW. |
3. | Receive response | DSW | DSW receives the unauthorized error message and re-process or retry accordingly. |
4. | Read and de-serialize JSON | VSS | Once the authentication is successful, VSS reads and de-serialize the JSON file. |
5. | Response | VSS | VSS generates the JSON response file and send to DSW. |
6. |
...
Generate IDoc | VSS | IDoc is generated with information from the de-serialized JSON request file. | |
7. | Process / Re-processing | VSS | The IDoc can be processed (immediate or scheduled job) which will trigger the execution of the relevant business process in VSS. In case of error during the execution, re-processing is possible. |
8. | Send data to DSW | VSS | Depending on the business object, the relevant response JSON file is generated and sent to DSW. |
9. | Process/Update | DSW | ODIL receives the JSON file and send the VSS response to DSW for further processing and status updates. |
IDoc Management in VSS-DSW
...
VSS uses IDoc when communicating with DSW. These are inbound and outbound IDocs corresponding to the real communication between the two applications. IDocs mechanism is utilized to generate the trace information - network calls can be traced by means of IDocs.
The following are transactions relevant to the VSS-DSW integration prepared to distribute the business objects to DSW.
...
Sending VSS objects in scope of the VSS-DSW integration.
...
.
No. | Description | Transaction Code |
|---|---|---|
1. | Distribution Item Data | /DBE/ODL_ITEM_DIST |
2. | Distribution Vehicle Reservation | /DBE/ODL_VEH_RSV_DIS |
3. | Distribution Vehicle | /DBE/ODL_VEH_DISTRIB |
4. | Distribution BP Data | /DBE/ODL_BP_DISTRIBU |
5. | Distribution Vehicle Assignment to Sales Order | /DBE/ODL_VASSIGN_DIS |
6. | Distribute Status of orders to DSW | /DBE/ODL_ORD_ST_DIST |
Interface / IDoc Monitor
Monitoring of inbound and outbound message for purpose of trouble-shooting or re-processing. Transaction code: /DBE/IFM
...
No. | Direction | IDoc Type | Description |
|---|---|---|---|
1. | Outbound | /DBE/ODL_BP_TRACE_OUT | IDoc to trace business partner sent to DSW |
2. | Outbound | /DBE/ODL_AITEM_TRACE_OUT | IDoc to trace additional item sent to DSW |
3. | Outbound | /DBE/ODL_VEH_TRACE_OUT | IDoc to trace vehicle sent to DSW |
4. | Outbound | /DBE/ODL_VEH_RESERV_OUT | IDoc to trace vehicle reservation sent to DSW |
5. | Outbound | /DBE/ODL_VEH_ASSIGN | IDoc to trace vehicle assignment sent to DSW |
6. | Outbound | /DBE/ODL_SYNCH_TRACE_OUT | IDoc to trace Synchronization REST API out (Update Mapping of Document No.) |
7. | Inbound | /DBE/ODL_CUSTOMER_TRACE_IN | IDoc to trace business partner received from DSW |
8. | Inbound | /DBE/ODL_PRICING_TRACE_IN | IDoc to trace pricing simulation received from DSW |
9. | Inbound | /DBE/ODL_VEH_RESERVATION | IDoc to trace vehicle reservation received from DSW |
10. | Inbound | /DBE/ODL_SALES_OFFER_TRACE_IN | IDoc to trace sales offer received from DSW |
11. | Inbound | /DBE/ODL_SALES_ORDER_TRACE_IN | IDoc to trace sales order received from DSW |
12. | Inbound | /DBE/ODL_SALES_OFFER | IDoc of sales offer ready to be passed to application |
13. | Inbound | /DBE/ODL_SALES_ORDER | IDoc of sales order ready to be passed to application |
Below is an example of the /DBE/IFM transaction. You can view the request or response file for each generated IDocs according to the IDoc Type.
...
Maintenance of IDocs for VSS-DSW
...
In general, IDocs generated in the system needs to be removed periodically as over time, they will consume disk space. How long the IDocs needs to be in the system is the decision of the customer based on various factors for example the criticality of the data and size of database. In any cases, after some times, the IDocs should be removed.
...