Processus BPMN uip Maestro et Processus BPMN UIP Maestro

Syntaxe et options pour « `uip maestro bpmn process` et `uip maestro bpmn processes`, couvrant les opérations de processus Maestro BPMN publiées par dossier et à l'échelle du locataire.

Une fois qu'un package Maestro BPMN est publié dans Orchestrator, il devient un processus de type ProcessOrchestration. Les deux groupes de commandes ci-dessous sont enregistrés sous la branche bpmn. Cette page couvre deux groupes de commandes associés:

• uip maestro bpmn process — opérations par dossier sur une seule définition de processus (répertorier dans un dossier, obtenir son schéma, l'exécuter, le compresser+publier).
• uip maestro bpmn processes — résumés à l'échelle du locataire, recherche d'incidents par processus et diagnostics.

Synthèse

# Singular — per-folder, operational
uip maestro bpmn process list    -f <folder-key> [--filter <odata>] [--login-validity <minutes>]
uip maestro bpmn process get     <process-key> <feed-id> -f <folder-key> [--login-validity <minutes>]
uip maestro bpmn process run     <process-key> <folder-key> --release-key <key>
                                  [-i, --inputs <json>] [--feed-id <id>] [--robot-ids <ids>]
                                  [--login-validity <minutes>]
uip maestro bpmn process publish <project-path> [output-path] -f <folder-key>
                                  [-n, --name <name>] [--process-name <name>] [-v, --version <version>]
                                  [-i, --inputs <json>] [--feed-id <id>] [--entry-point <path>]
                                  [--wait [--timeout <seconds>] [--poll-interval <seconds>]] [--login-validity <minutes>]

# Plural — tenant-wide summary, incidents, and diagnostics
uip maestro bpmn processes list       [--folder-key <key>] [-l <limit>] [--offset <n>] [--status <status>]
uip maestro bpmn processes incidents  <process-key> --folder-key <key>
uip maestro bpmn processes diagnose   <process-key> --folder-key <key>
uip maestro bpmn processes error-codes <process-key> --folder-key <key>

Toutes les sous-commandes nécessitent uip login et respectent les options globales. Les codes de sortie suivent le contrat standard.

---

Liste des processus BPMN uip Maestro

Répertoriez les processus Maestro (versions) disponibles dans un dossier spécifique.

Options

Option	Requis	Description
-f, --folder-key <key>	oui	Clé de dossier.
--filter <odata>	non	Un filtre OData supplémentaire est appliqué côté serveur.
--login-validity <minutes>	non	Seuil d’actualisation du jeton (par défaut 10).

Format des données (--output json)

{
  "Code": "MaestroProcessList",
  "Data": [
    {
      "name":           "InvoiceOrchestration",
      "processKey":     "a1b2c3d4-0000-0000-0000-000000000001",
      "processVersion": "1.0.0",
      "packageId":      "a1b2c3d4-0000-0000-0000-000000000001",
      "packageVersion": "1.0.0",
      "releaseKey":     "e5f6a7b8-0000-0000-0000-000000000001",
      "folderKey":      "c3d4e5f6-0000-0000-0000-000000000001",
      "feedId":         "default",
      "folderId":       42,
      "active":         "Yes",
      "latest":         "Yes"
    }
  ]
}

---

Obtenir le processus BPMN uip Maestro

Récupérer le schéma de point d'entrée (schéma d'entrée/sortie) d'un processus Maestro.

Arguments

• <process-key> (obligatoire) : clé de processus.
• <feed-id> (obligatoire) : ID de flux (depuis list).

Options

• -f, --folder-key <key> (requis)
• --login-validity <minutes> (par défaut 10)

Format des données

{
  "Code": "MaestroProcessGet",
  "Data": [
    {
      "Path":         "/content/main.bpmn#Event_start",
      "DisplayName":  "Manual trigger",
      "Type":         "processorchestration",
      "InputSchema":  "{\"type\":\"object\",\"properties\":{}}",
      "OutputSchema": "{\"type\":\"object\",\"properties\":{}}"
    }
  ]
}

InputSchema et OutputSchema sont les chaînes de schéma JSON reconfigurées.

---

Exécution du processus bpmn uip maestro

Démarrez une tâche Maestro pour un processus publié.

Arguments

• <process-key> (obligatoire) : clé de processus de package versionnée de process list, par exemple MyProcess:1.0.0.
• <folder-key> (obligatoire) — clé de dossier.

Options

Option	Requis	Description
--release-key <key>	oui	Clé de version — à partir de process list.
-i, --inputs <json>	non	Les entrées sous la forme d'une chaîne JSON ou @path/to/file.json. Si ce champ est omis et que st depuis est sur la barre de pipeline, st din est analysé.
--feed-id <id>	non	ID de flux pour la recherche des packages (facultatif).
--robot-ids <ids>	non	ID de robot séparés par des virgules (facultatif).
--login-validity <minutes>	non	Seuil d’actualisation du jeton (par défaut 10).

Il n'y a pas d'option --validate sur cette commande — les entrées sont envoyées telles quelles; le processus lui-même est responsable du rejet des entrées incorrectes.

Priorité d’entrée: --inputs <json> / --inputs @file.json > stdin > objet vide {}.

Exemples

# Inline JSON
uip maestro bpmn process run "InvoiceOrchestration:1.0.0" "<folder-key>" \
  --release-key <release-key> --inputs '{"amount":100}'

# From a file
uip maestro bpmn process run "InvoiceOrchestration:1.0.0" "<folder-key>" \
  --release-key <release-key> --inputs @inputs.json

# Piped stdin
echo '{"amount":100}' | uip maestro bpmn process run "InvoiceOrchestration:1.0.0" "<folder-key>" --release-key <release-key>

Format des données

{
  "Code": "MaestroJobStarted",
  "Data": {
    "jobKey":  "b2c3d4e5-0000-0000-0000-000000000001",
    "state":   "Pending",
    "traceId": "d4e5f6a7-0000-0000-0000-000000000001"
  }
}

Étape suivante: uip maestro bpmn job traces <jobKey> pour diffuser l'exécution ou uip maestro bpmn job status <jobKey> pour interroger.

---

publication du processus bpmn uip maestro

Compressez un répertoire de projet BPMN Maestro dans un .nupkg et publiez-le en tant que version de processus Orchestrator, en une seule étape.

Arguments

• <project-path> (obligatoire) : chemin d'accès au répertoire du projet BPMN Maestro.
• [output-path] (facultatif) — répertoire de sortie pour le .nupkg généré. Par défaut, un répertoire temporaire.

Options

Option	Description
-f, --folder-key <key>	Requis. Clé de dossier.
-n, --name <name>	Nom du package. Par défaut: le nom du dossier du projet.
--process-name <name>	Nom de la version du processus. Par défaut: le nom du package.
-v, --version <version>	Version du package. Par défaut 1.0.0.
-i, --inputs <json>	Les paramètres d'entrée par défaut sous la forme d'une chaîne JSON, de @file.json ou - pour stbin.
--feed-id <id>	ID de flux pour le téléchargement du package (facultatif).
--entry-point <path>	Chemin du point d’entrée du processus.
--wait	Attendez que les points d’entrée du package publié soient disponibles au lieu de revenir immédiatement après le téléchargement.
--timeout <seconds>	Nombre maximal de secondes à attendre pour la propagation de la publication lorsque l'élément --wait est défini. Par défaut 300.
--poll-interval <seconds>	Secondes entre les vérifications de propagation de publication lorsque --wait est défini. Par défaut 5.
--login-validity <minutes>	Seuil d’actualisation du jeton. Par défaut 10.

Exemple

uip maestro bpmn process publish ./invoice-process \
  --folder-key <folder-key> --version 1.2.0 --wait

Format des données

{
  "Code": "MaestroProcessPublished",
  "Data": {
    "Package": "invoice-process@1.2.0",
    "PackagePath": "/tmp/maestro-process-publish-.../invoice-process.processOrchestration.ProcessOrchestration.1.2.0.nupkg",
    "ProcessKey": "invoice-process.processOrchestration.ProcessOrchestration",
    "ProcessVersion": "1.2.0",
    "ReleaseKey": "e5f6a7b8-0000-0000-0000-000000000001",
    "ReleaseName": "invoice-process",
    "Action": "Created",
    "Upload": [
      { "key": "invoice-process.processOrchestration.ProcessOrchestration", "status": "Created" }
    ],
    "EntryPoints": 1
  }
}

Action est "Created" lors de la première publication d'une clé de processus donnée, "Updated" lors des publications ultérieures.

---

Liste des processus BPMN uip Maestro

Résumé des processus Maestro à l'échelle du locataire (ou du dossier). Contrairement à l'unique process list, aucun filtre processType n'est appliqué côté serveur — la commande multiple est partagée entre les outils (Maestro, Flow, Case) et ne s'étend pas à ProcessOrchestration par défaut.

Options

Option	Description
--folder-key <key>	Facultatif. Étendue du résumé à un dossier.
-l, --limit <number>	Nombre d'éléments à renvoyer (1-10 000).
--offset <number>	Nombre d’éléments à ignorer (0-1000 000). Par défaut 0.
--status <status>	Filtrez par statut de processus.

Format des données

{
  "Code": "ProcessList",
  "Data": [ /* array of Maestro process summaries */ ]
}

Remarque :

L'ensemble de champs exact de chaque résumé de processus est spécifié par le runtime Maestro et peut évoluer; exécutez la commande une fois avec --output json sur un locataire avec des données pour voir les champs que vous allez utiliser, et épinglez @uipath/cli dans CI si vous analysez des champs spécifiques.

---

Incidents de processus bpmn uip maestro

Obtenez tous les incidents pour une définition de processus Maestro spécifique.

Arguments

• <process-key> (obligatoire) : clé de définition du processus.

Options

• --folder-key <key> (requis)

Format des données

{
  "Code": "ProcessIncidents",
  "Data": [ /* array of process incidents */ ]
}

---

Diagnostic des processus BPMN uip Maestro

Corrélez le résumé, les incidents et les codes d'erreur d'un processus dans un même appel — un encapsuleur de convenance pour processes list, processes incidents et processes error-codes.

Arguments

• <process-key> (obligatoire) : clé de définition du processus.

Options

• --folder-key <key> (requis)

Format des données

{
  "Code": "ProcessDiagnostics",
  "Data": {
    "ProcessKey": "InvoiceOrchestration",
    "FolderKey": "c3d4e5f6-0000-0000-0000-000000000001",
    "Summary": { /* the matching process summary object, or null if not found */ },
    "FaultedCount": 2,
    "RunningCount": 5,
    "Incidents": [ /* array of incident objects */ ],
    "IncidentCount": 1,
    "ErrorCodes": [ /* array of error code strings */ ],
    "ErrorCodeCount": 1
  }
}

---

Processus BPMN uip Maestro - Codes d'erreur

Obtenez les codes d'erreur uniques déclenchés par des incidents pour un processus spécifique.

Arguments

• <process-key> (obligatoire) : clé de définition du processus.

Options

• --folder-key <key> (requis)

Format des données

{
  "Code": "ProcessIncidentErrorCodes",
  "Data": [ /* array of error code strings */ ]
}

Voir également

• uip maestro bpmn instances — inspecter et piloter les exécutions en cours d'exécution
• uip maestro bpmn job — traçages et statut pour une seule tâche
• uip maestro bpmn incidents — résumés et détails des incidents
• Tâches Orchestrator, Processus Orchestrator
• Vue d’ensemble de Maestro