uip rpa ejecutar, depurar & Ejecución

Sintaxis y opciones para `uip rpa run`, el grupo `debug` y `cancelación de ejecución`: la superficie principal actual para ejecutar y depurar un flujo de trabajo o archivo codificado, reemplazando el antiguo `run-file`/`stop-execution` verbos.

uip rpa run, uip rpa debug * y uip rpa execution cancel ejecutan y depuran un flujo de trabajo o archivo codificado a través de Studio. Los 17 verbos de esta página se envían a las mismas dos herramientas subyacentes que uip rpa run-file y uip rpa stop-execution exponen como un amplio enum --command : esta es la forma actual, principal y reconocible de esa misma funcionalidad, dividida en un verbo por comportamiento en lugar de un marcador con 19 valores. run-file/stop-execution siguen funcionando (se mantienen como alias de compatibilidad ocultos para las habilidades instaladas), pero esta página es lo que --help muestra realmente.

La ejecución se produce a través de Studio, por lo que estos comandos solo funcionan en ejecutores de Windows (Studio es solo para Windows). Si Studio aún no se está ejecutando, se abre automáticamente: ejecuta uip rpa start-studio primero si quieres que el coste de inicio se pague en un paso de configuración dedicado.

Sinopsis

uip rpa run --file-path <path> [--input-arguments <json>] [--log-level <level>] [--skip-build] [--profiling] [--profiling-mode endOfRun|stream] [--remote]

uip rpa debug start --file-path <path> [same options as run] [--breakpoints <json>]
uip rpa debug start-from-here [--input-arguments <json>] [--input-variables <json>] [--log-level <level>] [--profiling] [--profiling-mode <mode>]
uip rpa debug test-activity [--input-arguments <json>] [--input-variables <json>] [--log-level <level>] [--profiling] [--profiling-mode <mode>]
uip rpa debug break [--wait-timeout-seconds <n>]
uip rpa debug continue [--wait-timeout-seconds <n>]
uip rpa debug resume [--wait-timeout-seconds <n>]
uip rpa debug continue-retry [--wait-timeout-seconds <n>]
uip rpa debug continue-ignore [--wait-timeout-seconds <n>]
uip rpa debug step-into [--wait-timeout-seconds <n>]
uip rpa debug step-over [--wait-timeout-seconds <n>]
uip rpa debug step-out [--wait-timeout-seconds <n>]
uip rpa debug state [--wait-timeout-seconds <n>]
uip rpa debug set-breakpoints --breakpoints <json>
uip rpa debug apply-file-changes --file-changes <json>
uip rpa debug toggle-breakpoint
uip rpa debug restart-from-top

uip rpa execution cancel

Conceptos

• Uno de los dos backends. Studio Desktop y el backend Helm desatendido los implementan; varias opciones (--profiling-mode stream, debug set-breakpoints, debug apply-file-changes y encuesta larga --wait-timeout-seconds) son solo de Helm y se ignoran o no están disponibles en el backend de Studio, como se indica por verbo a continuación.
• --remote (solo en run/debug start/debug start-from-here/debug test-activity ) se ejecuta en el agente remoto configurado (un unattended robot de Orchestrator) en lugar de localmente — consulta uip rpa remote para saber cómo configurar primero el destino.
• Cada comando de mitad de sesión vuelve al siguiente estado estable. continue/resume/continue-retry/continue-ignore/los verbos de paso/break/state esperan a que la sesión alcance un estado estable (Paused, Suspended o Completed) antes de volver; si no se alcanza ninguno dentro de --wait-timeout-seconds, devuelven DebugState: "Running" en lugar de colgarse.

ejecución de rpa de uip

Ejecuta un flujo de trabajo o archivo codificado a través de Studio, sin depurador adjunto.

Opciones

Largo	Valor	Descripción
--file-path <path>	String	Obligatorio. Ruta al flujo de trabajo .xaml o al archivo codificado .cs.
--input-arguments <json>	ObjetoJson	Argumentos de entrada a nivel de proyecto como JSON simple, por ejemplo {"customerId":"ACME-1234"}.
--log-level <level>	Verbose|Trace|Information|Warning|Error|Critical	Nivel de registro mínimo en el flujo de salida. Predeterminado Trace.
--skip-build	Marca	Omitir la validación/compilación, suponiendo que el proyecto ya se ha creado. Utilízalo para una reejecución rápida cuando no haya cambiado nada.
--profiling	Marca	Recopilar datos de perfiles por actividad, devueltos como un campo Profiling. Requiere un perfil de Desarrollo de Studio con EnableProfiling establecido: si no está disponible, la ejecución aún se completa y Profiling simplemente se omite. Predeterminado false.
--profiling-mode <mode>	endOfRun|stream	Plazo de entrega de los datos de perfilado. endOfRun (predeterminado) devuelve el resumen una vez al finalizar; stream también activa la recopilación por sí misma y, además, reenvía cada entrada activa por actividad como una línea [Profiling], además de escribir los datos exhaustivos en el archivo .uistat de la ejecución. Solo backend de Helm; ignorado cuando se ejecuta de forma remota.
--remote	Marca	Ejecutar en el agente remoto configurado en lugar de localmente. Configura el destino primero con uip rpa remote configure. Predeterminado false.

Ejemplo

uip rpa run --file-path ./Main.xaml --input-arguments '{"customerId": "ACME-1234"}'

Forma de datos (--json de salida)

{ "Code": "RunResult", "Data": { "DebugState": "Completed", "Result": {} } }

La forma Data exacta es la carga útil del resultado de la ejecución de la herramienta subyacente — consulta uip rpa run-file para el contrato de resultado completo (ambos verbos devuelven la misma forma).

inicio de depuración de uip rpa

Inicia una sesión de depuración para un flujo de trabajo o archivo codificado. Las mismas opciones que run, más --breakpoints.

Opciones

Todas las opciones de run, más:

Largo	Valor	Descripción
--breakpoints <json>	MatrizJson	Punto de interrupción inicial establecido. Cada entrada: workflowFile (obligatoria, ruta relativa a la raíz del proyecto), activityIdRef (la actividad sap2010:WorkflowViewState.IdRef del XAML, la forma estable de abordarla) o activityId (ID de runtime), más condition opcional (expresión VB/C#; se rompe solo cuando es verdadero), hitCount (se rompe solo en el enésimo hit), enabled (valor predeterminado: true). Elementos key=value repetibles separados por comas, una entrada de matriz por ocurrencia o un archivo JSON a través de @breakpoints.json / --breakpoints-file.

Ejemplo

uip rpa debug start --file-path ./Main.xaml \
  --breakpoints 'workflowFile=Main.xaml,activityIdRef=Assign_1'

Forma de datos (--json de salida)

Misma forma que run; una sesión que alcanza un punto de interrupción informa DebugState: "Paused" con la actividad y los locales en DebugDetails.

depuración de uip rpa: iniciar desde aquí

Comienza a depurar desde la actividad enfocada actualmente, omitiendo todo lo que hay antes. No:--file-path opera en lo que esté enfocado en el proyecto abierto.

Opciones

Largo	Valor	Descripción
--input-arguments <json>	JSON	Entradas a nivel de proyecto. A diferencia de run/debug start, los valores aquí son expresiones VB.NET o C#, no literales JSON simples.
--input-variables <json>	JSON	Valores de variables en el nivel de flujo de trabajo para inicializar el estado en el ámbito (expresiones, no literales).
--log-level <level>	mismo enumerado que run	Nivel de registro mínimo.
--profiling / --profiling-mode <mode>	—	Igual que run.

Ejemplo

uip rpa debug start-from-here --input-variables '{"greeting": "\"Hello World\""}'

actividad de prueba de depuración de uip rpa

Aísla y ejecuta la actividad enfocada actualmente, utilizando --input-arguments/--input-variables (expresiones, la misma convención que start-from-here) para inicializar el estado dentro del ámbito.

Opciones

Igual que debug start-from-here.

Ejemplo

uip rpa debug test-activity --input-variables '{"greeting": "\"Hello World\""}'

interrupción de depuración de uip rpa

Pausar la ejecución en la siguiente actividad ejecutada en la sesión activa.

Opciones

Largo	Valor	Descripción
--wait-timeout-seconds <n>	Número	Máximo de segundos para esperar el siguiente estado estable antes de devolver DebugState: "Running". Predeterminado 120. Solo backend de Helm: el backend de Studio aplica su propio límite de 120 fijo e ignora un valor explícito.

uip rpa debug continuar/reanudar/continuar-reintentar/continuar-ignorar

Reanuda la ejecución en la sesión activa. continue se reanuda desde la pausa; resume se reanuda desde suspendido; continue-retry reanuda y reintenta la actividad que acaba de lanzar; continue-ignore reanuda y se traga la excepción de la actividad que acaba de lanzar.

Opciones

Mismo --wait-timeout-seconds que debug break.

paso a paso de entrada/paso a paso/salida de depuración de uip rpa

Pasos estándar del depurador en la sesión activa. step-out, llamado sin sesión activa, inicia una en pausa antes de la primera actividad.

Opciones

Mismo --wait-timeout-seconds que debug break.

estado de depuración de uip rpa

Informa del estado de la sesión de depuración activa (Running/Paused/Suspended/Completed/None) sin efectos secundarios.

Opciones

Largo	Valor	Descripción
--wait-timeout-seconds <n>	Número	Encuesta larga una sesión en ejecución para su próximo estado estable. Predeterminado 0 (un sondeo instantáneo). Solo backend de Helm: en el backend de Studio, siempre se trata de un sondeo instantáneo.

Establecer puntos de interrupción de depuración de UIP RPA

Reemplaza todo el conjunto de puntos de interrupción de la sesión de depuración activa. Solo backend de Helm: en el backend de Studio, utiliza debug toggle-breakpoint, o pasa los puntos de interrupción a debug start en su lugar.

Opciones

Largo	Valor	Obligatorio	Descripción
--breakpoints <json>	MatrizJson	Sí	La misma forma que el --breakpoints de debug start. Reemplaza todo el conjunto, no una fusión.

uip rpa debug apply-file-changes

Mientras está en pausa/suspendido en una sesión de depuración, concilia las ediciones de actividad-propiedad en el disco en la sesión en ejecución a través de la recarga en caliente, para que las recoja sin reiniciar. Edite primero el archivo de flujo de trabajo y luego llame a esto nombrando lo que ha cambiado.

Opciones

Largo	Valor	Obligatorio	Descripción
--file-changes <json>	MatrizJson	Sí	Un objeto por propiedad editada: workflowFile (obligatorio), activityIdRef, más el nombre/valor de propiedad cambiado. Formulario key=value repetible o @changes.json / --file-changes-file.

Forma de datos (--json de salida)

{ "Code": "ApplyFileChanges", "Data": { "applied": [], "rejected": [], "debugState": "Paused" } }

applied ediciones están activas en la sesión (por ejemplo continue-retry vuelve a ejecutar una actividad defectuosa con la corrección); rejected ediciones (cada una con un motivo) son cambios estructurales que necesitan reiniciar la sesión para surtir efecto.

UIP rpa debug alternar-punto de interrupción

Alternar un punto de interrupción en la actividad (.xaml) o línea (.cs) actualmente enfocada. Sin opciones. Ciclos XAML habilitado → deshabilitado → ninguno; los flujos de trabajo codificados se activan/desactivan.

uip rpa debug reiniciar-desde-arriba

Reinicia la sesión de depuración activa desde el principio. Sin opciones.

cancelación de ejecución de uip rpa

Cancela la sesión de ejecución o depuración actualmente activa: funciona de manera uniforme tanto para run como para debug start. Sin opciones.

Ejemplo

uip rpa execution cancel

Relacionado

• uip rpa run-file / uip rpa stop-execution : los alias heredados ocultos reemplazados por estos verbos; mismas herramientas subyacentes.
• uip rpa start-studio : paga el coste de inicio de Studio en un paso de configuración dedicado.
• uip rpa remote — configura el destino para --remote.
• uip rpa get-errors : inspecciona los diagnósticos después de una ejecución.

Ver también

• Descripción general de la herramienta RPA
• Opciones globales
• Códigos de salida