Working with Whomiboo

Content under development

What we need:

  • ManyWho username/password. If you do not have a ManyWho login, please click here to get one.
  • Boomi – A working atom with the API exposed to public. If you do not have a Boomi account, please click here to get one.

Building a service with Boomi – showing current time

  1. Login to your Boomi AtomSphere Dashboard.
  2. On the Build page in the Component Explorer, create a new folder or navigate to the folder in which you will create a new component.
  3. Click New Component.

    The Create Component dialog opens with the folder selected.
  4. Select API as the Type option.
  5. Enter a name for the component (Example: Time) and click Create.

    The component appears on a tab with the name you entered.
  6. Type Time API in the Title field.
  7. Copy-paste 1.1.0 in the Version Number field.
  8. Type time in the Base API Path field.
  9. Click Save.
  10. Click REST and click Help Me Create An Endpoint.
  11. Select Create a new process and click Next.
  12. Type metatadata in the Process Name field.
  13. If you want a different location, update the Process Location field with a new path.
  14. Select REST as the option for Add To.
  15. The Input Type field should be set to None.
  16. Select Single Data as Output Type.
  17. Select application/json for the Result Content Type.
  18. Under the REST section, type metadata for Object.
  19. Leave the URL Path empty and select POST as the HTTP Method.
  20. Click Finish.
  21. Click Save and Close.
  22. Click to expand the Processes options on the left, and select metadata.
  23. Hover your mouse on top of the Web Services Server component (this shows the Configure button) and click Configure.

    This opens the Start Shape panel.
  24. Click OK.
  25. Click Shapes and from the Execute group, drag a Message from the palette to the canvas.

    This opens the Message Shape panel.
  26. Click OK. This is what the canvas looks like now:
  27. Click Shapes and from the Logic group, drag a Return Documents shape from the palette to the canvas.

    This opens the Return Documents Shape panel.
  28. Click OK. This is what the canvas looks like now:
  29. Connect the components and arrows. This is what the canvas looks like now:

Getting the metadata from Whomiboo

  1. Open this URL in your browser.
  2. Click Add a Message Action.
  3. Type get-current-time in the Action URI field.
  4. Type Get Current Time in the Action Name and Action Summary fields.
  5. Under the Outputs option, select Is required.
  6. Type Current Time in the Property Name field.
  7. Select ContentDateTime as Content Type for Outputs.
  8. Click Create Output. This adds an output under the Outputs list.
  9. Click Create Action. This adds the action under List of actions.
  10. Click Copy to Clipboard Metadata Response. This copies the JSON in your clipboard.
  11. Click Message Action Request.
  12. This opens MessageActionRequestProfile.json.
  13. Check the Save File option and click OK

    This saves the JSON file in your local machine.
  14. Click Message Action Response.
  15. This opens MessageActionResponseProfile.json.
  16. Check the Save File option and click OK. This save the JSON file in your local machine.

Using the metadata in Boomi

  1. Open your Boomi AtomSphere canvas.
  2. Click the Message shape.

    This opens the Message Shape panel.
  3. Paste the contents of the clipboard in the Message field.
  4. Add single quotes before and after the code you’ve just pasted – wrapping the code block in single quotes.
  5. Click OK.
  6. Click Save and Close.
  7. Click Deploy, and select the metadata process by clicking on it.
  8. Click Attachments.

    This is what the Dashboard looks like now:
  9. Select ManyWho Test and click the first directional box to move it from Unattached Environments to Attached Environments.
  10. Tick the checkbox next to the metadata process.
  11. Click Save and Deploy.

    This opens the Deployment Confirmation dialog box.
  12. Click OK.

    This deploys the process. You can see the Version, Actions, Deployed By, Deployment ID, and any Notes you may have added.
  13. Click Deploy and select APIs from the dropdown menu.
  14. Click Time API. You do not need to check the box next to it.
  15. Click Attachments. This is what the Dashboard looks like now:
  16. Select ManyWho Test and click the first directional box to move it from Unattached Environments to Attached Environments.

    This is what the dashboard looks like now:
  17. Check the box next to Time API.
  18. Click Save and Deploy.
  19. Click OK.

    This deploys the Time API.
  20. In the Build options, select the Time API again.
  21. Click REST.
  22. Click Add an Endpoint.
  23. In the Resource Path field type get-current-time.
  24. Scroll down to Request Handled by Process and click the green plus icon in the Choose field.

    This opens the Start Shape configuration panel.
  25. In the Display Name field type Current Time Process.
  26. The Connector field should be set to Web Services Server.
  27. Click the green plus icon in the Choose field in Operation.

    This opens the New Web Services Server Connector Operation screen.
  28. Set Operation Type to CREATE.
  29. Set the Input Type to Single JSON Object.
  30. Click the black plus icon in the Request Profile field.

    This opens the New JSON Profile screen.
  31. Change the profile name to Message Action Request.
  32. Click Import. This opens the JSON Import Wizard.
  33. Click Choose File and upload the MessageActionRequestProfile.json file you had downloaded to your local machine earlier.
  34. Click Next and click Finish. This is what the dashboard looks like now:
  35. Expand the Root element by clicking the + sign next to it. This is what the dashboard looks like now:
  36. Expand Array by clicking the + sign next to it.
  37. Click the blue arrow next to ArrayElement1.
  38. Click Add Identifier Instance.

    This opens the Add/Edit Instance pop up.

  39. Check the Identify By Occurrence box and click OK.
  40. Click Save and Close.
  41. Set the Output Type to Single JSON Object.
  42. Click the black plus icon in the Response Profile field. This opens the New JSON Profile screen.
  43. Change the profile name to Message Action Response.
  44. Click Import. This opens the JSON Import Wizard.
  45. Click Choose File and upload the MessageActionResponseProfile.json file you had downloaded to your local machine earlier.
  46. Click Next and click Finish.
  47. Click Save and Close.
  48. Click Save and Close.
  49. Click Make the recommended changes for me.
  50. Click OK.
  51. Click Shapes and from the Execute group, drag a Map from the palette to the canvas. This opens the Map Shape panel.
  52. In the Display Name field type Request to Response.
  53. Click the green plus icon in the Choose field for Map. This opens the New Map screen.
  54. Change the name of the Map to Request to Response Map.
  55. Click Choose in the Map Source panel. This opens the Choose a Profile dialog box.
  56. Select JSON as the Profile Type.
  57. Select Message Action Request.
  58. Click OK.
  59. Click Choose in the Map Destination panel. This opens the Choose a Profile dialog box.
  60. Select JSON as the Profile Type.
  61. Select Message Action Response.
  62. Click OK.
  63. In the Message Action Request, click the plus sign to expand the Object folder.
  64. In the Message Action Response, click the plus sign to expand the Object folder. This is what the dashboard looks like now:
  65. Click token in the Message Action Request panel to select it, and drop it on token under the Message Action Response panel. This connects the two items.
  66. Click tenantId in the Message Action Request panel to select it, and drop it on tenantId under the Message Action Response panel. This connects the two items.
  67. Click the blue plus sign in the Function panel. This opens the Add a Function dialog box.
  68. Click Create New Function. This opens the New Map Function screen.
  69. Change the name of the map function to ManyWhoDate from New Map Function.
  70. Click the blue plus icon in the Step panel. This opens the Add a Function dialog box.
  71. Change the Category to Date.
  72. Select Get Current Date.
  73. Click OK.
  74. Click the blue plus icon in the Outputs panel. This opens the New Output dialog box.
  75. Type Current Date in the Name field and click OK. This creates a Current Date output.

 

 

  1. If you like, you can also check to make sure the API has been deployed. For example, you can use Postman to make a POST request with the URL of your server – http://URL and port/ws/rest/time/metadata POST


  1. ManyWho
  2. Import the service to the flow
  3. Create a new flow in ManyWho using the ManyWho Identity service.
  4. Drag a Message element from the sidebar to the canvas.
  5. Enter a name for the message action. Example: Display Time.
  6. Action – Create a new message action using the time service
  7. Create a new value – Current Time / Outputs
  8. Save / Apply
  9. Add a Step
  10. Insert value – whatever value
  11. Add outcomes
  12. Run flow