Messages

From Tygron Support wiki
Jump to: navigation, search
Please note: This page is currently being updated.

After reading this page:

  • you've learned what Messages.
  • you've learned how Messages relate to the Tygron Platform.
  • you've learned how to add Messages to a project.
  • you've learned how to change Message properties.

What is a Message?

A message is a discrete unit of communication intended by the source for consumption by some recipient or group of recipients. A message may be delivered by various means, including courier, telegraphy, carrier pigeon and digital means.

See also: https://en.wikipedia.org/wiki/Message

How do Messages relate to the Tygron Platform?

In the Tygron Platform messages are implemented as an internal messaging system to facilitate communication between active stakeholders and other (non playable) stakeholders, often represented by the session facilitator. This can be in the shape of automatically send permission requests for actions and measures, but can also be in the shape of money transfer requests, land transactions or bank loans.

The intention is to not allow sending and receiving messages between active stakeholders, to force direct verbal and face to face negotiations, in stead of an email exchange, between active stakeholders during a session. However, it is still possible to allow the exchange of messages between active stakeholders, this is just not as intended.

Session tip related to Messages

An often re-occurring event during sessions is when one stakeholder wonders how he can send the Municipality a message, to ask for instance why a permit approval is taking so long. Often the session facilitator will then reply: "Why don't you ask this directly? The Municipality sits just across the table..." 

Often (spatial planning) issues can be brought down to a bad communication flow between real life stakeholders. The above scenario can be a very important moment during sessions, when participants learn that by having a simple conversation (in person) these issues can often be resolved quicker than by following standard email procedures. Such session mechanisms contribute greatly to the educational/training value of the Tygron Platform.

Types of Messages

There are two main types of messages; fixed, predefined messages that are send automatically when a certain trigger is activated, and free-from messages that are send by the session participants to the session facilitator.

Fixed (predefined) messages

Predefined messages are linked to levels, measures and events. These messages will be send automatically when triggered by a measure or event. Such a trigger can be the start of a new level, or the deployment of a predefined construction as measure. Fixed messages can also be send by the session facilitator, or at a fixed (project) date.

Free-form Messages

Session participants can send messages to non selectable stakeholders and/or the session facilitator. In these cases, the content of the message needs to be created by the users themselves, including the replies from the session facilitator.

Adding, duplicating and removing predefined Messages in a project

Editor → Multi Stakeholder (Ribbon tab) → Messages (Ribbon bar)
'Messages' Left Panel
Select 'Messages' from Ribbon
Select 'Add Message' from bottom of left panel
Duplicate a message (left panel)
Remove a message (left panel)

Prior to linking a predefined message to a trigger, the message needs to be created itself. To create such a message, an empty message needs to be created through the Stakeholder section of the Ribbon. This message can then be edited into it's desired form.

How to add a new Message:

  1. Select "Stakeholders" in the ribbon header.
  2. Select "Messages" in the ribbon bar.
  3. Select "Edit Messages" in the drop down menu
  4. Select "Add Message" in the left panel.

How to duplicate a Message:

  1. Select "Stakeholders" in the ribbon header.
  2. Select "Messages" in the ribbon bar.
  3. Select "Edit Messages" in the drop down menu
  4. Select Message to be duplicated on the left panel
  5. Use the 'Duplicate' button to duplicate the selected Message.

How to remove a Message:

  1. Select "Stakeholders" in the ribbon header.
  2. Select "Messages" in the ribbon bar.
  3. Select "Edit Messages" in the drop down menu
  4. Select Message to be removed on the left panel
  5. Use the 'Remove' button to remove the selected Message
  6. Confirm the action on the warning panel


Changing properties of predefined Messages

'Messages' Right Panel

When selecting a message on the left panel, its properties can be edited on the right panel.

Subject

Subject field (right panel)

In the Subject field on the right panel a proper subject of the message can be entered. This is also the name of the message.

From

From/ sender field (right panel)

In the 'From' field, a drop down menu allows for selection of the desired sender of the message from a list of available stakeholders.

To

To/ receiver field (right panel)

The 'To' field on the right panel allows for the selection of the receiving stakeholder from a drop down list of available stakeholders.

Send to Everyone

'Send to Everyone' check box (right panel)

Marking this check box sets the message to be received by all active stakeholders.

Administrator can send this message

'Administrator can send this message' check box (right panel)

Marking this check box lets the session facilitator send the message to the selected recipients. This can be accomplished by the session facilitator in the Admin Interface.

Message is sent automatically at date

Message is sent automatically at date (right panel)

Marking this check box and entering a date in the date field triggers the message automatically when the selected date is reached in the project timeline simulation.

Contents

'Content' field (right panel)

In the Content field the actual body text of the message can be entered. It is also possible to paste (Ctrl-V) a copied text from elsewhere in this field.

Adding predefined answers to a predefined message

By default a standard answer (OK) is already attached to a new predefined message. It is possible to add more answers to the message, and even to let any answer trigger events in the Tygron Platform. This allows for multiple predefined answers to a single message, giving the session participants a choice in their replies. Any added event allows for automated feedback on the message reply.

Adding, duplicating or removing an Answer

Add an answer (left panel)
Remove an answer (left panel)
Duplicate an answer or message (left panel)

By using the 'Add Answer' button on the bottom of the left panel, a new blank answer (Empty) is added to the selected message. A new answer can also be added by selecting an already present answer and using the 'Duplicate' button.

To remove an answer, select the desired answer first on the left panel, then use the 'Remove' button on the bottom of the left panel to delete the selected answer from the list.

How to add a new answer to a Message:

  1. Select "Stakeholders" in the ribbon header.
  2. Select "Messages" in the ribbon bar.
  3. Select "Edit Messages" in the drop down menu
  4. Select the message in the left panel to add answer to
  5. Select 'Add Answer' button from the bottom of the left panel

How to duplicate an answer:

  1. Select "Stakeholders" in the ribbon header.
  2. Select "Messages" in the ribbon bar.
  3. Select "Edit Messages" in the drop down menu
  4. Select the message in the left panel to have answer duplicated of
  5. Select the answer to duplicate
  6. Select 'Duplicate' button from the bottom of the left panel

How to remove an answer from a Message:

  1. Select "Stakeholders" in the ribbon header.
  2. Select "Messages" in the ribbon bar.
  3. Select "Edit Messages" in the drop down menu
  4. Select the message in the left panel to have an answer removed from
  5. Select the answer to remove
  6. Select 'Remove' button from the bottom of the left panel
  7. Confirm the action on the warning panel


Answer Text and Events Fired When Chosen (right panel)

Answer Text

In the 'Answer Text' field the actual title of the answer can be entered. Besides the default 'OK' this can be entries such as 'NO' or any other short alternative answer.

Events fired when chosen

It is also possible to link events to an answer. This can be convenient if the answer implicates direct feedback in the 3D world for instance. Events, such as the triggering of a flooding, making available of new actions, or even switching levels, can be linked to be triggered an answer.

For the exact steps for adding, removing, and changing events, please see Editing Events.

Sending free-form Messages during a session

Action Menu icon to open Message Menu during a project session
Free-form message panel during a project session

Apart from setting up predefined messages in the Editor, stakeholders can also send free-form messages during a project session. As mentioned above, this is intended for communicating with non playable stakeholders, which will be represented by the session facilitator.

Most projects have the message action menu already implemented for all active stakeholders. Also, active stakeholders that do not have this menu option, will get the menu option added as soon as they receive a message. If no message action menu is present, please add this to the active stakeholder, to enable the sending of free-form messages.

Sending a message during a session resembles sending an email or cell text message in real life. The panel to send a message consists of three main elements; the subject field, the recipient field containing a drop down list with all suitable stakeholders, and a large text field for the body text of the message. It is not possible to send attachments along with these messages.

Due to the free form nature of these messages it is not possible to send auto replies in case the session facilitator does not have the time to reply.