Parâmetros de linha de comando de atualização em massa

A interface de usuário da linha de comando Atualização em massa das dependências do projeto pode ser usada para fazer a atualização em massa dos arquivos project.json que pertencem a vários projetos de automação. Isso permite adicionar ou remover dependências, alterar as versões do pacote e regras de runtime e assinar processos ou bibliotecas antes de publicá-los.

Observe que, ao usar a Ferramenta de Atualização em Massa das Dependências do Projeto, você aceita implicitamente os termos de licença de cada versão do pacote que você atualiza.

Observação:

A interface de usuário da linha de comando da Atualização em Massa das Dependências do Projeto está disponível para o Studio Enterprise Edition a partir da versão do Studio v2018.4.4.

UiPath.Studio.CommandLine.exe está disponível na pasta de instalação. Por padrão, o caminho para o Instalador do Windows (.msi) do Studio é C:\Program Files (x86)\UiPath\Studio\.

O caminho padrão para o Studio instalado com o instalador da versão Community Edition (.exe) é o seguinte: %LocalAppData%\UiPath\[Studio_version]\.

Alguns comandos podem estar indisponíveis, dependendo dos sistemas de controle de origem aos quais o Studio está conectado (SVN ou TFS). Para visualizar os argumentos específicos para cada comando basta usar o --help. Use --version para verificar a versão do UiPath.Studio.CommandLine.exe.

É possível usar combinações de vários comandos em uma única linha de comando. Além disso, certos argumentos não precisam ser repetidos na mesma linha de comando, por exemplo, r, --repository quando usado com svn login e svn checkout.

Observação:

Antes usar a interface de usuário da linha de comando Atualização em Massa das Dependências do Projeto com TFS, verifique se os projetos que deseja atualizar estão desconectados do TFS em relação ao usuário atual.

É recomendável salvar e fechar os projetos do Studio, antes de fazer alterações neles usando a Ferramenta de Atualização em Massa das Dependências do Projeto.

Comandos para atualizar arquivos locais

• list - Encontrar e exibir os caminhos para os arquivos project.json armazenados em um determinado diretório. Também ó possível listar os projetos de uma unidade de rede local. Os seguintes argumentos devem ser usados com o comando list.

  Argumento	Description
  -d, --directory	O diretório que armazena os arquivos que você deseja listar. Use os argumentos -u, --user e -p, --pass para os diretórios remotos protegidos por senha.

  Observação:

  Se o argumento --directory não for usado com o comando list, os caminhos para todos os arquivos project.json do diretório de trabalho atual serão exibidos.

• manage - gerencie o projeto especificado. Observe que é possível adicionar ou remover várias dependências e regras, desde que estejam separadas por espaços em branco. Os seguintes argumentos devem ser usados com o comando manage.

  Argumento	Description
  -a, --add-ref	Adiciona ou atualiza a regra de dependência e runtime para o arquivo project.json. ”dependencyname|version|runtimerule” = adiciona ou atualiza a versão da dependência e a regra de runtime. ”dependencyname|prereleaseversion|runtimerule” = adiciona a versão pré-lançada da dependência e a regra de runtime especificada.
  r, --rem-ref	Remove as dependências especificadas do arquivo project.json. "dependencyname" - a dependência a ser removida do projeto, independentemente de sua versão. "dependencyname|version" - remove a dependência com essa versão específica, independentemente de ser ou não uma versão de pré-lançamento.
  -p, --project-path	O caminho para o arquivo project.json.

  Observação:

  A sintaxe das regras de runtime é lowest para Menor Versão Aplicável e strict para a versão Estrita. Se nenhum desses dois parâmetros for mencionado, a Menor Versão Aplicável, será aplicada por padrão.

Por exemplo, o seguinte comando manage --project-path "C:\Users\username\Documents\UiPath\BlankProcess\project.json" --add-ref "UiPath.Excel.Activities|2.6.2|lowest" altera a versão do pacote para 2.6.2 e a regra de runtime para a Menor Versão Aplicável.

• publish - Publicar o projeto com as alterações feitas às dependências. Os seguintes argumentos devem ser usados com o comando publish.

  Argumento	Description
  -p, --project-path	O caminho para o project.json a publicar. O argumento é obrigatório.
  -g, --target	Onde publicar o projeto: Custom - URL personalizada ou pasta local. Definir o local com o argumento -f, --feed. Robot - Local de publicação padrão do robô, se não estiver conectado ao Orchestrator. Não disponível para a publicação de bibliotecas ou modelos. OrchestratorTenant - Feed de processos de tenant do Orchestrator (para processos e casos de teste) ou o Feed de bibliotecas do Orchestrator (para bibliotecas e modelos). OrchestratorPersonalFolder - Feed do Espaço de Trabalho Pessoal do Orchestrator. Indisponível para publicação de bibliotecas, modelos ou casos de teste.
  -f, --feed	The custom URL for publishing the project. This can also be a custom local directory, similar to the path in the Publish options tab in Studio.
  -a, --api-key	A chave de API para publicar o projeto. Esse argumento pode ser usado em relação a um destino personalizado.
  -n, --notes	As notas de versão que contêm alterações feitas no projeto.
  -v, --new-version	A nova versão para o projeto.
  -t, --timeout	Especifica o valor do tempo limite para publicar projetos. O tempo limite padrão é de 30 segundos. Essa configuração se aplica somente em relação à transferência do pacote para a duração do Orchestrator.
  --cer-path	Caminho local até o certificado para assinatura do pacote.
  --cer-password	A senha do certificado.
  --timestamper-url	A URL para o carimbador de data/hora.

  Observação:

  Currently .pfx and .p12 certificate extensions are accepted for signing projects. For more details, check out the Signing Packages page.

Baseando-se no exemplo acima, o comando a seguir atualiza o pacote UiPath.Excel.Activities para a versão 2.6.2. altera a regra de runtime para a Menor Versão Aplicável, adiciona notas de versão e uma versão nova, publicando o projeto em um local personalizado:

manage --project-path "C:\Users\username\Documents\UiPath\BlankProcess\project.json" --add-ref "UiPath.Excel.Activities|2.6.2|lowest" publish --project-path "C:\Users\username\Documents\UiPath\BlankProcess\project.json" --target Custom --feed "C:\Users\username\Desktop\myfeed" --notes "Changes were made to the Excel package" --new-version "1.0.2".

Comandos do Analisador de Fluxo de Trabalho

É possível usar os parâmetros da linha de comando para analisar arquivos ou projetos em relação a um conjunto de regras.

• analyze – Analisa o projeto completo. Requer o caminho para o arquivo project.json.

• analyze-file – Analisa um único arquivo. Requer o caminho para o arquivo .xaml.

  Argumento	Description
  -p, --project-path	Para analisar um arquivo, forneça o caminho para o .xaml. Para analisar o projeto completo, especifique o caminho para o arquivo project.json.

Read the About Workflow Analyzer page to find out more about how to analyze files/projects and configure rules using command-line parameters.

Comandos específicos do SVN

• svn login = Use credenciais para fazer login em um respositório de SVN determinado. Os seguintes argumentos devem ser usados com o comando svn login.

  Argumento	Description
  r, --repository	O endereço/a URL do repositório que armazena os projetos que você deseja modificar. O argumento é obrigatório.
  -p, --password	A senha exigida para autenticação no repositório SVN.
  -s, --password-stdin	Lê a senha de autenticação de entrada padrão (STDIN). Você é solicitado a digitar a senha para o repositório desejado.
  u, --user	O nome de usuário exigido para autenticação.

• svn checkout = Faça check-out dos projetos de um repositório de SVN. Os seguintes argumentos devem ser usados com o comando svn checkout.

  Argumento	Description
  -d, --directory	A pasta de check-out do destino dos arquivos. O argumento é obrigatório.
  -r, --repository	O endereço do repositório que armazena os arquivos que deseja verificar. O argumento é obrigatório.

• svn edit = Desbloqueie um ou vários projetos, disponibilizando-os para edição. Os seguintes argumentos devem ser usados com o comando svn edit.

  Argumento	Description
  -f, --files	Os caminhos dos arquivos que deseja editar. Os caminhos devem estar relacionados ao diretório de trabalho e separados por ponto e vírgula. O argumento é obrigatório.
  -d, --directory	O diretório de trabalho com os arquivos que deseja editar. Se não for especificado um diretório de trabalho , o diretório do ambiente atual será usado.

• svn checkin = Verificação de entrada das alterações feitas aos projetos de automação. Os seguintes argumentos devem ser usados com o comando svn checkin.

  Argumento	Description
  -m, --message	Grave uma mensagem de confirmação para detalhar as alterações feitas nos projetos. A mensagem de confirmação é obrigatória.
  -d, --directory	O diretório de trabalho em que os projetos estão sendo submetidos a check-in. Se não for especificado um diretório de trabalho , o diretório do ambiente atual será usado.
  -f, --files	Os caminhos dos arquivos que você editou. Os caminhos devem estar relacionados ao diretório de trabalho e separados por ponto e vírgula.

Comandos específicos do TFS

• tfs login = Use credenciais para fazer login em um repositório de TFS determinado. Os seguintes argumentos devem ser usados com o comando tfs login.

  Argumento	Description
  -t, --type	Método de login para o repositório do TFS: ntlm = autenticação por meio do protocolo NT LAN Manager em um repositório TFS local. token = autenticação com um token pessoal de acesso, habilitado no repositório TFS. basic = autenticação básica em um repositório TFS seguro.
  -p, --password	A senha exigida para autenticação no repositório SVN.
  -s, --password-stdin	Lê a senha de autenticação de entrada padrão (STDIN). Você é solicitado a digitar a senha para o repositório desejado.
  u, --user	O nome de usuário exigido para autenticação.
  -c, --collection	Refere-se ao URI da coleção. O argumento é obrigatório.

• tfs checkout = Fazer check-out dos projetos de um repositório de TFS. Os seguintes argumentos devem ser usados com o comando tfs checkout.

  Argumento	Description
  -c, --collection	Especifique o URI da coleção.
  -d, --directory	A pasta de check-out do destino dos arquivos. O argumento é obrigatório.
  -r, --remotedir	O caminho para o diretório do projeto relacionado à raiz da coleção. Ele começa com $/, sendo precedido pelo URI da coleção.

• tfs edit - desbloqueie um ou vários projetos e disponibilize-os para edição. Os seguintes argumentos devem ser usados com o comando tfs edit.

  Argumento	Description
  -f, --files	Os caminhos dos arquivos que deseja editar. Os caminhos devem estar relacionados ao diretório de trabalho e separados por ponto e vírgula.
  -d, --directory	O diretório de trabalho com os arquivos que deseja editar. Se não for especificado um diretório de trabalho , o diretório do ambiente atual será usado.

• tfs checkin - Verifique as alterações feitas aos projetos de automação. Os seguintes argumentos devem ser usados com o comando tfs checkin.

  Argumento	Description
  -m, --message	Grave uma mensagem de confirmação para detalhar as alterações feitas nos projetos. A mensagem de confirmação é obrigatória.
  -d, --directory	O diretório de trabalho em que os projetos estão sendo submetidos a check-in. Se não for especificado um diretório de trabalho , o diretório do ambiente atual será usado.
  -f, --files	Os caminhos dos arquivos que você editou. Os caminhos devem estar relacionados ao diretório de trabalho e separados por ponto e vírgula.

Atualização de Projetos de Automação Antigos

Ao instalar uma dependência usando a interface de usuário da linha de comando em uma versão do Studio anterior à v2018.3, considere as seguintes particularidades:

• If the project was not published and consequently, it doesn’t have any installed dependencies, the migration process steps in and installs the default packages, detailed in the Managing Dependencies page.
• Se o projeto tiver sido criado e publicado com uma versão do Studio anterior à v2018.3, o pacote UiPath.Core.Activitiesserá migrado para UiPath.System.Activities e UiPath.UIAutomation.Activities.