hitl del flujo maestro de uip y migración del flujo maestro de uip

Sintaxis y opciones para `hitl de flujo maestro de uip` (añadir un nodo Human-in-the-Loop) y `migrar flujo maestro de uip` (actualizar un archivo `.flow` al esquema actual).

Esta página cubre dos pequeños grupos de comandos no relacionados que editan un archivo .flow directamente:

• uip maestro flow hitl — añade un nodo Human-in-the-Loop (HITL), que detiene la ejecución y espera a que una persona complete una tarea en Action Center.
• uip maestro flow migrate : actualiza el flujo de trabajo de un archivo .flow y las versiones del esquema de nodo.

Sinopsis

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]

Prevalece las opciones globales. Los códigos de salida siguen el contrato estándar. Ninguno de los comandos requiere uip login.

hitl de flujo maestro de uip añadir

Añade un nodo HITL a un archivo .flow.

Argumentos

• <file> (obligatorio) : ruta al archivo .flow .

Opciones

Opción	Descripción
--schema <json>	Objeto JSON de esquema de tarea. inputs[] entradas rellenadas previamente de variables de flujo (añadir "binding":"varName"); outputs[] entradas se escriben en una variable de flujo (añadir "variable":"varName"); outcomes[] enumera las posibles decisiones (por ejemplo Aprobar/Rechazar).
--priority <level>	Low, Medium o High. Predeterminado Low.
--position <x,y>	Posición del lienzo, por ejemplo 250,300.
--label <label>	Mostrar etiqueta para el nodo.
--assignee <email-or-group>	Destino de la asignación: un correo electrónico de usuario o un nombre de grupo.

Ejemplos

# 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"}]}'

Forma de datos (--output json)

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

Migrar flujo maestro de uip

Actualiza la versión del esquema de flujo de trabajo de un archivo .flow y, opcionalmente, sus nodos typeVersion, a la versión actual. Idempotente: ejecutarlo en un archivo ya actual no informa de cambios.

Argumentos

• <file> (obligatorio) : ruta al archivo .flow .

Opciones

Opción	Descripción
--dry-run	Muestra lo que cambiaría sin escribir el archivo.
--no-include-optional	Omite las migraciones de nodos opcionales (por ejemplo,typeVersion normalización). Predeterminado: se aplican migraciones opcionales.

Ejemplos

# 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

Forma de datos (--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 es false y WorkflowSteps está vacío cuando el archivo ya está en la versión actual. Con --dry-run, Data.DryRun es true y el archivo se deja intacto.

Ver también

• uip maestro flow validate — validar después de migrar
• uip maestro flow node, uip maestro flow variable
• Descripción general del flujo
• Opciones globales, Códigos de salida