> For the complete documentation index, see [llms.txt](https://developer.collibra.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.collibra.com/workflows/designing-workflows/processes/process-editor.md).

# Process editor

You use the process editor to create BPMN diagrams. It allows you to visually model your processes using a drag-and-drop mechanism.

## Page overview

The process editor main page is divided into four areas:

* The [menu bar](/workflows/designing-workflows/processes/process-editor-menu-bar.md) on top, just below the navigation bar.
* The [Shape repository](/workflows/designing-workflows/processes/shape-repository.md) on the left side.
* The [canvas](/workflows/designing-workflows/processes/canvas-and-configuration-area.md) in the middle.
* The properties bar on the right side.

![](/files/9XeafHHHkRtg3yf2LsOo)

### General properties

| Property                                                                                                     | Description                                                                                                                                                             |
| ------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Model Key](/workflows/creating-workflows/workflow-basic-configuration-elements/model-keys.md)               | The unique identifier of the process in both Workflow Designer workspaces and Collibra. The key must be unique in any given workspace and in your Collibra environment. |
| Name                                                                                                         | The name of the process, which becomes the display name of the workflow in Collibra.                                                                                    |
| [Documentation](/workflows/creating-workflows/workflow-basic-configuration-elements/workflow-description.md) | The workflow description that is shown in Collibra, providing details about the purpose and general usage of a workflow.                                                |

### Assignment properties

| Property | Description                                                                               |
| -------- | ----------------------------------------------------------------------------------------- |
| Owner    | The owner of the instances of the process. This option is not currently used in Collibra. |

### Details properties

| Property            | Description                                                                                                                                                                                                                                                                                                                                                                                     |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Author              | The owner of the instances of the process. This option is not currently used in Collibra.                                                                                                                                                                                                                                                                                                       |
| Version             | A manual free-form field used to add versions to your workflows according to your needs. This is for informational purposes only and is different from automatic [model versions](/workflows/designing-workflows/models.md#model-versions) or [app revisions](/workflows/designing-workflows/apps/app-revisions.md).                                                                            |
| Signal definitions  | <p>Definition of the signals that the process uses, comprised of:</p><ul><li><strong>Model Id</strong>: A unique ID of the signal event.</li><li><strong>Name</strong>: The name of the signal event, used to reference it later.</li><li><strong>Scope</strong>: Whether all process instances can listen for this signal event, or only listeners within the same process instance.</li></ul> |
| Message definitions | <p>Definition of the messages that the process uses, comprised of:</p><ul><li><strong>Model Id</strong>: A unique id of the message event.</li><li><strong>Name</strong>: The name of the message event, used to reference it later.</li></ul>                                                                                                                                                  |

### Advanced properties

| Property                                                                                       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ---------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Event listeners                                                                                | <p>Event listeners of this process, which react to a series of predefined low-level runtime events that are fired during process instance execution:</p><ul><li><strong>Event</strong>: The type of event that the listener should listen to.</li><li><strong>Delegate expression</strong>: The expression to be executed when the process is started. A delegate expression must resolve to a Java object, for instance a Spring bean. The object's class must implement either <code>JavaDelegate</code> or <code>ActivityBehavior</code>.</li><li><strong>Class</strong>: The fully qualified classname of a class to be invoked when executing the process, for example <code>com.collibra.dgc.workflow\.api.listener.FlushExecutionListener</code>.</li><li><strong>Entity type</strong>: The type of entity that should be targeted by events for which the event-listener should be notified, which allows to filter the events that are received by this listener.</li><li><strong>Rethrow event</strong>: Whether to rethrow the event that is recieved.</li><li><strong>Rethrow event type</strong>: The type of the event that is thrown: <code>error</code>, <code>message</code>, <code>signal</code>, or <code>globalSignal</code>.</li><li><strong>Rethrow event name</strong>: The name under which the error, message or signal is thrown.</li></ul> |
| Data objects                                                                                   | <p>A list of process variables that are initialized when the process instance is started:</p><ul><li><strong>ID of the data object</strong>: A unique identifier of the data object.</li><li><strong>Name</strong>:The name of the variable, used to reference it later.</li><li><strong>Type</strong>: The data type of the variable.</li><li><strong>Default value</strong>: An optional default value for the variable.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| [Execution listeners](/workflows/designing-workflows/processes/process-execution/listeners.md) | <p>Allows you to invoke Java logic after certain events:</p><ul><li><strong>Start</strong>: Executes after the activity has been started.</li><li><strong>End</strong>: Executes after the activity was completed.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.collibra.com/workflows/designing-workflows/processes/process-editor.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
