Usar entidades em projetos

Ao usar entidades criadas no Data Fabric/Data Service, você pode gerenciar e manipular dados agregados em um único objeto, sem ter que trabalhar com ele de maneira granular. Para fazê-lo, 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.

Baixe o exemplo

Entidades no Data Fabric/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 cinco argumentos importados.

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

Observação:

As entidades devem ser inicializadas usando o novo operador, lidas a partir do Data Fabric/Data Service ou passadas por 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

Depois que os dados são coletados, você pode usar a atividade Create Entity Record para adicionar as informações ao Data Fabric / Data Service.

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

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

Criar registros com dados estruturados

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

Após executar o fluxo de trabalho, os seguintes dados são armazenados no Data Fabric/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 extrair uma lista de registros do Data Fabric/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 Olimpíadas e, na entidade Medição , escrever o número de medalhas que cada país participante ganhou.

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ável listOlympics 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

O Data Fabric/Data Service pode armazenar um grande número de registros. Para consultar apenas um determinado número de registros, use as propriedades de Paginação da atividade Query Entities Records . A propriedade Superior aceita um número máximo de 1.000, isso significa que 1.000 registros podem ser consultados de cada 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 esquema de entidade

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

Em Data Fabric / Data Service, acesse a entidade Datas , selecione Criar novo campo e adicione uma nova coluna HostCountry do tipo Yes/No. Selecione Salvar.

No Studio, selecione Gerenciar entidades e, em seguida, o botão Atualizar . Uma alteração foi detectada para a entidade Datas , conforme ilustrado na coluna Alterações . Selecione Salvar e a entidade é atualizada no Studio.

Registros de consulta e atualização

A atividade Update Entity Record pode ser usada para atualizar registros de seu fluxo de trabalho diretamente no Data Fabric/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 Fabric/Data Service.