Entitätsmetadaten

Jede Entität enthält die Funktion, strukturierte Daten zu speichern. Für Entwickler entsprechen Entitäten den Klassen, die Sie beim Arbeiten mit Daten im Common Data Service verwenden.

Entitätsnamen

Jede Entitäten hat einen eindeutig definierten Namen, wenn es erstellt wird, Dieser Name ist auf verschiedene Weise dargestellt:

Eigenschaftenname Beschreibung
SchemaName In der Regel eine Pascal-umkleidete Version des logischen Namen. z. B.Debitorenkonto
CollectionSchemaName Eine mehrzahlige Version des Anzeigenamens. z. B. Konto
LogicalName Alle kleingeschriebene Version des Schemanamens. z. B. Konto
LogicalCollectionName Alle kleingeschriebene Versionen des Schemanamens. z. B. Konto
EntitySetName Verwendet. um Sammlungen mit Internet API zu identifizieren. Standardmäßig ist sie gleich wie der logische Sammlungsname.
Es ist möglich den Namen einer Entität zu ändern, indem programmgesteuert die Metadatenänderung aktualisiert wird. Dies sollte nur gemacht werden, bevor der Internet API-Code für die Entität erstellt wird. Weitere Informationen: Web API Typen und Vorgänge > Änderung der Name eines Entitätssatzes

Hinweis

Wenn Sie ein benutzerdefiniertes Entität erstellen, wird der Name, den Sie auswählen, mit dem Anpassungspräfixwert des Lösungsherausgebers verwendet, der mit der Lösung zugeordnet wird, als die Entitä erstellt wurde. Im Gegensatz zum Festlegen des Namens der Entität können Sie den Namen der Entität nach dem Erstellen nicht mehr ändern. Wenn Sie konstante Namen für Metadatenelemente in der Lösung möchten, können Sie sie im Kontext einer Lösung erstellen, die Sie zu einem Lösungsherausgeber zuordnen, der das Anpassungspräfix enthält, das Sie verwenden möchten. Weitere Informationen: Erstellen eines Lösungsherausgebers und eine Lösung

Jedes Entität weist auch drei Eigenschaften auf, die lokalisierte Werte anzeigen.

Name Beschreibung
DisplayName Normalerweise gleich wie der Schemaname, können aber Leerzeichen enthalten. z. B.Debitorenkonto
DisplayCollectionName Eine mehrzahlige Version des Anzeigenamens. z. B. Konto
Description Ein kurzer SAtz, der die Entität beschreibt, z.B. Ein Geschäft, das einen Kunden oder einen potenziellen Kunden darstellt. Das Unternehmen, mit dem Geschäftstransaktionen abgerechnet werden.

Dies sind die Lokalisierungswerte, die verwendet werden, um sich auf die Entität in einer App zu beziehen. Diese Werte können jederzeit geändert werden. Informationen zum Hinzufügen oder Bearbeiten von lokalisierten Werten finden Sie unter Common Data Service-Anpassungshandbuch: Übersetzen angepasster Entitäts- und Feldtexte in andere Sprachen.

Primärschlüssel

Der PrimaryIdAttribute-Eigenschaftswert wird der logische Name des Attributs, des Primärschlüssels für die Entität.

Standardmäßig weisen alle Entitäten ein einzelnes Attribut des GUID- Bezeichners auf. Dies ist normalerweise < Entität logischer Name>+ Id.

Primärer Name

Der PrimaryNameAttribute-Eigenschaftswert wird der logische Name des Attributs, der den Zeichenwert speichert, der den Entitätsdatensatz identifiziert. Dies ist der Wert, der in einen Hyperlink angezeigt wird, um den Datensatz in einer Benutzeroberfläche zu öffnen.

Beispiel: Die Kontaktentität nutzt das fullname Attritut als primäres Namensattribut.

Hinweis

Nicht jede Entität hat einen primären Namen. Einige Entitäten werden nicht in einer Benutzeroberfläche angezeigt.

Entitätsbilder

Der PrimaryImageAttribute-Eigenschaftswert wird der logische Name des Attributs, der den Bildwert speichert, der den Entitätsdatensatz identifiziert. Jede Entität kann nur ein Bildattribut haben und der logische Name des Attributs ist immer entityimage.

Beispiel: Das Kontaktentität EntityImage Attribut kann ein Bild des Kontakts speichern.

Für Leistungsgründe sind Entitätsbilder nicht in den Abrufvorgängen enthalten, es sei denn, sie werden explizit angefordert.

Jede Entität, die Entitätsbilder werden, bestehen aus drei unterstützenden Attributen.

SchemaName Typ Beschreibung
EntityImage_Timestamp BigIntType Der Wert zeigt an, wenn das Bild zuletzt aktualisiert wurde, und wird verwendet, um sicherzustellen, dass die aktuelle Version des Bilds heruntergeladen und auf dem Client zwischengespeichert wird.
EntityImage_URL StringType Eine absolute URL, um das Entitätsbild in einem Client anzuzeigen.
EntityImageId UniqueIdentifierType Der eindeutige Bezeichner des Bilds

Weitere Informationen:

Hinweis

Dies ist anders als das Symbol, das für eine Entität in Modell-angetriebenen Apps angezeigt wird. Die IconVectorName-Eigenschaft enthält den Namen der SVG-Webressource, die dieses festlegt.

Arten von Entitäten

Für die Funktionen und das Verhalten von Entitäten hängt von einigen Entitätseigenschaften ab. Die meisten der Eigenschaften sind verhältnismäßig einfach und haben aussagekräftige Namen. Vier, die einige weitere Erklärung benötigen, können: Besitz, Aktivitätsentitäten, Activityparty-Entität und Untergeordnete Entitäten.

Entitätsbesitz

Entitäten können kategorisiert werden, welchen Daten innerhalb sie gehören. Dies ist ein wichtiges Konzept, das zugeordnet wird, beispielsweise wie Sicherheit auf Entitäten angewendet werden. Diese Informationen ist die OwnershipTypeEigenschaft. Die folgende Tabelle beschreibt die unterschiedlichen Besitztypen in :

Besitztyp Beschreibung
Geschäftlich Daten gehören der Unternehmenseinheit. Zugriff auf die Daten kann auf der Unternehmenseinheitebene gesteuert werden.
Keine Daten, die zu keiner anderen Entität gehören.
Organisation Daten, die der Organisation gehören. Der Zugriff auf die Daten wird auf Organisationsebene gesteuert.
Benutzer oder Team Daten, die zu einem Benutzer oder einem Team gehören. Aktionen, die für diese Datensätze ausgeführt werden, können auf Benutzerebene gesteuert werden.

Wenn Sie neue Entitäten erstellen, sind die einzigen Besitzoptionen: Organisation oder Benutzer oder Team. Nachdem Sie eine Wahl für diese Option auswählen, können Sie sie nicht mehr geändert werden. Wählen Sie Benutzer oder Team für eine präzisste Kontrolle darüber, wem Aktionen für Datensätze anzuzeigen oder ausgeführt werden können. Wählen Sie Organisation wenn dieses Maß an Kontrolle nicht erforderlich.

Aktivitätsentitäten

Eine Aktivität ist eine Aufgabe, die von einem Benutzer ausgeführt wurde oder auszuführen ist. Eine Aktivität ist eine beliebige Aktion, für die ein Eintrag in einem Kalender vorgenommen werden kann.

Aktivitäten werden anders gestaltet als andere Arten Entitäten, die Geschäftsdaten speichern. Daten über Aktivitäten werden oft in einer Liste angezeigt, aber die Aktivität benötigt der eindeutige Eigenschaften. Anstelle einer einzelnen Aktivitätsentität mit beliebigen Eigenschaft gibt es separate Arten von Aktivitätsentitäten und jede von ihnen erbt Eigenschaften einer Genauigkeit ActivityPointer-Entität. Die Entitäten mit dem IsActivity-Eigenschaftensatz legt den Wert true fest.

Entität Beschreibung
Termin Verpflichtung, die ein Zeitintervall mit Start-/Endzeit und Dauer darstellt.
Email Aktivität, die unter Verwendung von E-Mail-Protokollen übermittelt wird.
Fax Aktivität, die das Anrufergebnis sowie die Anzahl der Seiten eines Fax nachverfolgt und optional eine elektronische Kopie des Dokuments speichert
Brief Aktivität, die die Zustellung eines Briefs nachverfolgt. Die Aktivität kann die elektronische Kopie des Briefs enthalten.
PhoneCall Aktivität zur Nachverfolgung eines Telefonanrufs.
RecurringAppointmentMaster Der Mastertermin einer Terminserie.
Social Media-Aktivitäten Nur zur internen Verwendung.
Aufgabe Allgemeine Aktivität, die die auszuführende Arbeit darstellt

Immer wenn eine der folgenden Arten der Aktivitätsentitäts-Datensätzen erstellt wird, wird ein entsprechender ActivityPointer Entitätsdatensatz erstellt mit dem gleichen eindeutigen ActivityId Attributwert des Bezeichners. Sie können keine Instanzen erstellen, löschen oder aktualisieren der ActivityPointer Entität, aber Sie können ihn abrufen. Damit können Aktivitätstypen in einer Liste angezeigt werden.

Sie können benutzerdefinierte Aktivitätsentitäten erstellen, die sich gleich verhalten.

ActivityParty-Entität

Diese Entität wird verwendet, um die Struktur Aktivitätsentitätsattributen hinzuzufügen PartyListType, die Verweise in anderen Entitäten umfassen. Sie verwenden die Entität, wenn Sie Werte für Aktivitätsentitätsattribute wie oder Email.to . PhoneCall.from erstellen. Klicken Sie auf ActivityParty-Entität legen Sie das ParticipationTypeMask-Attribut fest, um die Rollen zu definieren, die den Verweis wiedergeben. Rollen umfassen Sender``ToRecipient``Organizer und mehr.

Sie können die Entität ActivityParty abfragen, aber Sie können eine Aktivitätspartei außerhalb der Aktivität nicht erstellen, abrufen, aktualisieren oder löschen, mit dem sie verknüpft ist. Weitere Informationen:

Untergeordnete Entitäten

Entitäten, in denen die IsChildEntity Eigenschaft wahr ist, hat nie definierte Rechte und wir nie vom Benutzer oder Team besessen. Vorgänge, die auf einer untergeordneten Entität ausgeführt werden, werden an die Entität gebunden, mit der sie über eine n: 1-Beziehung zugeordnet sind. Benutzer können Vorgänge in untergeordneten Entitäten nur ausführen, indem sie denselben Vorgang für die verknüpfte Entität ausführen. Untergeordnete Entitäten werden automatisch gelöscht, wenn der Datensatz von dem sie abhängen, gelöscht wird.

Beispielsweise PostComment, PostLikeund PostRole sind alle untergeordneten Elemente der Post Entität.

Entitätsschlüssel

Jede Alternativschlüsseldefinition hat eine oder mehrere Attribute in Kombination, mit der eine Entitätsinstanz eindeutig identifiziert wird. Alternativschlüssel werden in der Regel nur für die Integration mit externen Systemen angewendet. Sie können Alternativschlüssel definieren, um einen Datensatz eindeutig zu identifizieren. Dies ist dann von Nutzen, wenn Sie Daten in ein einzelnes System integrieren, das nicht den Schlüssel des GUID- Bezeichnerwert unterstützt. Sie können einen einzelnen Feldwert oder einer Kombination von Feldwerten definieren, um eine Entität eindeutig zu identifizieren. Einen Alternativschlüssel hinzufügen, wird eine Eindeutigkeitseinschränkung für diese Attribute. Es ist nicht möglich, einen anderen Entitätsdatensatz zu erstellen oder zu aktualisieren, um die gleichen Werte zu haben.

Weitere Informationen:

Entitätsstatus

Die meisten Geschäftsentitäten haben zwei Eigenschaften zum Nachverfolgen des Zustands eines Datensatzes. Dies sind StateCode, für die Status in Modell-angetriebenen Apps und StatusCode, die Statusgrund in Modell-angetriebenen Apps genannt werden.

Beide Attribute enthalten einen Satz von Optionen, um die gültigen Werte anzuzeigen. Die StateCode und StatusCode-Attributwerte werden verknüpft, damit nur bestimmte StatusCode Optionen für ein gegebenes StateCode gültig sind.

Dies kann nach Entität variieren, aber das allgemeine Muster für viele Entitäten und Standard- und benutzerdefinierte Entitäten ist dies:

StateCode-Optionen StateCode-Optionen
0 : Aktiv 1 : Aktiv
1 : Inaktiv 2 : Inaktiv

Für einige Entitäten gelten verschiedene Sätze von Optionen.

Beispiel: PhoneCall Entität StateCode sowie StatusCode Optionen

StateCode StatusCode
0 : Offen 1 : Offen
1 : Abgeschlossen 2 : Erledigt
4 : Empfangen
2: Storniert 3: Storniert

Der Satz gültiger Zustandscodes für eine Entität ist nicht anpassbar, aber die Statuscodes können angepasst werden. Sie können zusätzliche StatusCode Optionen für ein entsprechendes StateCode hinzufügen.

Für die Entität "Anfrage" und benutzerdefinierte Entitäten können Sie zusätzliche Kriterien für gültige Wechsel zwischen Status definieren. Weitere Informationen:

Siehe auch

Common Data Service-Entitäten