Anpassen von Entitätsmetadaten

  • Artikel

Entitäten werden von Metadaten definiert. Durch die Definition oder Änderung der Entitätsmetadaten können Sie die Funktionen einer Entität steuern. Verwenden Sie zum Anzeigen der Entitätsmetadaten für Ihre Organisation den Metadatenbrowser. Herunterladen des Metadatenbrowsers.

Weitere Informationen: Durchsuchen der Metadaten für Ihre Organisation.

Dieses Thema behandelt die programmgesteuerte Verwendung von Entitäten. Informationen über die Arbeit mit Entitäten in der Anwendung finden Sie unter Entitäten (Datensätze) erstellen oder bearbeiten.

Entitäten können mithilfe des Organisationsservice oder der Web-API erstellt. Die folgenden Informationen können auf beide angewendet werden.

Entitätsmetadatenvorgänge

Die Verwendung von Entitätsmetadaten hängt davon ab, welchen Service Sie verwenden.

Während die Internet-API ein RESTful API Endpunkt ist, verwendet sie eine andere Weise zum Erstellen, Abrufen, Aktualisieren und Löschen von Metadaten. Verwenden Sie POST, GET, PUT und DELETE HTTP-Verben, um mit Metadaten zu arbeiten. Weitere Informationen: Erstellen und Aktualisieren von Entitätsdefinitionen mit der Web-API.

Eine Ausnahme bildet die RetrieveMetadataChanges Funktion, mit der Sie eine Metadatenabfrage zusammenstellen und Änderungen im Laufe der Zeit verfolgen können.

Bei der Verwendung von Organisations-Service, können Sie die RetrieveMetadataChangesRequest-Klasse verwenden. Diese Klasse enthält die Daten, die benötigt werden, um eine Sammlung Metadatendatensätze abzurufen, die die angegebenen Kriterien erfüllen. Die RetrieveMetadataChangesResponse gibt einen Zeitstempelwert zurück, der zu einem späteren Zeitpunkt verwendet werden kann, um Informationen dazu zurückzugeben, wie Metadaten sich seit der letzten Anfrage geändert haben.

Meldung Web-API SDK-Assembly
CreateEntity Nutzen Sie eine POST-Anfrage, um eine Daten zum Erstellen einer Entität zu senden. CreateEntityRequest
DeleteEntity Verwenden Sie eine DELETE-Anforderung, um eine Entität zu löschen. DeleteEntityRequest
RetrieveAllEntities Verwenden Sie eine GET-Anforderung, um Entitätsdaten abzurufen. RetrieveAllEntitiesRequest
RetrieveEntity RetrieveEntity Funktion RetrieveEntityRequest
UpdateEntity Verwenden Sie eine PUT-Anforderung, um eine Entität zu aktualisieren. UpdateEntityRequest
RetrieveMetadataChanges
Wird zusammen mit Objekten im Namensraum Microsoft.Xrm.Sdk.Metadata.Query erstellt, um eine Abfrage zum effizienten Abrufen und Erkennen von Änderungen an bestimmten Metadaten zu erstellen. Weitere Informationen: Abrufen und Erkennen von Änderungen bei Metadaten		 RetrieveMetadataChanges Funktion RetrieveMetadataChangesRequest

Verfügbare Optionen, wenn Sie eine benutzerdefinierte Entität erstellen

Die folgende Tabelle enthält die Optionen, die zur Verfügung stehen, wenn Sie eine benutzerdefinierte Entität erstellen. Sie können diese Eigenschaften nur festlegen, wenn Sie eine benutzerdefinierte Entität erstellen.

Option Beschreibung
Erstellen einer benutzerdefinierten Aktivität Sie können keine Entität erstellen, der einer Aktivität ist, indem die Eigenschaft IsActivity festgelegt werden, wenn der Organisationsservice oder Internet verwendet wird. Für weitere Informationen siehe Benutzerdefinierte Aktivitäten in Dynamics 365 Customer Engagement (on-premises).
Entitätsnamen Es gibt zwei Arten von Namen, und beide müssen mit einem Anpassungspräfix versehen sein:

LogicalName: Name, der die Version des Namens der Entität ist, die in Kleinbuchstaben festgelegt ist.

SchemaName: Name, der zum Erstellen der Datenbanktabellen für die Entität verwendet wird. Dieser Name kann Groß- und Kleinbuchstaben enthalten. Die verwendete Groß-/Kleinschreibung legt den Namen des Objekts fest, das für das Programmieren mit starker Typisierung generiert wird, oder wenn Sie den REST-Endpunkt verwenden.

Hinweis: Wenn der logische Name vom Schemanamen abweicht, überschreibt der Schemaname den Wert, den Sie für den logischen Namen festlegen.

Wenn eine Entität in der Anwendung im Kontext einer bestimmten Lösung erstellt wird, wird das Anpassungspräfix verwendet, das für den Publisher der Lösung festgelegt wird. Wenn eine Entität programmgesteuert erstellt wird, können Sie das Anpassungspräfix auf eine Zeichenfolge festlegen, die zwischen zwei und acht Zeichen umfasst, ausschließlich alphanumerische Zeichen enthält und mit einem Buchstaben beginnt. Sie darf nicht mit “mscrm” beginnen. Die bewährte Methode besteht darin, das Anpassungspräfix zu verwenden, das vom Herausgeber definiert wurde, dem die Lösung zugeordnet ist, aber dies ist keine Voraussetzung. Ein Unterstrichzeichen muss zwischen dem Anpassungspräfix und dem logischen Namen oder Schemanamen angegeben sein.
Besitz Verwenden Sie die OwnershipType-Eigenschaft, um dies festzulegen. Verwenden Sie die OwnershipTypes Enumeration oder OwnershipTypes EnumType, um den Typ des Entitätsbesitzes festzulegen. Die einzigen gültigen Werte für benutzerdefinierte Entitäten sind OrgOwned oder UserOwned. Weitere Informationen finden Sie unter Entitätsbesitz.
Primäres Attribut Verwenden Sie beim Organization Service die Eigenschaft CreateEntityRequest.PrimaryAttribute, um dies festzulegen.

Mit der Internet-API muss das JSON, welches, das die Entität definiert, ein StringAttributeMetadata mit der IsPrimaryName -Eigenschaft auf true festgelegt enthalten.

In beiden Fällen muss das Zeichenfolgenattribut als Text formatiert werden. Der Wert dieses Attributs wird bei einer Suche nach verknüpften Entitäten angezeigt. Daher sollte der Wert des Felds einen Namen für den Entitätsdatensatz darstellen.

Aktivieren von Entitätsfunktionen

In der folgenden Tabelle sind die Entitätsfunktionen aufgeführt. Sie können diese Funktionen festlegen, wenn Sie eine Entität erstellen, oder Sie können sie später aktivieren. Nachdem diese Funktionen aktiviert wurden, können sie nicht mehr deaktiviert werden.

Funktionen Beschreibung
Geschäftsprozessflüsse Legen Sie IsBusinessProcessEnabled auf true fest, um die Entität für Geschäftsprozessflüsse zu aktivieren.
Notizen So können Sie eine Entitätsbeziehung mit der Annotation-Entität erstellen und das Einschließen eines Hinweise-Bereichs im Entitätsformular aktivieren. Durch den Einschluss von Notizen können Sie auch Anlagen zu Datensätzen hinzufügen.

Verwenden Sie für den Organization Service die Eigenschaft CreateEntityRequest oder UpdateEntityRequestHasNotes.

Mit der Web-API legen Sie die EntityMetadata fest.HasNotes-Eigenschaft.
Aktivitäten So erstellen Sie eine Entitätsbeziehung mit der ActivityPointer-Entität, sodass alle Aktivitätstypentitäten mit dieser Entität verknüpft werden können.

Verwenden Sie für den Organization Service die Eigenschaft CreateEntityRequest oder UpdateEntityRequestHasActivities.

Legen Sie mit der Web-API die EntityMetadata fest.HasActivities-Eigenschaft.
Verbindungen Um das Erstellen von Verbindungsdatensätzen zu aktivieren, um diese Entität mit anderen Verbindungsentitäten zu verknüpfen, legen Sie den IsConnectionsEnabled.Value-Eigenschaftswert zu true fest.
Warteschlangen Verwenden Sie die IsValidForQueue-Eigenschaft, um Unterstützung für Warteschlangen hinzuzufügen. Wenn Sie diese Option aktivieren, können Sie auch die AutoRouteToOwnerQueue-Eigenschaft festlegen, um Datensätze automatisch in die Standardwarteschlange des Besitzers zu verschieben, wenn ein Datensatz dieses Typs erstellt oder zugewiesen wird.
E-Mail Legen Sie die IsActivityParty-Eigenschaft fest, sodass Sie eine E-Mail an die E-Mail-Adresse in diesem Datensatztyp senden können.

Bearbeitbare Entitätseigenschaften

In der folgenden Tabelle sind die Entitätseigenschaften aufgeführt, die Sie bearbeiten können. Sie können diese Optionen jederzeit aktualisieren, es sei denn, dass eine verwaltete Eigenschaft sie nicht zulässt.

Eigenschaft Beschreibung
Schnellerfassung erlauben Verwenden Sie IsQuickCreateEnabled, um Schnellerfassungsformulare für die Entität zu aktivieren. Damit Sie Schnellerfassungsformulare verwenden können, müssen Sie zunächst ein Schnellerfassungsformular erstellen und veröffentlichen.
Hinweis:
Aktivitätsentitäten unterstützen keine Schnellerfassungsformulare.
Zugriffsteams Verwenden Sie AutoCreateAccessTeams, um die Entität für Zugriffsteams zu aktivieren. Weitere Informationen hierzu finden Sie unter Informationen zu Teamvorlagen.
Primäres Image Wenn eine Entität ein Bildattribut hat, können Sie die Anzeige des Bilds in der Anwendung mithilfe von PrimaryImageAttribute aktivieren oder deaktivieren. Weitere Informationen finden Sie unter Entitätsbilder.
Ändern des Anzeigetexts Die verwaltete Eigenschaft IsRenameable verhindert, dass der Anzeigename in der Anwendung geändert wird. Sie können die Beschriftungen jedoch programmgesteuert ändern, indem Sie die DisplayName- und DisplayCollectionName-Eigenschaft aktualisieren.
Bearbeiten der Entitätsbeschreibung Die verwaltete Eigenschaft IsRenameable verhindert, dass die Entitätsbeschreibung in der Anwendung geändert wird. Sie können die Beschriftungen jedoch programmgesteuert ändern, indem Sie die Description-Eigenschaft aktualisieren.
Aktivieren für die Verwendung im Offlinemodus Verwenden Sie IsAvailableOffline, um für Dynamics 365 for Microsoft Office Outlook-Benutzer mit Offlinezugriff die Möglichkeit, Daten für diese Entität offline zu nehmen, zu aktivieren oder zu deaktivieren.
Aktivieren des Outlook-Lesebereichs Hinweis:

Die Eigenschaft IsReadingPaneEnabled ist nur für den internen Gebrauch bestimmt.

Um die Fähigkeit von Dynamics 365 for Outlook-Benutzern zu aktivieren oder zu deaktivieren, Daten für diese Entität einzusehen, verwenden Sie den Outlook Lesebereich. Sie müssen diese Eigenschaft in der Anwendung festlegen.
Aktivieren des Seriendrucks Verwenden Sie IsMailMergeEnabled, um die Möglichkeit zu aktivieren oder zu deaktivieren, zusammengeführte Office Word-Dokumente zu erstellen, die Daten aus dieser Entität verwenden.
Duplikaterkennung aktivieren Verwenden Sie IsDuplicateDetectionEnabled, um die Duplikaterkennung für die Entität zu aktivieren oder zu deaktivieren. Weitere Informationen finden Sie unter Duplizierte Daten in Dynamics 365 Customer Engagement (on-premises) entdecken.
Integration SharePoint aktivieren Verwenden Sie IsDocumentManagementEnabled, um die SharePoint Server-Integration für die Entität zu aktivieren oder zu deaktivieren. Für weitere Information, siehe Aktivieren der Dokumentenverwaltung für Entitäten.
Aktivieren von Dynamics 365 for phones Verwenden Sie IsVisibleInMobile., um die Möglichkeit, Daten für diese Entität anzuzeigen, für Dynamics 365 for phones-Benutzer zu aktivieren oder zu deaktivieren.
Dynamics 365 for Tablets Verwenden Sie IsVisibleInMobileClient., um die Möglichkeit, Daten für diese Entität anzuzeigen, für Dynamics 365 for tablets-Benutzer zu aktivieren oder zu deaktivieren.

Wenn die Entität für Dynamics 365 for tablets verfügbar ist, können Sie IsReadOnlyInMobileClient verwenden, um anzugeben, dass die Daten für den Datensatz schreibgeschützt sind.
Aktivieren der Überwachung Verwenden Sie IsAuditEnabled, um die Überwachung für die Entität zu aktivieren oder zu deaktivieren. Weitere Informationen finden Sie unter Konfigurieren von Entitäten und Attributen für Überwachung.
Ändern der Bereiche, in denen die Entität angezeigt wird Sie können steuern, an welcher Stelle im Navigationsbereich der Anwendung die Entitätsraster angezeigt werden. Dies wird durch die Siteübersicht gesteuert.
Hinzufügen oder Entfernen von Attributen Solange die verwaltete Eigenschaft CanCreateAttributes.Value das Erstellen von Attributen zulässt, kann die -Meldung verwendet werden, um Attribute zu den Entitäten hinzuzufügen. Weitere Informationen finden Sie unter Anpassen von Entitäts- und Attributzuordnungen.
Hinzufügen oder Entfernen von Ansichten Solange die verwaltete Eigenschaft CanCreateViews.Value das Erstellen von Ansichten zulässt, kann die SavedQuery-Entität verwendet werden, um Ansichten für eine Entität zu erstellen.
Hinzufügen oder Entfernen von Diagrammen Solange die verwaltete Eigenschaft CanCreateCharts.Value das Erstellen von Diagrammen zulässt und die IsEnabledForCharts-Entitätseigenschaft auf "true" festgelegt ist, können Sie die SavedQueryVisualization-Entität verwenden, um Diagramme für eine Entität zu erstellen. Weitere Informationen finden Sie unter Daten mit Visualisierungen anzeigen Daten mit Visualisierungen (Diagrammen) anzeigen.
Hinzufügen oder Entfernen von Entitätsbeziehungen Es gibt mehrere verwaltete Eigenschaften, die die Arten von Entitätsbeziehungen steuern, die Sie für eine Entität erstellen können. Weitere Informationen finden Sie unter Anpassen von Entitätsbeziehungsmetadaten.
Ändern von Symbolen Sie können die für benutzerdefinierte Entitäten verwendeten Symbole ändern. Weitere Informationen finden Sie unter Entitätssymbole ändern.
Hierarchische Beziehung kann geändert werden CanChangeHierarchicalRelationship.Value Steuerelement, ob der hierarchische Status von Entitätsbeziehungen, die in Ihren verwalteten Lösungen enthalten sind, geändert werden kann. Weitere Informationen:

Meldungen, die von benutzerdefinierten Entitäten unterstützt werden

Benutzerdefinierte Entitäten unterstützen die gleichen Basismeldungen wie Systementitäten. Welche Meldungen verfügbar sind, hängt davon ab, ob die benutzerdefinierte Entität im Besitz des Benutzers oder im Besitz der Organisation ist. Weitere Informationen finden Sie unter Actions on Entity Records.

Siehe auch

Erweitern des Metadatenmodells für Dynamics 365 Customer Engagement (on-premises)
Einführung in Entitäten in Dynamics 365 Customer Engagement (on-premises)
Durchsuchen Sie Metadaten für die Organisation
Anpassen von Entitätsattributmetadaten
Entitätsbeziehungsmetadaten
Doppelte Daten erkennen in Dynamics 365 Customer Engagement (on-premises)
Aktivieren der Dokumentenverwaltung für Entitäten
Konfigurieren von Entitäten und Attributen für die Überwachung
Anzeigen von Daten mithilfe von Diagrammen (Visualisierungen)
Welche Entitäten sind anpassbar?
Erstellen einer benutzerdefinierten Entität
Abrufen, Aktualisieren und Löschen von Entitäten
Erstellen und Aktualisieren einer E-Mail-fähigen Entität
Erstellen einer benutzerdefinierten Aktivitätsentität
Ändern von Entitätssymbolen
Ändern von Entitätsmeldungen
Beispiel: Erstellen und Aktualisieren von Entitätsmetadaten
Beispiel: Erstellen einer benutzerdefinierte Aktivitätseinheit
Beispiel: Erstellen und aktualisieren einer E-Mail-fähigen Entität
Beispiel: Speichern von Entitätsmetadaten in einer Datei
Beispiel: Speichern von Entitätsberechtigungsinformationen für eine Datei