Como gerenciar os dados em um projeto

O Data Manager permite gerenciar os dados em um projeto de automação. Esses dados incluem:

• Variáveis - Armazene dados e passe-os entre atividades em um projeto.
• Argumentos - Armazene dados e passe-os para dentro ou para fora de um projeto.
• Entidades - Dados armazenados em registros do ^UiPath® Data Fabric, um serviço centralizado de modelagem e armazenamento de dados.

Para acessar o Data Manager para um projeto, selecione o ícone no lado esquerdo do painel Designer.

Tipos de variáveis e argumentos

As variáveis e argumentos têm tipos diferentes, dependendo dos dados que armazenam. Há vários tipos de variáveis e argumentos que você pode criar no Studio Web, sendo os seguintes os mais usados:

• Texto — Armazena dados de texto. Esse tipo pode ser usado para armazenar qualquer informação baseada em texto, como nomes de funcionários, nomes de usuários e qualquer outra string.
• Número — armazena números sem decimais. Você pode usá-lo para executar cálculos, equações e comparações.
• Verdadeiro ou falso — Também chamado de Booleano. Esse tipo tem apenas dois valores possíveis, verdadeiro ou falso. Permitem que você tome decisões e controle o fluxo de sua automação.
• Número com decimais — Semelhante a Número, porém útil quando você precisa usar decimais para maior precisão.
• Data — Armazena uma instância no tempo representado pela data, hora e minuto.
• Arquivo — Armazena um arquivo ou pasta como um recurso que você pode usar em seu projeto.
• Lista — Armazena vários valores do mesmo tipo (texto, número, verdadeiro ou falso, número com decimais, data ou arquivo). É possível manipular listas em seu projeto ao adicionar ou remover valores.
• Array [] — Armazena um número fixo de vários valores do mesmo tipo (texto, número, verdadeiro ou falso, número com decimais, data ou arquivo).
• Dicionário — Armazena uma coleção de pares de chave-valor. Você seleciona o tipo de dados para as chaves e valores (texto, número, verdadeiro ou falso, número com decimais, data ou arquivo). O tipo de dados pode diferir entre chaves e valores.

Se você precisar usar um tipo de dados diferente, ao criar uma variável ou um argumento, selecione Tipos avançados para explorar todos os tipos de dados disponíveis.

Tipos de dados avançados

O tipo de dados de data e hora permite que você armazene informações sobre qualquer data e hora. Mantenha estas diretrizes em mente ao trabalhar com formatos de data e hora:

• Para gerar uma data (sem hora), selecione o tipo de dados avançado DateOnly . Por exemplo, você pode usar:
  • DateOnly.FromDateTime(DateTime.Now)
  • DateOnly.FromDateTime(DateTime.Parse("2024/05/30"))
• Para gerar uma data com o tempo, selecione o tipo de dados avançado Data . Para saídas de Data , o fuso horário é obrigatório. Se nenhum fuso horário for especificado, a saída será rejeitada por não ser compatível com ISO. Por exemplo, você pode usar:
  • DateTime.SpecifyKind(DateTime.Now, DateTimeKind.Local)
  • DateTime.SpecifyKind(DateTime.Parse("2024/05/30T12:24:00"), DateTimeKind.Local)

O último parâmetro pode ser DateTimeKind.Local ou DateTimeKind.Utc. Não use DateTimeKind.Unspecified, pois ele não tem informações de fuso horário.

Como gerenciar variáveis

Você pode usar o Data Manager para criar e gerenciar variáveis manualmente. As variáveis que são geradas automaticamente para saídas de atividades podem ser gerenciadas a partir do Data Manager após serem usadas em uma atividade.

Criação de uma variável

1. Abra o Data Manager selecionando o Botão Abrir Data Manager no lado esquerdo do painel Designer.
2. Selecione o botão Adicionar novo item + ao lado de Variáveis.
3. Providencie a seguinte informação:
   • Nome da variável — insira o nome da variável.
   • Escopo — o contexto no qual a variável pode ser usada. Todas as variáveis são atualmente Globais (disponíveis em todo o fluxo de trabalho)
   • Tipo — O tipo de dados.
   • Valor padrão — o valor padrão.
   • Descrição – Uma descrição significativa da variável.
4. Selecione Criar.

Editando uma variável

1. Abra o Gerenciador de dados.
2. Em Variáveis, expanda a variável que deseja editar.
3. Edite as informações da variável.

Como renomear ou excluir uma variável

1. Abra o Gerenciador de dados.
2. Passe o mouse sobre uma variável.
3. Selecione o botão Renomear para inserir um novo nome de variável ou o botão Remover para excluir a variável do projeto. Observe que você não pode remover variáveis geradas automaticamente.

Transformando uma variável em um argumento

1. Abra o Gerenciador de dados.
2. Clique com o botão direito do mouse em uma variável.
3. Selecione Alterar para argumento.

Como gerenciar argumentos

Os argumentos no Data Manager são divididos entre as seções Entradas e Saídas . Use as duas seções para criar e gerenciar argumentos de entrada e saída, respectivamente.

Criação de um argumento

1. Abra o Data Manager selecionando o Botão Abrir Data Manager no lado esquerdo do painel Designer.
2. Selecione o botão Adicionar novo item + ao lado de Entradas ou Saídas.
3. Providencie a seguinte informação:
   • Nome do argumento — Insira o nome do argumento.

   • Direção — A direção do argumento:

     • Entrada — O argumento pode ser usado para transmitir dados para o projeto. Esse é o valor padrão.
     • Saída — O argumento pode ser usado para transmitir dados para fora do projeto.
     • Entrada/Saída — O argumento pode ser usado para transmitir dados para dentro e para fora do projeto.
   • Tipo — O tipo de dados.
   • Valor padrão — o valor padrão.
   • Descrição — uma descrição significativa do argumento.
4. Selecione Criar.

Observação: Você não pode definir o valor padrão dos argumentos Out e In/Out do Data Manager. Use a atividade Set Variable Value para definir um valor padrão para esses tipos de argumentos.

Edição de um argumento

1. Abra o Gerenciador de dados.
2. Em Entradas ou Saídas, expanda o argumento que deseja editar.
3. Edite as informações do argumento.

Renomeação ou exclusão de um argumento

1. Abra o Gerenciador de dados.
2. Passe o mouse sobre um argumento.
3. Selecione o botão Renomear para inserir um novo nome de argumento ou o botão Remover para excluir o argumento do projeto.

Transformando um argumento em uma variável

1. Abra o Gerenciador de dados.
2. Clique com o botão direito do mouse em um argumento.
3. Selecione Alterar para variável.

Como gerenciar entidades

O Studio Web integra-se ao Data Fabric para facilitar o processamento de registros de entidade. As atividades do Data Fabric estão disponíveis para criar, atualizar, consultar, obter ou excluir registros de entidades. Você seleciona a entidade para usar diretamente das atividades do Data Fabric em seus projetos e as entidades são então adicionadas ao Data Manager.

Para visualizar e gerenciar entidades adicionadas ao seu projeto, abra o Data Manager selecionando o Botão Abrir Data Manager no lado esquerdo do painel Designer. A lista de entidades é exibida nas seções Entidades .

Clique com o botão direito do mouse na seção Entidades para:

• Atualize todas as entidades no seu projeto.
• Mostra todas as entidades no Data Fabric.

Clique com o botão direito do mouse em uma entidade para:

• Remover a entidade do projeto.
• Mostre a entidade no Data Fabric.