- Introdução
- Configuração e Instalação
- Usando o Data Service
- Referência
- Exemplos e tutoriais
Guia do usuário do Data Service
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.
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.
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.
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.
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:
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
