Uso delle entità di dati composite

  • 10 minuti

Un'entità composita è un concetto che consente di creare una singola entità usando più entità correlate tra loro. Il concetto viene in genere usato negli scenari in cui un'entità può essere rappresentata come singolo documento, ad esempio un'intestazione dell'ordine cliente, una riga dell'ordine cliente, un'intestazione della fattura, una riga della fattura e un catalogo fornitore.

Un'entità composita è applicabile in scenari di integrazione asincrona piuttosto che in scenari OData sincroni. L'interfaccia programmatica non è disponibile per le entità composite in X++ ed è supportata solo per una piattaforma di gestione dei dati che fa parte di importazioni e/o esportazioni basate su file XML.

L'importazione e l'esportazione di entità composite è un processo rapido e semplice nell'area di lavoro Gestione dati delle app per la finanza e le operazioni.

Per importare o esportare un'entità di dati composita, effettuare i passaggi seguenti:

  1. Selezionare il riquadro Importa/Esporta nell'area di lavoro Gestione dati.
  2. Immettere un nome nel campo Nome.
  3. Selezionare il formato dell'origine dati per le importazioni o aggiungere l'entità da esportare.
  4. Selezionare Importa per le importazioni o Scarica pacchetto per eseguire un'esportazione.

Uso delle entità di dati aggregati

Un'entità di dati aggregati è concettualmente diversa dalle entità di dati che si usano per l'importazione e l'esportazione con il framework di gestione dei dati. Le entità di dati aggregati si basano su visualizzazioni di dati e si possono usare per consolidare, riepilogare e semplificare la struttura dei dati per scopi di analisi.

Le entità di dati aggregati dispongono dei componenti seguenti:

  • Misure di aggregazione
  • Dimensioni aggregate
  • Riferimenti alla dimensione del modello

Quando si crea l'entità di dati aggregati con la proprietà IsPublic impostata su true, è possibile accedervi con OData come entità di dati usando lo stesso URL: https://your dynamics name.dynamics.com/data/aggregate data entity.

Per creare entità di dati aggregati, tutte le attività di sviluppo hanno luogo in Visual Studio.

Per creare una misura di aggregazione in Visual Studio, effettuare i seguenti passaggi.

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto o attivare il menu di scelta rapida, quindi selezionare Aggiungi > Nuovo elemento.
  2. Selezionare Analisi e Misure di aggregazione.
  3. Immettere un nome per la misura di aggregazione, quindi selezionare Aggiungi.
  4. In Esplora applicazioni andare a Modello dati > Visualizzazioni.
  5. Selezionare la voce CustInvoiceTransExpanded e trascinarla su MeasureGroup1 nella misura di aggregazione.
  6. Andare al nodo dimensione e rimuovere il campo Data.
  7. Andare al nodo misure per creare una nuova misura.
  8. Selezionare il campo LineAmountMST, quindi Somma come Aggregazione predefinita nelle proprietà.
  9. Selezionare Salva tutto.

Per creare le dimensioni aggregate, effettuare i seguenti passaggi.

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto o attivare il menu di scelta rapida, quindi selezionare Aggiungi > Nuovo elemento.
  2. Selezionare Analisi e Dimensione aggregata.
  3. Immettere un nome per la dimensione aggregata, quindi selezionare Aggiungi.
  4. In Esplora applicazioni andare a Modello dati > Visualizzazioni.
  5. Selezionare la voce CustInvoiceTransExpanded, quindi trascinarla sulla radice della dimensione aggregata.
  6. Andare al nodo attributi e rimuovere tutti gli elementi tranne ItemId e la dimensione MyAggregate.
  7. Selezionare Salva tutto.

Per creare i riferimenti alla dimensione del modello, effettuare questi passaggi.

  1. In Esplora soluzioni selezionare la dimensione aggregata, quindi trascinarla sul nodo dimensioni della misura di aggregazione. Un nuovo nodo dimensione viene creato sulla misura di aggregazione.
  2. Fare clic con il pulsante destro del mouse sul nuovo nodo o attivare il menu di scelta rapida, quindi selezionare Nuova relazione.
  3. Nelle proprietà selezionare ItemId come campo e ItemId come campo correlato.
  4. Selezionare Salva.

Per distribuire la misura di aggregazione, effettuare i seguenti passaggi.

  1. Selezionare le proprietà del nodo superiore della misura di aggregazione, quindi verificare che Utilizzo sia impostato su InMemoryRealTime.
  2. In Esplora soluzioni fare clic con il pulsante destro del mouse sulla misura di aggregazione o attivare il menu di scelta rapida, quindi selezionare Aggiungi indici dell'archivio colonne.
  3. Selezionare Salva tutto per creare gli indici della misura nel progetto.

Per creare un'entità di dati aggregati, effettuare i seguenti passaggi.

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto o attivare il menu di scelta rapida, quindi selezionare Aggiungi > Nuovo elemento.
  2. Selezionare Analisi e Entità di dati aggregati.
  3. Immettere un nome per l'entità di dati aggregati, quindi selezionare Aggiungi.
  4. In Esplora soluzioni andare alla voce Misura di aggregazione, quindi trascinarla sul nodo origine dati della nuova entità di dati aggregati.
  5. Andare al nodo Origine dati > Misura di aggregazione > Misure, quindi trascinare LineAmountMST sul nodo del campo.
  6. Impostare la proprietà della misura e la proprietà ExtendedDataType in base alle esigenze.
  7. Andare a Origine dati > misure di aggregazione e dimensioni aggregate, quindi trascinare la nuova dimensione aggregata sul nodo del campo. Impostare la proprietà Name, quindi selezionare il campo nella proprietà Attribute.
  8. Impostare la proprietà del nodo superiore IsPublic su Sì per abilitare l'entità di dati aggregati per OData, quindi immettere i nomi per la raccolta pubblica e l'entità pubblica in base alle esigenze.
  9. Creare una chiave primaria per il campo ItemId.
  10. Impostare la chiave primaria del nodo superiore sul nome della chiave.
  11. Selezionare Salva tutto e compilare.

È ora possibile testare l'entità di dati aggregati usando l'URL https://your solution name.axcloud.dynamics.com/data/Aggregate Data Entity Collection name.

Il seguente esempio di codice illustra come potrebbe essere l'output.

{
  "@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
    }
  ]
}

Risorse

Per altre informazioni, consultare Importare un'entità composita.