Eine benutzerdefinierte Entität erstellen

Dieses Thema bezieht sich auf Dynamics 365 Customer Engagement (on-premises). Die Power Apps-Version dieses Themas finden Sie unter: Erstellen einer benutzerdefinierten Entität.

Bevor Sie eine benutzerdefinierte Entität erstellen, prüfen Sie, ob die Verwendung einer vorhandenen Entität Ihre Anforderungen erfüllen könnte. Weitere Informationen: Neue Metadaten oder bestehende Metadaten erstellen

Ein Teil des Namens jeder benutzerdefinierten Entität, die Sie erstellen, ist das Anpassungspräfix. Dieser Satz basiert auf dem Lösungsherausgeber für die Lösung, in der Sie arbeiten. Wenn Ihnen das Anpassungspräfix wichtig ist, achten Sie darauf, dass Sie in einer nicht verwalteten Lösung oder der Standardlösung arbeiten, in der das Anpassungspräfix Ihren Wünschen für diese Entität entspricht. Informationen zum Ändern des Anpassungspräfixes finden Sie unter Lösungsherausgeberpräfix.

Übersicht zum Erstellen einer Entität

Die minimalen Pflichtfelder zum Erstellen einer benutzerdefinierten Entität sind:

Feld	Beschreibung
Anzeigename	Dies ist der Name im Singular für die Entität, die in der App angezeigt wird.
Pluralname	Dies ist der Name im Plural für die Entität, die in der App angezeigt wird.
Name	Dieses Feld wird basierend auf dem von Ihnen eingegebenen Anzeigenamen vorab ausgefüllt. Es enthält das Anpassungspräfix des Lösungsherausgebers.
Besitz	Sie können eine benutzer-/team-eigene oder eine organisationseigene Entität wählen. Weitere Informationen: Entitätsbesitz.

Notiz

• Wenn Sie Safari als Browser nutzen, kann ein Timeout-Fehler beim Versuch eine neue benutzerdefinierte Entität zu speichern oder zu veröffentlichen auftreten. Wenn das geschieht, empfehlen wir einen anderen Browser zur Erstellung von Entitäten zu nutzen.
• Damit der Entitätsname zusammen mit der in Dynamics 365 for Customer Service eingebundenen Wissenssuche funktioniert, darf der Entitätsnamen einschließlich Herausgeberpräfix nicht länger als 24 Zeichen sein.

Wählen Sie zum Erstellen einer Aktivitätsentität Als Aktivitätsentität definieren, bevor Sie die Entität speichern. Weitere Informationen: Aktivitäten-Entitäten

Wählen Sie unter Bereiche, in denen diese Entität angezeigt wird aus, von welchen der auf der Navigationsleiste verfügbaren Bereiche diese Entität verfügbar sein soll. Dies ist nicht erforderlich, wenn Benutzer die Entität jedoch leicht finden sollen, treffen Sie hier eine Auswahl. Änderungen hier aktualisieren die Daten, die den Navigationsbereich definieren. Sie können die Einstellungen für Systementitäten nicht ändern. Allerdings können Sie diese Daten bearbeiten, um zu ändern, wo jede Entität angezeigt wird und wie sie angezeigt wird, indem Sie die Siteübersicht bearbeiten.

Einige Optionen sind standardmäßig eingestellt. Wenn Sie nicht sicher sind, ob Sie diese für Ihre benutzerdefinierte Entität wünschen, deaktivieren Sie sie vor dem Speichern. Sie können sie immer noch später aktivieren, einige Optionen können nach der Aktivierung jedoch nicht mehr deaktiviert werden. Hinweise, Aktivitäten und Verbindungen sind standardmäßig aktiviert und können nicht später deaktiviert werden. Weitere Informationen zu den Verfügbaren Optionen finden Sie unter Eine Entität bearbeiten.

Jede benutzerdefinierte primäre Entität verfügt über ein primäres Feld. Dies wird in der Registerkarte Hauptfeld festgelegt. Dieses Feld wird verwendet wenn Datensätze für die Entität in einer Liste angezeigt werden. Das primäre Feld ist in der Regel eine Verknüpfung, die den Datensatz öffnet. Dieses Feld muss ein Feld des Typs Einzelne Textzeile mit dem Format Text sein. Wenn Sie die Entität erstellen, ist der einzige Wert, der nicht später noch geändert werden kann, der Name. Standardmäßig ist der Anzeigename "Name" und der Name ist das Anpassungspräfix Ihres Lösungsherausgebers, ein Unterstrich und "Name". Wenn Sie dies nicht wünschen, ändern Sie es, bevor Sie die Entität erstellen. Nach dem Speichern der Entität können Sie das primäre Feld auf der Registerkarte Primäres Feld für die Entität nicht mehr ändern. Sie müssen dieses Feld in den Entitätsfeldern suchen. Sie können es dort wie jedes andere einfache Textfeld ändern.

Personen mit der Sicherheitsrolle Systemadministrator oder Systemanpasser können alle neuen benutzerdefinierten Entitäten sehen. Dadurch können Sie die benutzerdefinierten Entitäten testen, bevor sie den Personen angezeigt werden, die das System verwenden. Bevor Benutzer mit anderen Sicherheitsrollen diese Entitäten sehen können, müssen Sie die Sicherheitsrollen bearbeiten und anderen Benutzern den Zugriff gewähren, damit diese sie sehen können. Wenn die benutzerdefinierte Entität erstellt wurde, wird sie auf der Registerkarte Benutzerdefinierte Entitäten für jede Sicherheitsrolle angezeigt. Sie müssen mindestens eine Leseberechtigung auf Benutzerebene für die benutzerdefinierte Entität bereitstellen, damit Personen sie in den Apps sehen können.

Wenn eine neue Entität erstellt wird, werden einige Metadaten und unterstützende Systemdatensätze dafür erstellt. Sie fahren mit diesen bei der Erstellung der Entität fort.

Entität erstellen

Als App-Hersteller oder Anpasser können Sie Entitäten erstellen oder bearbeiten, indem der Lösungsexplorer verwendet wird.

1. Melden Sie sich bei Ihrer Dynamics 365 Customer Engagement (on-premises)-Instanz an.
2. Den Lösungsexploerer starten. Einstellungen>Anpassungen>System anpassen.
3. In der Liste Komponententyp wählen Sie die Option Neu und anschließend Entität aus.
4. Geben Sie in die folgenden erforderlichen Informationen ein. Weitere Informationen zu den verfügbaren optionalen Eigenschaften finden Sie unter Entitätsoptionen, die nur aktiviert werden können und Aktivieren oder deaktivieren von Entitätsoptionen.
   • Anzeigename: Definiert die Beschriftung, die in erstellten Apps für Entitätsverweise und Datensätze angezeigt wird, die auf der Entität basieren, wie beispielsweise Widget.
   • Pluralname. Dies ist die Beschriftung, die in Apps für Verweise auf Entitätsdatensätze angezeigt wird, die möglicherweise mehrere Datensätze enthalten, z. B. Widgets.
   • Name Dieses Feld wird basierend auf dem Anzeigename, den Sie eingegeben haben vorausgefüllt und das Lösungsherausgeberanpassungspräfix wie beispielsweise new_widget enthält. Sie können den Anzeigenamen später ändern, aber der Name kann nicht geändert werden, nachdem das Feld gespeichert wurde. Weitere Informationen Ändern des Lösungsherausgeberpräfix

Siehe auch

Erstellen und Bearbeiten von Feldern (Attributen)
Erstellen oder Bearbeiten des Hauptformulars für eine Entität
Ansichten (Listen)