Release Notes

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

Release log 2023

25th Oct 2023
Updates	app user displayed with app icon in document activity report

26th Sept 2023
What’s New?	New Onboarding feature with access to use cases and interactive demonstrations. Accessed through the Apps options in the Confluence left-side or top menu.

15th Sept 2023
What’s New?	We have updated our Comala Document Management Cloud app logo and in-app icons.
Updates	added further log details if the notification of a state change fails
Bugfixes	fixed a problem identified by Atlassian that sometimes displayed some static resources to a logged in user instead of only the admin user

24th Aug 2023
Updates	space settings document management dashboard is now accessed from space settings App links

9th Aug 2023
Updates	added button options in the workflow builder navigator panel to toggle between the visual editor and the code editor

12th June 2023
Updates	Updated space document management dashboard UI document activity Clear button is now grey changing the space workflow option is now Manage Workflows button Edit Workflow dropdown menu options are now Use Visual Builder and Use Code Editor
Bugfixes	fixed an issue that required reloading the page to display users pre-assigned as reviewers in the workflow popup fixed a problem initializing states using the space document management dashboard

29th May 2023

What’s New?

New Document Activity reporting page macro and updated document activity report. The document activity page macro can be added to a page or blog post to display the dynamic information for the lifecycle of the workflow events on the document. The macro can be configured to display one or more of the following: the User associated with the document activity workflow document Action the workflow State any user Comments related to the document activity the Date of the document activity the document Version The version includes a link to the document version.

9th May 2023
Improvements	The on-screen message notification displayed to an assigned user on viewing the page now includes the approval name and assigner.
Updates	maintenance updates
Bugfixes	resolved an issue causing unnecessary notifications fixed a problem generating notification messages when a user is assigned to an approval and when content is rejected

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
Improvement	each Document Activity report entry now includes a link to the document version at the date and time of the activity
Updates	updated error messaging for the app in the global admin migration screen to include a link to Appfire Comala support
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 Management 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 Management Cloud.

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

Updates

• minor maintenance updates 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, 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.

Update

• migrated content from server now includes the page status macro when the source server content includes the server page status page macro

  • the page status macro is not available in the macro browser in cloud

  • we recommend replacing this macro with the document state macro

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 an 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 to valid assigned users to an approval if one or more of the assignees were invalid (for example the user account is disabled; the user does not have view permission)

• when using the send-email trigger resolved an issue that stopped custom email notifications from being sent to any valid recipients added as a parameter value if one or more of the added recipient user values were invalid

10th August 2022

Update

•  error handling and logging improvements

  • log entry now occurs for a workflow trigger-generated email 'failure to send' error

  • additional context added for event requests to the log entries

Bugfixes

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

• workflow popup is no longer blocked for an applied page-level workflow if the state transitions are edited after adding the workflow

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

3rd August 2022

Bugfix

• fixed a problem to allow a custom workflow created from the bundled Basic Approval Workflow to be applied as a page workflow

2nd August 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 July 2022

What’s New?

As part of our integration into the Appfire family, Comala Document Management is now a member of the One Appfire app offering. We have updated our app logo and related assets.

28th June 2022

Update

• security improvement limiting permission scopes (admin; space_admin) requested by the app if the permission scope is 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 its deployment

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

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

June 1st 2022

What's New?

To better understand what business case our evaluation customers are seeking to achieve when installing Comala Document Management 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 Management 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

 new Edit Workflow button that is always visible for the current space workflow.

 if the current space workflow is disabled only Reindex Workflows is displayed in the Utilities/Settings options.

• new Set Parameters button option displayed if the current space workflow includes one or more workflow parameters

 Selecting the Set Parameters button opens the Parameters dialog box to edit the workflow parameter values.

April 27th 2022

• maintenance update to improve stability and performance

April 11th 2022

Update

• vulnerabilities update

Bugfixes

• fixed an issue in the send-mail trigger action that prevented the email notification being sent to some of the specified recipients

• resolved an issue when an applied workflow encountered a duration type workflow parameter with a fixed date value that caused the date value to be set as the current date

• fixed a bug in migrating the current workflow state attributes

March 24th 2022

Update

• users 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 document. This attachment can still be deleted by a user with edit or admin permission and this will clear the document Workflow History for the individual document.

A space admin has the option in space settings Document Management dashboard use the Clear to remove the 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

  

• improved the appearance of the Workflow Report dialog box when displaying multiple assignees of a specific approval

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

• resolved an issue in migration for spaces with >5k documents migrating some anonymous user and deleted user details who actioned the last workflow state change

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 caused the "on-expire" event in a trigger to require an Expired transition in the state set to expire (the "on-expire" event DOES NOT require the state to have an Expired transition)

• fixed a problem assigning groups to an approval by Confluence groupName and/or groupID  in the "assign" trigger action

• 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 14th 2021 

Update

• from now on migration data values for Comala Document Management will use a new attribute eventType (with either app-data-uploaded or listener-triggered values) that holds the current information for events fired by the Atlassian App migration platform. This is due to the Atlassian App migration platform deprecation notice for the webhookEventType attribute

December 9th 2021

Update

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

November 17th 2021

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

Updates

• a user select transition is available to add to a final state in a custom workflow

• 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

• summary details link of last import or export of a workflow history backup added to Workflow History in the space Document Approval dashboard

Bugfixes

• minor code patches to differentiate between upper and lowercase

• updated typos in some UI components

July 29th 2021

Updates

• vulnerability updates

Bugfixes

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

• fixed an issue so that an edited workflow cannot be saved with a select transition and an approval transition in the same state

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"

Bugfix

• 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

Bugfix

• 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 the reminder that e-signature is edited in workflow builder for each approval 

Bugfixes

• updated the approval 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 24th 2021

Bugfix

• removed email validation when inWebo OTP is active to accept username field in order to validate credentials

March 10th 2021

Updates

• send-email action in triggers updated to include additional value references - @creator and @lastUpdatedBy. This complements 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.

February 15th 2021

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.

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

The approval reviewers list is available from

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

• from the Document Report by choosing a reviewer avatar

  

Bugfix

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

January 26th 2021

Update in workflow report to show approval avatars (rather than assignee) when a state has multiple approvals. Users can click on each approval avatar to view assigned users

Bugfixes

• correct date format now being displayed in workflow history

• layout amended for reports when selecting filter buttons and accessing mouse-over information popups

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

Release log 2020

December 23rd 2020

Bug fix release that fixes some problems when showing pre-assigned reviewers (reviewers assigned by using the 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.

1. Anyone can approve (no restrictions)

From now on, approvals with the configuration Anyone can approve (no restrictions) won't be assignable anymore.

The workflow state dialog will NOT ALLOW reviewers assignation

1. 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 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

•  if a user has been assigned but the current logged-in user is NOT ASSIGNED to the approval the approve/reject buttons are disabled

1. 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 26th 2020

Introducing Comala Document Management as part of the roadmap of development of the Comalatech Document Management family of Cloud apps.

For details of the roadmap for feature development please see Migrating to Confluence Cloud for Comalatech Document Management for Cloud app.