Workflow translator for cloud

Owned by Robert Alexander Marshall
Last updated: May 31, 2024
4 min read
1 Overview | 2 Workflow Cloud translator view | 3 Workflow elements translated to cloud-compatible JSON | 4 What is not translated to cloud-compatible code? | 5 Use workflow translator

Overview

Workflow Translator for Cloud - all the server/data center workflows may not be translated to cloud-compatible JSON code. The workflow may need additional editing in the cloud, for example for workflow triggers; and some parameters.

A data center/server workflow can be translated into cloud-compatible JSON code using Workflow Translator for Cloud available in workflow builder.

This feature can be disabled and hidden in the workflow builder by the global admin configuration for the app (v6.18.0 or later).

The workflow cloud-compatible JSON code can be copied and then added to a cloud site space using the app workflow code editor in cloud.

Some product features and functionalities in the cloud app are different from the data center/server app, the workflow translator cannot translate all the elements and parameters of the data center/server workflow into a cloud-compatible JSON workflow.

Workflow Translator for Cloud is available when accessing workflow builder for a workflow in the global workflows dashboard; the space settings document management dashboard; and on a page with an applied page workflow.

Workflow Cloud translator view

The workflow cloud translator button (if enabled) is displayed in the workflow builder navigator panel.

Choose the Cloud Translator button in the workflow builder navigation panel to view the current workflow in the workflow translation tool.

Choose the Translate button to translate and display the cloud-compatible JSON code for the workflow in the Translated Workflow dialog box.

Any workflow elements or parameters not translated to cloud-compatible code by the tool are displayed in the Messages dialog box.

Copy the workflow cloud-compatible JSON code to the clipboard.

  • select the copy icon next to the Translated workflow box title

Paste the cloud compatible code to the Comala Document Management Cloud workflow code editor in a space in your cloud site (or paste as a text to a text/code editor for storage).

Workflow elements translated to cloud-compatible JSON

Workflow Translator for Cloud translates the following elements and their parameters of a server workflow into cloud-compatible code.

  • Workflow

    • name

    • description (if present

    • 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+

    • workflow parameters 6.18.0+

What is not translated to cloud-compatible code?

Unsupported workflow elements not included in the cloud-compatible JSON code translation.

Workflow JSON triggers are available in a cloud workflow but have different functionality from the server app workflow trigger.

In cloud, unsupported parameters include

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

Use workflow translator

See also

Comala Document Management Server and Data Center

Migration: Comala Document Management to Cloud

Comala Document Management Cloud