Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Formulare in modellgesteuerten Apps stellen die Benutzeroberfläche bereit, die benutzer zum Erstellen, Anzeigen oder Bearbeiten von Tabellendatensätzen verwenden. In diesem Artikel wird erläutert, wie Formulare programmgesteuert mithilfe des SystemForm Tabellen- und Formular-Designers in Anpassungstools erstellt oder bearbeitet werden. Sie erfahren, wie Sie auf Formulardefinitionen zugreifen, Formulareigenschaften verstehen und Formulare mithilfe von Codebeispielen implementieren.
Zugriffsformulardefinitionen
Die SystemForm Tabelle speichert Formulare zusammen mit Dashboards und Visualisierungen. Sie können die Formulardefinitionen für eine Tabelle auf zwei Arten prüfen:
Schließen Sie die Tabelle in einer nicht verwalteten Lösung ein, und exportieren Sie die Lösung.
Abfrage der
SystemFormTabelle.
Anzeigen von FormXML aus einer exportierten Tabelle
Eine exportierte verwaltete Lösung enthält nur Definitionen von Systemformularen, die Sie anpassen. Zum Anzeigen der Definition eines Systemformulars müssen Sie entweder das Formular ä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 den Inhalt, und zeigen Sie die customizations.xml Datei an. Sie finden die Definition der Formulare in ImportExportXml>Entities>Entity>FormXml.
<FormXml> Im Knoten wird jeder Formulartyp in einem <forms> Element gruppiert, wobei der Parameter den type Formulartyp angibt.
Eigenschaften des SystemForm-Tabellenformulars
Die folgende Tabelle enthält zentrale SystemForm-Tabellenspalte 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. Legen Sie diese Eigenschaft fest, wenn Sie ein neues Formular mithilfe von "Speichern unter " für ein vorhandenes Formular oder mithilfe der SDK-Klasse für .NET CopySystemFormRequest - oder Web-API CopySystemForm-Aktion erstellen. |
CanBeDeleted |
<CanBeDeleted> |
Informationen, die angeben, ob diese Komponente gelöscht werden kann. Diese verwaltete Eigenschaft gilt nur, wenn Sie das Formular durch Importieren einer verwalteten Lösung erstellen. |
Description |
<Descriptions> |
Description ist eine Zeichenkette und <Descriptions> enthält alle lokalisierten Beschriftungen für die Beschreibung des Formulars.Die lokalisierten Beschriftungen können mithilfe von RetrieveLocLabelsRequest abgerufen werden. |
FormActivationState |
<FormActivationState> |
Legt den Status des Formulars fest. Nur Formulare vom Typ „Haupt“ können deaktiviert werden. Gültige Werte: - 0: Inactive-1: Active |
FormId |
<formid> |
Eindeutiger Bezeichner des Formulars |
FormPresentation |
<FormPresentation> |
Gibt an, ob dieses Formular im aktualisierten UI-Layout in Microsoft Dataverse vorhanden ist. |
FormXml |
<form> |
XML-Darstellung des Formularlayouts. |
IntroducedVersion |
<IntroducedVersion> |
Version der Lösung, in der das Formular hinzugefügt wurde. |
IsAIRMerged |
N/V | Legt fest, ob dieses Formular mit dem aktualisierten UI-Layout in Dataverse zusammengeführt wird. |
IsCustomizable |
<IsCustomizable> |
Information, die angibt, ob die Komponente angepasst werden kann. Diese verwaltete Eigenschaft gilt nur, wenn Sie das Formular durch Importieren einer verwalteten Lösung erstellen. |
IsDefault |
N/V | 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 Beschriftungen für den Namen des Formulars.Die lokalisierten Beschriftungen können mithilfe von RetrieveLocLabelsRequest abgerufen werden. |
ObjectTypeCode |
Das Formular ist ein Nachkomme des Entity-Elements. |
Der ObjectTypeCode-Wert ist der logische Name der Tabelle. |
Type |
<forms> Element type Parameter |
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 nur für Tabellen erstellen, in denen EntityMetadata.CanCreateForms dies zulässt.
Erstellen Sie neue Formulare, indem Sie sie direkt oder mithilfe der CopySystemForm Nachricht erstellen. Verwenden Sie das SDK für .NET CopySystemFormRequest-Klasse oder die Web-API CopySystemForm-Aktion. Wenn Sie die CopySystemForm Nachricht oder Speichern unter im Formular-Editor verwenden, gibt es keine Vererbung zwischen den Formularen. Daher gelten Änderungen am Basisformular nicht automatisch für formulare, die daraus erstellt wurden.
Sie können Formulardefinitionen bearbeiten, indem Sie eine verwaltete Lösung exportieren, die Formulardefinitionen bearbeiten und dann die Lösung erneut importieren. Wenn Sie Formulare manuell bearbeiten, verwenden Sie einen XML-Editor, der die Schemaüberprüfung unterstützt. Weitere Informationen finden Sie unter Bearbeiten der XML-Anpassungsdatei mit Schemaüberprüfung.
Verwandte Inhalte
Formulare erstellen und gestalten
SystemForm-Tabelle
Form-XML-Schema
Öffnen des Hauptformulars in einem Dialogfeld mithilfe der Client-API