Como gerenciar os dados em um projeto

O Data Manager permite que você gerencie 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.

To access the Data Manager for a project, select the icon on the left side of the Designer panel.

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 tempo), 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 tempo, selecione o tipo de dados Data avançada. Para saídas de Data , o fuso horário é obrigatório. Se nenhum fuso horário for especificado, a saída será rejeitada como não 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. Open the Data Manager by selecting the Open Data Manager button on the left side of the Designer panel.
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ível 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. Open the Data Manager by selecting the Open Data Manager button on the left side of the Designer panel.
2. Selecione o botão Adicionar novo item + ao lado de Entradas ou Saídas.
3. Providencie a seguinte informação:
   • Argument name
     • 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.
     • In/Out
       • O argumento pode ser usado para passar 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.

To view and manage entities added to your project, open the Data Manager by selecting the Open Data Manager button on the left side of the Designer panel. The list of entities is displayed under the Entities sections.

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.