A workflow is a sequence of steps or rules applied to a process from its initiation to completion.
In OroCRM, workflows organize and direct users’ work, making them follow particular steps in a pre-defined order, or preventing them from performing actions that either contradict or conflict with the logical steps of a process.
In OroCRM, there are two types of workflows: system and custom.
System workflows are pre-implemented in the system and their management from the UI is limited.
Custom workflows can be created and edited depending on your desired configurations.
Each process or action applied to a record is called a Workflow Transition. On the interface, transitions take a form of a button. There are two types of transitions:
Transitions that take a user from one state to another and connect to each step in the workflow.
Self-transitions that do not change steps in the workflow.
Workflow Step is the state of a record before and after a transition.
Every workflow has a Start transition that launches the workflow.
A transition can be defined as soon as there is at least one step besides Start. However, it is often simpler to define all workflow steps and then all the transitions between them.
Attributes are characteristics of the record. For example, a ZIP code and a street name are attributes of an address. In the course of each transition, you can change some attributes of the processed record.
If enabled (see the section below), the Workflow Widget displays the process steps defined in workflow configuration on the record view page. Multiple workflow widgets can be displayed for one record at the same time.
On the Create Workflow page, specify the details ofyour workflow in the General section.
Field
Description
Name
The name of the workflow.
Related Entity
A related entity is the entity for which the workflow is created. When the workflow is active, it can be launched and executed on the records of its related entity.
Default Step
Specifying the default steps launches the workflow in a particular step by default. For instance, when you activate Opportunity Management Flow, a newly created opportunity will appear as open, if Open was specified as the default step.
If no step is selected, all newly created records will have no workflow associated with them, and it must be launched with one of the starting transitions.
Display Steps Ordered
Display Steps Ordered box is not checked by default.
If checked, all workflow steps are displayed in the workflow widget.
If not checked, only the steps that have actually been performed are displayed.
To add a step to a workflow, click Add Step in the top right corner of the chart.
In the Add Step form, complete the following fields:
Field
Description
Name
The name of the step that will be displayed on the entity record.
Position
A number that determines the position of the step in the workflow. The higher the number, the further the step is from the start.
Final
This option marks the step as the logical end or the outcome of the workflow. This is a purely logical property required for distinguishing steps for the funnel charts or creating reports with the workflow data. Marking the step final has no effect on the flow itself.
For the sample Opportunity Support flow, we will start off by creating two steps: No Complaints and Complaint Received.
Click Apply to save the step.
Next, we are going to apply a transition for these steps.
To add a step to a workflow, click Add Transition in the top right corner of the chart.
Field
Description
Name
The name of the transition that will be displayed on its button.
From Step
The workflow step, for which the transition button should appear on the entity page.
To Step
The step to which the workflow will progress after the transition is performed.
View Form
Transition attributes can appear in one of two available forms: in the popup window, which is a default transition behavior suitable for most cases, or on the separate page, which should be used with care and only for attribute-heavy transitions.
Warning Message
If you want to show a warning popup message to the user before a transition is executed, put the text of the warning into this field.
Button Icon
An icon that will appear on the transition button before the transition name.
Button Style
This control specifies the visual style of the transition button.
Button Preview
This is the live preview of the transition button as it will appear on the entity page.
Important
Self-transitions do not change steps in workflows (e.g. it can be a transition that launches an Edit form of a record within the same step).
Define the following fields in the Attributes section of the Add New Transition form:
Field
Description
Entity Field
This is the field of the workflow entity or its related entities that will appear on the view form of the transition. Use these if you want a user to add or edit some entity data in the transition.
Label
Use the field if you want to change the way it is displayed in the UI. The system label value of the entity is used by default.
Required
Check the Required box if definition of the attribute should be mandatory for the transition.
+Add
Click +Add to add a new attribute.
Click Apply to save the attribute(s) in the system.
The following is an example of an attribute added for the Register a Complaint transition in the sample Opportunity Support Flow. The entity selected for the attribute is Additional Comments. Its label has been changed to Specify the Complaint.
In the same manner, specify steps, transitions and attributes required for your custom workflow.
The sample Opportunity Support Flow has been configured the following way:
OroCRM workflows can be created from both the server-side and the UI. However, there is a number of functions that can be defined for a workflow only from the server-side logics in the course of integration. More information on workflow implementation can be found on this GitHub pageand here
Once the workflow has been configured and saved, you can see how it is visualized for the records:
Transition buttons will be displayed in the top right corner of the entity record page.
All the steps will be located at the top on the entity record page within the workflow widget.
The sample Opportunity Support Flow has been saved and activated.
As you can see from the screenshots below, the opportunity is currently in the No Complaints step. Clicking Register a Complaint will prompt an attribute we have configured for this transition:
Submitting a complaint will launch an opportunity page with Resolve, Request Feedback and Close transition buttons activated.
Clicking each of these buttons will pass the user on to the next step specified in the workflow:
Completed steps are green, the step in progress is white, the step to follow is grey. The completed workflow cycle will have all steps highlighted in green:
As an illustration, we have unchecked the Display Steps Ordered box in the edit mode for the same workflow. Here is what the steps look like in this case:
The workflow widget now displays only the current step that the opportunity is in.
The current step of a workflow is displayed in the Step column within the entity grid, as in the example below:
It is possible to have multiple active workflows for the same record. If you have more than one active workflow, you can separately activate each of them. In the following example, two workflows are available for one record:
Workflows are expandable and can be collapsed, if necessary, by clicking + on the left of the Workflow, as illustrated below:
Since System workflows are pre-implemented in the system, their management from the UI is limited. From the grid, you can perform the following actions for system workflows:
Clone: (copy the workflow to be able to customize it).
View: (Go to the view page of the workflow).
Activate/Deactivate: / (activate/deactivate the workflow).
You can activate a workflow by clicking on the corresponding button on the view page of the workflow:
Optionally, you can select certain workflows to be deactivated. If you do not, leave the field empty and click Activate.
Similarly, click Deactivate if you wish to deactivate the selected workflow:
Activating workflows does not happen automatically for all entities. Once the flow has been activated in System>Workflows, you need to start it manually for the required entities:
It is possible to activate/deactivate workflows from the grid. See the previous section of this guide on Workflow Management to learn more about workflow grids.
Multiple workflows functionality requires an ability to manage user permissions to run individual workflows. You can configure the following workflow permissions in System>User Management>Roles:
Visibility of the entire workflow and its steps/current step
All workflow labels can be translated into other languages, providing better localizations for users from different countries. Click on the corresponding icon to get redirected to the translation grid.
You can find more information on translations in the Manage Translation guide.
We collect cookie information with a goal to provide you with the best user experience. By using this website, you agree to our use of cookies. Read Oro Inc.’s Cookie policy.
We collect cookie information with a goal to provide you with the best user experience. By using this website, you agree to our use of cookies. Read Oro Inc.’s Cookie policy.