Anpassen von Entitätsmetadaten
Veröffentlicht: Januar 2017
Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
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 im SDK-Paket. Laden Sie das Microsoft Dynamics CRM SDK-Paket herunter. Weitere Informationen:Durchsuchen der Metadaten für die Organisation
Dieses Thema behandelt die programmgesteuerte Verwendung von Entitäten. Informationen zum Verwenden von Entitäten in der Anwendung finden Sie unter TechNet: Erstellen und Bearbeiten von Entitäten.
In diesem Thema
Verfügbare Optionen, wenn Sie eine benutzerdefinierte Entität erstellen
Aktivieren von Entitätsfunktionen
Bearbeitbare Entitätseigenschaften
Entitätsmetadaten-Meldungen
Meldungen, die von benutzerdefinierten Entitäten unterstützt werden
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 eine Entität erstellen, bei der es sich um eine Aktivität handelt, indem Sie die EntityMetadata.IsActivity-Eigenschaft festlegen. Weitere Informationen finden Sie unter Benutzerdefinierte Aktivitäten. |
Entitätsnamen |
Es gibt zwei Arten von Namen, und beide müssen mit einem Anpassungspräfix versehen sein:
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 EntityMetadata.OwnershipType-Eigenschaft, um dies festzulegen. Verwenden Sie die OwnershipTypes-Enumeration, 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 8597998f-764f-4c73-b63d-9f5e02c78061#EntityOwnership. |
Primäres Attribut |
Verwenden Sie CreateEntityRequest.PrimaryAttribute, um dies festzulegen. Jede Entität besitzt ein StringAttributeMetadata-Attribut, das StringFormat.Text als das primäre Attribut verwendet. 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 EntityMetadata fest.IsBusinessProcessEnabled, um die Entität für Geschäftsprozessflüsse zu aktivieren. |
Hinweise |
Verwenden Sie die CreateEntityRequest- oder UpdateEntityRequest.HasNotes-Eigenschaft, um eine Entitätsbeziehung mit der Annotation-Entität zu erstellen, und aktivieren Sie den Einschluss eines Notizen-Bereichs im Entitätsformular. Durch den Einschluss von Notizen können Sie auch Anlagen zu Datensätzen hinzufügen. |
Aktivitäten |
Verwenden Sie die CreateEntityRequest- oder UpdateEntityRequest.HasActivities-Eigenschaft, um eine Entitätsbeziehung mit der ActivityPointer-Entität zu erstellen, sodass alle Aktivitätstypentitäten mit dieser Entität verknüpft werden können. |
Verbindungen |
Legen Sie die EntityMetadata.IsConnectionsEnabled-Eigenschaft fest, um das Erstellen von Verbindungsdatensätzen zu aktivieren und diese Entität mit anderen Verbindungsentitäten zu verknüpfen. |
Warteschlangen |
Verwenden Sie die EntityMetadata.IsValidForQueue-Eigenschaft, um Unterstützung für Warteschlangen hinzuzufügen. Wenn Sie diese Option aktivieren, können Sie auch die EntityMetadata.AutoRouteToOwnerQueue-Eigenschaft festlegen, um Datensätze automatisch in die Standardwarteschlange des Besitzers zu verschieben, wenn ein Datensatz dieses Typs erstellt oder zugewiesen wird. |
Legen Sie die EntityMetadata.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 EntityMetadata.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 EntityMetadata.AutoCreateAccessTeams, um die Entität für Zugriffsteams zu aktivieren. Weitere Informationen hierzu finden Sie unter Hilfe und Schulung: 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 8597998f-764f-4c73-b63d-9f5e02c78061#BKMK_EntityImages. |
Ändern des Anzeigetexts |
Die verwaltete Eigenschaft EntityMetadata.IsRenameable verhindert, dass der Anzeigename in der Anwendung geändert wird. Sie können die Beschriftungen jedoch programmgesteuert ändern, indem Sie die EntityMetadata.DisplayName- und EntityMetadata.DisplayCollectionName-Eigenschaften aktualisieren. |
Bearbeiten der Entitätsbeschreibung |
Die verwaltete Eigenschaft EntityMetadata.IsRenameable verhindert, dass die Entitätsbeschreibung in der Anwendung geändert wird. Sie können die Beschriftungen jedoch programmgesteuert ändern, indem Sie die EntityMetadata.Description-Eigenschaft aktualisieren. |
Aktivieren für die Verwendung im Offlinemodus |
Verwenden Sie EntityMetadata.IsAvailableOffline, um die Möglichkeit, Daten für diese Entität offline zu nehmen, für Microsoft Dynamics 365 für Microsoft Office Outlook mit Offlinezugriff-Benutzer zu aktivieren oder zu deaktivieren. |
Aktivieren des Outlook-Lesebereichs |
Hinweis Die EntityMetadata.IsReadingPaneEnabled-Eigenschaft ist Nur zur internen Verwendung. Verwenden Sie den Microsoft Outlook-Lesebereich, um die Möglichkeit der Microsoft Dynamics 365 für Outlook-Benutzer, Daten für diese Entität anzuzeigen, zu aktivieren oder zu deaktivieren. Sie müssen diese Eigenschaft in der Anwendung festlegen. |
Aktivieren des Seriendrucks |
Verwenden Sie EntityMetadata.IsMailMergeEnabled, um die Möglichkeit, zusammengeführte Microsoft Office Word-Dokumente zu generieren, die Daten aus dieser Entität verwenden, zu aktivieren oder zu deaktivieren. |
Duplikaterkennung aktivieren |
Verwenden Sie EntityMetadata.IsDuplicateDetectionEnabled, um die Duplikaterkennung für die Entität zu aktivieren oder zu deaktivieren. Weitere Informationen finden Sie unter Doppelte Daten erkennen. |
Aktivieren der SharePoint-Integration |
Verwenden Sie EntityMetadata.IsDocumentManagementEnabled, um die SharePoint Server-Integration für die Entität zu aktivieren oder zu deaktivieren. Weitere Informationen finden Sie unter Aktivieren der Dokumentenverwaltung für Entitäten. |
Aktivieren von Dynamics 365 für Smartphones |
Verwenden Sie EntityMetadata.IsVisibleInMobile, um die Möglichkeit, Daten für diese Entität anzuzeigen, für Microsoft Dynamics 365 für Telefone-Benutzer zu aktivieren oder zu deaktivieren. |
Dynamics 365 für Tablets |
Verwenden Sie EntityMetadata.IsVisibleInMobileClient, um die Möglichkeit, Daten für diese Entität anzuzeigen, für Microsoft Dynamics 365 für Tablets-Benutzer zu aktivieren oder zu deaktivieren. Wenn die Entität für Dynamics 365 für Tablets verfügbar ist, können Sie EntityMetadata.IsReadOnlyInMobileClient verwenden, um anzugeben dass die Daten für den Datensatz schreibgeschützt sind. |
Aktivieren der Überwachung |
Verwenden Sie EntityMetadata.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 die Ü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. Weitere Informationen finden Sie unter Bearbeiten der Siteübersicht. |
Hinzufügen oder Entfernen von Attributen |
Solange die verwaltete Eigenschaft EntityMetadata.CanCreateAttributes das Erstellen von Attributen zulässt, kann die CreateAttributeRequest-Meldung verwendet werden, um Attribute hinzuzufügen. Weitere Informationen finden Sie unter Anpassen von Entitätsattributmetadaten. |
Hinzufügen oder Entfernen von Ansichten |
Solange die verwaltete Eigenschaft EntityMetadata.CanCreateViews 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 EntityMetadata.CanCreateCharts das Erstellen von Diagrammen zulässt und die EntityMetadataIsEnabledForCharts-Entitätseigenschaft auf "true" festgelegt ist, können Sie SavedQueryVisualization verwenden, um Diagramme für eine Entität zu erstellen. Weitere Informationen finden Sie unter Daten mit Visualisierungen (Diagramme) 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 Ändern der Symbole für eine Entität. |
Benutzerdefinierte Hilfe verwenden |
EntityMetadata.EntityHelpUrlEnabled steuert, ob die benutzerdefinierte Hilfe für die Entität aktiviert ist.Weitere Informationen:Hinzufügen von benutzerdefiniertem Hilfeinhalt. |
Hilfe-URL |
EntityMetadata.EntityHelpUrl steuert, welche Ressourcen für Hilfeinhalt für die Entität angezeigt wird, wenn benutzerdefinierte Hilfe aktiviert ist.Weitere Informationen:Hinzufügen von benutzerdefiniertem Hilfeinhalt. |
Hierarchische Beziehung kann geändert werden |
EntityMetadata.CanChangeHierarchicalRelationship steuert, ob der hierarchische Status von Entitätsbeziehungen, die den in verwalteten Lösungen enthalten sind, geändert werden kann.Weitere Informationen: |
Entitätsmetadaten-Meldungen
In der folgenden Tabelle sind die Meldungen aufgeführt, die Sie verwenden können, um Entitätsmetadaten zu erstellen, abzurufen, zu aktualisieren und zu löschen.
Name der Meldung |
Beschreibung |
|---|---|
Erstellt eine benutzerdefinierte Entität. |
|
Löscht eine benutzerdefinierte Entität. |
|
Ruft die Metadaten für alle Entitäten ab. |
|
Ruft die Metadaten für eine Entität ab. |
|
Aktualisiert die Metadaten für eine Entität. |
|
Wird in Kombination mit demMicrosoft.Xrm.Sdk.Metadata.Query-Namespace verwendet, um eine Abfrage zu erstellen, um Änderungen an bestimmten Metadaten effizient abzufragen und zu erkennen.Weitere Informationen:Abrufen und Erkennen von Änderungen bei Metadaten. |
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 8597998f-764f-4c73-b63d-9f5e02c78061#ActionsOnEntityRecords.
Siehe auch
Verwenden des Organisationsdienstes mit Dynamics 365-Metadaten
Einführung in Entitäten in Microsoft Dynamics 365
Durchsuchen der Metadaten für die Organisation
Anpassen von Entitätsattributmetadaten
Anpassen von Entitätsbeziehungsmetadaten
Doppelte Daten erkennen
Aktivieren der Dokumentenverwaltung für Entitäten
Konfigurieren von Entitäten und Attributen für die Überwachung
Bearbeiten der Siteübersicht
Daten mit Visualisierungen (Diagramme) anzeigen
Welche Entitäten sind anpassbar?
Erstellen einer benutzerdefinierten Entität.
Abrufen, Aktualisieren und Löschen von Entitäten
Entität, die per E-Mail gesendet werden kann, erstellen und aktualisieren
Erstellen einer benutzerdefinierten Aktivitätsentität
Ändern der Symbole für eine Entität
Ändern der Meldungen für eine Entität
Beispiel: Erstellen und Aktualisieren von Entitäts-Metadaten
Beispiel: Erstellen einer benutzerdefinierte Aktivitätsentität
Beispiel: Erstellen und Aktualisieren einer E-Mail-fähigen Entität
Beispiel: Speichern von Entitätsmetadaten in einer Datei
Beispiel: Dumpentitätsberechtigungsinformationen für eine Datei
Microsoft Dynamics 365
© 2017 Microsoft. Alle Rechte vorbehalten. Copyright