Skip to main content

ā€‹
What is a process definition?

A process definition is the core building block of the FlowX.AI platform, serving as the blueprint for a business process. Itā€™s composed of nodes linked by sequences that define the path and logic of your applicationā€™s workflow.
A complete process definition must include at least one START and one END node to mark where the process begins and concludes.

Executable Blueprint

Process definitions can be instantiated, executed, and monitored within the platform

Business Logic Container

Houses all actions, decisions, user interfaces, and integrations for your business process

Event-Driven Flow

Nodes and sequences create a path for process tokens to follow based on conditions and events

Multi-Platform Support

Process definitions can generate interfaces for web, mobile, and other platforms

ā€‹
Creating a process definition

1

Access the Process Definitions Section

  1. Open FlowX.AI Designer and navigate to your project
  2. Go to the Processes section within your project
You must have already created a project before creating process definitions. Process definitions belong to projects and inherit project settings.
2

Create a New Process Definition

  1. Click the + New Process button in the top-right corner
  2. Enter a unique name for your process definition that clearly describes its purpose
  3. Optionally, add a description to provide context about what this process does
  4. Click Create to create the new process definition
Use a descriptive naming convention for your processes, such as ā€œ[Department]-[Function]-[Action]ā€ (e.g., ā€œHR-Onboarding-Applicationā€).
Process Definition Editor
3

Configure the Process Definition

After creating the process definition, youā€™ll be automatically directed to the FlowX.AI Process Designer editor where you can start building your process flow.
Process Designer Empty Canvas
4

Add Start and End Nodes

Every process definition must have at least one START node and one END node:
  1. From the node palette on the left, drag a START node onto the canvas
  2. Configure the START node properties in the panel that appears
  3. Drag an END node onto the canvas
  4. Connect the nodes by clicking on the START node, selecting the arrow command, and then clicking on the END node
Without properly configured START and END nodes, your process wonā€™t be executable. The START node initializes the process, while the END node ensures proper process completion.
5

Build Your Process Flow

Expand your process by adding additional nodes between the START and END nodes:
  1. Drag the appropriate node types from the palette onto the canvas
  2. Configure each nodeā€™s properties and actions
  3. Connect nodes in the sequence they should execute
  4. Add conditions and gateways to create branching logic

Task Nodes

For business rules and automated actions

User Task Nodes

For user interactions and UI components

Gateways

For decision points and parallel flows
6

Save Your Process Definition

Regularly save your work by clicking the Save button in the editor toolbar.
Process definitions are saved within your project but need to be included in a project version and build to be deployed to environments.

ā€‹
Key node types

When building your process definition, youā€™ll use various node types to model your business logic:
Start Node: Marks the beginning of a process flow, defining how a process instance is initiated.End Node: Marks the conclusion of a process flow, ensuring proper cleanup and completion.
A process can have multiple START nodes (with different conditions) and multiple END nodes depending on the possible outcomes.
Task Node: Used for executing automated actions without user interaction.User Task Node: Configures the UI components and collects data from users.Send/Receive Message Tasks: Used for communication with external systems and services.
Exclusive Gateway: Creates decision points where the flow follows only one path based on conditions.Parallel Gateway: Splits the process into multiple parallel branches that execute simultaneously.Inclusive Gateway: Allows multiple paths to be taken based on conditions, unlike the exclusive gateway.
Subprocess Run Node: Enables you to run a subprocess within the main process.Timer Events: Schedule actions to occur at specific times or after delays.Message Events: Handle message-based communication between processes.

ā€‹
Adding actions to nodes

Nodes can have actions associated with them to perform specific operations:

Business Rules

Execute logic, validate data, and make decisions

Data Operations

Save, retrieve, and manipulate process data

Integration

Connect with external systems and services

UI Interactions

Send data to and receive data from users
Actions can only be added to certain node types: task nodes, user task nodes, and send/receive message tasks.

ā€‹
Managing process definitions

After creating process definitions, you can manage them using the contextual menu available in the Processes list. Access this menu by clicking the three-dot icon (ā‹®) next to any process entry.
Process management menu

Process contextual menu with management options

Two contextual menus available:This menu is accessible from the Processes list view (before opening a process). Thereā€™s also a separate contextual menu available when youā€™re inside a process definition that provides operations like Clear Cache, Audit Log, View History, and Delete.

Operations inside process definitions

Learn about the contextual menu available while editing a process definition

ā€‹
Configure process settings

Open the process settings interface to configure process-level options including permissions, platform selection, task management integration, and data search indexing. To configure a process:
  1. Click the three-dot menu (ā‹®) next to the process name
  2. Select Configure from the menu
  3. The settings panel opens, where you can modify:
    • Process name and general settings
    • Platform selection (Web, Mobile, Omnichannel)
    • Permissions and swimlane access control
    • Task management integration
    • Data search and indexing

Process settings

Complete guide to all process configuration options

ā€‹
Export a process

Export a process definition to transfer it between environments, create backups, or share it with other teams. To export a process:
  1. Click the three-dot menu (ā‹®) next to the process name
  2. Select Export
  3. The system generates a downloadable package containing:
    • Process definition JSON
    • Process metadata and manifest files
    • Version information
  4. Save the export file to your local system
Export structure: When you export a process, FlowX.AI creates a structured folder:
  • Root export folder with unique identifier
  • Process subfolder with manifest.json and metadata.json
  • Version subfolder with the process definition JSON file
Use a clear naming convention for exported files such as [ProcessName]_[Version]_[Date].zip to help identify exports later.
Exported process definitions may contain environment-specific configurations. Review and adjust these settings when importing to a different environment.

Export and import guide

Learn about importing exported processes

ā€‹
Duplicate a process

Create a copy of an existing process definition within the same project. This is useful when you want to create a variant of a process or use an existing process as a template. To duplicate a process:
  1. Click the three-dot menu (ā‹®) next to the process name
  2. Select Duplicate
  3. Enter a name for the duplicated process
  4. Click Confirm to create the copy
What gets duplicated:
  • Complete process flow with all nodes and sequences
  • All node configurations and actions
  • UI Designer configurations
  • Data model structure
  • Process settings (permissions, platform selection, etc.)
What doesnā€™t get duplicated:
  • Process instances and runtime data
  • Audit history
  • Version history
Use duplication to create process variants for different departments or to test significant changes without affecting the original process.
The duplicated process is created in the current work-in-progress (WIP) version of your project. Remember to commit your changes when ready.

ā€‹
Copy to another project or library

Transfer a process definition to a different project or library within your FlowX.AI environment. This enables sharing reusable processes across multiple projects. To copy a process to another project:
  1. Click the three-dot menu (ā‹®) next to the process name
  2. Select Copy to another project/library
  3. Choose the destination project or library from the list
  4. Optionally adjust the process name for the destination
  5. Click Confirm to complete the copy operation
Use cases:
  • Create reusable components: Move common processes to a shared library
  • Share across teams: Copy processes to other team projects
  • Promote to production projects: Transfer tested processes to production-ready projects
  • Create process templates: Build a library of standard process templates
Ensure all dependencies (subprocesses, data types, integrations) exist in the destination project, or copy them separately. Missing dependencies will cause errors.
Copying a process creates an independent copy. Changes to the original wonā€™t affect the copied version and vice versa.

ā€‹
See used resources

View all resources and dependencies that the process definition uses. This helps you understand the processā€™s connections to other components and identify potential impacts when making changes. To view used resources:
  1. Click the three-dot menu (ā‹®) next to the process name
  2. Select See used resources
  3. Review the list of dependencies, which may include:
    • Subprocesses and workflows
    • UI templates and components
    • Data model types
    • Integration connectors
    • Business rules and scripts
    • Document templates
    • Notification templates
Benefits:
  • Impact analysis: Understand what will be affected by changes
  • Dependency tracking: Ensure all required resources are available before deployment
  • Documentation: Map relationships between processes and resources
  • Troubleshooting: Identify missing or misconfigured dependencies
Review used resources before exporting or copying a process to ensure you include all necessary dependencies in the target environment.

ā€‹
View audit log

Access the comprehensive change history for the process definition, showing who made changes, when, and what was modified. To view the audit log:
  1. Click the three-dot menu (ā‹®) next to the process name
  2. Select Audit log
  3. Review the audit entries, which include:
    • Timestamp of each change
    • User who made the change
    • Application version
    • Event type and subject
    • Change status
Audit log features:
  • Filterable entries: Search and filter by date, user, or event type
  • Complete audit trail: Maintain compliance with regulatory requirements
  • Change tracking: Identify when specific modifications were introduced
  • Troubleshooting: Trace issues back to specific changes

Audit documentation

Learn more about audit logging capabilities

ā€‹
View history

Access the version history of the process definition to see how it evolved across different committed versions. To view version history:
  1. Click the three-dot menu (ā‹®) next to the process name
  2. Select View history
  3. Review the list of versions
  4. Select two versions to compare changes side-by-side
History capabilities:
  • Version comparison: See exactly what changed between any two versions
  • Change tracking: Identify when specific features were added or modified
  • Rollback reference: Understand previous configurations if you need to revert changes
  • Documentation: Track the evolution of your process over time
Version history shows committed versions only. Changes in the current work-in-progress version appear after you commit the project version.

Project versioning

Complete guide to version management

ā€‹
Delete a process

Remove a process definition from your project when itā€™s no longer needed. To delete a process:
  1. Click the three-dot menu (ā‹®) next to the process name
  2. Select Delete
  3. Confirm the deletion in the dialog that appears
Use with extreme caution: Deleting a process definition is a significant action with the following consequences:
  • The process definition is removed from the current work-in-progress (WIP) version
  • You cannot delete a process thatā€™s part of a committed version
  • Other processes that reference this one as a subprocess may break
  • The deletion can be recovered only from previous committed versions
Before deleting a process:
  1. āœ“ Check for dependencies: Use ā€œSee used resourcesā€ to identify processes that reference this one
  2. āœ“ Review running instances: Verify no critical process instances are currently active
  3. āœ“ Backup if needed: Export the process definition before deletion if you might need it later
  4. āœ“ Update documentation: Remove references to the deleted process from your documentation
Impact of deletion:
Deleted processes can be recovered by accessing previous committed versions through version history, but any uncommitted changes will be lost.

ā€‹
Best practices

Process Definition Design Tips:
  • Start with a simple skeleton process with START and END nodes before adding complexity
  • Create a logical flow from left to right in your diagram for better readability
  • Group related activities into subprocesses to keep the main process clean
  • Use clear naming conventions for nodes and actions
  • Document your process design decisions within node descriptions
  • Test your process with simulated data before publishing

ā€‹
Next steps

After creating your process definition, you can:

Add Nodes to Your Process

Learn how to add and configure different node types

Create User Interfaces

Build interactive UIs for your process

Process Definition Deep Dive

Comprehensive guide to process configuration and settings

Export and Import

Transfer processes between environments

ā€‹
Frequently asked questions

Yes, a process definition can have multiple START nodes, each with different starting conditions as long as they are on different swimlanes. This allows the same process to be initiated in different ways depending on the context.
Process definition cannot contain multiple start nodes on the same swimlane.
To modify an existing process, navigate to the Processes section in your project, find the process you want to edit, and click on it. Then click the ā€œEdit Processā€ button to open it in the Process Designer.
Yes, you can create reusable components as subprocesses, which can then be called from multiple main processes. This promotes reusability and maintainability. You can also duplicate existing processes or copy them to other projects using the contextual menu operations described in the Managing process definitions section above.
Yes, FlowX.AI allows you to export and import process definitions. Use the Export option from the process contextual menu to create a downloadable package. The export includes the process definition JSON, metadata, and version information in a structured format. See the Export a process section above for detailed instructions.
Use the See used resources option from the process contextual menu to view all dependencies including subprocesses, UI templates, data model types, integrations, and more. This helps with impact analysis before making changes and ensures all dependencies are available when exporting or deploying the process.
Last modified on May 12, 2026

Related topics

Process definitionCreating a new projectCreating a user interfaceAdding parallel flow branchesManaging templates