Tutorials and Examples

Learn how to use DOVU OS workflow engine with an overarching flow that can be applied to many of the workflows in built into the system.

All workflows in DOVU OS follow a consistent structure based on data blocks and approval blocks, assigned to specific actors with defined roles in the system. This flow is linked to our DOVU standard process, providing a robust and repeatable approach.

While this example showcases a typical use case, the platform offers complete flexibility to adapt and create unique processes tailored to specific supply chain or workflow requirements in the future. For now, this serves as an excellent example to guide you through the key functionalities of the system.

For more information on how DOVU can model different process flows please read our section on our template language.

---

1. Register Users

To begin, register three users with roles: Registry, Supplier, and Verifier. These roles are critical in enabling different permissions and interactions with the workflow. Follow the registration routes previously detailed in the API reference.

Actor Registration and Roles

Example: Registering A new user

---

2. Search for Workflows

Use the Workflow Index route to search for workflows available in the system. Here you will find two key workflows:

• example_workflow (recommended to test): A generic example showcasing how to process data through a workflow without external integrations.

• mmcm_elv_2024 (alpha): A specific example tied to end-of-life vehicles, this is connected to a guardian instance behind the scenes.

Workflow Blueprints

Example: List all Workflow blueprints that exist in system

From this you may extract out the id value to use for publishing.

---

3. Publish a Workflow

Once you’ve identified your workflow, publish it while logged in as a registry actor to create your own unique instance. This isolates your workflow and republishes the associated Guardian policy (if applicable), ensuring it is tied exclusively to your user account.

See: the workflow blueprint publish endpoint.

Workflow Blueprints

Example: publishing a workflow

Next, you may scan for the individual instance of the workflow to understand its ongoing status, if it is connected to Guardian, integrations, it will be in an "Importing" state while underlying policies, are imported and published.

Example: a workflow instance currently importing its downstream dependencies.

After a few minutes, the status of the workflow should update to "Ready", at this point, you can attach your verifier and supplier to the workflow itself so that they may process actions.

Example: a workflow instance in a Ready state

Note: The publishing and Guardian policy import process may take a few minutes. Ensure the workflow instance is ready before proceeding to user attachment.

---

4. Attach Users to the Workflow

After the workflow instance has reached the Ready state, attach the previously registered users (supplier, verifier) to your workflow.

Actor Registration and Roles

If you attempt to attach users to a workflow instance, before it is ready, you will receive a warning from the system.

"The workflow instance is currently not ready yet, this is usually related to the import and publishing of related Guardian policies."

---

5. Submit Data to Blocks

With the workflow ready and users attached, start pushing data to the initial Data Block. Ensure the data aligns with the schema formats provided during workflow publishing. Proper schema compliance is necessary for successful data submission.

Workflow Block Instance Processing

---

6. Approval Block Workflow

Switch to the Registry role to approve the submitted Data Block. This process will repeat across subsequent data and approval blocks as the workflow progresses.

Workflow Block Instance Processing

---

7. Final Submission and Claim Approval

After submitting the "claim" Data Block, the Verifier role is required to approve the final Approval Block. This step ensures compliance and verification of the entire workflow.

Workflow Block Instance Processing

---

8. Issuing Credits and Querying Assets

Upon successful verification:

• The system generates credits in the background using Guardian.

• Audit trails are created to track all actions and data points within the workflow.

• Issued assets can be queried via the Credit Warehouse System, allowing for comprehensive reporting and tracking.

Audit TrailsCredit Warehouse Queries