arquivo de execução uip rpa

Sintaxe e opções para o "uip rpa run-file", que executa ou depura um fluxo de trabalho ou arquivo codificado, com suporte para início, pausa, etapa e pontos de interrupção.

uip rpa run-file ou depura um fluxo de trabalho ou arquivo codificado. O mesmo verbo abrange o ciclo de vida completo da execução — iniciar, pausar, retomar, etapa, reiniciar, parar, alternar um ponto de interrupção — selecionado pelo sinalizador --command . É a ponte de um script ou agente de IA para o depurador do Studio.

A execução acontece por meio do Studio, portanto, o comando funciona apenas em executores do Windows (o Studio é somente do Windows). Se o Studio ainda não estiver em execução, a ferramenta o criará automaticamente — executar uip rpa start-studio primeiro é opcional, mas útil quando você deseja que o custo de inicialização seja pago em uma etapa de configuração dedicada.

Observação:

run-file agora é um alias legado oculto — ainda funciona, mas a origem atual (tool-names.ts, CLI_DERIVED_COMMANDS) divide essa mesma operação subjacente em uma família identificável de verbos de nível superior: uip rpa run (iniciar execução), uip rpa debug start / start-from-here / test-activity / break / continue / resume / continue-retry / continue-ignore / step-into / step-over / step-out / state / set-breakpoints / apply-file-changes / toggle-breakpoint / restart-from-top e uip rpa execution cancel (substitui stop-execution). Cada verbo derivados leva apenas os sinalizadores relevantes para ele, em vez de um enum --command com a lista completa de 19 valores. Os exemplos desta página ainda funcionam hoje por meio do alias oculto — consulte uip rpa run, debug & execution para obter a superfície primária atual.

Resumo

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

Opções

Bandeira	Description
--file-path <string>	Obrigatório. Caminho para o arquivo a ser executado — fluxo de trabalho .xaml ou fluxo de trabalho codificado .cs .
--command <verb>	O que fazer. O padrão é StartExecution. Consulte Verbo de comando abaixo.
--input-arguments <json>	Objeto JSON com argumentos de entrada no nível do projeto. Usado por todos os comandos. Para StartExecution / StartDebugging, os valores são JSON simples ({"name":"John","age":30}). Para TestActivity / StartDebuggingFromHere, os valores são expressões VB.NET ou C#.
--input-variables <json>	Objeto JSON com valores de variáveis no nível do fluxo de trabalho. Aplica-se apenas a TestActivity e StartDebuggingFromHere. Os valores são expressões de linguagem, não JSON literal.
--log-level <level>	Nível de log mínimo incluído no fluxo de saída — Verbose, Trace, Information, Warning, Error, Critical. O padrão é Trace.
--skip-build	Ignorar validação e compilação para StartExecution / StartDebugging. Assume que o projeto já foi criado — use para uma reexecução rápida quando o projeto não tiver sido alterado.

Para obter a lista completa de opções na versão da ferramenta instalada, execute:

uip rpa run-file --help

Verbos de comando

O sinalizador --command abrange dois modos de execução: execução sem depuração e controle do depurador. Os verbos diferenciam maiúsculas de minúsculas e são enviados para o Studio.

Execução

Texto	Efeito
StartExecution (Padrão)	Execute o fluxo de trabalho em --file-path. Nenhum depurador anexado.
StartDebugging	Inicie uma sessão de depuração para o fluxo de trabalho.
Stop	Interrompa a execução ou a sessão de depuração atual.
ForceSessionEnded	Forçar o encerramento da sessão atual se a parada suave travar.

Controle do depurador

Texto	Efeito
Break	Pausar a execução.
Continue	Retomar a partir de um estado pausado.
Resume	Retomar a partir de um estado suspenso.
ContinueRetry	Retomar; se pausado em uma exceção, tente novamente a atividade atual.
ContinueIgnore	Retomar; se pausado em uma exceção, ingerir a exceção.
StepInto / StepOver / StepOut	Etapa no sentido do depurador padrão.
RestartFromTop	Reinicie a depuração desde o início.
ToggleBreakpoint	Alternar um ponto de interrupção na atividade focada (.xaml) ou linha (.cs). Ciclos de XAML habilitados → desabilitados → nenhum; ciclo de fluxos de trabalho codificados ativado / desativado.
TestActivity	Isole e execute a atividade focada, com --input-variables / --input-arguments fornecendo expressões no escopo.
StartDebuggingFromHere	Comece a depurar a partir da atividade focada, ignorando tudo antes dela.
GetDebugState	Relata o estado atual da sessão de depuração sem efeitos colaterais (None quando nenhuma sessão está ativa). Sempre uma investigação instantânea no back-end do Studio; no backend do Helm, ele pode pesquisar o próximo estado estável.
SetBreakpoints	Substitua todo o ponto de interrupção da sessão de depuração ativa definido por --breakpoints. Apenas back-end do Helm — no back-end do Studio, defina pontos de interrupção por meio de ToggleBreakpoint ou passando-os para StartDebugging.
ApplyFileChanges	Enquanto estiver pausado/Suspenso em uma sessão de depuração, reconcilie as edições de propriedades de atividades no disco na sessão em execução por meio de Recarregamento dinâmico, para que sejam coletadas sem reiniciar. Edite o arquivo primeiro e depois chame essa nomenclatura para o que mudou. Retorna { applied, rejected, debugState } em vez de um resultado de execução — as edições estrutural (não recarregada com o hot) são rejeitadas e precisam de uma reinicialização da sessão.

Exemplos

# 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 — pague o custo de inicialização do Studio em uma etapa de configuração dedicada.
• uip rpa stop-execution — equivalente a --command Stop como um verbo independente.
• uip rpa get-errors inspecione o diagnóstico após uma execução.

Veja também

• Visão geral da ferramenta RPA
• Opções globais
• Códigos de saída