studio
2024.10
true
UiPath logo, featuring letters U and I in white
Guia do usuário do Studio
Last updated 18 de nov de 2024

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 atualizar os arquivos project.json de 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 do usuário da linha de comando de Atualização em massa de dependências do projeto está disponível para o Studio Enterprise Edition a partir 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 de usar a interface do usuário da linha de comando da Atualização em massa de dependências do projeto com o TFS, certifique-se de que os projetos que você deseja atualizar estejam desconectados do TFS para o 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 pacotes separado ou uma de suas subpastas estiver selecionada no menu Pastas na barra de status do Studio, o feed para essa hierarquia de pastas. Não disponível para a publicação de bibliotecas ou modelos.

    -f, --feed

    O URL personalizado para publicar o projeto. Este também pode ser um diretório local personalizado, paracido com o 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.

    Observação: atualmente, as extensões de certificados .pfx e .p12 são aceitas para assinatura de projetos. Para obter mais detalhes, confira 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 os 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 de executar o UiPath.Studio.CommandLine.exe git clone, certifique-se de que as credenciais do repositório já estejam 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

    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:

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

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.