Über die Entitätsreferenz

  • Artikel

Verwenden Sie diese Referenz, um die verfügbaren Vorgänge, die für bestimmte Entitäten, die Standardattributattribute jeder Entität und Beziehungen zwischen Entitäten ausgeführt werden können, zu verstehen.

Notiz

Dieser Verweis wird von einem Mandanten erzeugt, in dem mehrere Lösungen von Dynamics 365 installiert, aber nicht angepasst sind. Hierzu zählen Entitäten, die nicht in Ihrer Umgebung vorhanden sind, weil diese Lösungen nicht installiert worden sind. Benutzerdefinierte Entitäten, Attribute und Beziehungen zählen nie dazu.

Diese Referenz enthält nur Entitäten, bei denen:

  • IsPrivate ist false
    • Außer den Entitäten, bei denen keine externen Anwendungsfälle vorhanden sein.
  • IsIntersect ist false
    • Außer den Entitäten, die zur Bestimmung der N:n-Beziehungen verwendet werden.
  • Die Entität unterstützt einige Vorgänge.
    • Außer den Entitäten, die Sie nicht verwenden können.

Alle Entitätsmetadateninformationen für Ihre Umgebung finden Sie unter: Die Metadaten für Ihr Unternehmen durchsuchen.

Nachrichten

Die Nachrichten in dieser Liste sind für die Entität anwendbar. Beispielsweise unterstützen benutzereigene Entitäten die Assign-, GrantAccess-, ModifyAccess- und RevokeAccess-Nachrichten, während unternehmenseigene Entitäten diese nicht unterstützten. Andere Entitäten erhalten spezialisierte Nachrichten wie z.B. DeleteAuditData, die nur für die Überwachungsentität geeignet ist.

Organisationsdienst

Wenn Sie den Organisationsdienst verwenden, können Sie in der Regel die entsprechende Anfrageklasse, die den Microsoft.Crm.Sdk.Messages- oder Microsoft.Xrm.Sdk.Messages-Namespaces gehört, aufrufen. Diese Klassen haben Namen, die das zum Nachrichtennamen hinzugefügte Präfix Request enthalten.

Einige Nachrichten werden als benutzerdefinierte Aktionen für die Lösungen, die sie unterstützen, hinzugefügt. Diese Nachrichten werden nicht in den SDK-Assemblys definiert, aber .NET-Entwickler können stark typisierte Klassen für Aktionen erstellen, indem sie die Codegenerierungstool (CrmSvcUtil.exe) oder die Klasse OrganizationRequest verwenden. Weitere Informationen: Generieren Sie Typen mit früher Bindung für eine Aktion.

Internet-API

Bei der Nutzung der Web-API können Sie in der Regel die entsprechende Funktion oder Aktion mit demselben Namen wie die Nachricht aufrufen. Nicht jede Meldung, die mithilfe der SDK-Assemblys aufgerufen werden kann, hat eine entsprechende Web-API-Funktion oder -Aktion. Zum Beispielt ist die SetState-Nachricht abgelehnt und für die Web-API nicht imlementiert worden.

Entitätseigenschaften

Zu diesem Abschnitt zählen eher ausgewählte Entitätseigenschaften als alle davon. Nur Eigenschaften, die für Entwickler am hilfreichsten sein sollen, werden eingeschlossen. Einigen Entitäten können geändert werden. Wenn Sie die hier nicht aufgeführten Eigenschaften finden oder die aktuellen Eigenschaftswerte in Ihrer Umgebung anzeigen müssen, sehen Sie Die Metadaten für Ihr Unternehmen durchsuchen.

Attribute

Attribute werden in zwei unterschiedlichen Abschnitten aufgeführt: Druckattribute und Schreibschutzattribute. Das Ziel dieser Trennung ist sich auf den Attributen zu konzentrieren, die einer Entwickler festlegen kann, wenn eine Entitätsinstanz erstellt oder aktualisiert wird. Diese Attribute verstanden zu haben kann einem Entwickler helfen, zu verstehen, was er mit der Entität außer der bloßen Übersicht der Werte machen kann.

Die Attribute im Abschnitt Schreibbare Attribute geben für entweder die Eigenschaften IsValidForCreate oder IsValidForUpdate (normalerweise beide) den Wert Wahr zurück. Wenn eine dieser Eigenschaften als „false” gesetzt wird, wird das angegeben.

Schreibgeschützte Attribute geben bei den Eigenschaften IsValidForCreateundIsValidForUpdate immer Falsch zurück.

Beziehungen

Diese EntityMetadata-Klasse enthält drei Eigenschaften, um die Beziehungen darzustellen:

Eigenschaft Typ Beschreibung
OneToManyRelationships OneToManyRelationshipMetadata[] Ruft das Array von 1:n-Beziehungen für die Entität aus.
ManyToOneRelationships OneToManyRelationshipMetadata[] Ruft das Array von N:1-Beziehungen für die Entität aus.
ManyToManyRelationships ManyToManyRelationshipMetadata[] Ruft das Array von N:n-Beziehungen für die Entität aus.

Notiz

Es ist wichtig zu beachten, dass jede Entität die zu der anwendbaren Beziehungen aufführt; jede Beziehung wird von beiden verbundenen Entitäten geteilt. Die Beziehungen existieren zwischen den Entitäten. Wenn die 1:n-Beziehungen existieren, sind die N:1-Beziehungen eine bloße Übersicht einer 1:n-Beziehung von der Referenzentität.

Eins-zu-vielen-Beziehungen

Um darzustellen, dass es keine tatsächlichen N:1-Beziehungen mit einer minimalen Verwechslungschance gibt, werden die Details jeder Beziehung nur einmal dokumentiert. Jede 1:n-Beziehung ist in der referenzierten Entität aufgelistet und enthält ausgewählte Beziehungsdetails und einen Link zu der entsprechenden N:1-Beziehung. Jede N:1 aufgeführte Beziehung enthält nur einen Link zur entsprechenden 1:n-Beziehung.

Viele-zu-vielen-Beziehungen

Jede N:n-Beziehung enthält Entity1LogicalName und Entity2LogicalName. Weitere Details zu dieser Dokumentationsbeziehung sind nur im Thema Entity1 enthalten. Jede N:n-Beziehung, in der die Entität Entity2 ist, enthält nur einen Link zu den Details, die im Thema Entity1 gefunden wurden.

Anmerkung

Die Entwicklerkonzepte und Vorgänge in Bezug auf den Vertrieb in Dynamics 365 Customer Engagement (on-premises) ähneln Dynamics 365 Sales. Informationen zur Erweiterbarkeit von verkaufsbezogenen Entitäten finden Sie in der Entwickleranleitung für Dynamics 365 Sales.