flux uip maestro hitl et migration uip maestro flux

Syntaxe et options pour `uip maestro flow hitl` (ajouter un nœud Human-in-the-Loop) et `uip maestro flow migration` (mettre à niveau un fichier `.flow` vers le schéma actuel).

Cette page couvre deux petits groupes de commandes non liés qui modifient tous deux directement un fichier .flow:

• uip maestro flow hitl — ajouter un nœud Human-in-the-Loop qui suspend l'exécution et attend qu'une personne termine une tâche dans Action Center.
• uip maestro flow migrate — mettez à niveau les versions du workflow et du schéma de nœud d'un fichier .flow .

Synthèse

uip maestro flow hitl add <file> [--schema <json>] [--priority <Low|Medium|High>] [--position <x,y>] [--label <label>] [--assignee <email-or-group>]

uip maestro flow migrate <file> [--dry-run] [--no-include-optional]

Les options globales sont respectées. Les codes de sortie suivent le contrat standard. Aucune commande ne nécessite uip login.

Ajout de hitl de flux uip maestro

Ajoutez un nœud HITL à un fichier .flow.

Arguments

• <file> (obligatoire) : chemin d'accès au fichier .flow .

Options

Option	Description
--schema <json>	Objet JSON du schéma de tâche. inputs[] entrées préremplies à partir des variables de flux (ajoutez "binding":"varName"); Les entrées outputs[] réécrivent dans une variable de flux (ajoutez "variable":"varName"); outcomes[] répertorie les décisions possibles (par exemple, Approuver/Rejeter).
--priority <level>	Low, Medium ou High. Par défaut Low.
--position <x,y>	Position de la zone de dessin, par exemple 250,300.
--label <label>	Affichez le libellé pour le nœud.
--assignee <email-or-group>	Cible de l'affectation: un e-mail d'utilisateur ou un nom de groupe.

Exemples

# Bare HITL node, no schema
uip maestro flow hitl add workflow.flow

# With label, priority, and a group assignee
uip maestro flow hitl add workflow.flow --label "Invoice Review" --priority High --assignee finance-approvers

# Full schema: pre-filled input, a required output written back to a variable, two outcomes
uip maestro flow hitl add workflow.flow --label "Approval" \
  --schema '{"inputs":[{"name":"invoiceId","binding":"fetchInvoice1.result.invoiceId"}],"outputs":[{"name":"decision","variable":"approvalDecision","required":true}],"outcomes":[{"name":"Approve"},{"name":"Reject"}]}'

Format des données (--output json)

{
  "Code": "HitlNodeAdded",
  "Data": {
    "NodeId": "approval1",
    "NodeType": "uipath.human-in-the-loop",
    "Label": "Approval",
    "DefinitionAdded": true
  }
}

Migration du flux uip maestro

Mettez à niveau la version du schéma de workflow d'un fichier .flow et, éventuellement, ses typeVersionnœuds, vers les versions actuelles. Idempotente: si elle est exécutée sur un fichier déjà actuel, aucune modification ne sera signalée.

Arguments

• <file> (obligatoire) : chemin d'accès au fichier .flow .

Options

Option	Description
--dry-run	Indiquez ce qui changerait sans écrire le fichier.
--no-include-optional	Ignorez les migrations facultatives des nœuds (par exemple, la normalisation typeVersion). Par défaut: les migrations facultatives sont appliquées.

Exemples

# Migrate to the current schema version
uip maestro flow migrate ./my-flow/my-flow.flow

# Preview only
uip maestro flow migrate ./my-flow/my-flow.flow --dry-run

# Skip optional node migrations
uip maestro flow migrate ./my-flow/my-flow.flow --no-include-optional

Format des données (--output json)

{
  "Code": "FlowMigrate",
  "Data": {
    "File": "./my-flow/my-flow.flow",
    "Migrated": true,
    "DryRun": false,
    "FromVersion": "1.0.0",
    "ToVersion": "1.0",
    "WorkflowSteps": ["1.0.0 -> 1.0"],
    "NodeMigrations": {
      "ForcedAvailable": 0,
      "OptionalAvailable": 2,
      "OptionalApplied": 2,
      "Failed": 0
    }
  }
}

Migrated est false et WorkflowSteps est vide lorsque le fichier est déjà à la version actuelle. Avec --dry-run, Data.DryRun est true et le fichier n’est pas modifié.

Voir également

• uip maestro flow validate — valider après la migration
• uip maestro flow node, uip maestro flow variable
• Vue d’ensemble du flux
• Options globales, codes de sortie