Platform Services

Navigation:  How to Work with Projects > Project Properties >

Platform Services

Previous pageReturn to chapter overviewNext page

 

Overview

 

This tab is only available if your subscription includes the Messagebox Service.

This cloud-based service, provided by MCL-Mobility Platform, allows for message exchange between the device/application and the back-end with the use of topics.

In the MCL environment, a topic represents a queue in the Messagebox Service and it is similar to a mailbox - a specific sender posts a message into a specific topic and the intended receiver retrieves the message. A message can have up to 10 headers and 1 body.

There are 3 types of topics that represent the Messagebox sub-services. (Refer to the MCL Mobility Platform User Guide - Use Cases.)

Mobile to Back-end – the intended message is sent by the device/application to a specific topic and the back-end reads/retrieves it.

Back-end to Mobile – A message is sent by the back-end to the intended topic and the device/application reads/retrieves the message.

Request - a message is sent from the device/application to this type of topic, the back-end reads/retrieves the request and, then, posts back a response to be read/retrieved by the device/application.

 

MCL-Designer V4 provides 3 types of topic profiles to correspond to the 3 types of topics available in the Messagebox service:

 

MCL-Designer V4 Messagebox Topic Profile Types

MCL-Mobility Platform Topic Types

Outbound (Device -> Platform)

Mobile to Back-end

Inbound (Platform -> Device)

Back-end to Mobile

Request/Response (Device < - > Platform)

Request

 

 

This tab includes a table with all the Messagebox topic profiles in the project - it provides the name and direction/type of the existing topic profiles.

The following options can be edited during project development (only unpublished projects can have their settings edited).

 

 

Topic profiles can be added, deleted, edited or copied by using the buttons located to the right of the table.

 

Click to apply the modifications OR  proceed to another tab.

 

 

To have more detailed information on creating and editing Messagebox topic profiles, see:

 

To Create a Messagebox Topic Profile

To Edit a Messagebox Topic Profile

To Delete a Messagebox Topic Profile

 

 

To Create a Messagebox Topic Profile

 

Topic profiles can be created in the "Platform Services" tab of the "Project Properties" window but, also, within some of the processes included in the "Platform Services" process group.

See Messagebox Processes.

 

Step-by-Step

 

1. Use one of the following to access the messagebox topic profiles table:

 

a. Open the "Project" menu (located in the Menu Bar), select the "Properties" option and open the "Platform Services" tab. The existing topic profiles are displayed in a table.

 

 

b. Click (if available) in the properties window of a Messagebox related process. This opens another window with a table displaying the topic profiles that can be used with the currently open process (ex: A Post Message Background process can only use Outbound (Device -> Platform) topic profiles so only this type of profiles will be available in the table).

 

 

c. Use the button included in the "Receive Message" event's window (located next to the topic profile's name). This table only displays the "Inbound (Platform -> Device)" type topic profiles.

 

 

2. Click (located to the right of the table) to open the properties window of the new topic profile.

 

 

3. In the "General" tab (open by default), fill in the following options:

 

Topic

Topic Name

Enter a name for the new topic profile or maintain the suggestion. (Ex: "MyTopic_1".).

 

The name of a topic profile must correspond to the name of a topic that is already created, either in the MCL-Mobility Platform OR  by the back-end application. Another alternative is to access your MCL-Mobility Platform account and, in the related section, create a topic with the corresponding type and the same name. For more detailed information, refer to the MCL-Mobility Platform User Guide.

Direction

Select the appropriate Direction for the topic profile from the drop-down.

 

Not editable if the operation was initiated from a Messagebox process. The profile's type is auto-defined according to the selected Messagebox process.

See Messagebox Processes.

(Ex: If the initiating process is the "Inbox/Receive Message", you will only be able to create a topic profile with the direction "Inbound/Device <- Platform").

Notes

If necessary, add notes concerning the new topic profile.

Options

Time to Live

Define how long the device/application will try to send the messages intended for the topic represented by the current topic profile. Any messages that were not delivered during this time, are removed from the device's cache.

Select the "Time to Live" value from the drop-down. Selecting default, means to use the device/application's internal time frame.

 

This option is only available for the Outbound (Device -> Platform) topic profiles.

 

 

4. The options of the next tab(s) depend on the topic profile's "Direction" (set in the "General" tab).

 

a. Outbound topic profiles provide access to the corresponding "Header" tab.

 

 

I. Proceed as follows:

 

Message Header: XXXXXXX

Header Name column

Accept the suggestions OR define new names for the necessary message headers.

Default Value column

If required, define a default value for the corresponding header OR  click and select a variable with that value. See Variable Definition

Note column

As an option, add notes to the corresponding header.

 

 

These "headers" are free text fields that are part of the message header. A message can contain up to 10 headers.

 

 

The defined header default values will be applied to the outbound messages that use this topic profile.

 

b. Inbound topic profiles also provide a "Header" tab with the necessary options.

 

 

I. Fill in the available options as follows:

 

Message Header: XXXXXXX

Header Name column

Accept the suggestions OR  define new names for the necessary headers.

Note column

If required, add notes regarding the corresponding header.

 

c. Request topic profiles have a "Request" and a "Response" tab in addition to the "General" tab.

 

 

I. Fill in the "Request" tab, as necessary:

 

Message Header: MyTopic_1

Header Name column

Accept the suggestions or define a name for each required header.

Default Value column

If required, define a default value for each header OR  click and select a variable with that value. See Variable Definition

Note column

If necessary, add info to the corresponding header.

 

II. Open the "Response" tab.

 

 

III. Fill in the options as follows:

 

Message Header: MyTopic_1

Header Name column

Accept the suggestions OR  define new names for the necessary headers.

Note column

As an option, add notes to the corresponding header.

 

The default values concerning headers that were entered in the "Request" tab will be applied to all the message headers that use this topic profile.

 

5. Click to conclude or to abort the operation.

 

 

To Edit a Messagebox Topic Profile

 

Step-by-Step

 

1. Use one of the following to access the Messagebox topics table:

 

a. Open the "Project" menu (located in the Menu Bar), select the "Properties" option and open the "Platform Services" tab. The existing Messagebox topics are displayed in a table.

 

 

b. Click (if available) in the properties window of a Messagebox related process. This opens another window with a table displaying the Messagebox topic profiles that can be used with the currently open process.

Ex: A Post Message Background process can only use Outbound (Device -> Platform) topic profiles so only this type of profiles will be available in the table).

 

 

c. Use the button included in the "Receive Message" event's window (located next to the topic profile's name).

This table only displays the "Inbound (Platform -> Device)" type topic profiles.

 

 

2. Click (located to the right of the table) to open the properties window of the selected topic profile.

 

 

3. Edit the necessary options in the available tab(s).

 

 

If you change the topic name, make sure the corresponding topic is already created, either in the MCL-Mobility Platform OR  by the back-end application.

 

 

4. Click to apply your changes.

 

 

To Delete a Messagebox Topic Profile

 

Step-by-Step

 

1. Use one of the following to access the table with the existing Messagebox topics:

 

a. Open the "Platform Services" tab of the current project's properties window (in the Menu Bar > "Project" menu > "Properties" option > "Platform Services" tab).

 

 

b. Click , when available (in the properties window of the Messagebox related processes).

 

 

c. Use the button included in the "Receive Message" event's window (located next to the topic profile's name).

This table only displays the "Inbound (Platform -> Device)" type topic profiles.

 

 

2. Select the topic you want to remove.

 

3. Click (located to the right of the table).

 

4. Click in the resulting window to confirm the deletion.