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).

You can publish projects from Studio or from the command line. To update dependencies for multiple projects and publish them all at once, use the Project Dependencies Mass Update Tool.

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.

   • In the Version section, review the Current Version of your project, and type a New Version if needed. Check the Is Prerelease box to mark the version as alpha. Please note that this automatically changes the project’s version schema to semantic. When publishing a new version of the file locally, make sure that the custom location does not already include a file with the same proposed version number. For more details about project versioning, check the About Automation Projects page.

   • 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 será visível em Gerenciar Pacotes se um arquivo local for usado para uma biblioteca publicada no Orchestrator ou em um feed que não seja compatível com ícones incorporados. Nesse caso, especifique o ícone usando um 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 como usar 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):

     • Orchestrator Tenant Processes Feed, Orchestrator Personal Workspace Feed and, if a first-level folder with a separate package feed or one if its subfolders is selected from the folders menu in the Studio status bar, the feed for that folder hierarchy. These options are available if Studio is connected to Orchestrator. The Orchestrator Personal Workspace Feed is available only if your user has the Personal Workspace feature enabled in 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:

   • *(For libraries only)*Activities Root Category - enter a name for the category under which the reusable component will be listed in the Activities panel.

   • *(For Windows-legacy libraries only)*Compile activities expressions - select this option to compile and package all activities expressions. This results in an improved execution time.

   • (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:

     To find out what might prevent a library from being published successfully, read about the limitations when publishing libraries.

     

7. Clique em Avançar para ir para a guia Assinatura de Certificados ou Publicar para publicar seu projeto.

8. (Optional) In the Certificate Signing tab, add a local Certificate Path next to the Certificate box. Furthermore, add the Certificate Password and an optional certificate Timestamper if needed. For more details, check out the Signing Packages page.

   

   Observação:

   Atualmente, as extensões de certificado .pfx e .p12 são aceitas para assinar projetos.

9. Click Publish. A NUPKG file is created and uploaded to Orchestrator, the custom NuGet feed, or saved in the local directory. For libraries, if the Separate Runtime Dependencies Project Settings option is enabled, two NUPKG files are created: one file is the design time package used in Studio and the other file is the runtime package used by the Robot when executing the automation. Depending on the project, the package contains:

   • 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 podem 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 - If a first-level folder with a separate package feed or one if its subfolders is selected from the folders menu in the Studio status bar, the feed for that folder hierarchy. Not available for publishing libraries or templates.
-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.
-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."

For more information about the CommandLine.exe utility, see Mass Update Command Line Parameters.