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

O Data Manager tem uma estrutura semelhante a uma grade e contém as seguintes guias:

• Variáveis
• Argumentos
• Namespaces
• Conexões

Variáveis

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

Para criar uma variável no Data Manager:

1. Navegue até a aba Variáveis.
2. Selecione Criar variável. Sua nova variável aparece na parte superior da lista de variáveis.
3. 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.

Dentro da aba Variáveis, você pode:

• Selecione a coluna Nome para classificar variáveis por seu nome.
• Pesquise variáveis selecionando o ícone de pesquisa.
• Selecione a coluna Tipo de dados para classificar variáveis por seu tipo de dados.
• Selecione a coluna Escopo para classificar variáveis por seu escopo.
• Selecione o botão Sincronizar com escopo ativo. Quando um escopo ativo está em foco, por exemplo, uma atividade Usar arquivo do Excel é selecionada, ela exibe apenas as variáveis com o escopo correspondente atribuído a elas.
• Consulte o valor padrão de variáveis na coluna Valor padrão.
• Edite o nome, o tipo de dados, o escopo ou o valor padrão de uma variável. No caso de variáveis globais, você pode editar o valor, mas não o nome, tipo ou escopo.

Clicar com o botão direito do mouse em uma variável abre o menu de contexto com as seguintes opções:

• Novo > Variável global – Cria uma variável global.
• Novo > Constante – Cria uma constante.
• Criar gatilho – Cria um gatilho 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 Attended baseada em gatilhos.
• Converter em argumento – Converte a variável em um argumento.O argumento recém-convertido pode ser encontrado na guia Argumentos.
• Copiar - Copia a variável. Você também pode usar o atalho de teclado CTRL + C.
• Colar: Cola a variável copiada. Você também pode usar o atalho de teclado CTRL + V. Quando uma variável com o mesmo nome já existe, um número é adicionado ao nome da duplicada.Por exemplo, se uma variável com o nome número já existe, a variável copiada será renomeada número_1.
• Excluir – Exclui a variável.
• Adicionar inspeção – Adiciona a variável ao painel de Observação. Isso fica disponível apenas durante a depuração.
• Anotações – Exibe as opções para trabalhar com anotações. Use anotações para fornecer contexto ou apenas para acompanhar melhor a finalidade e o conteúdo das variáveis:
  • Adicionar anotação – Cria uma nova anotação.
  • Editar anotação – Edita uma anotação existente. Como alternativa, você pode editar anotações selecionando o ícone de anotação ao lado de uma variável e alterando o texto.
  • Excluir anotação – Exclui uma anotação existente.
• Localizar Referências – Abre o painel Localizar referências, que exibe todas as referências à variável no projeto.

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.

Para criar um argumento no Data Manager:

1. Navegue para a aba Argumentos.
2. Selecione Criar argumento. Seu novo argumento aparece na parte superior da lista de argumentos.
3. 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.

Dentro da aba Argumentos, você pode:

• Selecione a coluna Nome para classificar os argumentos por seu nome.
• Pesquise por argumentos selecionando o ícone de pesquisa.
• Selecione a coluna Direção para classificar argumentos por sua direção.
• Selecione a coluna Tipo de dados para classificar argumentos por seu tipo de dados.
• Indique se um argumento é necessário na coluna Obrigatório.
• Consulte o valor padrão dos argumentos na coluna Valor padrão.
• Edite qualquer um dos seguintes: direção, tipo de dados, se é necessário e valor padrão.
• Selecione várias variáveis clicando e arrastando o cursor do mouse sobre as variáveis ou usando o atalho de teclado CTRL + A.

Clicar com o botão direito do mouse em um argumento abre o menu de contexto com as seguintes opções:

• Converter em variável – Converte o argumento em uma variável. A variável recém-convertida pode ser encontrada na guia Variáveis.
• Copiar – Copia o argumento. Você também pode usar o atalho de teclado CTRL + C.
• Colar – Cola o argumento copiado. Você também pode usar o atalho de teclado CTRL + V. Quando já existe um argumento com o mesmo nome, um número é adicionado ao nome do duplicado.
• Excluir – Exclui o argumento.
• Anotações – Exibe as opções para trabalhar com anotações:
  • Adicionar anotação – Cria uma nova anotação.
  • Editar anotação – Edita uma anotação existente. Como alternativa, você pode editar anotações selecionando o ícone de anotação ao lado de um argumento e alterando o texto.
  • Excluir anotação – Exclui uma anotação existente.
• Encontrar Referências – abre o painel Encontrar referências, que exibe todas as referências ao argumento no projeto.
• Selecione vários argumentos clicando e arrastando o cursor do mouse sobre os argumentos ou usando o atalho de teclado CTRL + T.

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

Para criar uma constante no Data Manager:

1. Navegue até a aba Variáveis.
2. Clique com o botão direito do mouse em uma variável ou constante.
3. Selecione Novo > Constante.
4. 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.
5. Selecione OK. Sua nova constante aparece na parte superior da lista de variáveis.

Clicar com o botão direito do mouse em uma constante abre o menu de contexto com as seguintes opções:

• Novo > Variável global – Cria uma variável global.
• Novo > Constante – Cria uma constante.
• Copiar – Copia a constante. Você também pode usar o atalho de teclado CTRL + C.
• Colar – Cola a constante copiada. Você também pode usar o atalho de teclado CTRL + V.
• Excluir – Exclui a constante.
• Localizar Referências – Abre o painel Localizar referências, que exibe todas as referências à constante no projeto.

Namespaces

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

Para adicionar um namespace:

1. Abra o Gerenciador de dados.
2. Navegue até a aba Namespaces.
3. Selecione Adicionar namespace.
4. Um menu suspenso listando os namespaces disponíveis é exibido. Para filtrar a lista, use a caixa de pesquisa na parte superior do menu.
5. Selecione o namespace para importá-lo.

Para remover um namespace, clique com o botão direito do mouse no namespace e selecione Excluir.

Conexões

Para visualizar as conexões usadas em um projeto:

1. Abra o Gerenciador de dados.
2. Navegue até a aba Conexões para visualizar uma lista de conectores usados no projeto e suas conexões correspondentes.

Observação: as conexões são exibidas no Data Manager para determinadas atividades e somente depois que você salva o projeto.

Recursos

Nos projetos Windows-Legacy e Windows, você pode navegar até a aba Variáveis 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 nele com o botão direito do mouse na aba Variáveis 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. Navegue até a aba Variáveis.
2. Clique com o botão direito do mouse no painel e selecione Novo > Conectar a um novo arquivo de pasta de trabalho. A janela Gerenciar recursos é exibida.
3. 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.

Após o recurso ser criado, você pode editar sua configuração clicando nele com o botão direito do mouse na aba Variáveis 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 gerenciar um recurso do painel Variáveis, clique com o botão direito do mouse 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.