Usando o Gerenciador de dados

O painel Data Manager permite que você gerencie vários tipos de dados em seu projeto de automação. Esses dados incluem:

• Variáveis - Armazene dados de diferentes tipos e passe-os entre atividades em um projeto.
• Argumentos - Armazenam dados de diferentes tipos e os passam entre fluxos de trabalho e apps.
• Recursos — recursos e atividades do Excel que adicionam arquivos, contas de e-mail, aplicativos ou navegadores ao projeto.

• Os seguintes recursos do Orchestrator, desde que o Robot esteja conectado ao Orchestrator.

  • Processos - Um processo representa uma versão de pacote vinculada a uma pasta específica. Quando você implanta um processo novo, ele fica disponível para todas as contas que tenham acesso a essa pasta do Orchestrator.
  • Ativos - Ativos geralmente representam variáveis ou credenciais compartilhadas que podem ser usadas em diferentes projetos de automação. Eles permitem que você armazene informações específicas, para que os robôs possam acessá-las com facilidade.
  • Filas - Contêiner que permite que você mantenha um número ilimitado de itens. Os itens da fila podem armazenar vários tipos de dados, tais como informações sobre fatura ou detalhes do cliente e permitir que você crie grandes projetos de automação com uma lógica complexa subjacente.
• Conexões - Links entre sua automação e aplicativos externos.

Opções do menu

• Criar - Contém as opções para criar uma nova Variável, Argumento e um novo recurso do Excel.
• Expandir todas - Expande todas as categorias no Data Manager.
• Recolher todas - Recolhe todas as categorias no Data Manager.
• Atualizar - Atualiza o Data Manager e recarrega os dados para ele. As categorias podem ser atualizadas independentemente. Um ícone de carregamento é exibido ao lado de cada categoria durante o carregamento. Os recursos são desativados durante o carregamento e ficam disponíveis após a conclusão do carregamento.
• Agrupar itens por escopo - Agrupa suas variáveis no painel, dependendo do escopo atribuído a elas.
• Sincronizar com escopo ativo - Quando um escopo ativo está em foco, por exemplo, uma atividade Usar arquivo Excel é selecionada, apenas exibe as variáveis com o escopo correspondente para elas.
• Classificar elementos de seções - Permite classificar os dados selecionando uma das opções disponíveis: Padrão, Nome A-Z, Nome Z-A.
• Filtros de Gerenciamento de Dados - Permite que você selecione quais dados estarão visíveis no painel.

Variáveis

Criação e gerenciamento de variáveis

1. No Data Manager, selecione Criar > Variável.

2. Indique o nome, o tipo de dados, o escopo e o valor padrão para a variável.

   O escopo pode ser definido como Principal (disponível em todo o projeto) ou para qualquer atividade de contêiner dentro do projeto. O valor padrão é Principal.

   Observação: o escopo de uma variável determina a área no fluxo de trabalho na qual ela pode ser usada. Por exemplo, ter o escopo definido como Mainpermite que a variável seja usada em todo o projeto, enquanto ter uma atividade de contêiner definida como um escopo disponibiliza a variável apenas dentro daquela atividade de contêiner e das atividades adicionadas dentro dela.

Ou então, você pode criar variáveis diretamente a partir do painel usando a opção Na linha ou a partir da atividade Set Variable Value.

Criação de variáveis em massa

Para criar várias variáveis de uma vez, clique com o botão direito do mouse em Variáveis no Data Manager e, então, selecione Criar variáveis em massa. Na janela Painel de Variáveis, clique em Novo e adicione os detalhes para cada variável que você deseja adicionar.

Editando uma variável

1. Abra o painel Data Manager.
2. Expanda o nó Variáveis e, então, o nó da variável.

3. Edite qualquer um dos seguintes: nome, tipo de dado, escopo e valor padrão.

   
   

   

   
   

Excluindo uma variável

1. Abra o painel Data Manager.
2. Expanda o nó Variáveis e, então, clique com o botão direito do mouse em uma variável e selecione Excluir variável.

Ou então, selecione a variável e pressione Delete em seu teclado.

Convertendo uma variável em um argumento

1. Abra o painel Data Manager.
2. Em Variáveis, clique com o botão direito do mouse em uma variável para abrir o menu de contexto.
3. Selecione Converter para argumento.

O argumento recém-convertido pode ser encontrado na seção Argumentos do painel.

Encontrar todas as referências para uma variável

1. Abra o painel Data Manager.
2. Em Variáveis, clique com o botão direito do mouse em uma variável para abrir o menu de contexto.

3. Selecionar Localizar referências.

   O painel Encontrar referências é aberto e exibe todas as referências à variável no projeto.

Argumentos

Criação e gerenciamento de argumentos

1. No Data Manager, selecione Criar > Argumento.

2. Indique o nome, direção, tipo de dados, se é obrigatório e o valor padrão.

   Por padrão, todos os novos argumentos são do tipo String e têm uma direção de Entrada.

Ou então, você pode criar argumentos diretamente a partir do painel usando a opção Em linha.

Criação de argumentos em massa

Para criar várias variáveis de uma vez, clique com o botão direito do mouse em Argumentos no Data Manager e, então, selecione Criar argumentos em massa. Na janela Argumentos, clique em Novo e adicione os detalhes para cada argumento que você deseja adicionar.

Edição de um argumento

1. Abra o painel Data Manager.
2. Expandir o nó de argumentos e depois o nó do argumento.

3. Edite qualquer uma das seguintes opções: nome, direção, tipo de dados, se é necessário ou não, valor padrão.

   
   

   

   
   

Removendo Argumentos

1. Abra o painel Data Manager.
2. Em Argumentos, clique com o botão direito do mouse em um argumento para abrir o menu de contexto.
3. Selecione Excluir.

Ou então, selecione o argumento e pressione Delete em seu teclado.

Conversão de um argumento em uma variável

1. Abra o painel Data Manager.
2. Em Argumentos, clique com o botão direito do mouse em um argumento para abrir o menu de contexto.
3. Selecionar Converter para Variável.

A variável recém-convertida pode ser encontrada na seção Variáveis do painel.

Encontrando todas as referências para um argumento

1. Abra o painel Data Manager.
2. Em Argumentos, clique com o botão direito do mouse em um argumento para abrir o menu de contexto.

3. Selecionar Localizar referências.

   O painel Encontrar referências abre e exibe todas as referências ao argumento no projeto.

Copiar e colar argumentos e variáveis

Você pode copiar e colar argumentos ou variáveis dentro da tarefa. Clique com o botão direito do mouse em uma variável ou argumento e selecione Copiar. Para colá-la, clique com o botão direito do mouse no painel Data Manager e selecione Colar.

Quando uma variável ou argumento com o mesmo nome já existe, um número é adicionado ao nome do duplicado. Por exemplo, se uma variável com o nome número já existe, a variável copiada será renomeada número_1.

Ou então, você pode usar os atalhos do teclado CTRL + C e CTRL + V para copiar e colar variáveis e argumentos.

Gerenciamento de anotações em variáveis e argumentos

Você pode adicionar anotações às suas variáveis e ao seu argumento para dar contexto ou apenas para acompanhar melhor a finalidade e os conteúdos dessas variáveis e argumentos.

Para adicionar uma anotação:

1. Abra o painel Data Manager.
2. Clique com o botão direito do mouse em um argumento ou variável para abrir o menu de contexto.
3. Selecione Adicionar anotação.

4. Digite o texto e clique no ícone do pino.

   Observação:

   • As anotações fixadas são exibidas sob a variável ou argumento no painel quando expandidas.
   • Os argumentos e variáveis com anotações não fixadas têm um ícone exibido ao lado deles.
   • O status fixado das anotações é salvo quando o projeto é fechado ou publicado como um modelo.
   
   

   

   
   

Para editar ou remover anotações, clique com o botão direito do mouse em um argumento ou variável e selecione Editar anotação ou Remover anotação.

Alternativamente, você pode editar anotações fixadas clicando nelas no painel e alterando o texto.

Observação: Você pode ordenar variáveis e argumentos livremente arrastando e soltando-os. Este recurso é desabilitado quando você seleciona a opção Agrupar itens por escopo.

Recursos

Nos projetos Windows - legado e Windows, você pode expandir o nó Recursos no Data Manager para visualizar e gerenciar os seguintes recursos no arquivo de projeto atual:

• Aplicativos e navegadores adicionados nas atividades Use Application/Browser.
• Documentos do Word adicionados às atividades Use Word File.
• Apresentações do PowerPoint adicionadas nas atividades Use PowerPoint Presentation.
• Contas de email adicionadas nas atividades Use Desktop Outlook, Use Outlook 365 e Use Gmail.
• Arquivos do Excel adicionados à automação:
  • Arquivos adicionados às atividades Use Excel File ou do Data Manager, usando a opção Conectar ao novo arquivo do Excel para uso com as atividades modernas padrão do Excel disponíveis no StudioX.
  • Arquivos adicionados do Data Manager usando a opção Conectar a novo arquivo da pasta de trabalho para uso com atividades de pasta de trabalho disponíveis no painel de atividades na categoria Desenvolvedor.
  • O notebook do projeto.

  Para obter mais informações, consulte Como adicionar um arquivo do Excel a uma Automação.

Conexão a um arquivo do Excel (atividades modernas do Excel)

Para conectar-se a um arquivo do Excel e usá-lo com as atividades modernas padrão disponíveis no StudioX:

1. Na parte superior do painel do Data Manager, selecione Mais > Conectar a um novo arquivo do Excel.

2. Na janela Gerenciador de Recursos, forneça as seguintes informações e clique em OK:

   • Selecione o arquivo do Excel - Clique em Procurar próximo ao campo e busque e selecione o arquivo do Excel a ser adicionado à automação.
   • E forneça um nome para depois — digite o nome pelo qual se referir ao arquivo no projeto de automação (por padrão, o nome do arquivo).

   • Save changes (Salvar Alterações) - Selecione esta opção se você quiser que o arquivo seja salvo no fim da automação. Caso contrário, o arquivo retornará ao estado inicial após a execução do projeto. Esta opção é selecionada por padrão.

     Quando a opção de salvar alterações estiver desabilitada, a mensagem salvamento desabilitado será exibida próximo às entradas de recurso do Excel no menu Mais e no painel Gerenciador de Dados.

   • Somente leitura - Selecione esta opção se você quiser abrir o arquivo no modo somente leitura. Isso possibilita operações de extração de dados em um arquivo bloqueado para edições ou que exija senha para ser editado. Esta opção não está selecionada por padrão.

   • Formatação de leitura — selecione a formatação de leitura para o arquivo:

     • Padrão - Use a formatação padrão retornada pelo Excel.
     • RawValue - Use os valores brutos e ignore toda a formatação.
     • ValorDeExibição - Recupere os valores conforme exibidos no Excel.
   • Escopo - Selecione o escopo do recurso. Por padrão, o escopo é definido como o contêiner principal. Para otimizar o desempenho, defina o escopo para o contêiner mais próximo de onde as atividades que usam o recurso são colocadas no fluxo de trabalho.

Conexão a um arquivo Excel (atividades de pasta de trabalho)

Observação: as atividades da pasta de trabalho estarão disponíveis apenas se o filtro do Desenvolvedor for selecionado no painel Atividades.

Em projetos nos quais você usa várias atividades da pasta de trabalho com o mesmo arquivo grande do Excel, é possível obter o melhor desempenho do runtime conectando-se ao arquivo Excel a partir do Data Manager para adicioná-lo como um recurso. Isso garante que o arquivo seja carregado na memória uma vez para todas as atividades no runtime. Se você optar por fornecer o caminho para o arquivo Excel em cada atividade de pasta de trabalho, o arquivo será carregado na memória para cada atividade.

Para adicionar uma pasta de trabalho do Excel como um recurso:

1. Na parte superior do Data Manager, selecione Mais > Conectar a um novo arquivo de pasta de trabalho. A janela Gerenciar recursos é exibida.
2. Configure o recurso:
   • Selecionar arquivo Excel - Navegue e selecione o arquivo Excel.
   • E dê um nome para depois - Digite o nome pelo qual se referir ao arquivo nas atividades de pasta de trabalho (por padrão, o nome do arquivo). Este é o nome da opção que estará disponível no menu Mais da propriedade Pasta de trabalho, permitindo fazer referência ao arquivo da pasta de trabalho.
   • Senha - Digite a senha do arquivo, se aplicável.
   • Escopo - Selecione o escopo do recurso. Por padrão, o escopo é definido como o contêiner principal. Para otimizar o desempenho, defina o escopo para o contêiner mais próximo de onde as atividades que usam o recurso são colocadas no fluxo de trabalho.

Depois que o recurso for criado, você poderá editar sua configuração clicando com o botão direito do mouse no Data Manager e selecionando Configurar. Você pode fazer referência ao recurso em diversas atividades de pasta de trabalho selecionando o recurso no menu Mais.

Gerenciamento de recursos

Para ir para a atividade onde um recurso está definido no projeto, dê um duplo clique no recurso no Data Manager.

Para gerenciar um recurso do Data Manager, clique com o botão direito no recurso e selecione uma das opções no menu de contexto:

• Abrir - Abre um arquivo do Excel, PowerPoint ou Word adicionado como um recurso.
• Abrir local do arquivo - Abre a pasta que contém um arquivo do Excel, PowerPoint ou Word adicionado como um recurso.

  Esta opção não está disponível ao trabalhar com arquivos remotos (por exemplo, SharePoint).

• Configurar - Abre a janela Gerenciar recurso, onde você pode editar as propriedades de um recurso do Excel.
• Excluir - Remove o recurso do projeto.

Processos, Ativos e Filas

O Data Manager exibe recursos do Orchestrator (processos, ativos e filas) disponíveis na pasta do Orchestrator selecionada atualmente. O painel exibe recursos tanto de pastas clássicas quanto modernas. Leia mais sobre pastas.

Se o Robot conectado ao Orchestrator for do tipo Padrão, então o painel Data Manager poderá exibir apenas a pasta clássica que provisionou esse Robot. Se o Robô estiver no modo Flutuante, o painel exibirá todas as pastas Clássicas e Modernas às quais esse Robô tem acesso. Leia mais sobre a criação de Robots no Orchestrator aqui.

Para usar um processo, ativo ou fila, arraste-o e solte-o do Data Manager para o painel do Designer. Um conjunto de atividades é sugerido, dependendo do tipo de recurso; selecionando uma delas, a atividade é adicionada ao projeto pré-configurado para usar o recurso selecionado. Por exemplo, se você arrastar e soltar um processo, a barra de pesquisa Adicionar atividade é exibida com as atividades sugeridas Invoke Process, Start Job e Run Parallel Process. Selecionar Invoke Process adiciona a atividade com o caminho da pasta e os campos do nome do processo configurados com os dados do processo.

Você pode gerenciar os recursos do Orchestrator da seguinte forma:

• Clique com o botão direito em qualquer recurso em Ativos, Filas e Processos para acessar o menu de contexto onde você tem a opção de abrir o recurso no Orchestrator ou copiar o nome e usá-lo em atividades que interagem com esses recursos.

• Para atualizar recursos do Orchestrator, clique no botão Atualizar na parte superior do painel Data Manager.

  Observação:

  • Ao usar um Robot clássico provisionado manualmente, ele deve receber permissões View para que os recursos correspondentes (ou seja, Ativos, Filas e Processos) apareçam no painel. Leia mais sobre como configurar Funções e permissões no Orchestrator.
  • Se houver pastas clássicas e modernas no Orchestrator e você estiver conectado ao Orchestrator usando um robô de uma pasta moderna (você fez login na sua conta ou conectou-se usando uma chave de modelo de máquina), os processos nas pastas clássicas não ficarão disponíveis no painel Data Manager. Para ter acesso aos processos de uma pasta clássica, conecte-se ao Orchestrator usando um robô clássico com uma conexão de chave de máquina padrão.

Conexões

Visualizando as conexões usadas em um projeto

1. Abra o painel Data Manager.
2. Expandir o nó de Conexões para ver uma lista de conexões usadas no Projeto.

3. Expanda o nó de uma conexão para exibir uma lista de atividades nas quais ela é usada no projeto. Além disso, você pode expandir ainda mais cada atividade para ver mais dados específicos do usuário associados a uma conexão (por exemplo, as pastas de e-mail e as pastas de armazenamento em nuvem onde os e-mails e arquivos estão localizados).

   Observação: as conexões são exibidas no Data Manager para certas atividades e são exibidas apenas depois de você salvar o projeto.