Sitrion Cloud Comms Ask A Question Micro-app

 

Sitrion Cloud Comms

Ask A Question Micro-app

 

 

 

Table of Contents

Overview

Configuring the Ask a question micro-app

Available configuration options

Configuring channels for employee communication

Cloud Comms Card

Micro-app

Finding messages sent by users

 

 

Overview

The ask a question micro-app is intended to allow employees to submit questions to authorities deemed appropriate by management.

The micro-app is configured to create cloud communication messages on a configured channel. In order to allow regular employees to submit messages the channel should be made public for reading and only the appropriate groups should be marked as able to subscribe to it.

The employee composing the message will receive a copy of the question as a cloud comm card and will be able to see the interactions, comments/answers, that occur for that question.

 

Configuring the Ask a question micro-app

1. First you need to assign the “Sitrion Cloud Communication Ask a Question” micro-app to the role the users you want to communicate will be assigned to.
2. You should configure a channel you wish employees to use for communication
   1. See section about configuring channels
3. You need to configure the micro-app instance to it sends to the appropriate channel.
   1. The title you give the application instance will be the title that is displayed when running the application.
   2. See section about available configuration options

 

Available configuration options

Configuration options are set in the application instance configuration form.
 

 

 

Configuration option name	Expected	Description
TargetChannelName (Mandatory)	String	The name of the channel the micro app should use when sending out the question.
TargetGroupIds (Optional)	Guids separated by comma if more than one.	The id (Guid) of the group or groups you want the application to target when sending the question. These are not mandatory. Note: Right now it’s not easy to find out the id of the group, it will be added to the groups form soon so you can determine this info.
SendPushNotification (Optional)	True or False (Default : False)	Indicates if a push notification should be sent to the targets of the message when it is sent.
SummaryTruncationLength (Optional)	Integer (Default : 400)	Indicates how many characters of the question should be used to create the summary card of the message.
BannerImageUrl (Optional)	url	Indicates a url to a custom banner image you want to use in the app instead of the default provided one. Note: You can upload an image file to the “Portal / Resources / Files” form and use the URL to the uploaded file.
TitleFormat (Optional)	String (Localizable)	Allows you to control the title that will be set as the title for the message. It allows you to have the following tokens that will be replaced when creating the message : {FirstName} = First name of the current user {LastName} = Last name of the current user Default if parameter is not specified: "New question from {FirstName} {LastName}"
PostActionLabel (Optional)	String (Loalizable)	The label showed for the action button that will be used to send the message.
PostTextWatermark (Optional)	String (Localizable)	The watermark text showed in the post message field.
MarkAsImportant (Optional)	True or False (Default : False)	When set to true the user messages will be set as important.
SendCardToAuthor (Optional)	True or False (Default : True)	When set to true the author of the message will also receive the card.
ShowPictureUpload (Optional)	True or False (Default : True)	When set to false the picture upload isn’t available in the micro-app.
PictureUploadLabel (Optional)	String (Localizable)	The label showed on the picture chooser
SuccessLabel (Optional)	String (Localizable)	The message showed when the submit was succesful
SuccessLabelTitle (Optional)	String (Localizable)	The title showed for the success message
ErrorLabel (Optional)	String (Localizable)	The message showed when the submit was not succesful
ErrorLabelTitle (Optional)	String (Localizable)	The title showed for the error message

 

Configuring channels for employee communication

Channels are configured in the “Portal / Cloud Comm / Channels” form.

You will need to define a channel where all employees can write to and only certain groups can actually subscribe to receive the communications from those employees.

 

Figure 1 - Configuring a public write / private read channel

In the above image you can see that we configured a public channel called “Cloud Comm Questions”. For that channel only users in the “Cloud Comm Managers” group will be allowed to subscribe and therefore receive messages targeted to the “Cloud Comm Questions” channel.

Note: Channels are subscription base so if users do not subscribe they will not receive the messages. If you wish to force all users in the configured group to get the message you can make the channel mandatory in which case all users in the configured group will always receive all the messages.

 

Cloud Comms Card

When a user asks a question with the micro-app a cloud communication message is sent to the channel. Users subscribed to that channel will get the message and will be able to interact with the author of the question by commenting and liking. The author will also have received that card so he will also be able to interact.

 

Micro-app

 

Finding messages sent by users

To find all questions that have been submitted by your users go to the “Portal / Cloud Comm / Messages” form. The messages form offers filters that will allow you to find all messages sent on the channel you configured to receive the ideas.

Figure 2 - The messages form filtering on a channel