Getting started with Diagrams

Article contents

Apps  is the main app-creation dashboard and is where you will also design your business flow, add UIs, create Document Templates, add APIs, set up Catalogs and Data Model and view reports.

Within Apps you can:

  • Select an existing app to edit

  • Create a new app

  • Set users & groups permissions 

Once an app is created you will navigate automatically to the Diagrams of the respective app. Also you can easily navigate to the Diagrams of an app just by accessing the Edit  button on the respective app.

On the left side of the screen, underneath the Main Menu   you have a panel divided vertically into 8 categories.

App-based actions

Application Settings

Shortcut to edit or modifying an app.


Tool that will help you sketch the flow of your application, assign user groups and permissions for specific tasks and points of approval/denial/escalation, define notifications.

Smart Contract Designer

Tool that helps you add and edit functions, rules and policies for the domain applications.

Interface Builder

Design and prototype user interfaces used in apps.

Document Builder

Rich text editor used to define templates based on which documents can be generated within an app.


Tool that helps you set up the interaction between two apps.

Data Model & Catalogs

Tool that helps you:

  • Create and maintain data used to populate list of values displayed in an UI

  • Create and maintain data from all applications


Analytics dashboard that helps the process owner track and asses where the end-user hit a roadblock or if the end-user is taking more time than usual to complete a task.

Building blocks that can be dragged and dropped onto the canvas

  • Under the Diagrams tab we have Activities: 

This is a Human Activity. This element designates human interaction with the system. It’s mandatory that this element has an UI connected to it.

This is also a Human Activity. The difference between this and the previous element is that with the Approval Matrix you can set up levels of approval with rules, conditions and consequences. You can use the Approval Matrix Configurator for complex processes.

A Call API Activity is a system task that allows API configurations on it. This element can be used with Consume APIs when Aurachain calls other systems’ APIs to transfer data or trigger an action. API knowledge are a little bit more complex and require technical know-how.

Self-explanatory Activity, it generates a specific document or more. You need to add the type of document from a list (or create one if you don't have any) and select the Data model field (or create one for this specific task).

An External Task Activity has almost the same fields as a Human Activity but with one difference - it gives a one time access to a person that does not have a Aurachain user. This access is done via email, to send the invitation, and SMS, the phone number is used so the user can log into Aurachain.


A Data Export Activity is a system task that allows the process data to transition from the Aurachain platform to ElasticSearch, an analytics tool that helps you store, search, and analyze with ease at scale.  The data can be easily transferred afterwards from the Elasticsearch tool, to a preferred Business Intelligence tool that offers more complexity in terms of reports, pie charts and analytics. 


Blockchain Activity or block, is a cryptographic or encoded ledger (database) of transactions. This is used to highlight the usage of a Smart Contract within a business process. 

FYI: A Smart Contract is a complete set of software codes with components designed to automate execution and settlementSimply put, Smart Contracts manage transactions in a pre-programmed, automated way. 


An Expose API is actually a Call API in reverse. Meaning that this type of block will enable your process to receive based on demand and supply of data, information. 

  • Under the Events tab we have Start and End elements:

General Start

Usually, this is the first element that you drag and drop onto your canvas, when creating applications. It represents the manual Start of the process. You can add only one manual start.

When you require an API start, besides the manual Start, you can use this element. This, basically, is a associated with an Expose API. You can add only one API Start.

General End

This element is an event that ends the process. You can add as many General End elements as you like, just be sure you have a thought-through business logic.

  • Under the Gateways tab we have alternative paths and parallel flows:

Exclusive Gateway

This element can be used to create alternative paths within a Process flow.

Parallel Gateway

This element can be used to create parallel flows or synchronize (combine) them. It creates parallel paths without checking any condition.

Join Gateway

This element can be used to combine two or more parallel paths into one path.

And on the right side, we have a single panel with a few actions exposed, based on the type of selected element.

Stage-based actions

These actions slightly differ based on what elements you have selected on your Canvas.

Activity Details

This exposes the Properties of each element. The Activity Details differ depending on the object you want to modify (element, connector, API).

Activity Targets

Connects two elements on the canvas and it will be configurable at activity level. 

Configure Rule

This helps you configure rules in the process, add conditions or notifications or include consequences.

Approval Matrix  

This action is available only when the Approval Matrix element, Exclusive, Parallel and Join Gateways are selected. Use it to set up Levels of Approval, rules for each level, conditions for each rule and consequences for each condition.

Add New Group  

Add groups to the human stages and assign users to them.

Add New Notification

You can add notifications on each arrow to send an automated message to a Type of Assignment (as in ROL, USR, VAR, MOD, or TXT).

Other buttons

Start - The system activates and starts the BPMN process diagram (read, your app) and at the same time launches the process flow. (read, it sends work tasks to specific users and groups)

Save - The system saves the work you’ve done in the app (added elements, UIs, and so on) without activating it.

Publish - The system activates the BPMN diagram and creates the application. However, the application can only be activated if it meets a certain criteria.

  • UIs were attributed to each human stage.

  • Groups were added to the human stages.

  • API (if applicable) has been set up.

  • Decisions have been set up on the connectors when exiting a stage.

Related content