Release Notes

oo

Updates are made periodically and will automatically be available in your Confluence Cloud instance.

Check out the latest release logs below to see what we've been working on recently.

Latest Releases

14th February 2023
What’s New?	in the app UI we have renamed the following Workflow History (the report that shows the workflow lifecycle of the document) is now Document Activity Workflow Report (the report that shows the workflow activity in a space) is now Document Report
Improvements	each Document Activity report entry now includes a link to the document version at the date and time of the activity
Bugfixes	fixed the document activity (workflow history) report display of the color for each workflow state indicator status

Release log 2022

13th December 2022

What's New?

This is our new documentation space for Comala Document Control Cloud!

We have updated the in-app links to the new documentation space.

The old documentation space at wiki.comalatech.com will no longer be updated for Comala Document Control Cloud.

If you have any questions please open a ticket with our support team.

Update

•  maintenance update to improve stability and performance

30th November 2022

What's New?

New document approvals macro.

Add one or more document approvals macros to a document to display approval information for a selected workflow state. The macro can be configured to display the overall approval status in the state, the assignees for the review, each reviewer’s decision status, and the date of the last decision for each reviewer and the reviewer comment.

The document approvals macro is compatible with the Confluence page properties and page properties report macros.

27th September 2022

What's New?

New document state page macro

Add the document state macro to a document to display one or more of the content current workflow state, the date the state changed, and, if present the state expiry date.

 The macro is compatible with the Confluence page properties and page properties report macros.

1st September 2022

Bugfixes

• fixed an issue that caused a document with an applied workflow in a Comala Publishing configured target space to be published to another (un-configured) space when the applied workflow on the document in the target space was transitioned to the final state

23rd August 2022

Bugfixes

• fixed a problem preventing email notifications from being sent for an approval with assignees if one or more of the assignees were invalid (for example the user account is disabled; the user does not have view permission)

• resolved an issue when using the Quality Management System Workflow that stopped email notifications from being sent to any valid recipients on transition to the In Approval state if one or more of the added user values for the "Document User Reviewers" or "Document Group Reviewers" parameters were invalid

10th August 2022

Update

•  error handling and logging improvements

Bugfixes

• fixed an issue that caused the 'View approved' byline link to be removed after editing content in the final state

• workflow picker options displayed on a page are now appropriate to the user permission (admin, edit, view)

Aug 2nd 2022

Update

• security improvement limiting permission scopes (admin; space_admin) requested by the app if not required

Bugfix

• fixed a problem that prevented a user with space admin permission from choosing to delete workflow history when removing a page workflow

28th June 2020

Update

• security improvement limiting permission scopes (admin; space_admin) requested by the app if not required

June 23rd 2022

Bugfix

• pages were not expiring on the due date unless the page was viewed by a user.  This release expires the content that is due since the release deployment.

 This release will not affect pages with a historic expiration prior to the release date. This is to avoid unforeseen changes in the workflow history of these pages.

• fixed an error that stopped a due date on pages with a long contentID from expiring

June 1st 2020

What's New?

To better understand what business case our evaluation customers are seeking to achieve when installing Comala Document Control the workflow picker now has the option to select a business use option from a drop-down menu before choosing a workflow to apply.

The workflow picker will then display all the available workflows including any custom workflows. The first workflow displayed in the picker will be prioritized for the chosen business case use. A user can choose the option to Skip the request.

This business use option will be available in our evaluation version each time a workflow is added to the content. It is aimed to help in the development of additionally available workflows and features within the Comala Document Control app.

May 12th 2022

What's New?

Users now have the ability to see what workflow is currently added and applied to the page. 

• new Show workflow option in the workflow popup dialog actions (ellipsis) menu
  

  

Choosing Show workflow opens a dialog box displaying a visual workflow diagram for the current workflow applied to the content.

 Users can also view the current workflow by choosing the Show workflow option in the page tools menu.

May 5th 2022

Updates

What's New?

Updated space settings Document Management dashboard UI

• new layout for Utilities and Settings
  
  

 If the workflow is disabled for the space, only Reindex workflows is displayed

• new Set Parameters button option displayed if the current space workflow includes a workflow parameter (Content Expiry Workflow and Quality Management System Workflow)
  

April 27th 2022

Update

• maintenance updates to improve stability and performance

April 11th 2022

Update

• vulnerabilities update

March 24th 2022

Update

• an individual user cannot now clear Workflow History from an individual page - the Reset Workflows button has been removed from the page Workflow History report
  o
  
  

Workflow history is stored as an attachment to a page. This attachment can still be deleted by a user with edit or admin permission and this will remove the Workflow History for the individual page.

A space admin will still have the option in the  space settings Document Control dashboard to Clear workflow history for all documents in the space.

Bugfixes

• updated Workflow Report to display "You have no approval workflows applied in this space" when no Comalatech workflow has been applied to any content in a space
  o
  
  

• improvements in the display of multiple assignees of a specific approval in the Workflow Report dialog box

• improved the display of group parameters in the parameters value dialog box accessed through Manage Workflow parameters menu option on the content

March 14th 2022

Updates

• maintenance and backend improvement updates

Bugfixes

• long state names displayed in the workflow popup are no longer simply truncated but are now displayed with an ellipsis and a tooltip to show the full name on mouse-over

• resolved a problem displaying the page workflow history

• fixed a problem that prevented the assignment of a user as a reviewer in the workflow popup and displayed an error

• update to ensure consistent styles are used across dialog boxes in the user interface

February 17th 2022

Update

• updated our app to allow us to work on implementing future improvements to our UI

Bugfixes

• resolved a problem that prevented access to the workflow report if the space home page was deleted

• fixed a bug causing the breakup of the style for some of the app dialog boxes

February 14th 2022

Bugfixes

• fix to ensure workflow Updated transition works in any instance where Atlassian Confluence generates a long contentID

• resolved a problem that created duplicate notifications in the Workflow History when initializing states space-wide

February 9th 2022

Bugfix

• resolved a problem that caused the initialization of states in a space to fail if the space had no homepage

February 2nd 2022

Bugfixes

• resolved a problem causing duplication of automatic email notifications to users who are pre-assigned as a reviewer for an approval

• fixed a problem that caused inconsistencies in workflow states after a space-wide initialization of the states

• when adding a workflow, it is no longer applied to the space home page†

_{† Previously the workflow was applied to the space home page but due to the limitations of Atlassian Confluence Cloud there was no access to the workflow or display of any workflow breadcrumbs}

January 17th 2022

Bugfixes

• updated workflow report to display details of any content that is under the root level of the space (except space homepage)

• update to improve performance when using inWebo credentials for e-signature authentication

Release log 2021

December 16th 2021 

Bugfix

• fixed a problem in some instances to ensure the display of workflow history where Atlassian Confluence generated long contentIDs (greater than 9007199254740991)

December 9th 2021

Update

• maintenance update on the debug tools feature, which is a non-public (dark) feature

October 28th 2021 

Updates

• error handling messages are now displayed when importing or exporting workflow history

• import/export of workflow history is now logged and traced with a unique Trace id for the request containing details of the

  • user who performed the action

  • Cloud instance

  • space key

  • content id  (if applicable)

  • process type (Export or Import)

Crowdbugfix

• resolved a problem to ensure that we wait for a successful check for user rights before doing some actions when using Confluence accessor isUserAppAdmin method

October 25th 2021

Bugfix

• resolved a problem when enabling the inWebo e-signature authentication settings in global administration that prevented the attachment of the inWebo authentication certificate

October 21st 2021

Update

• update related to Atlassian Connect installation lifecycle security improvements

• update to add in-app InWebo credentials encryption when using InWebo for authentication

Bugcrowd fix

• update to prevent users from being able to change the app configuration using the REST API

October 14th 2021

Updates

• disabled workflow history backup and restore process

Due to customer feedback, we have temporarily disabled the workflow history backup and restore process.

Customers that are in the upgrade process should contact us.

September 27th 2021

Updates

• the user display name is now used in workflow history when workflow parameters are used to pre-assign or assign users and/or groups to an approval

Bugfixes

• resolved a problem displaying the workflow content byline

  • after using the Atlassian Cloud to Cloud migration process to move their entire site to a different Confluence Cloud site

  • after using the Atlassian Cloud to Cloud space import process to import a space to another Confluence Cloud site

September 15th 2021

Update

• standardized the storage of user and assigner attributes after a workflow action occurs to accountID and displayName - ensures consistency of display in the workflow history

Bugfixes

• resolved a problem displaying changes in space administration when there was a large number of space properties

August 24th 2021

Updates

• when a user has been disabled or deleted, Workflow History will now display the default avatar and a user's full name (as stored as the display name) instead of the Atlassian ID

• Back up Workflow History dialog close button has been renamed from Cancel to Close to avoid misinterpretation of the action

• links to summary details of the Last import and the Last export of a workflow history backup now available in Workflow History in the space Document Control dashboard

Bugfixes

• minor code patches to differentiate between upper and lowercase

• updated typos in some UI components

July 26th 2021

Updates

• vulnerability updates

Bugfixes

• resolved a problem that caused resizing of the app global configuration screen

July 15th 2021

Update

 This is a major release

• We have removed the ability to edit workflows for new installs only

  • a new install of Comala Document Control for Confluence Cloud will not have the workflow builder or the option to edit or add JSON markup. 

  • If you need the ability to fully customize a workflow please use Comala Document Management for Confluence Cloud
    

• For existing installs there are no changes; the ability to edit a workflow, access workflow builder and edit/add JSON markup is still available

  • for users requiring help in an existing install of the Comala Document Control app, workflow builder documentation is available here

If you have any questions please open a support ticket.

June 16th 2021

Updates

• you can use the Initialize states option to publish every page in a space to a target space at the same time. Comala Publishing is used to publish content in a space on a page-by-page basis.  However, you can choose to configure the Comla Publishing action on the transition to a specific state

  • the source space page hierarchy is maintained on the publish action to the target space
    
    

• updated space document dashboard UI to include a warning when initializing states if Comala Publishing is installed
  

  

  
  
  "Note: if Comala Publishing is installed & configured for this space, Initializing states when may result in unforeseen publishing of content to the target space"
  

Bugfixes

• fixed a problem that when a space admin chose to initialize states, it initialized content to the initial workflow state instead of the state selected in the space settings Document Dashboard dropdown menu

• resolved a problem that was causing misdirected request logs

June 8th 2021

Bugfix

• fixed a problem that caused the workflow history to be rendered empty

May 27th 2021

Bugfixes

• fixed a problem with license validation after the license has expired

• when no Comalatech workflows are added to a space, the workflow report now displays confirmation that the app is disabled for the space

May 18th 2021

Updates

• Atlassian Connect framework update

• updated space Document Management dashboard to remove reminder that enabling e-signature is found in approval settings

Bugfixes

• updated the workflow report to display confirmation message if no Comalatech approval workflow is installed in a space

• fixed a problem in the previous version link in the page history

• fixed a typo in the Change state on-screen notification

• fixed an authentication error when installing the app to a new instance

April 27th 2021

Updates

• upgraded app security together with improvements in cache management and performance

• update to support changes in the App migration platform   - see the  Atlassian migration model deprecation

April 1st 2021

 Maintenance update

March 31st 2021

 Maintenance update

March 17th 2021

Updates and bugfixes for inWebo authentication integration option for e-signature use for approvals

• updated global configuration to display a visual confirmation when the inWebo Certificate has been uploaded and added
  
  
  

• when using inWebo authentication removed email validation requirement from workflow popup  OTP username field to allow validation using inWebo usernames that are not an email address

• updated global configuration to remove all inWebo configuration details when the inWebo Service ID is removed

March 10th 2021

Updates

• send-email action in triggers updated to include additional value references @creator and @LastUpdatedBy. These complement existing use of value references such as @watchers

• Content Expiry Workflow updated to only include @watchers as the recipients for the send-email trigger action

Bugfixes

• fixed issue with the use of @watchers value reference when used in the  send-email action in a trigger

• fixed issue when using clean-message action in a trigger

March 1st 2021

Comala Document Management can now use inWebo authentication as an option when e-signatures are enabled

• this allows clients to use inWebo to manage the authentication process for users when an e-signature is required for approvals

• inWebo simply passes an API key and an inWebo Service ID - to Comala Document Management

• Service ID key generated by inWebo administration must be added to Comala Document Management global configuration

• a user generates an OTP token using the inWebo Authentication app for mobile Android and IOS devices

• all other 2FA use is disabled when inWebo is used for authentication

Bugfix

• resolved issue where sometimes status wasn't updated in byline and workflow report after a workflow change

February 18th, 2021

Workflows can now be edited^* to add a select transition to a state.

Each individual state can be configured to allow users to use the workflow popup to choose a destination state and transition the workflow to this state.

One or more options for the destination state will be displayed in a dropdown menu in the workflow popup.

The destination state options displayed in the popup are configured using the transition editor in workflow builder.

The select transition cannot be used

• in a state with an approval

• in a final state

A select transition can be added to a state together with an expired transition and an updated transition.

A select transition will not be available to add to a state with an approval added - the transitions editor will only display the approved, rejected, updated and expired transition options.

Adding an approval to a state with a previously added select transition will replace the Submit option on the workflow popup on the content with the Approve and Reject buttons.

^* Comala Document Control for Cloud release from 15th July 2021 - workflows can no longer be edited. Custom workflows can only be created and edited if you upgrade to the Comala Document Management for Cloud app.

February 15th 2021

Updates

• When there are more than 6 reviewers assigned to an approval a read-only workflow dialog box is available to display the full list of reviewers (approval reviewers list).

The approver dialog box is read-only but the columns can be sorted and the report can be filtered.

• The approval reviewers list can be viewed by

  • using the workflow popup on the page by choosing the +n icon
    

    

  • choosing a reviewer avatar in the workflow report
    

    

Bugfix

• resolved issue of set-expiration macro use in a trigger

January 26th 2021

Update

• when a state has multiple approvals, the workflow report now displays the named approval avatars rather than the assignee(s) avatars. Users can click on each approval avatar to view assigned users

Bugfixes

• correct date format now being displayed in workflow history

• layout issue for page report when selecting filter buttons

• set message action amended to work when used in a workflow trigger

Earlier Release logs

Releases 2020 December 23rd 2020 Bugfix release fixes some problems when showing pre-assigned reviewers (reviewers assigned by using the workflow builder as shown below) on the Workflow Report                December 16th 2020 We are introducing some security improvements onto the current approvals configuration different setting options. Anyone can approve (no restrictions) from now on, approvals with the configuration Anyone can approve (no restrictions) won't be assignable anymore workflow state dialog will NOT ALLOW reviewers assignation Users can be assigned through the (workflow popup) UI this option allows manual assignation of reviewers by using the workflow state dialog. This will remain working the same as now. → So It will still be possible to leave the approval with no assignees or assign specific reviewers: Workflow state dialog will ALLOW the assignment of reviewers, but you can add users in the approval editor to allow PRE_ASSIGNMENT of reviewers. A user with VIEW & EDIT permissions over the content will view enabled approve/reject buttons but these approve/reject buttons are disabled if a user has been assigned but the current logged-in user is NOT ASSIGNED to the approval. Set all reviewers that have to approve from now on, approvals with this configuration won't be assignable anymore. It'll still be mandatory to pre-assign the set of reviewers to the approval workflow state dialog will NOT ALLOW the assignment of reviewers. A user accessing the content who is not assigned as a reviewer will see the approve/reject buttons disabled (greyed out) October 15th 2020 Now you can set a minimum number of approvals/rejections (whatever happens first) for the approval to transition even when the approval setting is defined as "Set all reviewers that have to approve" (up until now you could set a minimum just for the other two approval settings). September 16th 2020 Feature update New feature available that allows you to automatically remove page restrictions when the page reaches the final state in the workflow, by simply accessing Document Control under your Space Settings. If you prefer to invoke the action manually by editing the JSON triggers, you can view the documentation here. Also included are some bug fixes: Fixed bug with multiple approvals not working Fixed email notifications for automatically pre-assigned users and groups August 25th 2020 Update and bugfix release multiple UI enhancements some bug fixes August 17th 2020 Update and bugfix release added support for option select workflow parameter type. This allows you to set up a list of valid options to select from we've made some tweaks for all parameter types at the space configuration screen also fixed bugs and made some tweaks for all parameter types at the space configuration screen August 4th 2020 Bugfix release fixed an issue where approving a page with a pre-assigned group was not working fixed an issue where the workflow report was not showing correct data - it now searches on every user action July 14th 2020 Fixed an issue with user first and last names that had special characters June 15th 2020 Update to the handling of expired subscriptions to improve error messages where app functionality will not be available. June 4th 2020 The workflow report has been renamed from Document Report to Workflow Report. Sidebar link and report title amended. June 2nd 2020 Bug fix updates for the pagination on the signing token global administration and filter options in the Document report. May 26th 2020 Updated the minimum approver option behavior to work with assigned users.  Now when multiple people are assigned to the approval it will be considered approved (or rejected) as soon as the minimum number has been reached, not waiting for all the assignees. May 19th 2020 Trigger markup can now be viewed and edited in the Document Control workflow builder without needing to go into full markup editing mode. May 18th 2020 New Welcome Tour feature added with useful information and links for new users. May 15th 2020 Option to enable anonymous user usage tracking added to the global admin configuration menu Note: This option is only available for paid licenses, not during the trial license period.  Site-wide feature usage statistics will still be compiled by Comalatech for all license types to help understand usage trends and prioritize future feature development. May 14th 2020 A fix in the workflow builder so that states that are referenced in triggers can have their names changed. April 24th 2020 Resolved issue with email notifications for approvers on the QMS workflow. April 7th 2020 In this update, e-signatures can now be configured to work on any approval. (Please note if you are using the existing Quality Management System workflow the e-signature setting will default to true on the approvals when you first make customizations to this workflow.) April 6th 2020 Customizable workflows are here.  You can now make changes to the workflows in each space; add states, approvals and transitions to exactly match your business process. April 1st 2020 Approvals using e-signatures are now identified in the workflow history. Adding more than 7 approvers to an approval will now work correctly with the addition of a scrollbar on that screen. March 17th 2020 Refreshed look for the workflow progress tracker. Other minor bug fixes including Fixed an issue where the space home page was appearing in the document report Fixed an issue where only 7 approvers could be selected Approval buttons will be now disabled if the user has already approved Feb 27th 2020 Fixed an issue with the time format of expiration date in the workflow report Feb 5th 2020 Resolved a long-standing issue sending email notifications when a page reaches the expiration date on the content expiry workflow. January 8th 2020 Change to the way the e-signature approvals are handled.  Now users will need to generate a token using a third-party app rather than their Atlassian password as part of the approval process. For guidance, see Setting up an approval signing token.

Releases 2019 November 26th 2019 Introducing Comala Document Control (formerly Comala Workflows Lite) The new name better describes the scope and use of the app. While workflows will continue to play an important role, Comala Document Control offers much more than just approval workflows. Teams are not only using our app to add approvals, they’re using it to add formal document control to their pages. Comala Document Control tells a much more complete story about what our apps can do. October 29th 2019 Bug fix, updates, including: Fix for emojis in approval/assign comments causing an error. October 15th 2019 Bug fix updates, including: Fixed a problem with workflow parameters when moving a page to another space. October 4th 2019 Bug fixing: Now Workflow History shows that workflow was initialized to a state from Space Configuration September 26th 2019 New feature: Added a new button to enable/disable the E-Signature on the QMS workflow: On new installations workflows will not be enabled in all spaces.  A workflow must be selected in space administration before it will become active. Bug fix updates, including: Fix for in page notifications on page approval/rejection Fix on description in the activity history for assigned/unassigned entries. Fix for the state dialog that was showing the internal user ID on assigned users. August 16th 2019 Bug fix updates, including: Improvements to expiry transition processing so it will happen next time the page is viewed if a webhook is missed. Fixed a problem reading some old workflow parameter values that were created with an earlier release. June 13th 2019 Improved Approvals Dialog Layout The visual design of the Approvals Dialog Pop-up has been improved. It's now easier to use, and is up to date with the latest Confluence styling. Added a progress tracker to see the current state within the full workflow.        March 18th 2019 Minor UI updates and Atlassian API changes for GDPR compatibility. January 23rd 2019 Small UI update to include the time an activity was undertaken in the activity report for all activities, not just the ones in the last 24 hours.

Releases 2018 December 20th 2018 Page Workflows: If the space wide workflow is disabled, it will now be possible to select and enable a workflow on individual pages. New transitions on QMS Workflow: You can now transition from the published state to "In Approval" or "Obsolete". Workflow Template Autoupdate: When the workflow templates are updated (for example in this release adding new transitions to the QMS workflow) this change will apply immediately where this workflow is applied.  Space admins will no longer need to re-enable the workflow to get the updates. September 6th 2018 New Quality Management System (QMS) Workflow. This workflow features: Approvals with E-Signatures. Reviewers need to use their email and password to confirm their identity (this is a compliance requirement). The e-signature does not work with SAML SSO yet. Due to the large amount of identity providers, we will progressively support SAML SSO based on our customers’ demand. Approvers as Space Parameters. Admins can set a list of users or groups as Controlled Document Approvers.  Several bugs fixed and UI improvements. August 2th 2018 New user picker in the byline section. Improved the Report Section, adding support for more workflow states. Minor UI bug fixed. May 7th 2018 Comala Approvals becomes Comala Workflows Lite: Workflows Lite now supports selecting from different workflows to enable on your space.  Initially there is the existing Basic Approval Workflow that was part of the previous Approvals product.  The first new workflow you can select from is a Content Expiry Workflow that will transition pages to an expired state after a designated time. We have also made some updates to the user interface to reflect the most recent design changes in Confluence. Apr 17th 2018 If a page has permission restrictions that prevents Comala Approvals we will attempt to add the Comala Approvals user to the page permission restrictions automatically. Fixed My Pending Approvals report to display the green checkmark when the user approves. Several minor UI improvements including some updates to match the latest Atlassian design guidelines. Feb 26th 2018 Administrators can now remove all the approvals history in a page. Fixed an issue related to adding reviewers to a page. Jan 30th 2018 Added pagination support for Approvals Report.  Fixed an issue that sent emails with broken links to pages waiting review. Fixed an issue that prevented approvals from working after a page was migrated to a different space. Minor UI issues. Jan 10th 2018 Bugfix Report when Space has numbers on ID  Changed Node version to 6.11.5 Minor UI issues

Releases 2017 Oct 23 2017 Fixed an issue related to e-mail notifications. Minor UI issues. Oct 10 2017 Internal server improvements. Minor UI issues. Sept 21 2017 Administrators can now remove Approval history from a space. Minor UI issues. Jun 22 2017 Minor UI issues. May 17 2017 Approvals now allows users to view the published page as well as the updated version before being approved toggling through links: View approved links to the approved version, and View pending approval links to the version under review. April 19 2017 UI tweaks to improve speed. February 22 2017 A new optional field to provide a message to all the assignees has been added to the Assign step; this message will be added to the notification email. Fixed bug where email notifications were not sent to all the reviewers assigned. Minor UI improvements February 2 2017 Multiple reviewers for a page can now be assigned in one single operation by entering them in a text field. Just start typing the user name in the field the the name will auto complete. 2 characters have to be entered to start the search. Users that have been assigned as reviewers already won't be displayed in the auto complete options. January 26 2017 The latest version of Comala Approvals features a significant update to how Approvals handles user activity. Specifically, Approvals now includes OAUTH user impersonation on all back-end operations. This resolves some existing issues and adds new functionality: Eliminates most add-on user permission problems Webhook transitions are now accurately ascribed to the user who triggered the event Improved permissions validation As this update includes changes to user permissions, it must be installed manually by the Confluence Administrator; the update will not roll out automatically. Click "update" in the Add-on manager and a pop-up will prompt you to accept and update; if you accept the update the new version of the add-on will be installed on your cloud instance instantly. January 19 2017 Minor bug fixes

Releases 2016 November 30 2016 Fixed a bug where character encoding was causing display issues. November 22 2016 Email notifications to assignees (and unassigned users) Bug fix for disabled spaces to prevent already open pages from being approved. November 9 2016 Improve the way the status display is dynamically updated.