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:

• Para as instalações por máquina, o caminho padrão é C:\Program Files\UiPath\Studio\.

• Para instalações por usuário, o caminho padrão é %localappdata%\Programs\UiPath\Studio.

  

Alguns comandos podem estar indisponíveis, dependendo de quais sistemas de controle de origem o Studio está conectado (GIT, 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. OrchestratorFolderHierarchy - Se uma pasta de primeiro nível com um feed de pacote separado ou uma de suas subpastas for selecionada no menu de pastas na barra de status do Studio, o feed para essa hierarquia de pastas será exibido.Não disponível para a publicação de bibliotecas ou modelos.
-f, --feed	O URL personalizado para publicar o projeto. Isso também pode ser um diretório local personalizado, semelhante ao caminho na guia Opções de publicação no Studio.
-a, --api-key	A chave de API para publicar o projeto. Esse argumento pode ser usado em relação a um destino personalizado.
-i, --icon	Caminho para o ícone personalizado para usar para o pacote.
-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.
--incl-all-feeds	Não é necessário.
--version-update-type	Especifica como a versão do projeto incrementa: IncrementOnly - A versão do projeto será incrementada automaticamente. ForcePrerelease - A versão do projeto é incrementada e é marcada como pré-lançamento com um sufixo especificado, independentemente de sua versão atual. Se nenhum sufixo for definido com o--prerelease-suffixargumento, o sufixo padrão é alpha. ForceRelease - A versão do projeto é incrementada e é marcada como pronta para lançamento, independentemente de sua versão atual.
--prerelease-suffix	Especifica o sufixo para usar quando o valor--version-update-typeestiver definido como ForcePrerelease.

Observação:

Atualmente, as extensões de certificados .pfx e .p12 são aceitas para assinatura de projetos. Para obter mais detalhes, consulte a página Como assinar pacotes.

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.
  -c, --config-path	O caminho para o arquivo RuleConfig.json. Especifique o caminho apenas se o arquivo de configuração de regras não estiver no local padrão (%LocalAppData%\UiPath\Rules).

Leia a página Sobre o Analisador de Fluxo de Trabalho para saber mais sobre como analisar arquivos/projetos e configurar regras usando parâmetros de linha de comando.

Comandos específicos do GIT

• git clone = Clonar um repositório em um novo diretório.
  Observação:

  Antes da execução de UiPath.Studio.CommandLine.exe git cloneverifique se as credenciais do repositório já estão armazenadas no Gerenciador de Credenciais do Windows. Caso contrário, ocorre um erro de autenticação.

Os seguintes argumentos devem ser usados com o comando git clone:

Argumento	Description
r, --repository	O endereço/a URL do repositório que armazena os projetos que você deseja modificar. O argumento é obrigatório.
-d, --directory	O diretório de trabalho. Se não especificado, o diretório do ambiente atual será usado.

• git commit= Gravar as alterações no repositório. Os seguintes argumentos devem ser usados com o comando git commit:

  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.
  -p, --push	Faça upload das alterações no repositório remoto.
  -d, --directory	O diretório de trabalho. Se não especificado, o diretório do ambiente atual será usado.
  -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.

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	The password required for authentication to the TFS repository.
-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:

• Se o projeto não tiver sido publicado e, consequentemente, não tiver nenhuma dependência instalada, o processo de migração entra em ação e instala os pacotes padrão, detalhados na página Gerenciamento de dependências.
• 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.