uipath-maestro-bpmn

Author, validate, package, and operate UiPath Maestro BPMN process orchestration projects.

9|6|Updated Aug 25, 2017
One-click install
npx skills add https://github.com/sergueik/springboot_study --skill uipath-maestro-bpmn-sergueik
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: uipath-maestro-bpmn
Source: https://github.com/sergueik/springboot_study/tree/main/basic-uipath-skills/.github/skills/uipath-maestro-bpmn
Command: npx skills add https://github.com/sergueik/springboot_study --skill uipath-maestro-bpmn-sergueik

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Creating valid UiPath Maestro .bpmn process orchestration files by hand is error-prone: extension payloads must come from the UiPath registry, structural BPMN must follow the Studio Web canvas contract, and every node needs diagram metadata to import. This Skill guides the full lifecycle so files validate and run correctly. ## Core Features & Use Cases - Registry-driven authoring: Discovers extension types (RPA jobs, agents, HITL tasks, queues, business rules, Integration Service connectors) via the UiPath CLI and builds each node's uipath:* payload from the official xmlTemplate. - Structural BPMN authoring: Generates process scaffolds, sequence flows, gateways, events, boundary events, subprocesses, multi-instance loops, and the mandatory BPMN diagram from the documented canvas contract. - Validate, operate, and diagnose: Runs the offline CLI validator, then packages, uploads, publishes, runs, and troubleshoots instances with explicit user consent for cloud changes. - Use Case: Ask for an invoice-approval process that starts an RPA job, waits for a human approval task, and branches on the outcome; the Skill discovers the templates, authors the .bpmn, validates it, and prepares it for upload. ## Quick Start Create a Maestro BPMN process that starts an RPA job, waits for human approval, and branches on the result, then validate it with the UiPath CLI.

Frequently Asked Questions about uipath-maestro-bpmn

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a UiPath Maestro BPMN process from a description?

Describe the process intent, then the Skill discovers matching extension types with uip maestro bpmn registry list/search, pulls each node's xmlTemplate with registry get, and assembles the structural BPMN plus diagram. It finishes by running uip maestro bpmn validate on the file.

How do I validate a Maestro .bpmn file before importing it?

Run uip maestro bpmn validate <file.bpmn> --output json. The CLI runs the full PO.Frontend canvas rule set offline; exit 0 means valid, exit 1 lists blocking errors with rule codes. Warnings are reported but do not fail the run.

What is the difference between uipath-maestro-bpmn and uipath-maestro-flow?

uipath-maestro-bpmn handles .bpmn process orchestration projects, while uipath-maestro-flow handles .flow JSON files. Case plans use uipath-maestro-case, XAML/coded workflows use uipath-rpa, and Python agents use uipath-agents.

Can I hand-write uipath:* extension XML in a Maestro BPMN file?

No. Every uipath:* payload must come from the registry's xmlTemplate via uip maestro bpmn registry get <type>. Only structural BPMN such as sequence flows, gateways, events, and the diagram is authored by hand from the canvas contract.

Why is my Maestro BPMN node invisible after import into Studio Web?

Import is diagram-driven: every node needs a BPMNShape and every sequence flow a BPMNEdge in the bpmndi:BPMNDiagram. A node without a shape is invisible and a flow without an edge is dropped, so the diagram must be generated completely.

Does the Maestro BPMN validator require a UiPath login?

No. Local authoring and uip maestro bpmn validate work fully offline without login. Login is only needed for registry discovery of connectors and processes and for Integration Service field enrichment.