Working with commentary
A Qommentary Insights extension can be embedded in two (2) different ways: Default view and Fullscreen view.
Default View
Commentary message: Displays commentary text entered by the user
Commentary Status: Displays the current commentary status.
Commentary explorer: Displays a list of draft, awaiting approval and published messages for the current extension.
Discussions: Opens the Discussions panel to enable threaded comments amongst teams
Watch: Subscribes a user to a Qommentary Insights extension to receive updates when new commentary has been published.
Share: Launches a popup window and allows commentary to be shared to one or many user/s or group/s.
Export: Generates a PDF report of the current commentary including any associated visualizations.
Edit/Recall: Depending on the commentary status, a user is able to Edit a commentary on Draft status or Recall a commentary on Published status.
Fullscreen view: Expands the commentary full screen and switches to Fullscreen View.
Commentary details: Displays additional commentary-related information, such as created/published date/time and owner’s full name.
Fullscreen View
Commentary visualization: Loads any visualization which has been associated to the commentary during the development phase.
Visualization panel controls: Allows you to expand or collapse the visualization panel.
Comments panel: Allows you to expand or collapse the comments panel.
Close fullscreen: Closes the Fullscreen View and returns to Default View.
Refresh comments: Updates the current list with latest comments.
Send comment: Sends a new comment.
Link visualization: Associates the current visualization to the new comment.
Input comment field: Allows you to type a new comment in the text field box and mention users.
Action button: Depending on the commentary status, it displays various commentary-related action buttons.
Commentary display modes
Qommentary Insights can be embedded in an application in two (2) different ways: Full and Compact.
Full Mode
Full mode displays a rich-text editor embedded on the sheet for added context and visibility.
Compact Mode
Compact mode displays an icon on the sheet, ideal for visualization-intensive applications where real estate is limited. This mode allows multiple Qommentary Insights extensions to be embedded in a single sheet without compromising dashboard design.
The Compact mode icon appearance can be customized in a variety of ways:
Changing icon color
Edit the sheet
Select your Qommentary Insights extension
In the Properties Panel, expand Appearance > Presentation
Under the Icon color property choose an color
Changing icon background color
Edit the sheet
Select your Qommentary Insights extension
In the Properties Panel, expand Appearance > Presentation
Under the Icon background color property choose a color
Changing icon shape
Edit the sheet
Select your Qommentary Insights extension
In the Properties Panel, expand Appearance > Presentation
Under the Icon background shape property choose a shape
Commentary Status
A commentary can progress through five (5) different statuses along its lifecycle:
Draft: Commentary is in draft mode and not visible to the application users
Awaiting Approval: Commentary has been submitted for approval and it’s waiting for approval workflow to be completed before publishing.
Recalled: User wishes to edit a commentary which has been published, or edit a rejected commentary.
Approved/Rejected: Commentary has been approved and is ready to be published or has been rejected and must be recalled before re-submitting for approval.
Published: Commentary has been published and is not visible to all application users.
Rich text formatting
Qommentary Insights allows commentary to be formatted just like your favourite text editor. There are two (2) types of text formats available: plain text and rich text.
To select a text format option, please follow these steps:
1. Edit the sheet and select your Qommentary Insights extension
2. Expand Commentary > Text editor section in the properties panel
3. Choose a text format option
If switch from rich text to plain text and edit a commentary which was previously saved with rich-text formatting, the commentary will be converted to plain text when you save.
When rich text is selected, you can control which formatting tools are displayed in the editor's toolbar:
Tool | Description |
Text formatting | Allows text to be formatted with bold, italic or underline |
Text color | Allows text background and font colors to be customized |
List | Allows creation of bullet or number lists |
Text alignment | Allows text to be horizontally aligned to left, center, right or justified |
Link | Allows text to link to other sheets, applications or external pages. |
Check or uncheck each option in the properties to enable or disable formatting tools as desired.
To apply rich text formatting to a commentary, please follow these steps:
Write a commentary or edit an existing one
2. Format your commentary using the rich-text toolbar
3. Click on the Save button
4. Your commentary has been successfully formatted
Enabling
Creating a commentary
You may begin writing commentary given you have the following roles or permissions:
To write a commentary, follow these steps:
2. Type some text into the rich-text editor
3. Click on Save button
4. Congrats! You have saved your first commentary as a draft.
Editing a commentary
Once commentary has been created for a given set of selections, you can edit the commentary given you have the following roles or permissions:
To edit an existing commentary, follow these steps:
2. Update your existing commentary
3. Click on Save button
4. Your commentary has been successfully updated
Submitting for approval
If the stream, application or sheet where the commentary resides is being managed by an approval workflow, you may submit a commentary for approval given you have the following roles or permissions:
To submit a commentary for approval, follow these steps:
Write a commentary or edit an existing one
2. Click on Save button
3. Click on Submit for approval button
4. The commentary has been successfully submitted for approval
Publishing a commentary
A commentary can be shared with all other application users, if the commentary status is set to Draft (without an approval workflow) or Approved (with an approval workflow).
Once a commentary is ready to be shared, you may publish the commentary given you have the following roles or permissions:
To publish a commentary, follow these steps:
Click on Publish button
2. The commentary has been successfully published
Recalling a commentary
If a commentary which has been published needs to be updated, you will need to recall the commentary given you have the following roles or permissions:
To recall a published commentary, follow these steps:
2. The commentary has been recalled successfully and the status will be reset to Draft
3. You may now edit the commentary.
Comparing a draft commentary to the published version
During the commentary authoring phase, it might be useful to compare a commentary against the published version.
To compare a commentary against the published version, follow these steps:
4. The published commentary is now displayed side-by-side with your draft commentary.
Viewing commentary info
2. The commentary info will display the full name and date/time of the last updated commentary
Last updated
