Entwickler: Terminologie in Microsoft Dataverse verstehen

Dataverse ist nicht nur eine Datenbank, sondern auch Webdienste, die es Entwicklern ermöglichen, mit Daten zu interagieren.

Wenn Sie mit dem ADO.NET Entity Framework vertraut sind, haben Architekten und Entwickler von datenorientierten Anwendungen mit der Notwendigkeit zu kämpfen, zwei unterschiedliche Ziele zu erreichen.

  • Sie müssen die Entitäten, Beziehungen und die Logik der Geschäftsprobleme, die sie lösen, modellieren.
  • Außerdem müssen sie mit den Datendiensten arbeiten, die zum Speichern und Abrufen der Daten verwendet werden.

Das Entity Framework ermöglicht es Entwicklern, mit Daten in Form von domänenspezifischen Objekten und Eigenschaften, wie z. B. Kunden und Kundenadressen, zu arbeiten, ohne sich mit den zugrunde liegenden Datenbanktabellen und -spalten beschäftigen zu müssen, in denen diese Daten gespeichert sind.

Während in Power Apps und Dataverse Tabellen und Spalten in der Benutzeroberfläche verwendet werden und sich auf die allgemeine Vorstellung davon beziehen, wie Daten in der Dataverse-Datenbank gespeichert werden, wird spezifische Terminologie (wie Entität und Attribute) verwendet, um sich auf das zugrundeliegende Datenmodell und die Schnittstellen zu beziehen, mit denen Entwickler je nach Protokoll oder Technologie arbeiten, um mit den Daten zu interagieren.

Die Datenstrukturen, mit denen Entwickler arbeiten, werden als Entitäten dargestellt, und der Begriff ist in den Namen der Dinge, die Entwickler verwenden, eingebrannt. Beispiel: ''

Zu... Verwenden... Entwickler werden...
Eine Dataverse-Tabelle erstellen Web-API POST eine Instanz des EntityMetadata EntityType an die /EntityDefinitions Ressource
Eine Dataverse-Tabelle erstellen .NET SDK Erstellen Sie eine Instanz der EntityMetadata-Klasse und verwenden Sie die CreateEntityRequest-Klasse, wenn Sie das SDK für .NET verwenden.
Erzeugen Sie eine Zeile oder einen Datensatz in einer Dataverse-Tabelle Web-API POST-Daten, die als ein bestimmter EntityType definiert sind. Eine Liste dieser EntityTypes finden Sie hier: Web-API EntityType-Referenz
Erzeugen Sie eine Zeile oder einen Datensatz in einer Dataverse-Tabelle .NET SDK Erstellen Sie eine Instanz der Entity-Klasse oder einer Klasse, die von ihr erbt (Account, Contact, etc.) und verwenden Sie die CreateRequest-Klasse, wenn Sie das SDK für .NET verwenden. Ein Entwickler kann die Informationen, die er zur Verwendung der Klasse Entity benötigt, in der Entity-Referenz finden.

Terminologieverwendung je nach Protokoll oder Technologie

Die in der Entwicklerdokumentation verwendete Terminologie hängt von dem Protokoll oder der Klassenbibliothek ab, die der Entwickler verwendet.

  • Bei der Arbeit mit der Web-API verwenden wir die vom OData-Protokoll definierte Terminologie. Datenstrukturen werden als EntityTypes definiert, die über Eigenschaften und Navigationseigenschaften verfügen.

  • Wenn wir mit dem .NET SDK arbeiten, verwenden wir Entity, weil es eine Entity-Klasse gibt. Die Entity-Klasse hat eine Attribute-Eigenschaft, die eine Sammlung von Attributen enthält, die durch Daten in einer AttributeMetadaten-Klasse und vielen anderen davon abgeleiteten Klassen definiert sind.

Wir verwenden die entsprechende Terminologie, um die SDK- und Web-API-Technologie zu beschreiben. In der Entwicklerdokumentation wird zuweilen eine andere Terminologie verwendet als in der Power Apps-Benutzeroberfläche. Die nachfolgende Tabelle gibt Ihnen eine Anleitung zu einigen terminologischen Unterschieden zwischen der Entwicklerdokumentation und dem Rest der Power Apps-Dokumentation.

Power Apps BENUTZEROBERFLÄCHE Dataverse SDK Web-API von Dataverse
Tabelle Entity EntityType
Spalte Attribut Eigenschaft
Zeile Datensatz Datensatz
Optionen OptionSet/Pickliste OptionSet
Ja/Nein Boolesch Boolesch