Data Service
2023.10
falso
  • Introdução
  • Configuração e Instalação
  • Usando o Data Service
  • Referência
  • Exemplos e tutoriais
Guia do usuário do Data Service
Last updated 19 de abr de 2024

Usar entidades em projetos

Ao usar entidades criadas no Data Service, você pode gerenciar e manipular dados agregados em um único objeto, sem precisar trabalhar com eles de forma granular. Para isso, você precisa do Studio v2020.8 ou posterior.

O exemplo a seguir recupera dados sobre os jogos e medalhas olímpicas para os 10 melhores países em cada categoria de modalidades, juntamente com as medalhas que ganharam.

Entidades no Data Service

Seguindo as etapas detalhadas na página Criando uma Entidade, criamos uma entidade para armazenar informações sobre nações participantes, as datas de abertura e fechamento e as medalhas que ganharam.

A entidade Olimpíadas tem os seguintes campos: Nome, Países, Data de Abertura e Data de Encerramento. A entidade Medalhas tem os seguintes campos: País, Ouro, Prata, Bronze e o número total de medalhas. As duas entidades estão vinculadas uma à outra com a tag de Relacionamento.



Entidades importadas no Studio

Importe a entidade para dentro do seu fluxo de trabalho no Studio.

O fluxo de trabalho a seguir coleta informações sobre uma determinada edição das Olimpíadas, mapeia dados para argumentos e passa eles adiante para o fluxo de trabalho principal.



Para fazer isso, definimos um argumento para cada tipo de informação que estamos coletando, resultando assim em 5 argumentos importados.



Com o uso de entidades, precisamos importar e trabalhar apenas com dois argumentos para coletar os dados.

Observação: Entidades devem ser iniciadas usando o Novo operador, lidas a partir do Data Service ou passadas por meio de um argumento de entrada em um fluxo de trabalho antes do uso. Caso contrário, atribuir ou ler seus valores pode causar erros.


Os dados coletados são mapeados para os dois argumentos inOlympics Year e outOlympics e suas respectivas propriedades, os mesmos que os campos definidos na entidade. Ao usar entidades, reduzimos o número de argumentos necessários para passar adiante informações, mapeamento dados corretamente para seus campos de entidade respectivos.

Criar registros de dados

Após os dados serem coletados, você pode usar a atividade Create Entity Record para adicionar as informações ao Data Service.

Nesse exemplo, usamos os argumentos importados para passar as informações coletadas ao Data Service. Os registros Entrada e Saída são os valores das variáveis do tipo Olimpíadas, usadas para passar os dados adiante.



Após executar o projeto, o seguinte registro foi criado no Data Service:



Criar registros com dados estruturados

Os registros estruturados em uma tabela de dados podem ser passados ao Data Service usando a atividade For Each Row . Nesse exemplo, estamos invocando um fluxo de trabalho que recolhe dados estruturados sobre o número de medalhas conquistadas por cada país e passa esses registros para o Data Service.



Após executar o fluxo de trabalho, os seguintes dados são armazenados no Data Service:



O conjunto de relacionamento entre as entidades Olimpíadas e Medalhas permite que usemos o registro de dados de uma na outra. Por exemplo, o valor do campo Olimpíadas dentro da entidade Medalha é o mesmo que na entidade relacionada.

Registros relacionados a consultas

A atividade Query Entity Records pode ser usada para obter uma lista de registros do Data Service. No exemplo a seguir, usamos a atividade para consultar registros de dados da entidade Olimpíadas , permitir que o usuário escolha uma edição das Olimpíadas e, da entidade Medalhas , escrever o número de medalhas que cada país participante conquistou.



Para consultar a tabela Olimpíadas, usamos a condição Name != NULL do Construtor de Consultas. Isso percorre todos os registros da coluna Nome e os transmite para a variávellistOlympicsName != NULL para ser usada na atividade Input Dialog.
Para mostrar a lista de registros como opções, usamos a seguinte expressão Lambda listOlympics.Select(Function (o as Olympics) o.Name).ToArray na atividade Input Dialog . De maneira alternativa, a atividade For Each também pode ser usada.
A seleção é mapeada para a variável selectedOlympics e é usada em outra atividade Query Entity Records para percorrer a lista de medalhas conquistadas nessa edição específica. Essa condição foi definida usando a opção equals no Construtor de Consultas.


A consulta pode ser executada na entidade selecionada e também em registros de entidades relacionadas.

Paginação

Os serviços de dados tem potencial para armazenar um grande número de registros. Para consultar apenas um certo número de registros, use as propriedades de Paginação da atividade Query Entities Records. A propriedade Topo suporta um número de até 1.000, o que significa que 1.000 registros podem ser consultados por vez.

Esse exemplo consulta os primeiros cinco registros e, em seguida, os cinco registros seguintes até os últimos registros da lista serem capturados.



Para fazer isso, a variável skip Int64 recebeu o valor inicial de 0 e, em seguida, seu valor foi incrementado após cada loop até o último registro ser capturado.


Após as primeiras cinco medalhas serem capturadas, a atividade For Each é usada para escrever os países participantes e o número de medalhas que conquistaram no arquivo do Notepad.

Atualizar Registro de Entidade

O cenário a seguir explica as etapas para atualizar um registro de entidade no Data Service e, em seguida, sincronizar os dados com o Studio.

No Data Service, acesse a entidade Medalhas , clique em Criar novo campo e adicione uma nova coluna HostCountry do tipo Sim/Não. Clique em Salvar.



No Studio, clique em Gerenciar entidades e, em seguida, no botão Atualizar. Uma alteração foi detectada para a entidade Medalhas, conforme ilustrado na coluna Alterações. Clique em Salvar e a entidade será atualizada no Studio.



Registros de consulta e atualização

A atividade Update Entity Record pode ser usada para atualizar registros do seu fluxo de trabalho diretamente para o Data Service.

Nesse exemplo, estamos consultando certos registros da entidade Medalhas e os atualizando automaticamente usando a atividade mencionada anteriormente.

Na entidade Medalhas, o país anfitrião de cada edição é marcado com um asterisco ao lado de seu nome. Por exemplo, para a edição de 2012, o país anfitrião está registrado como a Grã-Bretanha (GBR)* na coluna Olimpíadas.



Usando a atividade Query Entity Records, percorremos todos os registros que contêm o asterisco (*), coletamos os registros na variável listMedals, e usamos a atividade For Each para percorrer cada item em loop e atribuir o valor Verdadeiro na coluna HostCountry ao lado do país que hospedou uma edição específica.

A atividade Update Entity Record pode ser usada em vários outros cenários para passar dados e atualizar registros no Data Service.

Was this page helpful?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Logotipo branco da Uipath
Confiança e segurança
© 2005-2024 UiPath. All rights reserved.