Workflow translator for cloud

A data center app or server app workflow can be translated into cloud-compatible JSON code using Workflow Translator for Cloud, which is available in the workflow builder

Open

• Workflow

  • name

  • description (if present

  • workflow parameters 6.18.0+

  • state

    • name

    • description (if present)

    • final

    • color

    • due date 6.18.0+

  • state transitions

    • select*

    • approved

    • rejected

    • updated

    • expired

  • approval

    • name

    • description ((if present)

    • approve button label (if present)

    • reject button label (if present)

    • credentials 6.18.0+

    • minimum 6.18.0+

    • assignable 6.18.0+

    • user 6.18.0+

    • group 6.18.0+

    • selectedapprover and selectedapprovers 6.18.0+

  • trigger v7.6.3+

    • workflow triggers are translated based on their designated events, even if some conditions or actions in the trigger are unsupported in the Cloud

    • a trigger is translated regardless of unsupported conditions or actions, which will be omitted from the translation

    • translated triggers need to be reviewed in the Cloud environment and can be adjusted using the Cloud visual editor or code editor to meet specific requirements

For the workflow

• header parameter

• footer parameter

For a workflow state

• hideselection parameter

  • not available in cloud

• hidefrompath parameter

  • cannot be hidden from the progress bar in the workflow popup

• taskable parameter

  • manual addition of workflow tasks by a user is not supported

• changeduedate parameter

  • user by default, can edit the due date for a state

Other elements not translated include:

• macros, including the set-metadata and get-metadata macros, are not currently available in the cloud and are not translated

• metadata and other value references, including workflow value references, are not translated

• Read Confirmations are not translated. In Confluence Cloud, read confirmations must be added using the Comala Read Confirmations Cloud app.

The following are translated but have different functionalities in the cloud:

• Workflow parameters can be created and used in the cloud workflow but have different functionality from those in the server app workflow

• approvals are available in the cloud, but the management of reviewers has different options

• Workflow triggers are translated into corresponding workflow events in the cloud but function differently compared to the hosted app. Some trigger events are not supported as there are no corresponding events in the cloud, and they are omitted from the JSON code. Triggers can also include conditions and actions that are not supported in the cloud. In such cases, while the trigger is translated, the unsupported conditions and actions are omitted.

Workflow Translator for Cloud is available in the workflow builder in the global workflows dashboard, the space document management dashboard, and from a page when a page workflow is applied.

In the space document management dashboard

• open the ellipsis menu for a space scope workflow

Choose Edit to open the workflow builder.

Choose the Cloud Translator button.

The Actual Workflow dialog box displays the current workflow.

Choose the Translate button to translate the server workflow to cloud-compatible JSON code.

The Translated Workflow dialog box displays the cloud-compatible JSON code workflow.

The Messages dialog box displays workflow elements and parameters the cloud translator has not translated.

Unsupported elements

Some elements and parameters the workflow translator does not support are available in the cloud but have different features and functionality. Some of these, can be added to the workflow in the cloud app visual builder or code editor.

The workflow translator v6.18.0+ includes the following in a warning message about different functionalities in the cloud:

• approval user and group condition parameters work slightly differently in the cloud

• you must replace confluence usernames used in the workflow with the corresponding userIds in the cloud

• e-signature authentication for an approval reviewer is only available through the use of a time-based token

Copy the cloud-compatible JSON code to the clipboard using the Translated Workflow copy icon.

Paste the copied workflow template code to the code editor in the Comala Document Management Cloud app space settings.

• Save it as a new workflow in the Cloud space.

• Exit to view the workflow added in the app space settings

A warning message is displayed if the translator cannot translate the workflow.

Check that the workflow is valid in the hosted app.

If the error persists, contact our support team.