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 - Armazene dados de diferentes tipos e passe-os entre fluxos de trabalho.
• Constantes - Armazene valores globais imutáveis de tipos básicos.
• Recursos - Atividades que adicionam recursos como arquivos, contas de e-mail, aplicativos ou navegadores para o projeto.
• Entidades - Registros do Data Service, um serviço centralizado de modelagem e armazenamento de dados.

• Os seguintes recursos do Orchestrator, desde que o robô está conectado ao orquestrador:

  • 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.
• Namespaces - Defina o escopo de suas expressões, variáveis e argumentos. A importação de namespaces torna mais fácil se referir a elementos desses namespaces.

Opções do menu

• Criar - Contém as opções para criar uma nova Variável. Argumento e Constante.
• 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

Para obter informações adicionais sobre variáveis, consulte Como gerenciar variáveis.

Criação de uma variável

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 global (disponível em todo o projeto), o arquivo do fluxo de trabalho atual ou qualquer atividade de contêiner dentro do arquivo de fluxo de trabalho. O valor padrão é o arquivo do fluxo de trabalho atual.

   Observação:

   • As variáveis globais não podem ser usadas em fluxos de trabalho isolados (arquivos invocados usando as atividades Invoke Workflow File configuradas com a opção Isolada).
   • As variáveis globais não são suportadas em projetos de biblioteca.
   • Em projetos C#, o uso de uma variável global ou uma constante global em atividades requer seguir o formato: GlobalVariablesNamespace.GlobalVariables.YOUR_GLOBAL_VARIABLE_NAME. Em projetos VB, você pode fazer referência à variável global ou constante global por seu nome diretamente.

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.

Como gerenciar variáveis

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.

   No caso de variáveis globais, você pode editar o valor, mas não o nome, tipo ou escopo.

   
   

   

   
   

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.

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.

Criação de um disparador a partir de uma variável global

As variáveis globais são usadas em automação assistida baseada em gatilhos para armazenar dados sobre o usuário ou eventos de aplicativos. Esses dados podem ser usados para disparar outras atividades ou fluxos de trabalho (por exemplo, quando o valor de uma variável global muda). Para saber mais, consulte Automação assistida baseada em gatilho.

Para criar um gatilho a partir de uma variável global:

1. Abra o painel Data Manager.

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

3. Selecione Criar gatilho.

4. A janela Adicionar arquivo novo é exibida, onde você pode especificar o nome do arquivo do gatilho e o local onde ele está armazenado.

Argumentos

Para obter informações adicionais sobre argumentos, consulte Gerenciamento de argumentos.

Observação: Se você adicionar ou remover um argumento do Data Manager enquanto o painel Argumentos estiver aberto, as alterações só serão visíveis no painel Argumentos depois de você fechar e reabrir o arquivo de fluxo de trabalho.

Criação de um argumento

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.

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 Adicionar e adicione os detalhes para cada argumento que você deseja adicionar.

Como gerenciar argumentos

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.

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.

Adição, edição e remoção de anotações em variáveis e argumentos

Você pode adicionar anotações às suas variáveis e argumentos para fornecer contexto ou apenas para poder acompanhar melhor a finalidade e o conteúdo 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, basta clicar com o botão direito do mouse em um argumento ou variável e selecionar Editar anotação ou Remover anotação.

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

Constantes

As constantes habilitam você a definir valores fixos que não mudam durante a execução do projeto. As constantes estão disponíveis globalmente e podem ser referenciadas em campos de entrada de atividades ao longo de um projeto. Por exemplo, se um nome da empresa ou nome do departamento for uma entrada em várias telas, você pode armazenar o nome em uma constante e referenciá-lo nas atividades que interagem com cada tela.

Depois de criar uma constante, você pode editar seu valor, mas não seu nome, tipo ou escopo.

Observação:

• As constantes não estão disponíveis em projetos do Windows - legados e não são suportadas em projetos de biblioteca.
• Você pode ordenar variáveis, argumentos e constantes livremente arrastando e soltando-os. Este recurso é desabilitado quando você seleciona a opção Agrupar itens por escopo.
• Atualmente, você não pode alterar o nome ou o tipo de dados de uma constante criada. Você só pode alterar o valor padrão da constante.
• As variáveis que não têm um escopo global podem ter o mesmo nome que uma constante. Para distinguir entre uma constante e uma variável com o mesmo nome, acesse a constante usando seu nome completo (GlobalConstantsNamespace.GlobalConstants.YourConstantName).

Criando uma constante

1. No Data Manager, selecione Criar > Nova constante.
2. Providencie a seguinte informação:
   • Digite o nome da constante.
   • Selecione o tipo de dados da constante: Texto, Número, Verdadeiro ou falso, Número com decimais, Data ou Duração.
   • Digite o valor da constante.
3. Selecione OK.

Gerenciando constantes

1. Abra o painel Data Manager.
2. Expanda o nó Constantes.
3. Você tem as seguintes opções:
   • Para alterar o valor de uma constante, expanda-a e, então, insira um novo valor no campo correspondente.
   • Para excluir uma constante, clique com o botão direito do mouse nela e, então, selecione Excluir constante.

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 em atividades Word Application Scope.
• 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 Excel usados na automação:
  • Arquivos adicionados em atividades Use Excel File para uso com atividades modern Excel.
  • Arquivos adicionados do Data Manager usando a opção Conectar ao novo arquivo da pasta de trabalho para uso com atividades de pasta de trabalho.

Gerenciamento de recursos de arquivos do Excel (atividades modernas do Excel)

Depois de adicionar um arquivo Excel com uma atividade Use Excel File, você pode gerenciar o recurso da seguinte forma:

• Para configurar o recurso, clique com o botão direito no Data Manager e selecione Configurar. A janela Gerenciar recursos é exibida.
  • Selecionar arquivo Excel - Navegue e selecione o arquivo Excel.
  • E dê um nome para depois - Digite o nome pelo qual se referir ao arquivo no projeto (por padrão, Excel). Este é o nome da opção que estará disponível no menu Mais em atividades filhas da atividade Use Excel File, permitindo fazer referência ao arquivo Excel.
  • 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.
  • 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.
• Para remover a atividade Use Excel File e todas as suas atividades filhas do projeto, clique com o botão direito no recurso do Excel e selecione Excluir.

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

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.

Entidades

Para obter informações sobre o gerenciamento de entidades, consulte Como importar entidades.

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 Robô conectado ao Orchestrator for do tipo Padrão, o painel Data Manager pode exibir apenas a pasta clássica que provisionou esse Robô. 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 Robôs no Orchestrator .

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.

Selecionando uma pasta do Orchestrator

A pasta em que os recursos estão atualmente carregados no painel é mostrada na barra de status do Studio. É possível alternar para uma pasta diferente que você tem acesso clicando no nome da atual e depois selecionando outra no menu que aparece. Além dos recursos que estão disponíveis no Studio, a seleção da pasta também determina os destinos padrão disponíveis ao publicar seus processos.

Para carregar recursos no painel, clique no botão atualizar na parte superior do painel. Passe o mouse sobre o nome da pasta na barra de status para ver a URL do Orchestrator.

Observação: os logs gerados de processos localizados em subpastas ficam visíveis no Orchestrator somente se a subpasta estiver selecionada no painel Data Manager.

Usando recursos do Orchestrator em seus projetos

Arraste e solte ativos, filas ou processos do painel do Data Manager diretamente para seu projeto de automação. Ao fazer isso, as atividades adequadas são sugeridas na barra de pesquisa Adicionar atividade. Por exemplo, após arrastar uma fila em seu projeto, escolha a atividade Adicionar Item da Fila na barra de pesquisa Adicionar atividade. Note que aquela fila foi automaticamente atribuída à propriedade Nome da Fila da atividade.

Você também pode clicar com o botão direito do mouse no painel do Data Manager e, então, selecionar Copiar para copiar seu nome e usá-lo em atividades que interagem com esses recursos.

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 determinadas atividades e somente depois que você salva o projeto.

Namespaces

Para obter informações adicionais sobre namespaces, consulte Sobre namespaces importados.

Adição de um namespace

1. Abra o Data Manager e, então, clique com o botão direito do mouse em Namespaces e selecione Adicionar namespace.
2. Uma caixa de diálogo listando os namespaces disponíveis é exibida. Para filtrar a lista, use a caixa de pesquisa no topo da caixa de diálogo.
3. Selecione o namespace para importá-lo.

Excluindo um namespace

1. Abra o Data Manager e, então, expanda o nó Namespaces.
2. Clique com o botão direito do mouse no namespace e selecione Excluir.