Navigation:  Managing the Account > Data Sync > Messagebox

 

Overview

 

The "Messagebox" sub-module (included in the "Data Sync" module of the "Control Panel") relates to the Messagebox Service, a service provided by MCL-Mobility Platform that allows your mobile applications to exchange messages with a back-end via the topics within your account. See Messagebox Service.

A topic is a specific queue used by the sender (mobile application/back-end) to direct a message to a receiver (mobile application/back-end) that subscribes to that topic. It is similar to a mailbox that accepts messages from a specific entity to be delivered to another specific entity.

There are three possible types of topics (sub-services), meaning, a topic can have one of three directions:

Mobile to Back-end - the message is sent by the device(s)/application to a specific topic and, then, it is read by the intended back-end.

Back-end to Mobile - the back-end sends a message to a specific topic which is, then, read by the device(s)/application(s) that poll it.

Request - the device(s)/application(s) sends a message to a specific topic, expecting an answer from a specific entity. Once the entity reads the message, the answer will be sent through that same topic.

 

A topic can be associated to the account (all devices have access) or to a site (only the devices from the site have access).

There is a default topic of the "Mobile to Back-end" type that handles messages sent by the devices to non-existing topics. This topic is linked to the account and it cannot be removed. It can, however, be copied to other sites and that copy can be deleted.

 

The Messagebox Service is available at account and site level:

•There is a "Messagebox" sub-module (included in the "Data Sync" module) in the Admin Dashboard's "Control Panel" which allows the account administrator to create, edit, delete or replicate a topic onto all the sites in the account.

•There is a "Messagebox" sub-module (included in the site's "Data Sync" module) where the site manager and any site user with the necessary access rights can manage the topics that concern their own site.

 

The "Messagebox Service" sub-module is used, specifically, to manage the necessary topics for the Messagebox Service, meaning, it allows you to add, edit, delete and copy topics, purge a topic's messages and read or send messages from inside a topic to the intended receiver.

 

The back-end application can also manage the topics - it can add, edit, delete and copy topics.

 

 

In the Admin Dashboard's "Control Panel", click and, in the resulting row, select to access the "Topics" page.

The "Topics" page displays the list of topics created within the account (the list view is the default view):

 

 

Use one of the following to filter the display of topic information:

 

•Use the box (located to the left of the page) to filter the view so it displays a specific site's topics or the topics of the account (default display).

 

•Use the buttons below to filter the display in terms of topic type/sub-service (meaning, the direction for the messages included in a topic):

 

Mobile to Back-end (default filter)

 

Back-end to Mobile

 

Request

 

 

Whatever the filter, you can organize the displayed topics and corresponding information into a list or grid view:

 

Use this button to display the available information into a list view (default view).

It provides the following information:

 

 

Use this button to display information into a grid view:

 

 

 

Available Operations

 

The "Topics" page also provides direct access to specific topic related operations:

 

•Use the search box to look for topics:

 

a. Enter the name of the topic you want to search for.

b. Click or press <ENTER> in your PC keyboard to initiate the search.

c. Use one of the following to clean the searched data to start a new search or return to a full view:

•empty the search box and click ;

•empty the search box and press <ENTER> in your PC keyboard;

•click the icon.

 

•Use this button to define which columns in the list view should be hidden or shown:

a. Click , which is located on the page's upper right corner, to open the list of available columns.

b. Check/uncheck the intended columns.

c. Click again to hide the list and apply.

 

• Use this button to export a .csv file with a list of topics. The export only concerns the currently filtered topics and corresponding displayed columns/information.

Ex: If ("Mobile to Back-end") and "Account" is selected and if all columns are hidden except "Topic Name"; "Available Msg" and "Ack" (column selection performed in the listing), you export a .csv field with a list of the existing "Mobile to Back-end" topics, in the account, and with the following fields:

 

 

• This button is used to refresh the page and define a Page Refresh cycle:

•Click for an automatic Page Refresh.

•Use to define the page's Page Refresh cycle:

a. Click to access the drop-down list with the available time periods ("Disabled"; "Auto" (default option); "1 minute"; "# minutes").

b. Select the preferred Page Refresh cycle.

c. Click the arrow again to hide the list.

If you select "Disabled", the page's content is only refreshed when you click .

A blue vertical gauge in the middle of the button displays the refresh cycle's progress.

 

To add a topic, use . This option is always available. For more detailed information, see Adding a Topic.

 

To copy a topic, use . This option is only visible if you select one(1) topic from the list.

When you click this button, it opens a "New Topic" page. For more detailed information on how to fill in this page, see To Copy a Topic.

 

To delete a topic, click . This option is only visible if you select one or more topics from the list.

For more detailed information, see To Delete a Topic.

 

To empty the current topic of all its messages, click . This option is only visible if you select one or more topics from the list.

For more detailed information, see To Purge a Topic.

 

 

This chapter describes the operations available regarding topics: