archivo de ejecución de uip rpa

uip rpa run-file o depura un flujo de trabajo o archivo codificado. El mismo verbo cubre el ciclo de vida completo de la ejecución (iniciar, pausar, reanudar, paso, reiniciar, detener, alternar un punto de interrupción) seleccionado por el marcador --command . Es el puente desde un script o agente de IA hasta el depurador de Studio.

La ejecución se produce a través de Studio, por lo que el comando solo funciona en ejecutores de Windows (Studio es solo para Windows). Si Studio no se está ejecutando, la herramienta lo muestra automáticamente: ejecutar uip rpa start-studio primero es opcional, pero útil cuando quieres que el coste de inicio se pague en un paso de configuración dedicado.

Sinopsis

uip rpa run-file --file-path <path> [--command <verb>] [options]

Opciones

Marca	Descripción
--file-path <string>	Obligatorio. Ruta al archivo que se va a ejecutar: flujo de trabajo .xaml o flujo de trabajo codificado .cs .
--command <verb>	Qué hacer. El valor predeterminado es StartExecution. Consulta Verbos de comando a continuación.
--input-arguments <json>	Objeto JSON con argumentos de entrada en el nivel de proyecto. Utilizado por todos los comandos. Para StartExecution / StartDebugging, los valores son JSON simples ({"name":"John","age":30}). Para TestActivity / StartDebuggingFromHere, los valores son expresiones VB.NET o C#.
--input-variables <json>	Objeto JSON con valores de variables en el nivel de flujo de trabajo. Se aplica solo a TestActivity y StartDebuggingFromHere. Los valores son expresiones de idioma, no JSON literal.
--log-level <level>	Nivel de registro mínimo incluido en el flujo de salida: Verbose, Trace, Information, Warning, Error, Critical. El valor predeterminado es Trace.
--skip-build	Omitir la validación y compilación para StartExecution / StartDebugging. Se supone que el proyecto ya se ha creado: utilízalo para una reejecución rápida cuando el proyecto no ha cambiado.

Para obtener la lista completa de opciones en la versión de la herramienta instalada, ejecuta:

uip rpa run-file --help

Verbos de comando

El --command cubre dos modos de ejecución: ejecución sin depuración y control del depurador. Los verbos distinguen entre mayúsculas y minúsculas y pasan a Studio.

Ejecución

Verbo	Efecto
StartExecution (Predeterminada)	Ejecuta el flujo de trabajo en --file-path. No hay depurador conectado.
StartDebugging	Inicia una sesión de depuración para el flujo de trabajo.
Stop	Detener la ejecución actual o la sesión de depuración.
ForceSessionEnded	Forzar el final de la sesión actual si la parada elegante se bloquea.

Control del depurador

Verbo	Efecto
Break	Pausar la ejecución.
Continue	Reanudar desde un estado de pausa.
Resume	Reanudar desde un estado de suspensión.
ContinueRetry	Reanudar; si está en pausa por una excepción, vuelve a intentar la actividad actual.
ContinueIgnore	Reanudar; si se detiene en una excepción, traga la excepción.
StepInto / StepOver / StepOut	Paso en el sentido estándar del depurador.
RestartFromTop	Reinicia la depuración desde el principio.
ToggleBreakpoint	Alterna un punto de interrupción en la actividad (.xaml) o línea (.cs) enfocada. Ciclos XAML habilitado → deshabilitado → ninguno; activar/desactivar el ciclo de flujos de trabajo codificados.
TestActivity	Aísla y ejecuta la actividad enfocada, con --input-variables / --input-arguments proporcionando expresiones dentro del ámbito.
StartDebuggingFromHere	Comienza a depurar desde la actividad enfocada, omitiendo todo lo que hay antes.

Ejemplos

# Run a workflow with input arguments
uip rpa run-file \
  --file-path ./Main.xaml \
  --input-arguments '{"customerId": "ACME-1234"}'

# Start a debug session
uip rpa run-file \
  --file-path ./Main.xaml \
  --command StartDebugging

# Toggle a breakpoint at the focused activity, then start debugging
uip rpa run-file --file-path ./Main.xaml --command ToggleBreakpoint
uip rpa run-file --file-path ./Main.xaml --command StartDebugging

# Test a single activity with a custom variable expression (VB.NET project)
uip rpa run-file \
  --file-path ./Main.xaml \
  --command TestActivity \
  --input-variables '{"greeting": "\"Hello World\""}'

# Stop a runaway session
uip rpa run-file --file-path ./Main.xaml --command Stop

Relacionado

• uip rpa start-studio : paga el coste de inicio de Studio en un paso de configuración dedicado.
• uip rpa stop-execution : equivalente a --command Stop como verbo independiente.
• 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