Manage Workflows

Manage Workflows

In Pricefx, Workflow Designer lets you manage the full lifecycle of a workflow. From initial draft through publishing, versioning, activation, and deactivation. This article covers all workflow lifecycle management tasks. It does not cover the visual canvas design experience.

Navigation: Administration > Workflow Designer

Prerequisites

• You have the Manage Workflow Designer role assigned (required for the create, publish, activate, and deactivate actions described here). See Workflow Designer Permissions.

• Workflow Designer is installed and enabled on your partition.

View and Filter the Workflow List

The workflow list displays all workflows available in your partition. Use filters to locate specific workflows by status, name, or other attributes.

1. Go to Workflow Designer.

2. The workflow list opens and displays all existing workflows.

3. Use the filter controls at the top of the list to narrow results.

4. Click a workflow name to open it.

Note: Published workflows open in read-only mode. To make changes, create a next version from the published workflow. See Create Next Version from Published Workflow.

Expected result: The workflow list displays only the workflows that match your filter criteria.

Edit Workflow Details

You can edit the details of a workflow that is in Draft status.

Prerequisites: The workflow must have Draft status.

1. Go to Workflow Designer.

2. Locate the workflow in the list and click its name to open it.

3. Click the edit icon (pencil) next to the workflow name in the top-left area of the designer canvas.

4. The edit icon opens a Rename dialog. Only the workflow name/label is editable from this control. All other workflow content is edited on the canvas.

5. Save your changes. The status indicator in the top bar shows Draft | Saved.

Expected result: The workflow details are updated and saved. The workflow remains in Draft status.

Duplicate Workflow as New Draft

Duplicating a workflow creates a new independent draft that is a copy of the selected workflow. Use this task to reuse an existing workflow structure without modifying the original.

1. Go to Workflow Designer.

2. Locate the workflow you want to duplicate.

3. Open the workflow's action menu (⋯).

4. Select Duplicate (for Draft workflows) or Duplicate as Draft (for Published or Superseded workflows).

5. Confirm by clicking Duplicate in the confirmation dialog.

Expected result: A new workflow named "Copy of {original name}" appears in the list in Draft status.

Publish Workflow

Publishing a workflow makes it available for use. A published workflow is read-only. To modify a published workflow, you must create a next version.

Prerequisites:

• The workflow must have Draft status.

• The workflow must be valid. The status bar must show Valid before the Publish button becomes active. The screenshot shows the Publish button in the top-right corner of the designer canvas, active when the workflow status is Draft | Saved | Valid.

1. Go to Workflow Designer.

2. Open the draft workflow you want to publish.

3. Verify that the status bar shows Draft | Saved and the Valid badge is displayed.

4. Click Publish in the top-right corner.

5. In the Publish workflow dialog, enter a reason in the Reason for Publication field. Optionally check Activate this workflow immediately, then click Publish or Publish & Activate.

Expected result: The workflow status changes to Published. The workflow is now available for use and opens in read-only mode.

Warning: Publishing a workflow is irreversible. You cannot revert a published workflow to draft status. To make further changes, create a next version.

View Published Workflow Without Editing

Published workflows are read-only. You can open and inspect a published workflow, but you cannot modify it directly.

1. Go to Workflow Designer.

2. Locate the published workflow in the list and click its name.

3. The workflow canvas opens in read-only mode. All nodes, connections, and node properties are visible but not editable.

Tip: To modify a published workflow, create a next version. See Manage Workflows below.

Expected result: The published workflow displays on the canvas in read-only mode. No editing controls are active.

Create Next Version from Published Workflow

Creating a next version generates a new draft based on a published workflow. This lets you modify the workflow while keeping the published version available.

Prerequisites: The workflow must have Published status.

1. Go to Workflow Designer.

2. Locate the published workflow in the list and click its name to open it.

3. Select Create New Version from the workflow's action menu (⋯).

4. Confirm the action.

Expected result: A new workflow draft appears in the workflow list. The draft is a copy of the published workflow and is ready for editing. The published version remains unchanged and available.

Mark Workflow as Active

Activating a workflow assigns it to the Workflow Accelerator's Company Parameters tables. Only one version of a workflow can be active at a time.

Prerequisites: The workflow must have Published status.

1. Go to Workflow Designer.

2. Locate the published workflow in the list, or open it on the canvas.

3. Select Activate from the workflow's action menu (⋯) in the list, or click the Activate button in the canvas header.

4. In the Activate The Workflow confirmation dialog, confirm the action.

Expected result: The workflow status updates to Active.

Note: Activating a workflow means it is active in the Company Parameters tables. If another workflow version was previously active, it is replaced and moves to Superseded status.

Deactivate Workflow

Deactivating a workflow removes it from the Company Parameters tables by clicking Deactivate. The workflow record is retained but is no longer active.

Prerequisites: The workflow must currently be marked as Active.

1. Go to Workflow Designer.

2. Locate the active workflow in the list.

3. Open the workflow actions menu (⋯) for that workflow, or open it on the canvas.

4. Click Deactivate and confirm the action.

Expected result: The workflow is removed from the Company Parameters tables. The workflow record remains in the workflow list but is no longer active. Verify the impact before deactivating.

Reactivate Workflow

Reactivating re-writes the workflow to the Company Parameters tables without changing its status.

Prerequisites: The workflow must currently be Active.

1. Go to Workflow Designer.

2. Locate the active workflow in the list.

3. Open the workflow's action menu (⋯).

4. Select Reactivate and confirm the action.

Expected result: The message "Workflow is active again." is displayed.

Workflow Status Reference

The following table describes the workflow statuses used in Workflow Designer.