Copyright © 2016 Mobilengine Corp. All rights reserved. version: 7.0.4.19927
What you'll be learning about:
What is integration and why you need it
The made-up Rocky Jupiter scenario in the tutorials so far has been unrealistic in (at least) one significant way: it supposed that the company had no business management software, just a bunch of reference tables with contact, truck, and purchase order details. This fiction has been useful when focusing on binding reference data into forms, but now that you are comfortable with setting up even quite complex reference data-based workflows, you need to get ready for the real world.
Most of the time the companies that need your services as a Mobilengine solution developer will already have some sort of enterprise resource planning (ERP) software in place, and want the new mobile- and webform solutions to tie in with the existing system.
The Mobilengine platform offers automated data exchange, called integration, between the Mobilengine Cloud and a client business management software to achieve this. The integrated data gets exchanged via XML messages through web services that are defined by the proprietary Wire Data Exchange (WDX) SOAP-type protocol.
Mobilengine integration is defined using an integration endpoint on the Mobilengine Cloud end of the message channel. When the messages are coming in to an endpoint on the Mobilengine Cloud through the web service, workflow scripts process them just like form submission data, and typically update specific reference tables with their contents.
In case of an outbound integration solution, workflow scripts create and send the messages through an endpoint on the Mobilengine Cloud to the web service, which then relays them to the company ERP.
This tutorial demonstrates inbound integration by getting rid of the New Task webform, and feeding new delivery tasks into the mobile workflow directly from the Rocky Jupiter ERP system. Follow along to learn how to set up a web service client that forwards delivery task data from Astro, the Rocky Jupiter business management software, to the Mobilengine Cloud. The mobile devices that run your previously created workflow solution will then download the data from the Cloud as before.
Getting outside data into the Cloud
If Rocky Jupiter already have a purchase order processing workflow in place, one that registers new delivery tasks in the company databse, it is really a waste of resources to have a separate New Task webform that administrators fill in and submit to make the delivery tasks appear on drivers' mobile devices. A more efficient way would be to have any new delivery task get pushed from the Rocky Jupiter ERP to the Mobilengine Cloud (and the mobile devices that synchronize with it) automatically, as soon as a new purchase order for a delivery arrives to the Rocky Jupiter system. That is exactly what you'll be doing in this tutorial.
Let's review the steps involved:
Set up a custom data package definition that specifies the structure of the XML messages that carry the delivery task data
Set up and configure an inbound integration endpoint on the Cloud to handle the inbound data traffic
Set up and customize a WDX protocol-compliant web service client that passes the integration messages to the inbound endpoint
Make the workflow script that was associated with the New Task
webform, and that inserts new delivery tasks into the assignments
reference table process the incoming integration messages instead of form
submissions
In the next section, you'll be introduced to the custom schema language that defines
the XML messages that an integration solution passes to and fro, and specifies their
workflow script representation.