Grundlegendes zu Datenkarten in Canvas-Apps

Karte-Steuerelemente sind die Bausteine der Steuerelemente Formular bearbeiten und Formular anzeigen in Canvas-Apps. Das Formular stellt den gesamten Datensatz dar, und jede Karte stellt ein einzelnes Feld dieses Datensatzes dar.

Am einfachsten können Sie mit Karten im rechten Bereich interagieren, nachdem Sie ein form-Steuerelement im Designarbeitsbereich ausgewählt haben. In diesem Bereich können Sie auswählen, welche Felder auf welche Weise in welcher Reihenfolge angezeigt werden sollen. In diesem Beispiel wird ein Formular bearbeiten-Steuerelement in einer App veranschaulicht, die anhand der -Liste Assets erstellt wurde.

Erster Bildschirm

Weitere Informationen zu den ersten Schritten mit Karten finden Sie unter Add a form (Formular hinzufügen) und Understand data forms (Grundlegendes zu Datenformularen). Im weiteren Verlauf dieses Artikels wird ausführlicher erläutert, wie Karten funktionieren, und wie Sie sie anpassen oder sogar Ihre eigenen Karten erstellen können.

Vordefinierte Karten

Power Apps bietet einen vordefinierten Satz von Smartcards, die für Zeichenfolgen, Zahlen und andere Datentypen geeignet sind. Im rechten Bereich finden Sie die verfügbaren Varianten; hier können Sie auch die für ein Feld verwendete Karte anpassen:

Ausgewählte Karte

In diesem Beispiel wird eine Karte für einzeiligen Text verwendet, aber der Text der URL ist länger als in einer einzelnen Zeile angezeigt werden kann. Ändern Sie diese Karte also in eine Karte für mehrzeiligen Text, damit Ihr Benutzer mehr Spielraum zum Bearbeiten hat:

Mehrzeilige Bearbeitung

Verschiedene Felder 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 veranschaulicht, wie das Feld SecurityCode angezeigt wird.

Eine Karte anpassen

Karten enthalten 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.

Arbeiten wir schrittweise ein Beispiel dafür durch, wie Sie das Erscheinungsbild einer Karte ändern können, indem Sie ihre Steuerelemente bearbeiten.

  1. Kehren Sie zunächst zu der Karte zurück, die Sie als letztes hinzugefügt haben, und machen Sie das Feld SecurityCode (Sicherheitscode) ausfindig. Wählen Sie diese Karte aus, indem Sie einmal darauf klicken oder tippen:

    Sicherheitscode auswählen

  2. Klicken oder tippen Sie auf das Texteingabe-Steuerelement auf der Karte, um es auszuwählen.

    Texteingabe auswählen

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

    Texteingabe anpassen

Sie können die Größe des Steuerelements in der Karte anpassen, es verschieben und weitere Änderungen vornehmen, aber Sie können es nicht löschen, ohne es zunächst entsperrt zu haben.

Entsperren einer Karte

Karten sind selbst auch Steuerelemente, die über Eigenschaften und Formeln verfügen, genauso wie jedes andere Steuerelement – auch wenn sie selbst wiederum Steuerelemente enthalten. 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. Diese Formeln finden sich auf der Registerkarte Erweitert im rechten Bereich:

Erweitert gesperrt

Sie sehen umgehend eine der wichtigsten Eigenschaften der Karte: die DataField-Eigenschaft (Datenfeld). 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.

Schlosssymbole

Klicken oder tippen Sie auf das Banner oben, um die Smartcard zu entsperren, damit Sie diese Eigenschaften ändern können:

Entsperrte Karte

Ändern Sie DisplayName, um ein Leerzeichen zwischen Asset 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:

Anzeigename ändern

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

Wichtig

Wenn Sie eine Karte entsperrt haben, können Sie sie nicht wieder sperren. Entfernen Sie die Karte, und fügen Sie sie nochmals im rechten Bereich ein, um sie erneut zu sperren.

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.

Stern 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:

Bild hinzufügen

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:

Bild anzeigen

Jetzt sehen Sie die Bilder und können deren URLs bearbeiten. Beachten Sie, dass Sie auch Parent.Default als Image-Eigenschaft hätten verwenden können, bei einer Änderung der URL durch den Benutzer würde dann jedoch keine Aktualisierung stattfinden.

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:

Bildanzeige anzeigen

Interagieren mit einem Formular

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

Im Folgenden finden Sie einige Richtlinien für die Funktionsweise von Steuerelementen mit ihrer Karte und mit dem Formular. Dies sind nur Richtlinien. Genauso wie mit jedem anderen Steuerelement in Power Apps können Sie Formel erstellen, die auf jedes beliebige Steuerelement in Power Apps verweisen – und dies gilt auch für Karten und Steuerelementen auf Karten. Seien Sie kreativ: Erstellen Sie eine Anwendung auf verschiedene Arten.

DataField-Eigenschaft

Die wichtigste Eigenschaft auf der Karte ist die DataField-Eigenschaft. Diese Eigenschaft steuert die Validierung, die Aktualisierung von Feldern und 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. Unter bestimmten Umständen möchten Sie diesen Wert vor der Zuweisung umwandeln. 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 bietet ein Maß an Datenkapselung für die Karte, damit sich die Default-Eigenschaft der Karte ändern kann, ohne die interne Formeln der Karte zu ändern.

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 wird 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 DataField-Eigenschaft einer Karte blank ist, ist die Smartcard lediglich ein 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 Zwischenraum zwischen Steuerelementen wurde verbessert, um sie besser voneinander abgrenzen zu können:

Karte zerlegen

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

Karten zerlegen

Dies Karte funktioniert durch vier Steuerelemente:

Name Art Beschreibung
TextRequiredStar Beschriftung-Steuerelement Zeigt einen Stern an, der häufig in Dateneingabeformularen verwendet wird, um erforderliche Felder zu kennzeichnen
TextFieldDisplayName Beschriftung-Steuerelement Zeigt den benutzerfreundlichen Namen dieses Felds an. Dieser Name kann von dem im Schema der Datenquelle abweichen.
InputText Eingabetext-Steuerelement Zeigt den anfänglichen Wert des Felds und ermöglicht es dem Benutzer, diesen Wert zu ändern
TextErrorMessage Beschriftung-Steuerelement Zeigt eine benutzerfreundliche Fehlermeldung für den Benutzer an, wenn ein Problem mit der Validierung auftritt. Außerdem stellt es sicher, dass das Feld einen Wert hat, wenn einer erforderlich ist.

Um diese Steuerelemente mit Daten aufzufüllen, können deren Eigenschaften von den Eigenschaften der Karte anhand dieser Schlüsselformeln gesteuert werden. Beachten Sie, dass sich Formeln auf ein bestimmtes Feld beziehen. Stattdessen stammen alle Informationen von der Karte.

Steuerelementeigenschaft Formel Beschreibung
TextRequiredStar.Visible Parent.Required Der Stern erscheint nur, wenn das Feld erforderlich ist. Eine Formel ist erforderlich, die von Ihnen oder den Metadaten der Datenquelle gesteuert wird.
TextFieldDisplayName.Text Parent.DisplayName Das Textfeld-Steuerelement zeigt den benutzerfreundlichen Namen, den Sie oder die Metadaten der Datenquelle bereitstellen, und die in der DisplayName-Eigenschaft der Karte festgelegt wird.
InputText.Default Parent.Default Das Texteingabe-Steuerelements zeigt zuerst den Wert des Felds der Datenquelle, wie er vom Standardwert der Karte bereitgestellt wird.
TextErrorMessage.Text Parent.Error Wenn ein Überprüfungsproblem auftritt, bietet die Error-Eigenschaft der Karte eine entsprechende Fehlermeldung.

Hinweis

Die Eigenschaft Parent.Error ist eine reine Ausgabeeigenschaft, die Sie nicht durch eine Formel festlegen können. Daher erscheint diese Eigenschaft nicht in der Liste der Eigenschaften in der Nähe der oberen linken Ecke oder in den Registern Eigenschaften oder Erweitert am rechten Rand. Die Formelleiste schlägt diese Eigenschaft vor, wenn Sie eine Formel schreiben, die auf diese Eigenschaft verweisen könnte.

Folgende Schlüsselformeln stehen zur Verfügung, um Informationen aus diesen Steuerelementen abzurufen und sie wieder in die Datenquelle einzufügen:

Steuerelementname Formel Beschreibung
DataCard.DataField "ApproverEmail" Der Name des Felds, das der Benutzer auf dieser Karte anzeigen und bearbeiten kann.
DataCard.Update InputText.Text Der zu überprüfende Wert, der wieder in die Datenquelle eingefügt werden soll, wenn SubmitForm ausgeführt wird.

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).