Query Messages, Download Messages and E-mail Messages functionality

Published on : Apr 20, 2014

Category : BizTalk360 Update

Sriram Hariharan


In the previous versions of BizTalk360, the Message Box (Queries) section can be used to query service instances that reside in the Message Boxes. You can build the Query Expression by selecting a query option from the drop-down and adding some complex filter conditions. We had the option to query All In-Progress Service Instances, Running Service Instances, Suspended Service Instances. In addition to service instances query, now we added the ability to query ‘Messages’.

Query Messages

You can select ‘Messages’ from the Select Query drop-down. When you execute the query, you will see the list of messages, the status of messages and services, service name and class and icons to view the service and message properties. According to your user role, you will have the privilege to Resume, Suspend, and Terminate the service instances. The user can click on the detail link to see message content and context properties associated with the message. Query Messages While we decided to add the messages functionality in Message Box (Queries) section, we realized, in addition to viewing the message context and content directly in the UI,  the users also wanted to download it to disk, and possibly email to someone to start diagnosing a problem. Keeping this in mind, we decided to implement a “Download and E-mail” functionality for the users right within the BizTalk360 UI.

Download and E-mail Messages Functionality

Download Messages

We have implemented the download and e-mail functionality both at the Message level and Service Instance level. After you query messages [in Message Box (Queries) page], you can click on the check-box next to the messages. This will display a “Download” button next to the message actions that will allow you to download the messages. You can download the messages either “As File” or you can “Send as Email”. When you download the message as a file,  you’ll get a zip file containing the message and associated context files. The user can then open the zip file and view all the content. We also added the functionality to email the zip file directly from the UI, this is very useful if you want to forward this content to someone in your team for them to take a look (e.g., business users). Download File/Email In the Tracking Data (Queries) page, you can select ‘Tracked Message Events’ from the drop-down. When you execute the query, the queries are run against previously tracked information. You can click on the check-box next to the message events. This will display a ‘Download’ button that will allow you to download the tracked message events ‘As File’ or ‘Send as Email’. The Download as File/Send as Email works the same way as in the Message Box (Queries) section. Download File/Email - Tracking Data (Queries) Note: At present, you can download/email the message information only for one message. We are working to implement multi-select download/email functionality and will make it available in the upcoming release.

Send as Email

To send an email of the zip file containing message context and content files through BizTalk360 UI, you must enter the valid email addresses of the recipient and click Send Email button. Send messages as Email attachments Note: For the email functionality to work correctly, you need to set up the SMTP settings under BizTalk360 Settings in order to receive email messages from the application.

Download/Email all the messages associated with Service Instance

We have also provided the option to users to download and email the zip file (containing the message and associated context files) associated with service instances. In the Message Box (Queries) page, you can execute the query for ‘Service Instances’. In the query results, select the check-box against the Service Instance name and download the messages ‘As File’ or ‘Send as Email’. Download/Email messages associated with Service Instance