Grundlegendes zu Datenkarten in Canvas-Apps

Anzeigeformular - und Bearbeitungsformularsteuerelemente in Canvas-Apps sind Container für ganze Datensätze. Jedes Formular verfügt über mehrere Card-Steuerelemente, die die Bausteine des Formulars bilden. Jede Karte zeigt ein einzelnes Feld aus dem Datensatz an oder ermöglicht es Ihnen, ein einzelnes Feld über seine DataField-Eigenschaft zu bearbeiten. Das Formular zeigt den vollständigen Datensatz an, und jede Karte konzentriert sich auf ein Feld, sodass Sie steuern, wie Daten angezeigt oder aktualisiert werden.

Öffnen Sie Ihre App zur Bearbeitung in Power Apps Studio. Wählen Sie in der Strukturansicht ein Formularsteuerelement aus. Wählen Sie im Eigenschaftenbereich aus, welche Felder angezeigt werden sollen, wie jedes Feld angezeigt wird, und die Reihenfolge, in der sie angezeigt werden sollen. Der folgende Screenshot zeigt z. B. ein Steuerelement 'Formular bearbeiten' in einer App, die aus einer Liste mit dem Namen "Vermögenswerte" erstellt wurde, bei dem Sie Felder Ihren Anforderungen anpassen.

Beginnen Sie mit Karten, indem Sie Formular hinzufügen und Grundlegendes zu Datenformularen lesen. In diesem Artikel wird erläutert, wie Karten funktionieren und wie Sie Eigene anpassen oder erstellen.

Vordefinierte Karten

Power Apps bietet einen vordefinierten Satz von Karten für Zeichenfolgen, Zahlen und andere Datentypen, sodass Sie Ihre App auf bestimmte Datenanforderungen anpassen können. Im rechten Bereich sehen Sie die verfügbaren Typen und können die Karte für ein Feld ändern.

In diesem Beispiel wird eine einzeilige Textkarte ausgewählt, der URL-Text ist jedoch länger als das, was in eine Zeile passt. Ändern Sie dies in eine mehrzeilige Textkarte, damit Benutzer mehr Platz zum Bearbeiten haben.

Verschiedene Felder in dieser Datenquelle werden nicht angezeigt, Sie können jedoch die einzelnen Felder ein- oder ausblenden, indem Sie das entsprechende Kontrollkästchen aktivieren. In diesem Beispiel wird gezeigt, wie das SecurityCode-Feld angezeigt wird.

Eine Karte anpassen

Karten verfügen über andere Steuerelemente. Der Benutzer gibt in einem Bearbeitungsformular-Steuerelement Daten in einem standardmäßigen Texteingabe-Steuerelement ein, das Sie von der Registerkarte Einfügen hinzufügen.

In diesem Artikel wird erläutert, wie Sie die Darstellung einer Karte ändern, indem Sie die darin angezeigten Steuerelemente ändern.

1. Kehren Sie zunächst zu der Karte zurück, die als Letzte für das Feld SecurityCode hinzugefügt wurde. Wählen Sie diese Karte aus, indem Sie sie einmal auswählen:

   

2. Wählen Sie das Texteingabesteuerelement innerhalb der Karte aus, indem Sie das Eingabesteuerelement selbst auswählen.

   

3. Verschieben Sie das Steuerelement auf der Karte durch Ziehen des Auswahlfelds, und ändern Sie seine Größe mithilfe der Ziehpunkte am Rand des Auswahlfelds.

Sie können die Größe der Steuerelement in der Karte ändern, sie verschieben und andere Änderungen vornehmen, aber Sie können sie nicht löschen, ohne sie erst zu entsperren.

Entsperren einer Karte

Karten sind selbst auch Steuerelemente, die über Eigenschaften und Formeln verfügen, sodass erweiterte Anforderungen daran vorgenommen werden können. Wenn Sie ein Feld in einem Formular anzeigen möchten, erstellt der rechte Bereich automatisch die Karte für Sie und generiert die benötigten Formeln, sodass Sie Zeit und Aufwand sparen. Diese Formeln finden sich auf der Registerkarte Erweitert im rechten Bereich:

Sie sehen umgehend eine der wichtigsten Eigenschaften der Karte: die Eigenschaft DataField. Diese Eigenschaft gibt an, welches Feld der Datenquelle dem Benutzer angezeigt wird und was er auf dieser Karte bearbeiten kann.

Auf der Registerkarte Erweitert gibt das Banner am oberen Rand an, dass die Eigenschaften dieser Karte gesperrt sind. Außerdem wird neben den Eigenschaften DataField, DisplayName und Required ein Schlosssymbol angezeigt. Diese Formeln wurden im rechten Bereich erstellt, und das Schloss verhindert das versehentliche Ändern dieser Eigenschaften.

Wählen Sie das Banner oben aus, um die Karte zu entsperren, damit Sie diese Eigenschaften ändern können:

Ändern Sie DisplayName, um ein Leerzeichen zwischen Anlage und ID einzufügen. Durch diese Änderung ändern Sie das, was für Sie generiert wurde. Im rechten Bereich hat diese Karte eine andere Bezeichnung:

Jetzt habe Sie die Kontrolle über diese Karte und können sie noch weiter an Ihre Bedürfnisse anpassen. Allerdings können Sie nicht mehr wie vorher die Darstellung der Karte ändern (z. B. von einzeiligem auf mehrzeiligen Text umzustellen). Sie haben die vordefinierten Karte in eine „benutzerdefinierte Karte“ umgewandelt, die Sie nun steuern können.

Sie haben vielfältige Möglichkeiten, um das Erscheinungsbild und das Verhalten einer entsperrten Karte zu ändern. Sie können in der Karte z.B. Steuerelemente hinzufügen oder löschen. Sie können beispielsweise über das Menü Symbole auf der Registerkarte Einfügen eine Sternform hinzufügen.

Der Stern ist nun Bestandteil der Karte und verbleibt auf dieser, auch wenn Sie z.B. die Karten innerhalb des Formulars neu anordnen.

Ein weiteres Beispiel: Entsperren Sie die Karte ImageURL, und fügen Sie ihr von der Registerkarte Einfügen ein Bild-Steuerelement hinzu:

Legen Sie auf der Bearbeitungsleiste die Image-Eigenschaft dieses Steuerelements auf TextBox.Text fest, wobei TextBox der Name des Texteingabe-Steuerelements ist, das die URL enthält:

Jetzt sehen Sie die Bilder und können ihre URLs bearbeiten. Wir hätten Parent.Default als Image-Property verwenden können, aber es würde nicht aktualisiert, wenn der Benutzer die URL ändern würde.

Den gleichen Vorgang können Sie auch auf dem zweiten Bildschirm der App ausführen, wo Sie ein Anzeigeformular-Steuerelement verwenden, um die Details eines Datensatzes anzuzeigen. In diesem Fall empfiehlt es sich, die Bezeichnung auszublenden (legen Sie die Visible-Eigenschaft der Bezeichnung und nicht der Karte auf FALSE fest), da der Benutzer die URL auf diesem Bildschirm nicht bearbeitet:

Interagieren mit einem Formular

Nach dem Entsperren einer Karte können Sie ändern, wie sie mit dem Formular interagiert, in dem sie enthalten ist.

Hier finden Sie Leitlinien dafür, wie Steuerelementen mit ihrer Karte und Karten mit dem Formular funktionieren. Diese Anleitungen helfen Ihnen zu verstehen, wie Formeln erstellt werden, die auf andere Steuerelemente verweisen, einschließlich Karten und Steuerelemente innerhalb von Karten. Seien Sie kreativ – Sie können eine App auf vielerlei Arten erstellen, um sie an Ihre spezifischen Anforderungen anzupassen.

DataField-Eigenschaft

Die wichtigste Eigenschaft auf der Karte ist die DataField-Eigenschaft. Diese Eigenschaft steuert die Validierung, bestimmt, welches Feld aktualisiert wird, steuert andere Aspekte der Karte.

Informationsfluss (eingehend)

Als Container stellt das Formular ThisItem für alle Karten, die es enthält, zur Verfügung. Dieser Datensatz enthält alle Felder für den aktuellen, relevanten Datensatz.

Die Default-Eigenschaft jeder Karte sollte auf ThisItem.FieldName festgelegt werden. In einigen Fällen können Sie diesen Wert transformieren, sobald er eingeht. Z.B. möchten Sie möglicherweise eine Zeichenfolge formatieren oder einen Wert in eine andere Sprache übersetzen.

Jedes Steuerelement der Karte sollte auf Parent.Default verweisen, um den Wert des Feld abrufen zu können. Diese Strategie kapselt die Karte, sodass die Eigenschaft Default der Karte geändert werden kann, ohne dass sich dies auf die internen Formeln auswirkt.

Standardmäßig werden die Eigenschaften DefaultValue und Required aus den Metadaten der Datenquelle genommen, auf der Grundlage der DataField-Eigenschaft. Sie können diese Formeln mit Ihrer eigenen Logik überschreiben und die Metadaten der Datenquelle mithilfe der DataSourceInfo-Funktion integrieren.

Informationsfluss (ausgehend)

Nachdem der Benutzer einen Datensatz mithilfe der Steuerelemente auf den Karten geändert hat, speichert die SubmitForm-Funktion die Änderungen der Datenquelle. Wenn diese Funktion ausgeführt wird, liest das form-Steuerelement die Werte der DataField-Eigenschaft jeder Karte, um herauszufinden, welches Feld geändert werden soll.

Des form-Steuerelements liest auch den Wert der Update-Eigenschaft jeder Karte. Dieser Wert ist in der Datenquelle für dieses Feld gespeichert. Hier können Sie eine weiter Transformierung anwenden, um eventuell die Transformierung umzukehren, die auf die Default-Formel der Karte angewendet wurde.

Die Valid-Eigenschaft wird von den Metadaten der Datenquelle gesteuert, auf Grundlage der DataField-Eigenschaft. Außerdem basiert sie auf der Required-Eigenschaft und darauf, ob die Update-Eigenschaft einen Wert enthält. Wenn der Wert für die Update-Eigenschaft nicht gültig ist, bietet die Fehler-Eigenschaft eine benutzerfreundliche Fehlermeldung.

Wenn die Eigenschaft DataField einer Karte leer ist, fungiert die Karte als Container für Steuerelemente. Seine Eigenschaften Valid und Update werden nicht einbezogen, wenn das Formular gesendet wird.

Analyse eines Beispiels

Sehen Sie sich die Steuerelemente an, aus denen eine einfache Dateneingabekarte besteht. Der Abstand zwischen den Steuerelementen wird vergrößert, um die einzelnen Steuerelemente deutlicher anzuzeigen und verständlicher zu machen, wie die einzelnen Komponenten zur Funktionalität der Karte beitragen:

In dieser Grafik wurden die Steuerelemente innerhalb der Datenkarte mit einer Beschriftung versehen:

Dies Karte funktioniert mithilfe von vier Steuerelementen:

Um diese Steuerelemente mit Daten zu befüllen, können ihre Eigenschaften von denen der Karte anhand dieser Schlüsselformeln gesteuert werden. Formeln beziehen sich auf ein bestimmtes Feld. Stattdessen stammen alle Informationen von der Karte.

Verwenden Sie die folgenden Hauptformeln, um Informationen aus diesen Steuerelementen abzurufen und sie wieder in die Datenquelle einzufügen: