Implantação de automações unattended

Implantando robôs não assistidos -licença Community

Os robôs não assistidos são usados na automação de tarefas que não exigem supervisão humana, eles geralmente são executados em ambientes virtuais em máquinas dedicadas e as automações são controladas a partir do Orchestrator.

Uma automação não assistida pode ser iniciada manualmente a partir do Orchestrator quando necessário, mas também pode ser agendada se a tarefa tiver que começar em um intervalo específico (diariamente, a cada hora, semanalmente) ou em um horário e data específicos (fim de semana).

This document guides you through the process of running your first unattended automation using the Community licensed version of UiPath^® , starting with building the automation, setting up the environment, and running the unattended process.

Para executar uma automação não assistida, as seguintes etapas precisam ser realizadas:

1. Crie a automação e publique-a no Orchestrator

Para fornecer um exemplo da vida real, vamos supor que precisamos fazer um backup de arquivos de log em um servidor todos os dias às 9h. Para isso, precisamos copiar o arquivo de log desse dia para outra pasta. Neste exemplo, copiamos um arquivo chamado "Logs.txt" da pasta "Logs" para a pasta "Old Logs", substituindo o backup a cada vez.

1. Crie um novo processo, adicione a atividade Copiar arquivo, configure os campos/caminhos para os arquivos e selecione a opção Substituir para que o arquivo recém-copiado possa substituir o arquivo anterior todos os dias.

2. Publique o processo para o Orchestrator.

3. Clique no botão Publicar, à direita da faixa de opções do Studio,

4. Na guia Propriedades de publicação, insira um nome para o pacote.

5. Na guia Opções de publicação, para a opção Publicar em, selecione Feed de processos para tenant do Orchestrator, o local onde robôs não assistidos podem acessar a automação.

6. Click Publish.

   For more information, see About Publishing Automation Projects in the Studio Guide.

7. No Orchestrator, crie o processo que o robô não assistido usa para executar a automação.

8. Acesse sua instância do Automation Cloud em https://cloud.uipath.com, e selecione seu tenant do Orchestrator.

9. No Orchestrator, selecione a Pasta Compartilhada > Processos e clique no botão Mais no lado direito para abrir a página Adicionar processo.

10. Selecione o pacote e clique em Criar para adicionar o processo à Pasta Compartilhada.

    Observação:

    Tenha em mente que você está trabalhando com duas entidades nesse processo. A primeira entidade é você, o desenvolvedor que cria e publica o processo. A segunda é o usuário não assistido que executa a automação e o Robô na máquina não assistida.

2. Configure a máquina Windows para executar o robô não assistido

Set up a Windows machine on which to run the unattended robot, ideally this would be a cloud virtual machine that matches the Hardware and Software Requirements. Make sure that the screen saver is disabled on the Windows machine.

For example, you can host your virtual machine in Azure. For details on how to set up a Windows virtual machine in Azure, see Windows VMs Overview.

Outros ambientes, como AWS, VMware ou Citrix, também são compatíveis se corresponderem aos requisitos de hardware e software.

3. Crie o robô não assistido no Orchestrator

O robô não assistido tem dois componentes: o usuário do Robô e a máquina na qual ele é executado. O usuário do robô é a identidade do robô que fornece permissões e é usado para disparar trabalhos em nome do Robô, enquanto a máquina é aquela que executa a automação.

Os modelos de máquina oferecem uma maneira mais fácil de implantar máquinas, pois uma única chave de máquina pode ser usada por vários Robôs para se conectar ao Orchestrator.

1. Crie o usuário do Robô.

   • No Automation Cloud, acesse Administrador > Usuários e Grupos > Convidar Usuários para convidar o usuário para sua organização e criar um robô não assistido para ele.Um endereço de e-mail fictício pode ser usado para essa etapa.

2. Adicione o usuário à Pasta Compartilhada.

   At this point, the user created in your Organization exists only as an identity with no roles or permissions assigned. Therefore, we need to add it to the Shared Folder to gain access to processes published there and give it the Automation User role:

3. No Orchestrator, selecione a Pasta Compartilhada > Usuários e clique no botão Atribuir usuário ou grupo no lado direito.

4. Selecione o usuário e, em seguida, a função Usuário de automação e clique em Atribuir.

5. Crie o robô não assistido que executa as automações:

6. Volte para a pasta compartilhada e selecione Mais ações > Editar.

7. Selecione Robô não assistido, habilite o alternador para Criar automaticamente um robô não assistido para esse usuário, preencha as credenciais do Windows e clique em Atualizar.

As credenciais do Windows são usadas pelo Robô para permissões e autorização na máquina não assistida ao executar automações.

Observação:

As credenciais que você definir ao criar o Robô no Orchestrator devem corresponder às credenciais da conta do Windows usadas na máquina do robô não assistido. Abra o prompt de comando e use o comando whoami na máquina não assistida para obter essas informações.

4. Crie o modelo de máquinas não assistidas.

Após o usuário robô não assistido ser criado, adicione um novo modelo de máquina com uma licença de runtime não assistido:

1. No Orchestrator, selecione a Pasta Compartilhada > Máquinas e clique no botão Gerenciar modelos de máquinas no lado direito.
2. Clique no botão Mais no lado direito para abrir a página Adicionar máquina.
3. Enter a template name, for example Unattended Machines, assign one unattended runtimes license, and click Provision.
4. Copie a chave da máquina recém-gerada para uso posterior.

4. Install UiPath^® Studio on the unattended machine

In order to run unattended automations on a machine with a Community License, you need to install UiPathStudio.msi on the unattended machine. If you opt for the Quick Setup during installation, the Robot is deployed in User Mode, meaning that it runs under the user that started it, and has the exact rights as that particular user.

O instalador do UiPathStudio.msipode ser baixado da Central de Recursos ou diretamente da página inicial do Automation Cloud.

Para iniciar um trabalho no Orchestrator, o usuário do Windows deve ter feito login na máquina. O Robô de Modo de Usuário não pode executar trabalhos simultâneos em usuários diferentes, independentemente de o Robô estar instalado em um Windows Server ou não.

After downloading the Community version of UiPath^® Studio and Robot, you need to connect it to your Orchestrator instance. For unattended automations, it's recommended to use the Machine Key connection.

5. Conecte o Robô ao Orchestrator

Do Studio

Após a instalação ser concluída, aparecerá para você a tela Começar, que, por padrão solicita que você se autentique. Escolha Usar chave da máquina pois é a configuração recomendada para robôs não assistidos. O nome da máquina é preenchido automaticamente; tudo o que você precisa fazer é digitar o URL do Orchestrator no formulário https://cloud.uipath.com/organisation/tenant, a Chave da máquina que você salvou ao criar o modelo da máquina e clicar em Continuar.

From the UiPath^® Assistant

The connection between the Robot and Orchestrator can also be established from the UiPath^® Assistant by following the steps below:

1. Open the UiPath^® Assistant.

2. No menu Preferências, selecione Preferências.

3. Navegue até Configurações do Orchestrator.

4. No campo Orchestrator URL, insira sua URL do Orchestrator.

5. In the Machine Key field, enter the key you copied earlier when you created the machine template in Orchestrator.

   For details about the differences between machine entities in Orchestrator and when to use each one, see Machines in the Orchestrator Guide.

6. Clique em Conectar. O status deve mostrar Connected, Licensed.

   Observação:

   Ao configurar a máquina, se a configuração for baseada em um ambiente virtual, você pode desconectar a sessão remota, mas certifique-se de deixar o usuário não assistido conectado à máquina, para que a conexão com o Orchestrator permaneça ativa.

6. Teste a automação

1. No Orchestrator, selecione Pasta Compartilhada > Automações > Processos. Procure pelo processo implantado na etapa 1 e clique no botão Iniciar um trabalho no lado direito para abrir a página Iniciar trabalho.

2. Escolha o usuário e a máquina configurados anteriormente e clique em Iniciar.

   Isso inicia o processo não assistido selecionado na máquina selecionada. Você pode monitorar o trabalho na seção Status de trabalhos da Pasta Compartilhada no Orchestrator.

7. Agende a automação

Vamos agendar a automação neste exemplo para ser executada diariamente às 9h:

1. No Orchestrator, selecione Pasta Compartilhada > Gatilhos e clique no botão Adicionar no lado direito para abrir a página Criar gatilhos.
2. Certifique-se de que Tempo esteja selecionado e forneça as informações necessárias: insira um nome para o gatilho, selecione o processo, o usuário e a recorrência diária às 9h.
3. Clique em Adicionar.

Definir o agendamento conforme a captura de tela acima dispara o processo Logs.Backup para ser executado na máquina não assistida em nome do usuário selecionado todos os dias às 9h UTC.

Implantando robôs não assistidos -licença Enterprise

Os robôs não assistidos são usados na automação de tarefas que não exigem supervisão humana, eles geralmente são executados em ambientes virtuais em máquinas dedicadas e as automações são controladas a partir do Orchestrator.

Uma automação não assistida pode ser iniciada manualmente a partir do Orchestrator quando necessário, mas também pode ser agendada se a tarefa tiver que começar em um intervalo específico (diariamente, a cada hora, semanalmente) ou em um horário e data específicos (fim de semana).

This document guides you through the process of running your first unattended automation using the Enterprise Licensed Version of UiPath^® , starting with building the automation, setting up the environment and running the unattended process.

Para executar uma automação não assistida, as seguintes etapas precisam ser realizadas:

1. Crie a automação e publique-a no Orchestrator

Para fornecer um exemplo da vida real, vamos supor que precisamos fazer um backup de arquivos de log em um servidor todos os dias às 9h. Para isso, precisamos copiar o arquivo de log desse dia para outra pasta. Neste exemplo, copiamos um arquivo chamado "Logs.txt" da pasta "Logs" para a pasta "Old Logs", substituindo o backup a cada vez.

1. Crie um novo processo, adicione a atividade Copiar arquivo, configure os campos/caminhos para os arquivos e selecione a opção Substituir para que o arquivo recém-copiado possa substituir o arquivo anterior todos os dias.

2. Publique o processo para o Orchestrator.

3. Clique no botão Publicar, à direita da faixa de opções do Studio,

4. Na guia Propriedades de publicação, insira um nome para o pacote.

5. Na guia Opções de publicação, para a opção Publicar em, selecione Feed de processos para tenant do Orchestrator, o local onde robôs não assistidos podem acessar a automação.

6. Click Publish.

   For more information, see About Publishing Automation Projects in the Studio Guide.

7. No Orchestrator, crie o processo que o robô não assistido usa para executar a automação.

8. Acesse sua instância do Automation Cloud em https://cloud.uipath.com, e selecione seu tenant do Orchestrator.

9. No Orchestrator, selecione a Pasta Compartilhada > Processos e clique no botão Mais no lado direito para abrir a página Adicionar processo.

10. Selecione o pacote e clique em Criar para adicionar o processo à Pasta Compartilhada.

    Observação:

    Tenha em mente que você está trabalhando com duas entidades nesse processo. A primeira entidade é você, o desenvolvedor que cria e publica o processo. A segunda é o usuário não assistido que executa a automação e o Robô na máquina não assistida.

2. Configure a máquina Windows para executar o robô não assistido

Set up a Windows Machine that runs the Unattended Robot, ideally this would be a cloud virtual machine. Make sure that its screen saver functionality is disabled and matches the Hardware and Software Technical Requirements.

For example, you can host your virtual machine on Azure, see the Windows VMs Overview document for details on how to set up a Windows Virtual Machine in Azure.

Outros ambientes, como AWS, VMWare ou Citrix, também são suportados se corresponderem aos requisitos técnicos de hardware e software.

3.Crie o robô não assistido no Orchestrator

O Robô não assistido tem dois componentes: o usuário do Robô e a máquina na qual ele é executado. O usuário do robô é a identidade do robô que fornece permissões e é usado para disparar trabalhos em nome do Robô, enquanto a máquina é aquela que executa a automação.

Os modelos de máquina oferecem uma maneira mais fácil de implantar máquinas, pois uma única chave de máquina pode ser usada por vários Robôs para se conectar ao Orchestrator.

1. Crie o usuário do Robô.

   • No Automation Cloud, acesse Administrador > Usuários e Grupos > Convidar Usuários para convidar o usuário para sua organização e criar um robô não assistido para ele.Um endereço de e-mail fictício pode ser usado para essa etapa.

2. Adicione o usuário à Pasta Compartilhada.

   At this point, the user created in your Organization exists only as an identity with no roles or permissions assigned. Therefore, we need to add it to the Shared Folder to gain access to processes published there and give it the Robot role:

3. No Orchestrator, selecione a Pasta Compartilhada > Usuários e clique no botão Atribuir usuário ou grupo no lado direito.

4. Selecione o usuário, depois a função Robot e clique em Atribuir.

5. Crie o robô não assistido que executa as automações:

6. Volte para a pasta compartilhada e selecione Mais ações > Editar.

7. Selecione Robô não assistido, habilite o alternador para Criar automaticamente um robô não assistido para esse usuário, preencha as credenciais do Windows e clique em Atualizar.

As credenciais do Windows são usadas pelo Robô para permissões e autorização na máquina não assistida ao executar automações. Quando a versão Enterprise (.MSI) é implantada, essas credenciais são usadas para criar sessões do Windows na máquina não assistida para executar automações.

Observação:

As credenciais que você definir ao criar o Robô no Orchestrator devem corresponder às credenciais da conta do Windows usadas na máquina do Robô não assistido. Abra o prompt de comando e use o comando whoami na máquina não assistida para obter essas informações. Essas credenciais são usadas para criar sessões do Windows na máquina não assistida para executar automações.

4. Crie o modelo de máquinas não assistidas.

Após o usuário robô não assistido ser criado, adicione um novo modelo de máquina com uma licença de runtime não assistido:

1. No Orchestrator, selecione a Pasta Compartilhada > Máquinas e clique no botão Gerenciar modelos de máquinas no lado direito.
2. Clique no botão Mais no lado direito para abrir a página Adicionar máquina.
3. Enter a template name, for example Unattended Machines, assign one unattended runtimes license, and click Provision.
4. Copie a chave da máquina recém-gerada para uso posterior.

4. Install the UiPath^® Studio Enterprise (.MSI) on the Unattended machine

The UiPathStudio.msi installer is used for installing Studio, the UiPath^® Assistant or the legacy Robot on your machine. Using the .MSI installer, the Robot is deployed in Service-Mode by default, meaning that it is available to all users on the machine. For running the installer administrator rights are needed.

O instalador do UiPathStudio.msipode ser baixado da Central de Recursos ou diretamente da página inicial do Automation Cloud.

Por padrão, Robot e Studio são instalados no seguinte local - C:\Program Files \UiPath\Studio. Você pode alterar o local de instalação fazendo uso de argumentos de linha de comando ou da interface do instalador.

Interface do Instalador

1. Clique duas vezes no instalador para iniciar o assistente de instalação.

2. Read and accept the Terms of use, and then click Install.

   Please note that by accepting the aforementioned terms of use, you implicitly accept the terms of use of UiPath^® activity packages and their dependencies.

3. Selecione os produtos a serem instalados:

   • Install UiPath^® Studio + Robot - Installs UiPath^® Studio, Assistant, and the Robot for creating and testing automations.
   • Install UiPath^® Robot Only - Installs UiPath^® Assistant and the user-mode Robot for running attended automations.

4. Selecione o tipo de instalação:

   • Modo de Serviço - Instala o Robô no modo de serviço
   • Modo de Usuário - Instala o Robô no modo de usuário

Para obter mais detalhes sobre como usar o instalador .MSI, leia o guia Instalação do UiPathStudio.msi.

5. Conectando o Robô ao Orchestrator

Observação:

If during the installation process you choose to only install the Robot, the connection to Orchestrator can only be configured From the Command Line Interface (admin rights are needed) or from the UiPath^® Assistant . Otherwise, you can connect your Robot either from Studio or from the UiPath^® Assistant.

Do Studio

Após a instalação ser concluída, você é apresentado à tela Conectar ao Orchestrator, que, por padrão, solicita que você use Usar a chave da máquina, já que é a configuração recomendada para robôs não assistidos. O nome da máquina é obtido automaticamente; tudo que você precisa fazer é digitar a URL do Orchestrator e a chave da máquina que você salvou anteriormente.

Observação:

Usando o instalador do .MSI, ao conectar o Robô ao Orchestrator, toda a máquina se conecta, não apenas o usuário que está logado na máquina.

From the UiPath^® Assistant

1. Open UiPath^® Assistant
2. No menu Preferências, selecione Preferências. A janela Preferências é exibida.
3. Navegue até Configurações do Orchestrator.
4. No campo Orchestrator URL, insira o endereço web do Orchestrator.
5. No campo Machine Key, insira a chave que você copiou anteriormente.

Click here for details about the different machine entities in Orchestrator and when to use each.

1. Clique em Conectar. O status deve mostrar Connected, Licensed

   Observação:

   Ao configurar a máquina usando o instalador do Enterprise (.MSI), você pode sair da máquina, pois o Robô pode criar sua própria sessão do Windows usando as credenciais fornecidas na Etapa 3.

6. Teste a automação

Para testar a automação no Robô não assistido, acesse a seção Automações -> Processos da Pasta Compartilhada no Orchestrator e procure o processo implantado na etapa 1.

Você pode ver os detalhes do processo e, no lado direito, há o botão Iniciar trabalho.

Quando clicado, você é apresentado à interface Iniciar trabalho; escolha o usuário e a máquina configurados anteriormente e clique em Iniciar.

Isso inicia o processo não assistido selecionado na máquina selecionada e pode ser monitorado na seção Trabalhos da Pasta Compartilhada no Orchestrator.

7. Agende a automação

Para o exemplo fornecido neste guia, podemos agendá-lo para ser executado diariamente às 9h. Isso é configurado na Seção Gatilho da Pasta Compartilhada no Orchestrator.

Definir o agendamento conforme a captura de tela acima dispara o processo Logs.Backup para ser executado na máquina não assistida em nome do usuário selecionado todos os dias às 9h UTC.