- Notas de Versão
- Introdução
- Configuração e Instalação
- Projetos de automação
- Sobre a publicação de projetos de automação
- Projetando automações
- Gerenciamento de pacotes de atividades
- Como definir as configurações do projeto de atividades
- Como assinar pacotes
- Governança
- Como importar entidades
- Experiência de Criação Moderna
- Vincular um projeto a uma ideia no Automation Hub
- Usando o Gerenciador de dados
- Dependências
- Tipos de fluxos de trabalho
- Fluxo de controle
- Comparação de arquivos
- Melhores Práticas de Automação
- Integração de controle de origem
- Sobre o controle de versões
- Como gerenciar projetos com o TÁS
- Como gerenciar projetos com o SN
- Dif. do fluxo de trabalho
- Depuração
- Geração de logs
- A ferramenta de diagnóstico
- Analisador de Fluxo de Trabalho
- Sobre o Analisador de Fluxo de Trabalho
- STN MG-001 - Convenção de nomenclatura de variáveis
- STN MG-002 - Convenção de nomenclatura de argumentos
- STN MG-004 - Duplicação de Nome de Exibição
- STN MG-005 - Variável substitui variável
- STN MG-006 - Variável substitui argumento
- STN MG-008 - Comprimento de variável excedido
- STN MG-009 - Variáveis Catablema de prefixo
- STN MG-011 - Argumentos Catablema de prefixo
- STN MG-012 - Valores padrão de argumentos
- STN MG-016 - Comprimento do argumento excedido
- ST-NMG-017 - O nome da classe corresponde ao namespace padrão
- SR-DB-002 - Contagem alta de argumentos
- SR-DB-003 - Esvaziar bloco catechu
- SR-DB-007 - Múltiplas camadas Com fluxograma
- ST-DPB-010 - Várias instâncias de [Fluxo de trabalho] ou [Caso de teste]
- SR-DB-020 - Propriedades de saída indefinidas
- SR-DB-021 - Tempo limite embutido em código
- SR-DB-023 - Fluxo de trabalho vazio
- SR-DB-024 - Verificação da atividade Persistente
- SR-DB-025 - Pré-requisito de serialidade de variáveis
- SR-DB-026 - Uso da atividade Dela
- SR-DB-027 - Melhores práticas de persistência
- SR-DB-028 - Pré-requisito de serialidade de argumentos
- SR-US-005 - Argumentos de atividades embutidos em código
- SR-US-009 - Variáveis não utilizadas
- SR-US-010 - Dependências não utilizadas
- SR-US-014 - Restrições de pacotes
- ST-USG-017 - Invalid parameter modifier
- SR-US-020 - Mensagens de logue mínimas
- SR-US-024 - Não utilizado e postergado
- SR-US-025 - Uso incorreto do valor salvo
- SR-US-026 - Restrições da atividade
- SR-US-027 - Pacotes necessários
- ST-USG-28 — restringir modelos de invocação de arquivos
- ST-USG-032 — rótulos obrigatórios
- ST-USG-034 — URL do Automation Hub
- Variáveis
- Argumentos
- Namespaces Importados
- Automações codificadas
- Introdução
- Registro de serviços personalizados
- Contextos Antes e Depois
- Gerando código
- Geração de caso de teste codificado a partir de casos de teste manuais
- Automação assistida baseada em gatilho
- Gravação
- Elementos de Interface Gráfica
- Seletores
- Repo. de Objetos
- Extração de Dados
- Automação de imagem e texto
- Automação de Tecnologias Citrix
- Automação RDP
- Automação do Varear Horizonte
- Automação da Salesforce
- Automação SAP
- Automaçāo da interface gráfica do macOS
- A ferramenta ScreenScrapeJavaSupport
- O protocolo Servodrive
- Extensões
- Sobre extensões
- Ferramenta SetupExtensions
- UiPathRemoteRuntime.exe não está sendo executado na sessão remota
- O UiPath Remote Runtime bloqueia a sessão do Citrix de ser fechado
- O UiPath Remote Runtime causa vazamento de memória
- O pacote UiPath.UIAutomation.Activities e as versões do UiPath Remote Runtime são incompatíveis
- A extensão do UiPath necessária não está instalada na máquina remota
- Configurações de resolução de tela
- Políticas de grupo
- Não é possível se comunicar com o navegador
- A extensão do Chrome é removida automaticamente
- A extensão pode ter sido corrompida
- Verifique se a extensão para o Chrome está instalada e habilitada
- Check if ChromeNativeMessaging.exe is running
- Check if ComSpec variable is defined correctly
- Habilite o Acesso às URLs do arquivo e o Modo Anônimo
- Multiple browser profiles
- Group Policy conflict
- Known issues specific to MV3 extensions
- Lista de extensões para Chrome
- Extensão do Chrome no Mac
- Políticas de grupo
- Não é possível se comunicar com o navegador
- A extensão Edge é removida automaticamente
- A extensão pode ter sido corrompida
- Check if the Extension for Microsoft Edge is installed and enabled
- Check if ChromeNativeMessaging.exe is running
- Check if ComSpec variable is defined correctly
- Enable access to file URLs and InPrivate mode
- Multiple browser profiles
- Group Policy conflict
- Known issues specific to MV3 extensions
- Lista de extensões para Edge
- Extensão para Safari
- Extensão para o Varear Horizonte
- Extensão para Amazon WorkSpaces
- Plug-in do SAP Solution Manager
- Suplemento do Excel
- Test Suite — Studio
- Solução de problemas
- Sobre a solução de problemas
- Assembly compilation errors
- Suporte e limitações do Microsoft Apo-V
- Solução de problemas do Internet Explorer x64
- Problemas do Microsoft Office
- Como identificar elementos de EU em PDF com opções de acessibilidade
- Reparando o suporte da Active Accessibility
- Validation of large Windows-legacy projects takes longer than expected
Guia do usuário do Studio
Introdução
As automações codificadas permitem criar automações usando código em vez de atividades de arrastar e soltar, permitindo trabalho colaborativo em projetos complexos. Em fluxos de trabalho codificados e casos de teste, você pode usar serviços UiPath (iguais a pacotes de atividades), APIs (semelhantes a atividades), pacotes .NET NuGet externos e suas classes C# personalizadas no UiPath Studio. Isso facilita a integração com sistemas externos, bancos de dados, APIs e outros serviços.
Os fluxos de trabalho codificados se comportam como fluxos de trabalho padrão, o que significa que eles também podem ser invocados a partir de fluxos de trabalho UiPath padrão e vice-versa, usando a atividade Invoke Workflow File.
Além disso, os tipos definidos em código, como enums, podem ser usados como entradas em fluxos de trabalho UiPath padrão.
As automações codificadas podem ser de três tipos:
- Fluxos de trabalho codificados — usados para projetar fluxos de trabalho no código.
- Casos de teste codificados - usados para projetar casos de teste.
- Arquivos de código-fonte - - usados para criar código que você pode chamar posteriormente em outros tipos de arquivos codificados.
UiPath.CodedWorkflows
pré-instalado. O pacote vem com a classe base CodedWorkflowBase
e parcial CodedWorkflow
.
O pacote é pré-instalado quando:
- Você cria um novo projeto com pelo menos a versão 23.10 do System.Activities, Testing.Activities ou UIAutomation.Activities ou qualquer outro pacote de atividades compatível com fluxo de trabalho codificado.
- Você cria um novo Fluxo de trabalho codificado, Caso de teste codificado ou Arquivo de código-fonte em seu projeto.
Se não puder usar automações codificadas nos cenários indicados, baixe o pacote no menu Gerenciar pacotes.
Aqui estão alguns dos benefícios de usar automações codificadas:
- Produtividade aprimorada - Se você estiver familiarizado com codificação ou scripts, poderá aproveitar suas habilidades e aumentar sua produtividade. Trabalhar em um ambiente de codificação familiar permite desenvolver automações mais eficientes.
- Gerenciamento de complexidade — Automações codificadas fornecem uma solução flexível para gerenciar cenários de automação complexos. Ao usar código, você pode implementar lógica personalizada, gerenciar exceções e criar funções reutilizáveis.
- Automação híbrida - Você pode usar automações codificadas de forma intercambiável com automações de pouco código. Isso promove a integração perfeita entre as duas abordagens, permitindo criar soluções de automação flexíveis.
- Desempenho aprimorado — Automações codificadas permitem que você otimize seus fluxos de trabalho de automação para melhorar o desempenho. Ao usar código, você pode implementar algoritmos específicos para tornar suas execuções de automação mais rápidas.
- Legibilidade — Automações codificadas permitem criar código estruturado, resultando em legibilidade de código. Se você organizar seu código e documentá-lo, poderá mantê-lo facilmente e compartilhá-lo com outros colaboradores.
As automações codificadas apresentam um design estruturado com namespaces , classes auxiliares e métodos de Entry Point. O framework de automações codificadas permite escrever as automações usando a linguagem de programação C#.
Siga a estrutura detalhada de uma automação codificada conforme descrito nas seções a seguir.
Ao criar uma automação codificada, um namespace é gerado automaticamente usando o nome do projeto do Studio. Por exemplo, se o seu projeto do Studio for denominado "Meu projeto", o namespace para todas as automações codificadas será "Meu projeto".
Além disso, se você criar uma automação codificada dentro de uma pasta no seu projeto do Studio, o namespace será o nome do projeto e o nome da pasta. Por exemplo, se o seu projeto do Studio se chamar "Meu projeto" e a pasta se chamar "local", o namespace será "Meuprojeto.local".
CodedWorkflow
do pacote UiPath.CodedWorkflow. Essa classe dá à automação acesso às interfaces necessárias para serviços (iguais a pacotes de atividades), com base nos pacotes de atividades instalados em seu projeto.
Fluxo de Trabalho Codificado
CodedWorkflow
, criando uma relação do tipo CodedAutomationExample : CodedWorkflow
. Isso significa que a classe CodedAutomationExample
herda atributos, métodos e funcionalidade da classe CodedWorkflow
. Essencialmente, ele pode acessar e utilizar as funcionalidades definidas na classe CodedWorkflow
, o que fornece uma base para a automação codificada, tornando mais fácil criar e personalizar o comportamento da automação.
CodedWorkflow
é declarada como uma classe parcial, permitindo estender suas funcionalidades definindo a mesma classe parcial CodedWorkflow
em um arquivo de código-fonte. Dessa forma, você pode adicionar novos campos e métodos para personalizar ainda mais o comportamento de suas automações codificadas. Você pode usar essa abordagem para implementar uma interface Antes e Depois, especificamente para casos de teste codificados.
CodedWorkflow
herda a classe CodedWorkflowBase
.
CodedWorkflowBase
CodedWorkflowBase
contém as funcionalidades integradas que uma automação codificada herda. Esta classe contém métodos e propriedades específicas para gerenciar instâncias de fluxo de trabalho, acesso a runtime, manipulação de contêineres de serviço e configuração de contextos de ambiente. A classe CodedWorkflowBase
também oferece outro método separado para registro de log que você mesmo pode personalizar.
CodedWorkflowBase
.
CodedWorkflowBase
na tabela abaixo:
Método | Description |
---|---|
ICodedWorkflowServices services Observação: recomendamos que você use o
Log , BuildClient e os métodos RunWorkflow por meio da classe services e seus serviços correspondentes, em vez de usá-los como métodos independentes e prontamente disponíveis.
| Fornece acesso aos serviços disponíveis para fluxos de trabalho codificados, como:
|
serviceContainer(ICodedWorkflowServiceContainer) Observação: isso foi substituído por
ICodedWorkflowServices services . Se você continuar usando essa sintaxe, você receberá um aviso apontando para você usar a nova sintaxe services.Container .
| Fornece acesso ao contêiner de injeção de dependência específico do fluxo de trabalho codificado atual. Esse contêiner, conhecido como contêiner de serviço, permite recuperar instâncias de serviços que foram registrados nele. |
GetRunningJobInformation() | Recupera informações sobre o trabalho atualmente em execução no contexto do fluxo de trabalho codificado. O método acessa a propriedade RunningJobInformation do objeto executorRuntime , que contém informações sobre status do trabalho, progresso, parâmetros e carimbos de data/hora.
|
Log(string message, LogLevel level = LogLevel.Info, IDictionary<string, object> additionalLogFields = null) | Adiciona campos de log adicionais às mensagens de log com atributos especificados. |
RunWorkflow(string
workflowFilePath, IDictionary<string, object> inputArguments = null, TimeSpan? timeout = null, bool isolated = false,
InvokeTargetSession targetSession = InvokeTargetSession.Current) | Fornece uma estrutura para executar um fluxo de trabalho no contexto de um determinado runtime de fluxo de trabalho. Ele pode definir parâmetros, lidar com isolamento potencial e iniciar a execução do fluxo de trabalho. A tarefa retornada fornece os resultados do fluxo de trabalho executado, incluindo sua saída e seus argumentos de entrada/saída. |
RunWorkflowAsync(string
workflowFilePath, IDictionary<string, object> inputArguments = null, TimeSpan? timeout = null, bool isolated = false,
InvokeTargetSession targetSession = InvokeTargetSession.Current) | Fornece uma estrutura para executar um fluxo de trabalho de forma assíncrona no contexto do runtime do fluxo de trabalho dado. Ele pode definir parâmetros, lidar com isolamento potencial e iniciar a execução do fluxo de trabalho. A tarefa retornada fornece os resultados do fluxo de trabalho executado, incluindo sua saída e seus argumentos de entrada/saída. |
DelayAsync(TimeSpan time) e DelayAsync(int delayMs) | Suspende a execução por um período especificado de tempo de forma assíncrona. |
Delay(TimeSpan time) e Delay(int delayMs) | Suspende a execução por um período de tempo especificado. |
HttpClient BuildClient (string scope = "Orchestrator", bool force = true) | Cria um cliente HTTP com um escopo e um token de acesso especificados. |
RegisterServices (ICodedWorkflowsServiceLocator serviceLocator) | Registra serviços (pacotes de atividades) no localizador de serviços do fluxo de trabalho codificado. Você pode substituí-lo quando quiser injetar serviços personalizados no contêiner de injeção de dependência. Aprenda como criar e usar serviços personalizados (pacotes de atividades codificadas) aqui. |
Artigos relacionados
Execute()
e atribuído como Workflow
ou TestCase
. Você pode alterar o nome do método, desde que o atribua a Workflow
ou a TestCase
.
Execute()
([TestCase]
ou [Workflow]
) dentro de um arquivo, que herda a classe Coded Workflow
.
Neste método, você pode adicionar argumentos de entrada e/ou saída, que são equivalentes aos argumentos In, Out ou In/Out em automações de pouco código. Acesse o tutorial Trabalhando com argumentos de entrada e saída para aprender como usar argumentos em automações codificadas.
Execute()
.
Compatibilidade do projeto
Você pode usar automações codificadas somente em projetos do Windows e multiplataforma.
System.Activities
não é apenas um pacote de atividades em automações de pouco código, mas também um serviço em automações codificadas. Da mesma forma que as atividades dentro de um pacote de atividades, um serviço possui APIs que você pode usar para criar automações codificadas.
Os serviços disponíveis para utilização dentro de automações codificadas são os seguintes:
Serviço | Versão |
---|---|
System.Activities | 23.10 e superior |
UiAutomation.Activities | 23.10 e superior |
Testing.Activities | 23.10 e superior |
MobileAutomation.Activities | 23.12-preview e superior |
Mail.Activities | 1.22.1 e superior |
Excel.Activities | Pré-visualização 2.23.2 e superior |
Para usar pacotes de atividades em automações codificadas, execute as seguintes etapas:
- Baixe o pacote de atividades, igual a um serviço, semelhante ao que você faria em automações de pouco código. Isso fornece uma coleção de APIs para usar em seu código.
- Chame as APIs nos serviços usando o formato: service.API. Por exemplo, se você quiser usar a API GetAsset, você a chamaria como
system.GetAsset
. - As APIs possuem parâmetros em vez de propriedades. Após chamar uma API, você pode configurar seus parâmetros fornecendo valores entre parênteses. Por exemplo, se você tiver um ativo na instância do Orchestrator à qual você está conectado, chamado
Email Address
, poderá passar o nome desse ativo comoString
para a API:system.GetAsset("Email Address")
.