depuración de flujo maestro de uip

Sintaxis y opciones para `depuración de flujo maestro de uip`, que carga un proyecto de flujo local en Studio Web y ejecuta una sesión de depuración en el servidor con actualizaciones de estado transmitidas.

uip maestro flow debug un proyecto de flujo local a Studio Web y ejecuta una sesión de depuración en el servidor, transmitiendo actualizaciones de estado por elemento a la consola y devolviendo un estado final.

Sinopsis

uip maestro flow debug <project-path>
               [--folder-id <id> | --folder-key <key> | --folder-path <path>]
               [--poll-interval <ms>]
               [-i, --inputs <json>]
               [--attachment <name=path>]...
               [--open-in-browser]
               [--login-validity <minutes>]

Requiere uip login. Prevalece las opciones globales. Los códigos de salida siguen el contrato estándar.

Argumentos

• <project-path> obligatorio) : ruta al directorio del proyecto Flow. Debe contener un project.uiproj.

Opciones

Opción	Predeterminado	Descripción
--folder-id <id>	Detectado automáticamente	Carpeta de Orchestrator (OrganizationUnitId), un entero positivo. Mutuamente exclusivo con --folder-key/--folder-path. Si no se proporciona ninguna de las tres, se utiliza la carpeta en la sesión de inicio de sesión actual.
--folder-key <key>	—	Clave de carpeta de Orchestrator (UUID): resuelta en el ID de carpeta por la CLI. Mutuamente exclusivo con --folder-id/--folder-path.
--folder-path <path>	—	Ruta de la carpeta de Orchestrator, por ejemplo Shared/Sub — resuelto en el ID de carpeta por la CLI. Mutuamente exclusivo con --folder-id/--folder-key. Utiliza uip or folders list para descubrir claves/rutas válidas.
--poll-interval <ms>	2000	Intervalo de sondeo en milisegundos mientras se espera a que Studio Web avance la sesión.
-i, --inputs <json>	—	Argumentos de entrada como una cadena JSON, o @path/to/file.json para leer desde un archivo.
--attachment <name=path>	—	Carga un archivo local en Orchestrator y vincúlalo como una variable de entrada de tipo de archivo. Repetible, por ejemplo --attachment file1=./resume.pdf. Anula el mismo nombre de variable si también está presente en --inputs.
--open-in-browser	—	Abre la URL de la sesión de Studio Web en un navegador una vez que esté disponible.
--login-validity <minutes>	10	Minutos mínimos antes de la caducidad del token para desencadenar una actualización automática.

Comportamiento

1. Valida el inicio de sesión y extrae la organización, el tenant, la URL base, el nombre de la organización y el token de autenticación de la sesión.
2. Carga el proyecto en Studio Web en la carpeta de destino.
3. Sondea un estado final, emitiendo líneas de estado por elemento como:

   Status: InProgress (2/5 elements completed)
     v Node_1 [Completed]
     > Node_2 [InProgress]
     - Node_3 [NotStarted]
   

4. En incidentes durante la ejecución, emite una línea de advertencia.
5. Sale de 0 si finalStatus es Completed o Successful; 1 de lo contrario.

Ejemplos

# Debug a local project, auto-detect folder, default poll interval
uip maestro flow debug ./invoice-flow

# Debug against a specific folder with inline JSON inputs
uip maestro flow debug ./invoice-flow --folder-id 2553016 \
  --inputs '{"amount":100,"customer":"Acme"}'

# Debug with inputs from a file
uip maestro flow debug ./invoice-flow --inputs @inputs.json

# Slower polling for long-running flows
uip maestro flow debug ./invoice-flow --poll-interval 5000

Forma de datos (--json de salida)

{
  "Code": "FlowDebug",
  "Data": {
    "jobKey": "b2c3d4e5-0000-0000-0000-000000000001",
    "instanceId": "c3d4e5f6-0000-0000-0000-000000000001",
    "runId": "d4e5f6a7-0000-0000-0000-000000000001",
    "finalStatus": "Completed",
    "solutionId": "e5f6a7b8-0000-0000-0000-000000000001",
    "studioWebUrl": "https://cloud.uipath.com/org/tenant/studio_/debug/e5f6a7b8",
    "elementExecutions": [
      { "elementId": "Node_1", "status": "Completed" }
    ],
    "variables": {}
  }
}

Abre studioWebUrl en un navegador para inspeccionar la sesión de forma interactiva.

Transferencia de desencadenador conversacional

Un flujo cuyo punto de entrada es core.trigger.conversation solo puede ser impulsado por una IU de chat: la CLI no puede iniciar una sesión de depuración para él. En su lugar, carga el proyecto en Studio Web y lo realiza:

{
  "Code": "FlowDebugStudioWebHandoff",
  "Data": {
    "solutionId": "e5f6a7b8-0000-0000-0000-000000000001",
    "studioWebUrl": "https://cloud.uipath.com/org/studio_/designer/a1b2c3d4?solutionId=e5f6a7b8",
    "handedOff": true
  }
}

No hay campos elementExecutions/finalStatus: no se ejecutó nada, por lo que no hay nada que sondear. Introduce --open-in-browser para que la CLI se abra studioWebUrl automáticamente.

Ejecución defectuosa: incidentes en línea

Una ejecución defectuosa se devuelve como un sobre Result: "Failure" (código de salida 1), con detalles del incidente ya en línea el Data.incidents — no se necesita un comando de seguimiento para ver qué es lo que ha fallado:

{
  "Code": "FlowDebug",
  "Data": {
    "jobKey": "b2c3d4e5-0000-0000-0000-000000000001",
    "instanceId": "c3d4e5f6-0000-0000-0000-000000000001",
    "runId": "d4e5f6a7-0000-0000-0000-000000000001",
    "finalStatus": "Faulted",
    "incidents": [
      {
        "incidentId": "inc-1",
        "elementId": "Node_3",
        "errorCode": "Process.UnhandledException",
        "errorMessage": "Object reference not set to an instance of an object."
      }
    ]
  }
}

En una ejecución defectuosa, el error Instructions te señala en uip maestro flow debug-instance incidents <instanceId> para inspeccionar la carga útil del backend sin procesar; consulta debug-instance para esa superficie de control de nivel inferior.

Ver también

• uip maestro flow debug-instance : control paso a paso sobre una sesión de depuración, para crear herramientas personalizadas
• uip maestro flow validate — comprobación estática antes de ejecutar
• uip maestro flow process run : ejecutar un proceso publicado
• uip maestro flow job traces : seguimientos de flujo para un trabajo ya iniciado
• Autenticación
• Descripción general del flujo