Sobre a publicação de projetos de automação

Publicar um projeto de automação quer dizer arquivar a pasta do projeto, de modo que ela possa ser enviada para os Robôs e, então, executada.

Por padrão, todos os arquivos na pasta do projeto são publicados, exceto para casos de teste. Se você quiser impedir um arquivo específico de ser incluído no pacote publicado, clique com o botão direito no painel Projeto, e selecione Ignorar da Publicação (não disponível para arquivos de fluxo de trabalho em projetos de biblioteca). No caso de bibliotecas, para impedir que um arquivo de fluxo de trabalho apareça como um componente reutilizável no painel Atividades quando a biblioteca publicada for instalada em um projeto, clique com o botão direito no painel Projeto, e selecione Tornar Privado.

Você pode publicar os projetos de automação no Orchestrator, um feed personalizado do NuGet ou localmente. Depois de publicar no Orchestrator, o projeto arquivado é exibido na página Pacotes e você pode criar um processo para ser distribuído para os Robôs. Ao publicar um processo de automação no Espaço de Trabalho Pessoal do Orchestrator ou publicar casos de teste, um processo é criado automaticamente caso ainda não exista um e os processos existentes são automaticamente atualizados para a versão mais recente publicada.

Além disso, os projetos de automação podem ser publicados em um feed personalizado do NuGet, com a opção de também adicionar uma chave de API se o feed requer autenticação.

Para publicar projetos localmente você precisa fornecer um caminho na máquina local, diferente do local onde os pacotes do processo são publicados. A partir desse local, mais tarde você poderá enviar manualmente os pacotes para os Robôs para que possam ser executados. A localização padrão da publicação local é %ProgramData%\UiPath\Packages.

Para publicar um projeto, os arquivos project.json e design.json na pasta do projeto não devem estar em um local somente de leitura (por exemplo, se o projeto estiver sob controle de origem, os arquivos devem estar marcados para edição).

Você pode publicar projetos do Studio ou da linha de comando. Para atualizar dependências para vários projetos e publicar todas elas de uma só vez, utilize a Ferramenta para atualização em massa de dependências do projeto.

Observação: outros aplicativos de software podem interferir no processo de publicação se as pastas que começam com um ponto (.) estiverem ocultas e, portanto, ignoradas ao publicar.

Publicação de Projetos a partir do Studio

Para publicar um projeto, selecione Publicar na faixa de opções da guia Design do Studio.

Para publicar um projeto de automação:

1. No Studio, crie um novo projeto.
2. Na aba de faixa de opções Design, clique em Publicar. A janela Publicar se abre. Observe que a barra de título da janela muda conforme o contexto:
   • Publicar Processo ao publicar um processo;
   • Publicar Biblioteca ao publicar um projeto de biblioteca;
   • Publicar Biblioteca de Interface Gráfica ao publicar um projeto de biblioteca de Interface Gráfica;
   • Publicar Casos de teste ao publicar casos de teste.
   • Publicar Modelos durante a publicação de modelos.
3. Na guia Propriedades do Pacote:
   • Insira um nome para o pacote. A lista suspensa tras até cinco dos nomes de pacotes mais recentes que você publicou anteriormente.
   • Na seção Versão, revise a Versão Atual do seu projeto e o tipo da Nova Versão, se necessário. Assinale a caixa É Pré-lançamento para marcar a versão como alpha. Note que isso muda automaticamente o esquema da versão do projeto para semântica. Ao publicar uma nova versão do arquivo localmente, verifique se o local personalizado não inclui um arquivo com o mesmo número de versão proposta. Para obter mais detalhes sobre o controle de versões do projeto, consulte a página Sobre projetos de automação.
   • Opcionalmente, use a opção Ícone do projeto para definir um ícone personalizado para ele. Você pode procurar e selecionar um arquivo ou inserir um caminho ou URL público para um jpeg, jpg ou arquivo png de até 1 MB.

     Após a publicação do projeto, o ícone é exibido da seguinte maneira:

     • Para processos, no Assistant ao lado do nome do processo, facilitando identificá-lo na lista de processos.
     • Para modelos, ao lado do modelo em Início (modo de exibição Backstage do Studio) > Modelos.

     • Para bibliotecas, ao lado do pacote na janela Gerenciar pacotes no Studio.

       Observação: o ícone não ficará visível em Gerenciar pacotes se um arquivo local estiver sendo usado em uma biblioteca publicada no Orchestrator ou em um feed que não seja compatível com ícones incorporados. Nesse caso, especifique o ícone usando uma URL.
   • Na caixa Tags do projeto, você pode adicionar uma ou mais tags ao projeto, quer criando novas tags ou reutilizando aquelas já definidas no Orchestrator. Existem dois tipos de tags: rótulos e propriedades (pares de chave-valor). As tags são incluídas no pacote publicado e ajudam a descrever e categorizar projetos. Por exemplo, elas podem se referir à aplicação automatizada (um rótulo Excel) ou ao departamento (uma propriedade de chave-valor de department:accounting).
     Quando você começa a digitar, são sugeridas combinações possíveis a partir de tags já definidas, e você pode reutilizar uma delas selecionando-a na lista de correspondências. Para uma correspondência de propriedade, a chave seguida pelo caractere : (dois pontos) é exibida primeiro, e os valores associados são exibidos após você selecionar a chave. Para adicionar uma nova tag, clique na entidade com o sinal de mais ao lado do nome depois de inserir o nome. Separar strings com o caractere : (dois pontos) habilita você a adicionar propriedades, enquanto as entradas que não contêm um :adicionam rótulos.
     Os rótulos e propriedades de chave-valor são limitados a 256 caracteres. Nomes de tags não podem conter estes caracteres: <, >, %, &, \, ?, /, :.

     As tags de projeto podem ser aplicadas automaticamente a processos no Orchestrator. Para obter mais informações sobre o uso de tags, consulte Organização de recursos com tags no Guia do Orchestrator.

   • Na caixa de texto Observações de Versão, insira detalhes sobre a versão e outras informações pertinentes. As notas de versão do projeto publicado ficam visíveis na seção Pacotes no Orchestrator. Observe que o campo Notas da Versão aceita um máximo de 10.000 caracteres.

     
     

     

     
     
4. Clique em Avançar.

   Se estiver publicando um modelo, a guia Informações do Modelo se abrirá em seguida (passo 5). Caso contrário, prossiga para o passo 6.

5. (Somente para modelos) Na guia Informações do Modelo, forneça as informações a seguir e, depois, clique em Avançar:
   • Nome ─ O nome do modelo.
   • Descrição - A descrição do modelo na guia Modelos.

   • Nome do Projeto Padrão - Nome do projeto padrão ao se criar um projeto com esse modelo.

     Observação: Evite usar sinais de pontuação, caracteres separadores e caracteres que não são permitidos em nomes de arquivos. Esses caracteres podem ser removidos do nome padrão quando o modelo é usado.

   • Descrição de Projeto Padrão - Descrição padrão ao se criar um projeto com esse modelo.

     
     

     

     
     
6. Na guia Opções de Publicação, selecione onde publicar o projeto. As opções disponíveis dependem do tipo de projeto que estiver publicando:

   • Para processos (incluindo projetos do StudioX):

     • Feed de Processos Tenant do Orchestrator, Feed do Espaço de Trabalho Pessoal do Orchestrator e, se uma pasta de primeiro nível com uma pasta com um feed de pacotes separada ou se as subpastas estiverem selecionadas no menu de status do Studio, o feed dessa hierarquia de pastas. Essas opções ficam disponíveis se o Studio estiver conectado ao Orchestrator. O Feed do Espaço de Trabalho Pessoal do Orchestrator ficará disponível apenas se seu usuário tiver o recurso Espaço de Trabalho Pessoal habilitado no Orchestrator.

       Se o Espaço de Trabalho Pessoal ou uma pasta da hierarquia com um feed de pacotes separado estiver selecionado no Studio, o feed para tal pasta é a opção padrão. Caso contrário, o feed do tenant é a opção padrão. Se você já publicou um projeto na sessão atual, o último local de publicação que você usou é a seleção padrão até você fechar o Studio ou alterar a pasta do Orchestrator na barra de status do Studio.

     • Assistente (Padrões do Robô) - o local padrão do pacote para o Robô e o Assistente, C:\ProgramData\UiPath\Packages. Os projetos publicados aqui aparecem automaticamente no Assistente. A opção não fica disponível se o Studio estiver conectado ao Orchestrator.
     • Personalizado - seja a URL de um feed personalizado do NuGet ou uma pasta local. Adicionar uma Chave de API é opcional.

   • Para casos de teste:

     • As mesmas opções que são disponibilizadas para os processos, exceto o Feed de Espaço de Trabalho Pessoal do Orchestrator.

   • Para bibliotecas e bibliotecas de Interface Gráfica:

     • Feed de Bibliotecas de Tenant do Orchestrator ou Feed de Bibliotecas Compartilhadas do Orchestrator ─ disponíveis se o Studio estiver conectado ao Orchestrator. A opção disponível depende de se o feed de bibliotecas de tenant está habilitada no Orchestrator.
     • Personalizado - seja a URL de um feed personalizado do NuGet ou uma pasta local. Adicionar uma Chave de API é opcional.

   • Para modelos:

     • Feed de Bibliotecas de Tenant do Orchestrator ou Feed de Bibliotecas Compartilhadas do Orchestrator ─ disponíveis se o Studio estiver conectado ao Orchestrator. A opção disponível depende de se o feed de bibliotecas de tenant está habilitada no Orchestrator.
     • Local - O local para publicar modelos localmente, por padrão: C:\Users\User\Documents\UiPath\.templates

     • Personalizado - seja a URL de um feed personalizado do NuGet ou uma pasta local. Adicionar uma Chave de API é opcional.

   Se você estiver publicando uma biblioteca ou qualquer projeto com a compatibilidade do Windows ou multiplataforma, exceto para modelos, as configurações adicionais estão disponíveis na guia Opções de publicação em Configurações de compilação:

   • (Apenas para bibliotecas) Categoria da Raiz das Atividades ─ insira um nome para a categoria sob o qual o componente reusável será listado no painel Atividades.
   • (Apenas para bibliotecas do Windows legado) Compilar expressões de atividades - Selecione essa opção para compilar e empacotar todas as expressões de atividades. Isso resulta em um tempo de execução aprimorado.

   • (Para Windows — somente bibliotecas legadas) Pronto para Executar — selecione essa opção para otimizar os binários gerados para uma compilação JIT mais rápida no runtime.

     Observação: para descobrir o que poderia impedir uma biblioteca de ser publicada com sucesso, leia sobre as limitações ao publicar as bibliotecas.
     
     

     

     
     
7. Clique em Avançar para ir para a guia Assinatura de Certificados ou Publicar para publicar seu projeto.
8. (Opcional) Na guia Assinatura de Certificado , adicione um Caminho do Certificado local, ao lado da caixa Certificado . Além disso, adicione a Senha do Certificado e um Carimbo opcional de data/ hora ao certificado, se necessário. Para obter mais detalhes, confira a página Como Assinar Pacotes .
   
   

   

   
   

   Observação: atualmente, as extensões de certificados .pfx e .p12 são aceitas para assinatura de projetos.
9. Clique em Publicar. Um arquivo NUPKG é criado e carregado no Orchestrator, no feed personalizado do NuGet ou salvo no diretório local. Para bibliotecas, se a opção de Configurações do projeto de Dependências de runtime separadas estiver habilitada, dois arquivos NUPKG são criados: um arquivo é o pacote de tempo de design usado no Studio e o outro é o pacote de runtime usado pelo Robô ao executar a automação. Dependendo do projeto, o pacote contém:
   • Para projetos e processos de modelos com a compatibilidade com o Windows - Legado, os arquivos de origem do projeto.
   • Para bibliotecas ou projetos com a compatibilidade do Windows ou Multiplataforma, arquivos DLL compilados.
10. Se o projeto for publicado com sucesso, a caixa de diálogo Informações será exigida e o projeto copiado para o local do NuGet definido no parâmetro NuGetServerUrl, no arquivo UiPath.settings.

A caixa de diálogo Informações exibe:

• O nome sob o qual o pacote foi publicado.
• O número da versão sob o qual o pacote foi publicado;
• O local onde o projeto foi publicado se ele tiver sido publicado localmente ou no Padrão do Robô. Clique no caminho para acessar o pacote, exceto se o local de publicação for o Orchestrator.
• A opção Detalhes que expande uma lista com os nomes dos arquivos do projeto que foram publicados.

• A opção Copiar para Área de Transferência.

  
  

  

  
  

Informações adicionadas durante a publicação, como o local de publicação persistem na janela, para que possa ser usado em publicações subsequentes para o mesmo tipo de projeto. Sempre que você clica em Publicar, uma nova versão do projeto é criada e enviada para o feed de pacotes. A publicação em um feed seguro pode ser autenticada por meio da Chave do Robô, credenciais do Orchestrator, autenticação do Windows ou chave de API.

Importante: os projetos publicados não devem ser desempacotados.Para fazer alterações, abra o arquivo .xaml inicial no Studio, faça as alterações e publique o projeto novamente.

Publicação de Projetos a partir da Linha de Comando

Você pode publicar projetos usando o comando de publicação UiPath.Studio.CommandLine.exe.

UiPath.Studio.CommandLine.exe está disponível na pasta de instalação:

• Para 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\.

Os argumentos a seguir estão disponíveis para o comando de publicação:

Argumento	Description
-p, --project-path	O caminho para o project.json a ser publicado. O argumento é obrigatório.
-g, --target	Onde publicar o projeto: Personalizado - URL personalizado ou pasta local. Defina o local usando o argumento -f, --feed. Robô - 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 com suas subpastas for selecionada no menu de pastas na barra de status do Studio, o feed dessa hierarquia de pasta. 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 do projeto. Se não ifnromada, a versão será automaticamente aumentada.
-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.
--help	Exibe os argumentos disponíveis para cada comando.
--version	Verifique a versão do UiPath.Studio.CommandLine.exe.

Por exemplo:

• O comando a seguir publica o processo de amostra no feed de processos do tenant do Orchestrator:

  UiPath.Studio.CommandLine.exe publish --project-path "C:\Users\username\Documents\UiPath\Sample\project.json" --target OrchestratorTenant --notes "Alguns bugs corrigidos."

• O seguinte comando publica o mesmo processo em uma pasta local:

  UiPath.Studio.CommandLine.exe publish --project-path "C:\Users\username\Documents\UiPath\Sample\project.json" --target Custom --feed "C:\Users\username\Desktop\myfeed" --notes "Alguns bugs corrigidos."

Para obter mais informações sobre o utilitário CommandLine.exe, consulte Atualização em Massa de Parâmetros da Linha de Comando.