Formulare zur Interaktion mit Dataverse-Daten verwenden

Abgeschlossen

Formulare bieten Webseiten die Möglichkeit, mit Zeilen in einer bestimmten Tabelle zu interagieren, indem modellgesteuerte Formulardefinitionen als Layoutvorlage verwendet werden. Ähnlich wie bei Listen handelt es sich bei Formularen um datengesteuerte Konfigurationen, mit denen Benutzer ein Formular hinzufügen können, um Daten auf der Website zu erfassen oder anzuzeigen, ohne dass ein Entwickler ein benutzerdefiniertes Formular erstellen muss. Sie können Formulare mit modellgesteuerten Formularen definieren und diese auf Webseiten auf der Website platziert werden.

Formulare können die meisten Spaltentypen und Unterraster, Typen von Auswahlspalten (siehe Konfigurieren Sie eine Spalte für Auswahlmöglichkeiten in PortalenPower Pages) und Kodekomponenten (siehe Codekomponenten in Power Pages verwenden) anzeigen.

Screenshot mit dem schreibgeschützten Formular mit Unterraster

Häufige Anwendungsbereiche

In der folgenden Tabelle werden die gängigen Szenarien erläutert, in denen Sie Formulare verwenden können.

Szenario Beschreibung
Layout Richten Sie Formulare ein, und verwenden Sie sie im schreibgeschützten Modus als Layoutmechanismus. Ein Beispiel sind die Formulare als Informationsseiten über Mitarbeiter, Produkte oder andere Microsoft Dataverse-Tabellen. Beispielsweise besitzen Sie eine benutzerdefinierte Tabelle in Ihrer Dataverse-Instanz, die offenen Positionen beschreibt, die in Ihrer Organisation verfügbar sind. Anstatt eine spezielle Vorlage zum Rendern der Seite zu erstellen, können Sie ein separates modellgesteuertes Formular für die Tabelle anlegen, eine neue Webseite mit dem Power Pages-Designstudio erstellen und dann die Komponente Formular der Seite hinzufügen. Alle veröffentlichten Änderungen im Formularlayout in modellgesteuerten Apps werden automatisch auf die Webseite angewendet.
Informationserfassung Verwenden Sie Formulare auf der Website zur Datenerfassung von anonymen oder authentifizierten Benutzern. Beispielsweise kann auf einer Kontaktseite ein einfaches Leadformular verwendet werden, um anonyme Anforderungen als Leads in Dynamics 365 Sales aufzuzeichnen. Für authentifizierte Benutzer kann eine Website eine Umfrageseite verwenden, um Produktfeedback von Kunden in einer benutzerdefinierten Tabelle für Produktfeedback zu sammeln.
Datensatzverwaltung Mit Formularen können Sie in verschiedener Kombinationen Vorgänge zum Erstellen, Abrufen, Aktualisieren und Löschen (CRUD) für eine Tabelle innerhalb einer Reihe verknüpfter Webseiten verwenden. Beispielsweise können Kunden ihre eigenen Fälle abrufen, lesen und neue erstellen, Partner können ihre Unternehmensprofile bearbeiten und Mitarbeiter können die Liste der Assets anzeigen, die ihnen vom Unternehmen zugewiesen wurden.
Web-Apps Wenn Sie Formulare mit Listen und Unterrastern sowie mit der durch JavaScript erweiterten Funktionalität verwenden, können Entwickler vollständige Webanwendungen erstellen.

Ein Formular erstellen

Beim Erstellen eines neuen Formulars besteht Ihr erster Schritt darin, zu entscheiden, welche Tabelle und welches Formular Sie rendern möchten. Obwohl die Wiederverwendung von Formularen, die Teil einer modellgesteuerten App sind, möglich ist, besteht die übliche Praxis darin, Power Pages-spezifische modellgesteuerte Formulare zu entwerfen (die in den modellgesteuerten Apps enthalten sein können oder nicht).

Screenshot eines Formulars im Power Pages-Designstudio

  • Power Pages-Formulare sind in der Regel übersichtlicher und enthalten weniger Informationen, insbesondere wenn eine externe Zielgruppe beteiligt ist.

  • Power Pages-Prozesse unterscheiden sich von der internen Nutzung einer modellgesteuerten App für Mitarbeiter (einschließlich Dynamics 365-Apps). Dedizierte Formulare sind einfacher zu warten, da Änderungen an den modellgesteuerten Apps manuell auf die Power Pages-Formulare angewendet werden müssen, wodurch sich die Gelegenheit bietet, die Anforderungen zu überprüfen und Aspekte der Benutzerfreundlichkeit zu bewerten.

  • Das Rendern von Formularen und Spalten unterliegt bestimmten Einschränkungen. Weitere Informationen erhalten Sie unter Über Formulare.

  • Clientseitige Geschäftsregeln und JavaScript, die ein wesentlicher Bestandteil eines modellgesteuerten Formulars sind, werden auf der Power Pages-Website nicht ausgeführt. Dieser Faktor ist leicht zu übersehen und kann zu unbeabsichtigten Konsequenzen führen.

  • Besondere Überlegungen sind beim Rendern von zugehörigen Zeilen, Notizen und Zeitskalen erforderlich, da nicht alle funktionalen Aspekte auf der Website unterstützt werden (oder erforderlich sind).

Modus

Sie können auf der Registerkarte Daten des Formulareigenschaftendialogs den Formularmodus auswählen. Dieser Formularmodus definiert, ob das Formular zum Generieren eines Layouts, zum Erfassen der Daten oder zum Bereitstellen vollständiger Bearbeitungsfunktionen für Dataverse-Zeilen verwendet wird. Dieser Formularmodus kann eine der folgenden Optionen sein:

  • Schreibgeschützt – Power Pages-Designstudio bezeichnet diese Option als ist schreibgeschützt.

  • Einfügen – Designstudio bezeichnet diese Option als Neuen Datensatz erstellen.

  • Bearbeiten – Designstudio bezeichnet diese Option als Einen vorhandenen Datensatz aktualisieren.

Hinweis

Ein Formular im Modus Bearbeiten wird als Schreibgeschützt gerendert, wenn der Benutzer keine Schreibberechtigungen für die Zeile hat.

Wenn der Modus Einfügen lautet, sind keine weiteren Informationen erforderlich. Für die Modi Schreibgeschützt und Bearbeiten muss das Formular die Tabellenzeile „kennen“, die angezeigt und aktualisiert werden muss. Die Einstellung Datensatzquelltyp definiert, wie diese Informationen an das Formular übergeben werden:

  • Abfragezeichenfolge – Diese Einstellung ist die Standardeinstellung, wenn Sie ein Formular im Designstudio erstellen. Es wird erwartet, dass der Zeilenbezeichner Teil der Abfragezeichenfolge ist, wie https://contoso.powerappsportals.com/contacts/edit/?id=<contact guid>, wenn eine Seite mit dem Formular angezeigt wird. Normalerweise erfolgt diese Einstellung automatisch, wenn das Formular mit einer Liste verknüpft ist. Dies ist die gängigste Einstellung.

  • Aktueller Portalbenutzer – Diese Option können Sie in der Power Pages Management-App einrichten. Wenn Sie diese Option auswählen, lädt das Formular die Informationen aus der aktuellen Websitebenutzerzeile, ohne weitere Informationen aus der Seiten-URL zu verwenden. Diese Option wird üblicherweise zum Rendern eines Benutzerprofilformulars verwendet. Die Spalte Tabellenname muss in diesem Fall auf Kontakt gesetzt werden, da Websitebenutzer von der Kontakttabelle vertreten werden.

  • Dem aktuellen Portalbenutzer zugeordneter Datensatz – Sie können diese Option in der Power Pages Management-App einrichten. Durch Auswahl dieser Option können Sie zugeordnete Zeilen bearbeiten, z. B. die übergeordneten Kontodetails des aktuellen Benutzers. Stellen Sie sicher, Beziehungsname festzulegen, um die zu bearbeitende Zeile zu identifizieren. Der ausgewählte Tabellentyp muss mit der Auswahl in der Spalte Tabellenname übereinstimmen. Diese Option ist in Partner-Szenarien nützlich, in denen eine Partnerorganisation mehrere Websitebenutzer hat. Sie können einige dieser Benutzer autorisieren, die Zeile des übergeordneten Kontos zu bearbeiten.

Tabelle, Formular, Name und Modus sind die benötigten Eigenschaften, die zum Rendern des erforderlich sind.

Das Formular einrichten

Weitere Konfigurationsoptionen zur Bestimmung von Erscheinungsbild und Verhalten des Formulars sind im Designstudio verfügbar.

Screenshot des Dialogfelds „Formulareigenschaften“ mit der ausgewählten Registerkarte „Beim Senden“

Formular-Registerkarte

Auf der Registerkarte Formular können Sie eine Tabelle, ein Formular für diese Tabelle und das Formular Name auswählen (was Sie nach dem Erstellen nicht mehr ändern können).

Datenregisterkarte

Auf der Registerkarte Daten können Sie den Formularmodus verändern.

Registerkarte Bei Senden

Die Einstellung Bei Senden bestimmt die Aktionen, die ausgeführt werden, wenn ein Formular erfolgreich gesendet wurde:

  • Meldung anzeigen – Zeigt eine Nachricht an, wenn das Formular gesendet wird.
  • Zur Seite umleiten – Navigiert automatisch zu einer Webseite beim erfolgreichen Einreichen des Formulars.
  • Zur URL umleiten – Leitet zu einer URL um (Website oder extern).

CAPTCHA-Registerkarte

Die Funktion CAPTCHA bestimmt, ob ein Captcha für anonyme oder authentifizierte Benutzer angezeigt werden soll.

Anhang-Registerkarte

Auf der Registerkarte Anhang können Sie auswählen, ob ein Benutzer Dateien hochladen darf, und Sie können die maximale Anhanggröße und Einschränkungen für die Dateitypen festlegen.

Einstellungen zu anderem Formular

Für Formulare in der Power Pages Management-App stehen weitere Konfigurationseinstellungen zur Verfügung. Folgen Sie diesen Schritten, um auf das Formular in der Power Pages Management-App zuzugreifen:

  1. Wählen Sie die Formularkomponente auf der Seite im Power Pages-Designstudio aus.

  2. Wählen Sie den Befehl Formular bearbeiten aus.

  3. Wählen Sie im Dialogfeld Formulareinstellungen die Registerkarte Daten aus.

  4. Wählen Sie Power Pages Management-App öffnen unter der Überschrift Konfigurationen aus.

Screenshot der Formularverwaltungs-Metadaten

Formulare können Aktionen zur Interaktion des Benutzers mit der Zeile enthalten. Detaillierte Konfigurationen für jedes Formularelement sind über weitere Formularmetadaten-Zeilen verfügbar.

Diagramm der Formularstruktur und Übersicht

Konfiguration

In den folgenden Abschnitten werden die verschiedenen Möglichkeiten zum Einrichten von Formularen in der App Power Pages-Verwaltung beschrieben.

Formularoptionen

Die meisten Formularoptionen unterstützen die Anpassung der Elemente der Cascading Stylesheets (CSS), um das Erscheinungsbild zu ändern. Sie können Textelemente wie Beschriftungen, Nachrichten und QuickInfos in mehreren Sprachen angeben. Beispielsweise lautet die Standardnachricht nach der Übermittlung eines Formulars „Gespeichert“, sie kann jedoch für jede aktivierte Websitesprache angepasst werden.

Zu den anderen Formularoptionen gehört Kontrollieren des Validierungsverhalten. Hiermit können Sie festlegen, ob alle Spalten unabhängig von der Formulareinstellung als erforderlich markiert werden sollen.

Andere Einstellungen

Weitere Einstellungen definieren andere Aspekte des Formularverhaltens, einschließlich des Stils, der Übersetzung der Benutzeroberflächenelemente usw.

Tipp

Einige Einstellungen und Konfigurationsoptionen sind ausgeblendet. Wählen Sie das Kontrollkästchen Erweiterte Einstellungen aus, um alle verfügbaren Optionen anzuzeigen.

  • Aktuellen Portalbenutzer beim Einfügen zuordnen – Mit dieser Option können Sie nachverfolgen, von welchem Websitekontakt die Zeile erstellt oder aktualisiert wurde. Mit dieser Einstellung wird ein Websiteäquivalent der Spalten Erstellt von und Geändert von in Dataverse erstellt. Sie können gegebenenfalls auch übergeordnete Beziehungen festlegen. Wenn beispielsweise eine neue Kontozeile erstellt wird, können Sie den aktuellen Kontakt automatisch als primären Kontakt festlegen.

  • Datei anfügen: Hinzufügen – Es gibt viele Optionen, um Ihrem Formular ein Steuerelement zum Hochladen von Dateien hinzuzufügen. Die Konfiguration ist flexibel und unterstützt mehrere Dateien, Speicheroptionen, MIME-Typ und Größenbeschränkungen. (Sie können beispielsweise Uploads auf Bilder mit einer Größe von bis zu 2 MB beschränken.)

  • Geolocation – Sie können ein Formular einrichten, um ein Kartensteuerelement anzuzeigen und so entweder einen vorhandenen Standort als Stecknadel auf einer Karte anzuzeigen oder einem Benutzer die Möglichkeit zu geben, einen Standort anzugeben. Das Kartensteuerelement des Formulars erfordert weitere Konfigurationen, um die verschiedenen Positionsspalten zu bestimmen, ihnen Werte zuzuweisen oder Werte von ihnen abzurufen. Weitere Informationen finden Sie unter Geolocation-Konfiguration für Formulare.

Screenshot des Formulars mit aktivierter Geolocation

Zugeordnete Tabellenreferenz

Die Funktion Zugeordnete Tabellenreferenz bietet die Möglichkeit, die aktuelle Zeile, die erstellt oder aktualisiert wird, mit einer anderen Zielzeile zu verknüpfen. Diese Funktion ist hilfreich, wenn Sie mehrere Schritte mit mehreren Tabellentypen ausführen und die resultierenden Zeilen zuordnen möchten oder wenn der Seite eine Abfragezeichenfolge einer Zeilen-ID übergeben wird, die Sie zuordnen möchten.

Möglicherweise haben Sie eine Ereignisseite, auf der Informationen zu einem bevorstehenden Webinar angezeigt werden. Sie möchten eine Registrierungsschaltfläche einfügen, die Besucher auf die Registrierungsseite weiterleitet, auf der das Registrierungsformular angezeigt wird. Sie können den Ereignisbezeichner in einer Abfragezeichenfolge übergeben. Wenn das Registrierungsformular übermittelt wird, können Sie die Registrierungsinformationen automatisch mit dem Ereignis verknüpfen.

Aktionen

Da sich ein Formular auf eine einzelne Tabellenzeile bezieht, gibt es zahlreiche Aktionen, die für diese Zeile ausgeführt werden können, z. B. Aktualisieren, Löschen, Deaktivieren usw. Sie können diese Aktionen einrichten, die zur Runtime als Befehlsschaltflächen angezeigt werden, können konfiguriert werden, indem Sie Zusätzliche Einstellungen > Aktionsschaltflächenkonfiguration auswählen.

Alle Befehle enthalten Optionen zum Umbenennen der Schaltflächen und zum Ändern ihrer Position im Formular.

Formularmetadaten

Formularmetadaten-Zeilen ermöglichen Ihnen, das Erscheinungsbild und Verhalten einzelner Formularelemente festlegen, einschließlich:

  • Darstellung der Spalten, Abschnitte und Registerkarten Zudem können Sie eine Standardwerte, Validierungsverhalten und andere Aspekte von einzelnen Spalten definieren.

  • In der Unterrasterkonfiguration können Sie Aktionen für verknüpfte Zeilen definieren, ähnlich wie bei Tabellenlistenaktionen.

  • Verhalten von Hinweisen und Zeitskalenabschnitten, und ob Sie neue Zeilen hinzufügen können. Sie verwenden diese Option häufig, um Websitebenutzern die Eingabe von Kommentaren zur Zeile zu ermöglichen, z. B. zu einer aktuellen Anfrage.

Ihrer Website ein Formular hinzufügen

Ein Formular definiert das erforderliche Verhalten, enthält jedoch keine Informationen darüber, wie und wo auf der Website das Formular gerendert werden soll. Es gibt zwei Methoden zum Rendern eines Formulars auf einer Website:

  • Ein Formular kann explizit als Ziel für eine Listenaktion wie das Erstellen, Aktualisieren oder Bearbeiten festgelegt werden. In diesem Fall wird das Formular in einem modalen Popupfenster gerendert. Wenn das Formular in einem Popup-Fenster gerendert wird, gelten bestimmte Einschränkungen. Das Funktion zum Erstellen verwandter Zeilen aus Unterrastern ist zum Beispiel nicht verfügbar.

  • Fügen Sie einer Webseite eine Formularkomponente im Power Pages-Designstudio hinzu, wie Sie es für eine Liste tun würden. Diese Aktion platziert ein Liquid-Tag auf der Webseitenkopie, um das Formular zu rendern.

    {% entityform name: '<<form name>>' %}
    

Da Formulare Informationen zur Verarbeitung an den Server zurücksenden können, erhalten Sie im Vergleich zu den Listen weitaus weniger Kontrolle über das Rendern von Formularen.