Manually Acknowledge Channel Updates
Generally, MDH itself takes care of channel update acknowledgment by acknowledging the updates automatically when the updates are fetched by the source.
But if we want to manually acknowledge the updates we have to do some configurations from MDH and Integration side.
In this blog, we will learn how can we manually acknowledge channel updates in MDH.
If we go to the MDM connector operation while selecting the action as Query we can see a checkbox called “Manually Acknowledge” if we select the check box then MDH will not automatically acknowledge any updates we have to acknowledge manually.
Now let us go to the platform and see how can we manually acknowledge channel updates:
Steps:
Step 1. Go to platform.boomi.com
Step 2. Login by giving your valid credentials (Username and Password).
Step 3. Home page will be displayed, now click on “Integration”.
Step 4. Click on the “Create New” button.
Step 5. Select “Process” and click on “Create”.
Step 6. Click on the “No Data” option and click on “OK”.
Step 7. Drag and drop a Message shape and put these records as shown in the below image.
Step 8. Add a Boomi Master data Hub connector. To configure the connection click on the “+” icon.
Step 9. Give the URL, UserName and Token.
URL: Go to Atom Management ,then Click on “Test” atom cloud ,then Click on Shared web server,then Copy the Base URL and Add “/mdm/” at the end.
Username and Token: Go to MDH ,then Select the Test repository, then Configure Tab and Copy the Username and Auth token.
Step 10. Save and close, select the Action as Upsert and then configure the operation.
Step 11. Click on Import operation.
Step 12. Select your Atom, give the Source name and Staging Area ID, click on “Next”.
Step 13. Select your Model and click on Next.
Step 14. Click on Finish.
Step 15. Drag and drop one Mape shape and inside map component add two profiles. In the source side add the Employee profile and in the Target add the MDH upsert request profile.
After mapping each field click on Save and close.
Step 16. Add a stop shape at the end. The process should look like this now-
Step 17. Save the process and test.
In this situation, the Golden records are created in MDH. Channel updates are generated for
other sources.
Now we need another process to query channel updates from MDH.
Step 18. Create a process to Query Golden records from MDH.
Take an MDH connector, the same connection, and the action will be Query.
Click on + icon to create an Operation.
Step 19. Click on Import Operation.
Step 20. Choose the Atom, give the Source, click on Next.
Step 21. Select your Model and click on Next.
Step 22. Click on Finish.
Step 23. Check the checkbox of Manually Acknowledge.
Step 24. Click on Save and Close.
Step 25. Add a Stop shape at last, save, and test the process.
Generally, if we execute this process, for the first time we will get the channel update. If we try to execute the process for the 2nd time we will not get any records because MDH automatically acknowledges the channel updates whenever the updates are queried from the model.
But in our case, we can execute the process multiple times, each time we will get the Golden records because we have checked the Manually Acknowledge checkbox which means we have to acknowledge the delivery manually.
To acknowledge the delivery manually we can consume one REST API. Below are the API details given for consuming the API.
REST API for Manually Acknowledge Channel Updates
URL: <a href="https://<host>:<port>/mdm/universes/<universeID>/sources/<sourceID>/updateshttps://:/mdm/universes//sources//updates/acknowledge
Method: POST
Note:
Host and Port: You can find in the MDH connection.
universeID: Universe Id of the particular model.
sourceID: Id of the particular source.
updateID: The delivery ID for a channel update (You can capture it using one dpp named “mdm-current-delivery-id”)
