Example of workflow

An example of workflow usage

Workflow example

In this example, we will demonstrate how a business could set up and utilize a workflow within the PIM. Building on the previous examples from the How to Use Workflows tutorial, we will focus on each state and transition in the workflow.

In this example the business manages a large number of products that require configuration and maintenance within the PIM system. To avoid data inconsistencies or potential errors in process, they need a clear and enforceable workflow. The business can, by defining specific states and transitions, ensure that each product and its variants follow a controlled lifecycle, from initial creation to publication, with visibility into every step of the process.

Product page

Setting up workflow

Initially, a workflow is created and given an alias and label. In this example, the workflow has been labeled "BusinessFlow" to identify this specific use case. In practice, you could have multiple workflows depending on team and business structure.

Workflow settings page

After setting the label and alias, we proceed to configure the states in the workflow.

Edit workflow state page

When configuring each state, an alias and a label are set alongside a color to help identify the state and its context.

In the example above, "Draft" has been chosen to indicate that a draft of a product has been added to the PIM and needs to be enriched. No transitions are added since we start by setting up all the stages in the workflow.

Below you can see the all the states that make up the workflow. Following states are:

  • Draft: Initial state when a product or variant is first created. At this point, only basic data may be available.

  • EnrichmentInProgress: Teams are actively adding or updating product content (descriptions, attributes, images, etc.).

  • ReadyForApproval: Enrichment is complete. The product is now waiting for validation or approval from a responsible party.

  • Published: Product has been approved and published.

  • Discontinued: Product is no longer active or available but is kept in the system for future reference.

Each state is assigned a color for visual clarity. For instance, grey here could indicate a new item lacking content, yellow represents an item in progress, and green shows an item ready for completion.

Workflow states page

Transitions between states

When all the states are set up, it is time to add the crucial transitions that determine the flow of the workflow.

Edit workflow transitions page

When adding transitions to a state, start by selecting the state you want to transition from. In the image above, we want to transition from the state "Draft" to the next step in the product cycle, "EnrichmentInProgress."

The label and description help identify the transition and the process behind it. Required permission has not been set, but would be valid to ensure only specific individuals can make some transitions, such as the approval of a product.

Below you can see all the transitions added to the workflow between the states:

  • Draft:

    • Draft → EnrichmentInProgress - The product begins enrichment.

    Transition from Draft state
  • EnrichmentInProgress:

    • EnrichmentInProgress → ReadyForApproval - All required enrichment is done, and the product is ready to be approved.

    Transition from EnrichmentInProgress state
  • ReadyForApproval:

    • ReadyForApproval → EnrichmentInProgress - The product needs further enrichment and is moved back for revision.

    • ReadyForApproval → Published - The product passes all checks and is approved and published.

    Transitions from ReadyForApproval state
  • Published:

    • Published → EnrichmentInProgress - Updates or corrections are needed after publication.

    • Published → Discontinued - The product is no longer active or offered.

    Transitions from Published state
  • Discontinued:

    • Discontinued → Published - The product is republished.

    Transition from Discontinued state

Each transition is designed to clearly track the status of products in sequence. With all states and transitions established, we've crafted a user-friendly workflow that assists in maintaining product tracking.

Example of workflow with transitions and states

Assignments of workflow

Now that the workflow is created, we just need to assign the products and variants that need to adhere to the workflow. In this case, we focus on the food that the business sells. By creating a product structure for all the various versions of food, we can add it under workflow assignments to ensure that all products and variants with this structure follow the same workflow.

Workflow assignments setup page

Using the workflow

To use the workflow, we move the newly added product "Chicken Breasts" from the "Draft" state to the "EnrichmentInProgress" state by clicking the "Begin Enrichment" transition. This indicates that the product is in the process of being enriched with the remaining information it needs. From here we can continue following the workflow and change the state depending on the products status.

Workflow in use

After changing the state, our collection of food products is now easy to track, showing which workflow state each product is in. This can be seen in the image below. This is valuable for managing a large collection of products and variants efficiently.

Collection of products in workflow

Last updated