Trabalhar com entidades de dados compostos

  • 10 minutos

Uma entidade composta é um conceito que permite criar uma única entidade usando várias entidades relacionadas entre si. Normalmente, você usaria o conceito em cenários em que é possível representar uma entidade como um único documento, como cabeçalho de ordem de venda, linha de ordem de venda, cabeçalho de fatura, linha de fatura e catálogo de fornecedor.

Uma entidade composta é aplicável em cenários de integração assíncrona em vez de cenários OData síncronos. Uma interface programática não está disponível para entidades compostas em X++ e só tem suporte para uma plataforma de gerenciamento de dados que faz parte de importações e/ou exportações com base em arquivos XML.

A importação e a exportação de entidades compostas são um processo rápido e simples no espaço de trabalho Gerenciamento de dados nos aplicativos de finanças e operações.

Para importar ou exportar uma entidade de dados compostos, siga estas etapas:

  1. Selecione o bloco Importar/Exportar no espaço de trabalho Gerenciamento de dados.
  2. Insira um nome no campo Nome.
  3. Selecione o formato da fonte de dados para importações ou adicione a entidade a ser exportada.
  4. Selecione Importar para importações ou selecione Baixar pacote para executar uma exportação.

Trabalhar com entidades de dados agregadas

Uma entidade de dados agregada é conceitualmente diferente das entidades de dados, que são usadas para importação e exportação com a estrutura de gerenciamento de dados. As entidades de dados agregadas são com base em exibições de dados, e você pode usá-las para consolidar, resumir e simplificar a estrutura de dados para fins analíticos.

As entidades de dados agregadas têm os seguintes componentes:

  • Medidas agregadas
  • Dimensões agregadas
  • Referências de dimensão de modelo

Ao criar a entidade de dados agregada com a propriedade IsPublic definida como true, você poderá acessá-la com OData como entidades de dados usando a mesma url: https://your dynamics name.dynamics.com/data/aggregate data entity.

Para criar entidades de dados agregadas, todo o desenvolvimento acontece no Visual Studio.

Para criar uma medida agregada, no Visual Studio, siga estas etapas.

  1. No Gerenciador de Soluções, clique com o botão direito do mouse em seu projeto ou ative o menu de contexto e selecione Adicionar> Novo item.
  2. Selecione Medida analítica e agregada.
  3. Insira um nome para a medida agregada e selecione Adicionar.
  4. No Explorador de Aplicativos, acesse Modelo de dados> Exibições.
  5. Selecione CustInvoiceTransExpanded e arraste-o para MeasureGroup1 na Medida agregada.
  6. Vá para o nó de dimensão e remova o campo Data.
  7. Vá para o nó de medidas e crie uma nova medida.
  8. Selecione o campo LineAmountMST e selecione Sum como Agregado Padrão nas propriedades.
  9. Selecione Salvar tudo.

Para criar dimensões agregadas, siga estas etapas.

  1. No Gerenciador de Soluções, clique com o botão direito do mouse em seu projeto ou ative o menu de contexto e selecione Adicionar> Novo item.
  2. Selecione Dimensão analítica e agregada.
  3. Insira um nome para a dimensão agregada e selecione Adicionar.
  4. No Explorador de Aplicativos, acesse Modelo de dados> Exibições.
  5. Selecione CustInvoiceTransExpanded e arraste-o para a raiz da dimensão agregada.
  6. Vá para o nó de atributos e remova todos os itens, exceto a dimensão ItemId e MyAggregate.
  7. Selecione Salvar tudo.

Para modelar referências de dimensão, siga estas etapas.

  1. No Gerenciador de Soluções, selecione a dimensão agregada e arraste-a para o nó de dimensões na medida agregada. Um novo nó de dimensão externa é criado na medida agregada.
  2. Clique com o botão direito do mouse no novo nó ou ative o menu de contexto e selecione Nova relação.
  3. Nas propriedades, selecione ItemId como campo e ItemId como campo relacionado.
  4. Selecione Salvar.

Para implantar a medida agregada, siga estas etapas.

  1. Selecione as propriedades do nó superior na medida agregada e verifique se Uso está definido como InMemoryRealTime.
  2. No Gerenciador de Soluções, clique com o botão direito na medida agregada ou ative o menu de contexto e selecione Adicionar Índices de Armazenamento de Colunas.
  3. Selecione Salvar tudo e os índices de medida serão criados no projeto.

Para criar uma entidade de dados agregada, siga estas etapas.

  1. No Gerenciador de Soluções, clique com o botão direito do mouse em seu projeto ou ative o menu de contexto e selecione Adicionar> Novo item.
  2. Selecione Entidade de Dados Analíticos e Agregados.
  3. Insira um nome para a entidade de dados agregados e selecione Adicionar.
  4. No Gerenciador de Soluções, vá para Medida agregada e arraste-a para o nó da fonte de dados na nova entidade de dados agregados.
  5. Vá para o nó Fonte de dados > Medida agregada > Medidas e arraste LineAmountMST para o nó do campo.
  6. Configure a propriedade de medida e a propriedade de tipo de dados estendida conforme aplicável.
  7. Vá para Fonte de dados > nossas medidas e dimensões agregadas e arraste a nova dimensão agregada para o nó do campo. Defina a propriedade Name e selecione o campo na propriedade Attribute.
  8. Configure a propriedade do nó superior IsPublic como Sim para habilitar a entidade de dados agregados para OData e configurar nomes para o nome da coleção pública e o nome da entidade pública, conforme aplicável.
  9. Crie uma chave primária para o campo ItemId.
  10. Defina a chave primária no nó superior com o nome da chave.
  11. Selecione Salvar tudo e crie.

Agora, você pode testar a entidade de dados agregada usando a URL https://your solution name.axcloud.dynamics.com/data/Aggregate Data Entity Collection name.

O exemplo de código a seguir ilustra como a saída pode ser mostrada.

{
  "@odata.context":"https://mb-500-dev23bd5795219c31f9devaos.axcloud.dynamics.com/data/$metadata#MyAggregateDataEntityCollection","value":[
    {
      "@odata.etag":"W/\"JzAsMTAxMCc=\"","ItemId":"","LineAmountMST":5636950
    },{
      "@odata.etag":"W/\"JzAsMTAxMCc=\"","ItemId":"D0001","LineAmountMST":3236760
    },{
      "@odata.etag":"W/\"JzAsMTAxMCc=\"","ItemId":"D0003","LineAmountMST":1651826
    },{
      "@odata.etag":"W/\"JzAsMTAxMCc=\"","ItemId":"D0004","LineAmountMST":11798000
    }
  ]
}

Recursos

Para saber mais, consulte Importar uma entidade composta.