Anpassen von Entitätsformularen
Formulare bieten die Benutzeroberfläche (UI), mit der Benutzer Entitätsdatensätze erstellen, anzeigen oder bearbeiten. Verwenden Sie den Formular-Designer in der Anpassungstools, um Entitätsformulare zu erstellen und zu bearbeiten. Weitere Informationen: Formulare erstellen und gestalten zu Informationen über Aufgaben im Zusammenhang mit der Arbeit mit Formularen in der Anwendung.
Dieses Thema enthält die erforderlichen Informationen, um programmgesteuert Formulare zu erstellen oder zu bearbeiten.
Zugriffsformulardefinitionen
Entitätsformulare werden in der SystemForm-Entität zusammen mit Dashboards und Visualisierungen gespeichert. Es gibt zwei Möglichkeiten, die Formulardefinitionen für eine Entität einzusehen:
Schließen Sie die Entität in einer nicht verwalteten Lösung ein, und exportieren Sie die Lösung.
Fragen Sie die
SystemForm-Entität ab.
Anzeige von FormXML aus einer exportierten Entität
Nur Definitionen von Systementitätsformularen, die angepasst wurden, sind in einer exportierten verwalteten Lösung enthalten. Um die Definition eines Systementitätsformulars anzuzeigen, müssen Sie sie entweder irgendwie ändern oder ein neues Formular erstellen, indem Sie das vorhandene Formular unter einem neuen Namen speichern.
Nachdem Sie die Lösung exportiert haben, extrahieren Sie die Inhalte und zeigen Sie die customizations.xml-Datei an. Sie finden die Definition der Formulare in ImportExportXml>Entities>Entity>FormXml.
Im <FormXml>-Knoten finden Sie alle Formulartypen gruppiert in einem <forms>-Element mit dem Attribut type, das den Typ des Formulars angibt.
Formulareigenschaften
Die folgende Tabelle enthält zentrale SystemForm-Entitätsattribute und die entsprechenden Daten in den mit der Lösung exportierten XML-Elementen.
| SystemForm-Eigenschaft | FormXML-Element | Beschreibung |
|---|---|---|
AncestorFormId |
<ancestor> |
Eindeutiger Bezeichner des übergeordneten Formulars. Dieser wird festgelegt, wenn Sie ein neues Formular erstellen, indem Sie ein Formular mit Speichern unter fürein bestehendes Formular oder mit CopySystemFormRequest erstellen. |
CanBeDeleted |
<CanBeDeleted> |
Informationen, mit denen angegeben wird, ob die Komponente gelöscht werden kann. Diese verwaltete Eigenschaft wird erst angewendet, wenn das Formular erstellt wurde, indem eine verwaltete Lösung importiert wird. |
Description |
<Descriptions> |
Description ist eine Zeichenkette und <Descriptions> enthält alle lokalisierten Labels für die Beschreibung des Formulars.Die lokalisierten Etiketten können mithilfe von RetrieveLocLabelsRequest abgerufen werden. |
FormActivationState |
<FormActivationState> |
Legt den Status des Formulars fest. Nur Formulare des Typs "Haupt" können deaktiviert werden. Gültige Werte: - 0: Inaktiv - 1: Aktiv |
FormId |
<formid> |
Eindeutiger Bezeichner des Formulars |
FormPresentation |
<FormPresentation> |
Legt fest, ob dieses Formular im aktualisierten UI-Layout in Dynamics 365 for Customer Engagement enthalten ist. |
FormXml |
<form> |
XML-Darstellung des Formularlayouts. |
IntroducedVersion |
<IntroducedVersion> |
Version der Lösung, in der das Formular hinzugefügt wurde. |
IsAIRMerged |
Nicht zutreffend | Gibt an, ob dieses Formular mit dem aktualisierten UI-Layout in Dynamics 365 for Customer Engagement zusammengeführt wird. |
IsCustomizable |
<IsCustomizable> |
Information, die angibt, ob die Komponente angepasst werden kann. Diese verwaltete Eigenschaft wird nur angewendet, wenn das Formular durch Importieren einer verwalteten Lösung erstellt wurde. |
IsDefault |
Nicht zutreffend | Informationen, die angeben, ob es sich bei Formular oder Dashboard um den Systemstandard handelt. |
Name |
<LocalizedNames> |
Name ist eine Zeichenkette und <LocalizedNames> enthält alle lokalisierten Labels für den Namen des Formulars.Die lokalisierten Etiketten können mithilfe von RetrieveLocLabelsRequest abgerufen werden. |
ObjectTypeCode |
Das Formular stammt von dem Entity-Element. |
Der ObjectTypeCode-Wert ist der logische Name der Entität. |
Type |
<forms>-Element type-Attribut |
Gültige Werte für Formulare sind: - 2: main- 5: mobile- 6: quick- 7: quickCreate |
Erstellen und Bearbeiten von Formularen
Sie können neue Formulare für eine Entität nur erstellen, wenn EntityMetadata. CanCreateForms lässt es zu.
Sie können neue Formulare entweder mit einer CreateRequest oder mit CopySystemFormRequest erstellen. Wenn Sie CopySystemFormRequest oder Speichern unter im Formulareditor verwenden, findet keine Vererbung zwischen den Formularen statt. Daher werden Änderungen am Basisformular nicht automatisch auf auf dessen Grundlage erstellte Formulare angewendet.
Das Ändern der Formulardefinitionen aus einer exportierten verwalteten Lösung und der anschließende erneute Import der Lösung ist das unterstützte Verfahren für die Bearbeitung von Entitätsformularen. Beik manuellen Bearbeiten von Formularen wird nachdrücklich empfohlen, einen XML-Editor zu verwenden, der die Schemaevaluierung ermöglicht. Weitere Informationen: Bearbeiten der Anpassungs-XML-Datei mit Schemaüberprüfung.
Siehe auch
Anpassen von Microsoft Dynamics 365 Customer Engagement
Erstellen und Gesalten von Formularen
SystemForm-Entität
Erstellen oder Bearbeiten, wie Unternehmensregeln initiiert werden
Formular-XML-Schema