execução de uiip rpa, debug e amp; Execução

Sintaxe e opções para "uip rpa run", o grupo "debug" e "execution cancel" — a superfície principal atual para executar e depurar um fluxo de trabalho ou arquivo codificado, substituindo o antigo "run-file"/"stop-execution" verbos.

uip rpa run, uip rpa debug * e uip rpa execution cancel executam e depuram um fluxo de trabalho ou arquivo codificado por meio do Studio. Todos os 17 verbos nesta página são enviados para as mesmas duas ferramentas subjacentes que uip rpa run-file e uip rpa stop-execution expõem como um amplo enum --command . Essa é a forma atual, principal e localizável dessa mesma funcionalidade, dividida em um verbo por comportamento em vez de um sinalizador com 19 valores. run-file/stop-execution ainda funcionam (eles são mantidos como alias de compatibilidade ocultos para habilidades instaladas), mas esta página é o que --help realmente mostra.

A execução acontece por meio do Studio, portanto, esses comandos funcionam apenas em executores do Windows (o Studio é somente do Windows). Se o Studio ainda não estiver em execução, ele será exibido automaticamente — execute uip rpa start-studio primeiro se quiser o custo de inicialização pago em uma etapa de configuração dedicada.

Resumo

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

Conceitos

• Um de dois back-ends. O Studio Desktop e o back-end do Helm sem periféricos implementam esses recursos; várias opções (--profiling-mode stream, debug set-breakpoints, debug apply-file-changes e enquete longa --wait-timeout-seconds) são apenas do Helm e são ignoradas ou indisponíveis no back-end do Studio — anotado por verbo abaixo.
• --remote (em run/debug start/debug start-from-here/debug test-activity apenas) é executado no agente remoto configurado (um robô não assistido do Orchestrator) em vez de localmente — consulte uip rpa remote para saber como configurar primeiro o destino.
• Cada comando no meio da sessão retorna no próximo estado estável. continue/resume/continue-retry/continue-ignore/os verbos da etapa/break/state aguardam a sessão atingir um estado estável (Paused, Suspended ou Completed) antes de retornar; se nenhum for alcançado dentro de --wait-timeout-seconds, eles retornarão DebugState: "Running" em vez de ficarem suspensos.

execução de RPA do UIP

Execute um fluxo de trabalho ou arquivo codificado por meio do Studio, sem nenhum depurador anexado.

Opções

Long	Valor	Description
--file-path <path>	String	Obrigatório. Caminho para o .xaml fluxo .cs de trabalho ou arquivo codificado.
--input-arguments <json>	JsonObject	Argumentos de entrada no nível do projeto como JSON simples. Por exemplo {"customerId":"ACME-1234"}).
--log-level <level>	Verbose|Trace|Information|Warning|Error|Critical	Nível mínimo de log no fluxo de saída. TracePadrão.
--skip-build	Bandeira	Ignore a validação/compilação, supondo que o projeto já tenha sido construído. Use para uma reexecução rápida quando nada mudar.
--profiling	Bandeira	Colete dados de criação de perfil por atividade, retornados como um campo Profiling. Requer um perfil de Desenvolver do Studio com EnableProfiling definido — se indisponível, a execução ainda é concluída e Profiling é simplesmente omitido. Padrão false.
--profiling-mode <mode>	endOfRun|stream	Tempo de entrega para dados de criação de perfil. endOfRun (padrão) retorna o resumo uma vez na conclusão; stream também ativa a coleta por conta própria e também encaminha cada entrada por atividade ao vivo como uma [Profiling] linha, além de gravar os dados completos no .uistat arquivo da execução. Apenas back-end do Helm; ignorado ao executar remotamente.
--remote	Bandeira	Execute no agente remoto configurado em vez de localmente. Configure o destino primeiro com uip rpa remote configure. Padrão false.

Exemplo

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

Formato dos dados (--output json)

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

A forma Data é a carga de resultado de execução da ferramenta subjacente — consulte uip rpa run-file para o contrato de resultado completo (ambos os verbos retornam a mesma forma).

Início da depuração do uip rpa

Inicie uma sessão de depuração para um fluxo de trabalho ou arquivo codificado. As mesmas opções que run, mais --breakpoints.

Opções

Todas as opções do run, mais:

Long	Valor	Description
--breakpoints <json>	Matriz JSON	Ponto de interrupção inicial definido. Cada entrada: workflowFile (obrigatório, caminho relativo à raiz do projeto), activityIdRef (o sap2010:WorkflowViewState.IdRef da atividade do XAML — a maneira estável de resolvê-lo) ou activityId (ID do runtime), além de condition opcional (expressão VB/C#; interrompe apenas quando verdadeiro), hitCount (quebra apenas na enésima ocorrência), enabled (padrão true). Itens key=value separados por vírgulas repetíveis, uma entrada de array por ocorrência ou um arquivo JSON por meio de @breakpoints.json / --breakpoints-file.

Exemplo

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

Formato dos dados (--output json)

Mesma forma que run; uma sessão que atinge um ponto de interrupção relata DebugState: "Paused" com a atividade e locais em DebugDetails.

Depuração uip rpa começa-aqui

Comece a depurar a partir da atividade focada no momento, ignorando tudo antes dela. Não --file-path — ele opera no que estiver focado no projeto aberto.

Opções

Long	Valor	Description
--input-arguments <json>	JSON	Entradas no nível do projeto. Ao contrário de run/debug start, os valores aqui são expressões VB.NET ou C#, não literais JSON simples.
--input-variables <json>	JSON	Valores de variáveis no nível do fluxo de trabalho para gerar o estado no escopo (expressões, não literais).
--log-level <level>	mesmo enum que run	Nível mínimo de log.
--profiling / --profiling-mode <mode>	—	Igual a.run

Exemplo

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

atividade de teste de depuração do uip rpa

Isole e execute a atividade focada atualmente, usando --input-arguments/--input-variables (expressões, mesma convenção que start-from-here) para semear o estado no escopo.

Opções

Igual a.debug start-from-here

Exemplo

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

interrupção de depuração do uip rpa

Pausar a execução na próxima atividade executada na sessão ativa.

Opções

Long	Valor	Description
--wait-timeout-seconds <n>	Número	Máximo de segundos para aguardar o próximo estado estável antes de retornar DebugState: "Running". Padrão 120. Apenas back-end do Helm — o back-end do Studio aplica seu próprio limite fixo de 120s e ignora um valor explícito.

uip rpa depurar continuar / retomar / continuar-repetir / continuar-ignorar

Retome a execução na sessão ativa. continue retoma da pausa; resume retoma da suspensão; continue-retry retoma e tenta novamente a atividade que acabou de ser gerada; continue-ignore retoma e depura a exceção da atividade que acabou de gerar.

Opções

Igual a --wait-timeout-seconds e debug break.

Debug uip rpa passo a passo

Depurador padrão passo na sessão ativa. step-out, chamado sem sessão ativa, inicia uma pausa antes da primeira atividade.

Opções

Igual a --wait-timeout-seconds e debug break.

estado de depuração do uip rpa

Relate o estado da sessão de depuração ativa (Running/Paused/Suspended/Completed/None) sem efeitos colaterais.

Opções

Long	Valor	Description
--wait-timeout-seconds <n>	Número	Faça uma pesquisa longa de uma sessão em execução para seu próximo estado estável. 0 Padrão (uma investigação instantânea). Apenas back-end do Helm — no back-end do Studio, esta é sempre uma investigação instantânea.

conjuntos de pontos de interrupção de debug uip rpa

Substitui todo o conjunto de pontos de interrupção da sessão de depuração ativa. Apenas back-end do Helm — no backend do Studio, use debug toggle-breakpoint ou passe pontos de interrupção para debug start.

Opções

Long	Valor	Required	Description
--breakpoints <json>	Matriz JSON	sim	Mesmo formato que o --breakpoints de debug start. Substitui todo o conjunto, não uma mescla.

depuração adicionar-arquivo-alterações do uiip rpa

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 do fluxo de trabalho primeiro e, em seguida, chame essa nomeação do que mudou.

Opções

Long	Valor	Required	Description
--file-changes <json>	Matriz JSON	sim	Um objeto por propriedade editada: workflowFile (obrigatório), activityIdRef, mais o nome/valor da propriedade alterada. Formulário key=value repetível ou @changes.json / --file-changes-file.

Formato dos dados (--output json)

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

applied edições estão ativas na sessão (por exemplo continue-retry executa novamente uma atividade com falha com a correção); rejected edições (cada uma com um motivo) são alterações estrutural que precisam de uma reinicialização da sessão para entrar em vigor.

alternância-ponto de interrupção de depuração do uip rpa

Alternar um ponto de interrupção na atividade atualmente focada (.xaml) ou linha (.cs). Sem opções. Ciclos de XAML habilitados → desabilitados → nenhum; ciclo de fluxos de trabalho codificados ativado/desativado.

Reinicialização-do-top de uip rpa

Reinicie a sessão de depuração ativa desde o início. Sem opções.

execução de uip rpa cancelamento

Cancelar a execução atualmente ativa ou depuração — funciona uniformemente para run e debug start. Sem opções.

Exemplo

uip rpa execution cancel

Relacionado

• uip rpa run-file / uip rpa stop-execution — os alias legados ocultos que esses verbos substituíram; mesmas ferramentas subjacentes.
• uip rpa start-studio — pague o custo de inicialização do Studio em uma etapa de configuração dedicada.
• uip rpa remote — configurar o destino para --remote.
• 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