Using the Netgrif Builder

This chapter guides you through using the Netgrif Application Builder - a visual, low-code environment for designing Petriflow processes, forms, and application logic. It helps process designers and developers model workflows and export deployable application packages.

Netgrif builder is fully equipped for building processes and Netgrif applications ready for deployment.

What is the Netgrif Builder?

The Netgrif Builder is a web-based interface that allows users to visually create, modify, and export processes for the Netgrif Platform. It enables non-programmers and developers alike to design complex workflows using the Petriflow language.

The Builder simplifies the creation of processes by enabling:

• Creating structured workflows
• Defining user roles, permissions, data fields, and actions
• Configuring process transitions (tasks)
• Designing layout and form configuration
• Exporting processes as XML or as deployable applications
• Defining event logic, actions, and dependencies

Accessing the Builder

You can access the Netgrif Builder at builder.netgrif.cloud a custom internal address provided by your administrator.

You’ll see a dashboard with options to create, edit, or import processes.

Creating a New Process

1. Click "New Process"
2. Enter a process name, optional ID, and description
3. Click "Create"

You will be taken to the graphical editor, where you can begin designing your process.

Graphical Editor Components:

• Places and Transitions: The flow logic
• Data Fields: Store form inputs or internal variables
• Roles: Define who can perform which actions
• Actions and Events: Define what happens and when

Defining Data Fields

Each process can have multiple data fields:

• Text: Basic input
• Number: Numeric values
• Date/Time: Calendar inputs
• UserList: Assignable users
• Boolean: Toggle or checkbox

Adding Transitions (Tasks)

Transitions define user and system actions:

• Label each transition clearly
• Assign a role that can execute it
• Attach actions (e.g., assign user, validate form, run script)

Each transition can trigger events that manipulate data, control behavior, send emails, redirect views, and more. All of this is made possible through action API.

Creating forms

Each transition is bound to a data form, where you can:

• Easily drag and drop data fields
• Define the behavior of the data fields
• Attach actions to a field's data reference

Setting Up Roles and permissions

Roles in a process define who can Perform, Delegate, Cancel, Assign and View specific tasks during the case (process instance) lifecycle.

Permissions define what a role is allowed to do - such as reading data, editing fields, or executing transitions.

You define roles directly within the process model in the Builder. These roles are then assigned to transitions and data fields to control visibility and access.

Functions

Functions are reusable blocks of code that can be executed within transitions and actions in a process. They operate similarly to functions in traditional programming languages.

You can define custom functions that encapsulate logic and call them from multiple places within your process.

INFO

For advanced use, refer to the Actions API documentation for function syntax, scoping, and return handling.

Exporting the Process

Once finished:

1. Click Export
2. Download the process as a .xml file or download the package application as a .zip.

This file is ready to be added to an application ZIP and deployed to the platform.

Best Practices

• Use clear and descriptive names for fields and transitions
• Group related data fields with panels
• Test your process in Builder before deployment