Usar entidades em projetos

By using entities created in Data Fabric / Data Service, you can manage and manipulate data aggregated in a single object, without having to work with it in a granular way. To do so you need Studio v2020.8 or later.

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

Entities in Data Fabric / Data Service

Following the steps detailed on the Creating an entity page, we created an entity for storing information about participating nations, the opening and closing dates, and the medals they won.

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:

Entities must be initialized using the new operator, read from Data Fabric / Data Service or passed through an input argument in a workflow before usage, otherwise assigning or reading their values can cause errors.

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

Once the data was collected, you can use the Create Entity Record activity to add the information to Data Fabric / Data Service.

In this example, we used the imported arguments to pass the collected information to Data Fabric / Data Service. The Input and Output records are the values of variables of type Olympics used for passing along the data.

After running the project, the following record was created in Data Fabric / Data Service:

Criar registros com dados estruturados

Records structured in a data table can be passed along to Data Fabric / Data Service using the For Each Row activity. In this example, we're invoking a workflow that collects structured data on the number of medals won by each country and passes these records along to Data Fabric / Data Service.

After running the workflow, the following data is stored in 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

The Query Entity Records activity can be used to pull up a list of records from Data Fabric / Data Service. In the following example, we use the activity to query data records from the Olympics entity, allow the user to choose an Olympics edition, and from the Medals entity write the number of medals that each participating country won.

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

Data Fabric / Data Service can potentially store a large number of records. To query only a certain number of records, use the Pagination properties from the Query Entities Records activity. The Top property supports a maximum number of 1,000, this means that 1,000 records can be queried at a time.

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

The following scenario explains the steps for updating an entity schema in Data Fabric / Data Service and then syncing the data with Studio.

In Data Fabric / Data Service, go to the Medals entity, select Create New Field, and add a new column HostCountry of type Yes/No. Select Save.

In Studio, select on Manage Entities, and then the Refresh button. A change was detected for the Medals entity, as illustrated in the Changes column. Select Save and the entity is updated in Studio.

Registros de consulta e atualização

The Update Entity Record activity can be used for updating records from your workflow directly into 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.

The Update Entity Record activity can be used in numerous other scenarios for passing along data and updating records in Data Fabric / Data Service.