Skip to main content

Mission Control in BC: Configuration - Knowledgebase / Mission Control / Mission Control Documentation - Cavallo Technical Support

Mission Control in BC: Configuration

Authors list

Cavallo's workflow engine for Business Central allows users to take advantage of logic based routing and business rules in both Cavallo and in Business Central itself. Below, we'll cover how to set up and use this functionality in Business Central!

Note: Only users with "Cavallo All Access" permissions will have the ability to set the Cavallo API.

Order of Operations:

  1. Install the latest extension of Cavallo found here: Cavallo Extensions

  2. Establish the Service to Service connection. Instructions here: Service to Service

  3. Assign an admin the “Cavallo All Access” permission set in Business Central: Cavallo Permission Sets

  4. Build out a workflow in Cavallo and select publish.

  5. Ensure the Cavallo API is configured correctly within Business Central: Cavallo API

  6. Validate workflow submits and moves within Business Central.

Cavallo API

The first action that must be taken in order to use the Cavallo workflow in Business Central is that we need to set the Cavallo API setting within Business Central. In order to do this follow the below steps:

  1. Navigate to the Cavallo Workflow Setup and click any of the workflows that exist.
  2. Edit one of the workflow queues (This can be as simple as changing the name or description fields).
  3. Press Save and Publish your changes.

Our API settings will be set in Business Central when the user selects "Publish Changes". In order to validate your API is set, you can navigate to Business Central and search "Cavallo API" and click the "Cavallo API Configuration" option as seen below:

wAcUQkerpZ4aKXL4qwcp8OFArL1hWaEh.jpeg?access_token=snx3qk-ohduiecjlt-4ca1afbbab05bfa4d43ba8af9665ca7d5f24167d

From this screen you will be able to see that all the fields for the Cavallo API are set. (Example is unpopulated on purpose)

ALd3kpDFFCwS8ZPkEXGJCDxFsepcJb5t.jpeg?access_token=snx3qn-sfjylwvyut-cde69bcc81026851ff935ebd9c7d4873739da725

Once the Cavallo API is successfully set, the user will have the ability to execute their workflow and business rules, filter documents for broken rules and approve/reject those documents all within Business Central. Continue reading below to see examples of these features!


Submit Document To Workflow

For all of the actions within Business Central, We have created a menu on the main Business Central nav bar called "Cavallo". These options can be moved around and personalized in the same way that other Business Central fields are able to be. In order to find our menu, navigate to "Actions" in Business Central. See the below image:

*Note*: Your menu may be in a different order than the below image but still under the actions dropdown.

0GD6RPcLWQ3bfOFr0QwyEh9WnPRDhWXE.jpeg?access_token=snx3ql-jmfbrqfmkn-16537361489913756e75c322785f4a910d1bddb2

The current queue a document is in Workflow can be viewed on the header of any sales document as seen below:

AyLxFEmqK1CPA6XvSS6GBiyOrvqbL9xZ.jpeg?access_token=snx3qm-pvavcwzdqg-989b62b39d15faf761b3e45d754ab3a04afebb5b

On any document, using the "Submit" button will run that document against the logic assigned in Cavallo.

X1IbdM755QQnqeRsaKDkLSGTXdg7EqL6.jpeg?access_token=snx3qk-lynzzuveao-60381acc719dd993a58f34f4f38242f91e1dd313


Cavallo Document Statuses

Cavallo has a number of custom statuses that have been built to ensure that documents are always on the correct workflow path. If users have the Cavallo API configured, the ability to view the Cavallo Document Status panel should be available on sales order search and the sales order cards.

LlbEJm9c6ZUCiAE8XHdTU0o25IqeonPo.png?access_token=snx3qk-yxeoplaxxk-af1b9c27eb9a9de96126b9ecb96dac4360235347

As documents are submitted to Cavallo's workflow engine, the statuses will dynamically update on transition to ensure users have the most accurate information possible. In addition, Cavallo will provide direct links to any related documents that are generated as a part of the workflow actions such as warehouse picks, warehouse shipments and purchase orders.

2B4AvxOdQ1mlbdTXqxbSSzewSeEqhXwJ.gif?access_token=snx3qj-lflkejwqtn-6867282c517f2e78c477a1fce510f2898aad826d


Cavallo Business Rules In Business Central

Several different tools are available in Business Central when it comes to utilizing Cavallo business rules.

Personalization Options

Cavallo pushes a number of columns over to Business Central for users to utilize. One of these columns is titled "Broken Business Rules" and can be applied to the sales line search grid in addition to the sales lines grid. When applied, this column will show the user how many broken business rules a particular sales line has attached to it. Clicking the number in this column will populate the approve/reject window for users to take action against any line with a broken rule.

O5Q8MNkZCU5WsQxyrR2xUWygxDIFDnIQ.gif?access_token=snx3qr-mexhdddcgs-a0f5f3ab89d538ae8a0784e9e20791f5b3d3634f

Broken Business Rule

Business Rules are evaluated whenever a document is submitted through the workflow. In the case there is a broken rule, the user will presented with a pop up window showing them all the broken rules and allowing them to add a comment for the approver to view.

gRwnwJq7anHINVY1dy4hNpQsndzdMvQW.jpeg?access_token=snx3qq-rwuvhuttzn-baef8f2db78a3ce54ba8af8872492ac15129c1d8Once submitted, the "Workflow Queue" field in Business Central will update to reflect the broken rule and the document will be ready for approval or rejection.

Reviewing Business Rules

The approve or reject options are located in the Cavallo dropdown menu on the nav bar. A user can select an order from the document search, a line containing broken rules from sales line search or directly from the document itself in order to review for approval. Once the approve/reject option is selected, a pop up window will display the broken rules in addition to the lines that break each rule and allow a user to select the number of rules to approve. The approver may also add comments at this time and either approve or reject the rule(s).

KuZgfn0jVJ2neoZacqNWYDkRbYuK5zr3.gif?access_token=snx3qk-ttxxucttkp-8c4ef5cd9a68c3fd17df2bd4b24d25159068b880

On submit, the user will receive a confirmation of their selections and the document will be unlocked and moved the workflow to its destination queue. Keep in mind, these actions will respect any business rule notifications set in the Cavallo workflow engine as well.

Filtering For Broken Rules

There are 2 main filters in Business Central that can be utilized to show only documents or sales lines with business rules that require review. The first is a document level filter called "Broken Cavallo Business Rules" and has two main options. When the filter is set to yes, only documents with broken rules will be shown. When the filter is set to no, documents with broken rules will be omitted from the document search page. See the below image for the filter:

KSFbra7d2TsBQQidNifvT1mvzsPlz7nJ.jpeg?access_token=snx3ql-qenwezucql-0de5878b50b8ee8694e3ec898ae04be436236bf9

Next, there is a saved view on the sales line search grid titled "Has Broken Rules". Clicking this view will sort the entire grid to only view those sales lines with greater than 0 broken rules. Users can also take approve/reject action from this filtered view if the correct grid personalization has taken place and the "Broken Business Rules" column is visible.

4u8Q584TwywG4X7o5EM1HtIKzdiqYo7L.gif?access_token=snx3qm-dgfvmqpgsm-ea5bb48465acd38b91a5ce88e484e60c8bda7206


Helpful Unhelpful