- Notas de Versão
- Introdução
- Governança
- Controle de origem
- Pipelines de CI/CD
- Gerenciamento de feeds
- Geração de logs

Guia do usuário do Automation Ops
Tarefas de trabalho
Seu pipeline é composto de diferentes etapas que, por sua vez, podem ser divididas em trabalhos. Para cada trabalho, você pode configurar as etapas para incluir as tarefas da UiPath, incluídas com a Integração da UiPath para Azure DevOps.
Folder not found
message is displayed, and the task is not performed. For more information, refer to Classic folders removal.
To prepare your environment, refer to Azure DevOps extension prerequisites.
Antes de começar a executar tarefas no seu pipeline, considere o seguinte:
- Você precisa executar tarefas UiPath apenas em agentes de compilação baseados no Windows.
- Configure a conexão de serviço do UiPath Orchestrator.
- Os recursos de teste exigem o Orchestrator na versão 2020.4 ou superior.
- Se você usa uma versão local do Orchestrator com HTTPS, importe o certificado SSL para garantir que as chamadas HTTPS para o Orchestrator sejam confiáveis.
A extensão Azure DevOps vem com uma CLI interna (interface de linha de comando) específica para UiPath.
Quando você executa o agente de compilação, a CLI se comunica com o Orchestrator e permite que você execute suas tarefas de trabalho.
Agent.ToolsDirectory
(cache do Azure) ao executá-la pela primeira vez.
Agent.ToolsDirectory
para concluir a execução.
Agent.ToolsDirectory
(cache do Azure), o sistema a baixará automaticamente do feed público do NuGet. Um requisito para isso é que o feed público do NuGet não seja bloqueado por um firewall e possa ser acessado de seu agente de compilação.
Agent.ToolsDirectory
, usando a tarefa Instalar plataforma.
Para definir um procedimento de automação no seu pipeline, você precisa adicionar e configurar tarefas individuais no pool do agente.
- No Azure DevOps, acesse Pipelines.
- Crie um novo pipeline ou edite um existente.
- Adicione um trabalho ao pool do agente.
- Procure uma das seguintes tarefas:
- UiPath Run Job
- UiPath Manage Assets
- Plataforma de instalação UiPath
- UiPath Pack
- UiPath Deploy
- UiPath Test
- Select Add and configure the task.
- Reinicie as tarefas no pool do agente se necessário e, em seguida, salve seu pipeline.
You can use this task to execute a process that's been already deployed on an Orchestrator instance. For more information, refer to Processes and Jobs.
Use a tabela a seguir para configurar as entradas do UiPath Run Job.
Entrada | Description |
---|---|
Nome da exibição (obrigatório) | Insira um nome para a sua tarefa. |
Conexão do Orchestrator (obrigatório) | Configure the service connection to access UiPath Orchestrator services. You can configure a connection only for this step or use an existing global connection. For more information, refer to Configuring UiPath Orchestrator service connection. |
Processo (obrigatório) | O processo é a versão do pacote vinculado a um tipo específico de pasta. Você precisa configurar essa entrada com base no tipo de pasta na qual o processo está implantado. Para pastas modernas, a entrada é o nome do processo listado na aba Processos . Para descobrir o nome do processo, abra o Orchestrator, abra sua pasta e navegue até Automações > Processos.Para pastas clássicas (obsoletas), a entrada é o nome do processo, seguido por um caractere de sublinhado e depois o nome do ambiente , onde os Robôs são hospedados. Como um exemplo para essa convenção de nomenclatura, considere as seguintes variáveis: O nome do processo éTestAutomation . O nome do ambiente é Production .O nome do seu processo para essa entrada é TestAutomation_Production .
|
Parâmetros de entrada | Especifique o caminho de arquivo como um arquivo de entrada JSON, como Input\jobParameters.json .
Exemplo de formato de arquivo JSON: |
Prioridade | Selecione a prioridade da execução do trabalho se quiser definir uma ordem específica no nível de processo. Por padrão, essa entrada é definida como Normal .
|
Pasta do Orchestrator (obrigatório) | Especifique a pasta em que o processo está sendo implantado. Para as pastas clássicas, você pode usar nomes de robôs específicos. Para as modernas, é possível utilizar nomes específicos de usuários e máquinas.
Para inserir subpastas, certifique-se de inserir o nome da pasta pai e o nome da subpasta. Por exemplo, use AccountingTeam\TeamJohn. |
Strategy | Especifique a estratégia de execução para alocação dinâmica ou especifica por robô. Para trabalhos alocados dinamicamente, o processo é executado na conta e máquina que estiverem disponíveis. De maneira alternativa, você pode escolher trabalhos específicos por robô. |
Tipo de Trabalho | Available only on modern folders.Choose the license model of the runtime under which the job is to be executed. For more information, refer to Robot licensing. |
Número de trabalhos | Disponível apenas para estratégia de alocação dinâmica. Especifique o número de vezes que deseja executar esta tarefa. Por padrão, esta entrada é definida como 1 .
|
Usuário | Disponível apenas em pastas modernas juntamente com uma estratégia de alocação dinâmica. Adicione o nome de usuário da máquina. Por exemplo, um usuário local para essa entrada é MachineName\UserName .
|
Máquina | Disponível apenas em pastas modernas juntamente com uma estratégia de alocação dinâmica. O nome da máquina que realiza a execução. |
Saída | Os resultados são coletados em um arquivo JSON. Você precisa especificar o caminho dos resultados do trabalho (por exemplo, Output\testResults.json ). Se você deixar essa entrada em branco, a saída padrão será enviada ao diretório de staging de artefato sob o nome UiPathResults.json .
|
Tempo limite | Especifique o número de segundos para aguardar antes que a solicitação expire. |
A tarefa falha quando um trabalho falha | Selecione essa entrada se quiser definir a tarefa como falha quando pelo menos um trabalho falhar. Essa entrada é selecionada por padrão. |
Aguarde a conclusão do trabalho | Aguarde a execução do trabalho ser concluída. Essa entrada é selecionada por padrão. |
Nível de trace | Selecione o nível de log da lista suspensa. |
robotsIds | Lista de nomes de robôs específicos, separados por vírgula. |
[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]
- task: UiPathRunJob@2
displayName: 'Start ProcessProject'
inputs:
#orchestratorConnection: 'service-connection-name' # Service connection to UiPath Orchestrator
#processName: 'ProccessProject_CI-Pipeline' # The name of the process
#parametersFilePath: 'Input\\jobParameters.json' # json file with input values if the process requires them
#priority: 'Low' # Options 'Low', 'Normal', 'High'
#folderName: 'MyFolder' # Specify the folder to deploy to. For clasic folders, you can use specific robot names. For modern folders, you can use specific user and machine names.
#strategy: 'Dynamically' # Options 'Specific', 'Dynamically'
#jobCount: 1 # The number of job runs. (default 1) - used if strategy is 'Dynamically'
#user: 'MyUser'
#machine: 'machine'
#robotsIds: 'robot1, robot2'
#resultFilePath: 'Output\\testResults.json'
#timeout: 3600
#failWhenJobFails: false
#waitForJobCompletion: false,
#traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None
Você pode usar essa tarefa para implantar, atualizar ou excluir ativos na sua instância do Orchestrator.
Os tipos de ativo a seguir são compatíveis:
Text
– Armazena apenas strings (não é necessário adicionar aspas)Boolean
- Suporta valores de verdadeiro ou falsoInteger
- Armazena apenas números inteirosCredential
- Contém nomes de usuário e senhas que o Robô requer para executar processos específicos. Para esse tipo de ativo, você precisa codificar o nome de usuário e a senha usando::
para separar os dois campos.
name,type,value, description asset_1_name,text,asset_value, asset_2_name,integer,123,asset_3_name,boolean,false, this is an asset description asset_4_name,credential,"username::password",
name,type,value, description asset_1_name,text,asset_value, asset_2_name,integer,123,asset_3_name,boolean,false, this is an asset description asset_4_name,credential,"username::password",
For more information, refer to Orchestrator Assets.
Use a tabela a seguir para configurar as entradas do UiPath Manage Assets.
Argumento | Description |
---|---|
Nome da exibição (obrigatório) | Insira um nome para a sua tarefa. |
Conexão do Orchestrator (obrigatório) | Configure the service connection to access UiPath Orchestrator services. You can configure a connection only for this step or use an existing global connection. For more information, refer to Configuring UiPath Orchestrator service connection. |
Pasta do Orchestrator (obrigatório) | Especifique a pasta em que o processo está sendo implantado. Para as pastas clássicas, você pode usar nomes de robôs específicos. Para as modernas, é possível utilizar nomes específicos de usuários e máquinas.
Para inserir subpastas, certifique-se de inserir o nome da pasta pai e o nome da subpasta. Por exemplo, use AccountingTeam\TeamJohn. |
Escolher ação de ativo (obrigatório) | Selecione uma opção da lista suspensa. |
Arquivo CSV de ativos (obrigatório) | Adicione o caminho do arquivo CSV. Você pode usar o mesmo arquivo para as ações de ativos Implantar e Atualizar. Considerações:
(Opcional) Você pode definir uma descrição Para cada ativo usando a seguinte sintaxe:
type, value ,description |
Nível de trace | Selecione o nível de log da lista suspensa. |
[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]
- task: UiPathAssets@2
displayName: 'Deploy/Update assets'
inputs:
#orchestratorConnection: 'service-connection-name' # Service connection to UiPath Orchestrator
#assetActionType: 'Deploy' # Options: Deploy, Delete
#csvFile: 'assets_deploy.csv' # the path to the csv file containing the assets description,
#traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None
Selecione a versão da CLI que você deseja usar com sua extensão do Azure DevOps, no menu suspenso Escolher uma versão da CLI (obrigatório).
As opções na lista suspensa incluem:
- As últimas versões disponíveis da CLI.
- Os requisitos de ambiente necessários para serem compatíveis com a versão CLI escolhida.
If your pipeline fails to access the UiPath Public Feed and can't download the CLI version that you chose from the dropdown list, take the following steps:
- Baixe a versão CLI desejada do UiPath Public Feed.
- Coloque o arquivo NUPKG baixado dentro do diretório
Agent.Tools
de seu agente de construção. Lembre-se do caminho do arquivo NUPKG dentro do diretórioAgent.Tools
. Por exemplo,$(Agent.ToolsDirectory)\nupkg\UiPath.CLI.xx.xx.xx.nupkg
- Use a tarefa InstallPlatform e insira o caminho usado na etapa 2 dentro do campo Path to CLI's nupkg.
Você pode visualizar um documento YAML totalmente analisado para a UiPath Install Platform, incluindo o seletor de versão CLI:
[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]
- task: UiPathInstallPlatform-preview@2
displayName: 'UiPath Install Platform'
inputs:
cliVersion: 'WIN_22.10.8418.30339' or 'X_22.10.8418.30339' or '21.10.8319.10920
cliNupkgPath:'$(Agent.ToolsDirectory)\nupkg\UiPath.CLI.X.22.10.8418.30339.nupkg'
A tarefa UiPathPack permite empacotar um projeto existente da UiPath em um pacote NuGet.
Use a tabela a seguir para configurar as entradas do UiPath Pack.
Argumento | Description |
---|---|
Nome da exibição (obrigatório) | Insira um nome para a sua tarefa. |
Escolher método de versionamento (obrigatório) | You can select an automatically generated version, use the project version, or define a new version. For more information, refer to Package Versions. |
Versão (obrigatório) | Disponível apenas em pastas modernas juntamente com uma estratégia de alocação dinâmica. A especificação da versão do pacote fornece a possibilidade de rastrear os pacotes criados e sua origem com mais eficiência. Por exemplo, o padrão do assembly da Microsoft pode ser utilizado para criar a versão do pacote NuGet: [Principal].[Secundária].[NúmerodaCompilação].[NúmerodeRevisão].
As opções disponíveis são:
|
Caminho do(s) projeto(s) (obrigatório) | Selecione a localização do projeto que será empacotado. Pode ser um caminho direto para um arquivo project.json ou um diretório com um, ou vários projetos. Nesse último caso, cada projeto de nível um é empacotado individualmente. |
Escolher tipo de saída (obrigatório apenas para o versionamento manual) | Defina um tipo de projeto para o projeto que será empacotado. Se você definir None , o tipo de projeto será extraído do arquivo JSON do projeto. Os seguintes tipos de projeto são suportados: 'Processo', 'Biblioteca', 'Testes', 'Objetos', 'Nenhum'.
|
Conexão do Orchestrator (obrigatório) | Configure the service connection to access UiPath Orchestrator services. You can configure a connection only for this step or use an existing global connection. For more information, refer to Configuring UiPath Orchestrator service connection. |
Caminho de Saída (obrigatório) | Defina um caminho da pasta em que o pacote será colocado. |
Executar análise de fluxo de trabalho | Select this option to run workflow analysis rules on your automation project (e.g., Fail jobs in case of errors). By default, this option is not activated. For more information, refer to Application Testing Workflow Analyzer Rules. |
Nível de trace | Selecione o nível de log da lista suspensa. |
[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]
- task: UiPathPack@2
inputs:
#versionType: AutoVersion # Options: AutoVersion, CurrentVersion, ManualVersion
#version: '1.0.0' # Required when versionType == ManualVersion
#projectJsonPath: '$(Build.SourcesDirectory)\MyFirstProcess'
#outputPath: '$(Build.ArtifactStagingDirectory)\Packages\MyFirstProcess'
#outputType: 'None' # Options: Process, Library, Tests, Objects, None
#runWorkflowAnalysis: 'False'
#orchestratorConnection: 'service-connection-name' # Service connection to UiPath Orchestrator,
#traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None
A tarefa UiPath Deploy permite implantar um pacote UiPath NuGet no UiPath Orchestrator.
Certifique-se de que sua rede permite o acesso ao seguinte feed de pacote do NuGet:
- https://api.nuget.org/v3/index.json
- https://uipath.pkgs.visualstudio.com/_packaging/nuget-packages/nuget/v3/index.json
- https://uipath.pkgs.visualstudio.com/Public.Feeds/_packaging/UiPath-Internal/nuget/v3/index.json
- https://www.myget.org/F/workflow
- http://www.myget.org/F/uipath
- https://www.myget.org/F/uipath-dev/api/v3/index.json
Use a tabela a seguir para configurar as entradas do UiPath Deploy.
Argumento | Description |
---|---|
Nome da exibição (obrigatório) | Insira um nome para a sua tarefa. |
Conexão do Orchestrator (obrigatório) | Configure the service connection to access UiPath Orchestrator services. You can configure a connection only for this step or use an existing global connection. For more information, refer to Configuring UiPath Orchestrator service connection. |
Pacote(s) (obrigatório) | Defina o feed para seus pacotes NuGet da UiPath. |
Criar processo automaticamente | Selecione esta opção se desejar implantar um pacote sem criar um processo. A opção é selecionada por padrão. Se selecionada, você precisa configurar o parâmetro Entry Point Path. |
Pasta do Orchestrator (obrigatório) | Especifique a pasta em que o processo está sendo implantado. Para pastas clássicas (obsoletas), você pode usar nomes de robôs específicos. Para as modernas, é possível utilizar nomes específicos de usuários e máquinas.
Para inserir subpastas, certifique-se de inserir o nome da pasta pai e o nome da subpasta. Por exemplo, use
AccountingTeam\TeamJohn .
|
Ambiente | (Opcional) Se você usa pastas clássicas (obsoletas), precisa definir o ambiente em que os pacotes serão implantados. Você pode usar esse campo para criar ou atualizar pacotes. Você pode usar o seguinte exemplo para adicionar seus ambientes a esse campo, separados por uma vírgula: testingEnvironment,productionEnvironment .
|
Caminho(s) do ponto de entrada (obrigatório) | Specify entry point paths to create or update a process. The entry point path specifies the file path starting from the root of the project.Before configuring the entry point paths, consider the following: Entry points are available for Orchestrator version 21.4 or higher (e.g. 21.4.UiPathDeploy.entryPoints ). For Orchestrator versions lower than 21.4, you need to enter any value, as the field must not remain empty. The default entry point is set to Main.xaml . Multiple entrypoints can be specified as 'Main.xaml, EntryPoint2.xaml '. For classic folders (deprecated) you can specify only one entry point for each environment. For nested folders you need to specify the file path, as follows:Folder01/Folder02/Main.xaml or Folder01/Folder02/Entrypoint.xaml For more information, refer to Orchestrator Entry Points.
|
Nível de trace | Selecione o nível de log da lista suspensa. |
[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]
- task: UiPathDeploy@2
inputs:
#orchestratorConnection: # Service connection to UiPath Orchestrator
#packagesPath: '$(Build.ArtifactStagingDirectory)\Packages\ITAutomationProcess'
#folderName: 'ITAutomation'
#environments: 'AutomationRobots' # Optional,
#traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None
Normalmente, a tarefa UiPath Test executa um conjunto de testes existente no Orchestrator. Além disso, você pode usá-la para empacotar, implantar e executar casos de teste, especificando o caminho para um projeto de teste da UiPath. A última opção aparece no Orchestrator como um conjunto de testes transitório.
Depois que a tarefa termina a execução, os resultados do teste são carregados na aba Teste no Azure DevOps. Você pode especificar o caminho de saída dos resultados do teste em um formato JUnit.
Dependendo do resultado, a compilação será marcada como bem-sucedida (todos os casos de teste foram aprovados), ou com falha (pelo menos um caso de teste falhou).
Use a tabela a seguir para configurar as entradas do UiPath Test.
Argumento | Description |
---|---|
Nome da exibição (obrigatório) | Insira um nome para a sua tarefa. |
Escolha um método de execução de teste | Escolha o teste que você deseja executar: Executar conjunto de testes: especifique e execute um conjunto de testes existente no Orchestrator. Executar testes no projeto: especifique um projeto, implante o pacote e execute os casos de teste como parte de um conjunto de testes transitório. |
Conexão do Orchestrator (obrigatório) | Configure the service connection to access UiPath Orchestrator services. You can configure a connection only for this step or use an existing global connection. For more information, refer to Configuring UiPath Orchestrator service connection. |
Parâmetros de entrada | Especifique o caminho do arquivo para um arquivo de entrada JSON, como Input\jobParameters.json . Especifique o argumento type se estiver criando novos argumentos de entrada no nível do conjunto de teste. Caso contrário, você pode usar name e value .
|
Conjunto de testes (obrigatório para o método Executar conjunto de testes) | O nome mostrado para o Conjunto de teste que você deseja executar. Certifique-se de que o Conjunto de teste inclua a versão mais recente dos Casos de teste.
Se o Conjunto de teste não estiver na pasta padrão, certifique-se de incluir o nome da pasta relevante antes dele. Por exemplo, use
AccountingTeam\TestSet .
|
Caminho do projeto de teste (obrigatório para o método Executar testes no projeto) | Especifique a localização do projeto de teste que será executado como parte de um conjunto de testes transitório. |
Ambiente (obrigatório para o método Executar testes no projeto) | Se você usa pastas clássicas (obsoletas), precisa definir o ambiente em que os pacotes serão implantados. Você pode usar esse campo para criar ou atualizar pacotes. Você pode usar o seguinte exemplo para adicionar seus ambientes a esse campo, separados por uma vírgula: testingEnvironment, productionEnvironment .
|
Pasta do Orchestrator (obrigatório) | Especifique a pasta em que o processo está sendo implantado. Para pastas clássicas (obsoletas), você pode usar nomes de robôs específicos. Para as modernas, é possível utilizar nomes específicos de usuários e máquinas.
Para inserir subpastas, certifique-se de inserir o nome da pasta pai e o nome da subpasta. Por exemplo, use
AccountingTeam\TeamJohn .
|
Caminho de saída dos resultados do teste | Especifique o caminho de saída dos resultados do teste no formato JUnit (por exemplo: Output\testResults.json ).
|
Tempo limite | Especifique o número de segundos para aguardar antes que a solicitação expire. |
Nível de trace | Selecione o nível de log da lista suspensa. |
Anexar logs do Robot | Select this option to attach INFO level logs from the executing Robot. By default, this is unselected. For more information, refer to Robot Logs. |
[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]
-- task: UiPathTest@2
inputs:
#testTarget: TestProject # Options: TestProject, TestSet
#orchestratorConnection: # Service connection to UiPath Orchestrator
#testProjectPath: '$(Build.SourcesDirectory)\MobileAutomationTests' # Required only when testTarget = TestProject
#testSet: 'MobileAutomationTests' # Required only when testTarget = TestSet
#folderName: 'MobileAutomationTesting'
#environment: 'TestingRobots' # Required only when testTarget = TestProject and the folder is a classic folder
#testReportDestination: '$(Build.ArtifactStagingDirectory)\report.xml' # Optional
#timeout: 200 # Optional, default = 3600s,
#traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None task: UiPathTest@2
- Visão geral
- Pré-requisitos
- Considerações
- Interface Command-Line
- Armazenando a CLI
- Adição de tarefas da UiPath ao pool do agente de pipeline
- UiPath Run Job
- Configuração
- Pipeline YAML
- UiPath Manage Assets
- Configuração
- Pipeline YAML
- Plataforma de instalação UiPath
- Seletor de versão CLI
- Caminho para o nupkg da CLI
- Pipeline YAML
- UiPath Pack
- Configuração
- Pipeline YAML
- UiPath Deploy
- Configuração
- Pipeline YAML
- UiPath Test
- Configuração
- Pipeline YAML