Mit zusammengesetzten Datenentitäten arbeiten

  • 10 Minuten

Eine zusammengesetzte Entität ist ein Konzept, mit dem Sie eine einzelne Entität erstellen können, indem Sie mehrere Entitäten verwenden, die zueinander in Beziehung stehen. Das Konzept verwenden Sie normalerweise in Szenarien, in denen eine Entität als ein einzelnes Dokument dargestellt werden kann, z. B. als Kundenauftragskopf, Kundenauftragsposition, Rechnungskopf, Rechnungsposition und Lieferantenkatalog.

Eine zusammengesetzte Entität ist eher in asynchronen Integrationsszenarien als in synchronen OData-Szenarien anwendbar. Eine programmgesteuerte Schnittstelle ist für zusammengesetzte Entitäten in X++ nicht verfügbar und wird nur für eine Datenverwaltungsplattform unterstützt, die Teil von XML-basierten Importen und/oder Exporten ist.

Das Importieren und Exportieren von zusammengesetzten Entitäten ist ein schneller und einfacher Vorgang im Arbeitsbereich Datenverwaltung von Finanz‑ und Betriebs-Apps.

Gehen Sie folgendermaßen vor, um eine zusammengesetzte Datenentität zu importieren oder zu exportieren:

  1. Wählen Sie die Kachel Import/Export im Arbeitsbereich Datenverwaltung aus.
  2. Geben Sie einen Namen in das Feld Name ein.
  3. Wählen Sie das Datenquellenformat für Importe aus oder fügen Sie die zu exportierende Entität hinzu.
  4. Wählen Sie Importieren für Importe oder Paket herunterladen aus, um einen Export durchführen.

Mit aggregierten Datenentitäten arbeiten

Eine aggregierte Datenentität unterscheidet sich konzeptionell von Datenentitäten, die für den Import und Export mit dem Datenverwaltungsframework genutzt werden. Aggregierte Datenentitäten basieren auf Datenansichten. Sie können sie verwenden, um die Datenstruktur für Analysezwecke zu konsolidieren, zusammenzufassen und zu vereinfachen.

Aggregierte Datenentitäten umfassen die folgenden Komponenten:

  • Messungen aggregieren
  • Dimensionen aggregieren
  • Modelldimensionsreferenzen

Wenn Sie die aggregierte Datenentität erstellen, wobei die Eigenschaft IsPublic auf true gesetzt ist, kann mit OData als Datenentität über dieselbe URL: https://your dynamics name.dynamics.com/data/aggregate data entity darauf zugegriffen werden.

Alle Entwicklungen werden in Visual Studio durchgeführt, um aggregierte Datenentitäten zu erstellen.

Führen Sie die folgenden Schritte aus, um in Visual Studio eine aggregierte Messung zu erstellen.

  1. Klicken Sie mit der rechten Maustaste im Fenster Projektmappen-Explorer auf ein Projekt oder aktivieren Sie das Kontextmenü, und wählen Sie dann Hinzufügen > Neues Element aus.
  2. Wählen Sie Analyse und Aggregatmessung aus.
  3. Geben Sie einen Namen für die Aggregatmessung ein, und wählen Sie Hinzufügen aus.
  4. Navigieren Sie im Anwendungs-Explorer zu Datenmodell > Ansichten.
  5. Wählen Sie CustInvoiceTransExpanded aus, und ziehen Sie es dann auf die MeasureGroup1 auf der Aggregatmessung.
  6. Wechseln Sie dann zum Knoten Dimension, und entfernen Sie das Feld Datum.
  7. Gehen Sie zum Knoten Messungen, und erstellen Sie eine neue Messung.
  8. Wählen Sie das Feld LineAmountMST aus, und wählen Sie unter den Eigenschaften die Option Summe als Standardaggregat aus.
  9. Wählen Sie Alle speichern aus.

Führen Sie die folgenden Schritte aus, um Aggregatdimensionen zu erstellen.

  1. Klicken Sie mit der rechten Maustaste im Fenster Projektmappen-Explorer auf ein Projekt oder aktivieren Sie das Kontextmenü, und wählen Sie dann Hinzufügen > Neues Element aus.
  2. Wählen Sie Analyse und Aggregatdimension aus.
  3. Geben Sie einen Namen für die Aggregatdimension ein, und wählen Sie Hinzufügen aus.
  4. Navigieren Sie im Anwendungs-Explorer zu Datenmodell > Ansichten.
  5. Wählen Sie CustInvoiceTransExpanded aus, und ziehen Sie es dann zum Stamm der Aggregatdimension.
  6. Gehen Sie zum Knoten Attribute, und entfernen Sie alle Elemente außer den Dimensionen ItemId und MyAggregate.
  7. Wählen Sie Alle speichern aus.

Führen Sie die folgenden Schritte aus, um Dimensionsreferenzen zu modellieren:

  1. Wählen Sie im Projektmappen-Explorer die Aggregatdimension aus, und ziehen Sie sie zum Knoten Dimensionen auf der Aggregatmessung. Ein neuer ausgehender Dimensionsknoten wurde auf der Aggregatmessung erstellt.
  2. Klicken Sie mit der rechten Maustaste auf den neuen Knoten, und aktivieren Sie Neue Beziehung.
  3. Wählen Sie unter Eigenschaften ItemId als Feld und ItemId als zugehöriges Feld aus.
  4. Wählen Sie Speichern aus.

Führen Sie die folgenden Schritte aus, um eine Aggregatmessung bereitzustellen.

  1. Wählen Sie die Eigenschaften für den obersten Knoten der Gesamtmessung aus, und stellen Sie dann sicher, dass der Verbrauch auf InMemoryRealTime eingestellt ist.
  2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Aggregatmessung, oder aktivieren Sie das Kontextmenü, und wählen Sie dann Säulenspeicherindizes hinzufügen aus.
  3. Klicken Sie auf die Option Alle speichern. Dann werden die Messindizes im Folgenden im Projekt erstellt.

Führen Sie die folgenden Schritte aus, um eine Aggregatdatenentität zu erstellen.

  1. Klicken Sie mit der rechten Maustaste im Fenster Projektmappen-Explorer auf ein Projekt oder aktivieren Sie das Kontextmenü, und wählen Sie dann Hinzufügen > Neues Element aus.
  2. Wählen Sie Analyse und Aggregatdatenentität aus.
  3. Geben Sie einen Namen für die Aggregatdatenentität ein, und wählen Sie dann Hinzufügen aus.
  4. Wählen Sie im Projektmappen-Explorer die Aggregatdimension aus, und ziehen Sie sie dann zum Datenquellenknoten auf der neuen Aggregatdatenentität.
  5. Wechseln Sie zu Datenquelle > Aggregierte Messung > Messungen, und ziehen Sie LineAmountMST zum Feldknoten.
  6. Richten Sie die Messungseigenschaft und die erweiterte Datentypeigenschaft je nach Bedarf ein.
  7. Wechseln Sie zu Datenquelle > Unsere aggregierten Maße und Abmessungen, und ziehen Sie dann die neue aggregierte Dimension auf den Feldknoten. Richten Sie die Eigenschaft Name ein, und wählen Sie dann das Feld in der Eigenschaft Attribut aus.
  8. Stellen Sie die oberste Knoteneigenschaft IsPublic auf Ja ein, um die Datenentität aggregieren für OData zu aktivieren und gegebenenfalls Namen für die öffentliche Sammlung und die öffentliche Entität einzugeben.
  9. Erstellen Sie einen Primärschlüssel für das Feld ItemId.
  10. Richten Sie den Primärschlüssel auf dem obersten Knoten auf den Schlüsselnamen ein.
  11. Wählen Sie Alle speichern aus, und beginnen Sie mit der Erstellung.

Sie können jetzt mit der URL https://your solution name.axcloud.dynamics.com/data/Aggregate Data Entity Collection name die aggregierte Datenentität testen.

Das folgende Codebeispiel veranschaulicht, wie die Ausgabe aussehen könnte.

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

Ressourcen

Unter Eine zusammengesetzte Entität importieren finden Sie dazu weitere Informationen.