Grundlegendes zu Datenkarten in Canvas-Apps

In diesem Artikel wird erläutert, was eine Datenkarte ist, wie Sie das Steuerelement ändern, in das Benutzer Daten eingeben, wann eine Karte entsperrt werden soll und wie das Formular Änderungen wieder in Dataverse speichert.

Datenkarten sind die Bausteine von Power Apps Formularen. Jede Datenkarte zeigt einen Wert für ein einzelnes Feld an, z. B. Name, Position oder Telefonnummer.

Der folgende Screenshot zeigt ein Formular mit einer für Kontonamen ausgewählten Datenkarte.

Ein Formular zur Anzeige zeigt einen Datensatz an. Mithilfe von Bearbeitungsformularen können Benutzer einen vorhandenen Datensatz aktualisieren oder einen neuen datensatz erstellen. In beiden Formulartypen ist jede Datenkarte mit genau einem Feld (einer Spalte) in Ihrer Datenquelle verbunden – häufig eine Dataverse-Tabelle.

Eine Datenkarte ist ein Container, der die Feldbezeichnung, das erforderliche Überprüfungsverhalten und das Steuerelement enthält, mit dem Benutzer interagieren. Eine Datenkarte enthält Folgendes:

• Erforderlicher Indikator (Stern oder Stern): Zeigt an, dass das Feld einen Wert aufweisen muss.
• Titel: Die Bezeichnung, die Benutzern für das Feld angezeigt wird.
• Datenkartenwert: Das Eingabesteuerelement (z. B. ein Textfeld oder dropdown), in das Benutzer den Wert eingeben oder bearbeiten.
• Fehlermeldung: Zeigt Überprüfungsfehler an, in der Regel nach dem Senden des Formulars.

Voraussetzungen

Wenn Sie mit Formularen noch nicht fertig sind, lesen Sie zunächst add-form.md und working-with-forms.md.

Eine Karte anpassen

Eine Datenkarte enthält die Steuerelemente, die Benutzer sehen – in der Regel eine Bezeichnung wie den Titel, ein Eingabesteuerelement wie Texteingabe oder Dropdown und eine Fehlermeldungsbeschriftung. Um das Aussehen eines Felds anzupassen, markieren Sie das Steuerelement innerhalb der Karte, z. B. die Texteingabe, und passen Sie dessen Größe, Position oder Eigenschaften an.

Neuanordnen von Feldern in einem Formular

Power Apps bietet vordefinierte Karten für Zeichenfolgen, Zahlen und andere Datentypen. Sie bearbeiten das Formular und ordnen felder neu an, sodass Sie das Layout ändern können, ohne dass Karten entsperrt werden.

1. Öffnen Sie Ihre App zum Bearbeiten in Power Apps Studio.

2. Wählen Sie das Formular aus, und wählen Sie dann "Felder" aus.

3. Wählen Sie "Weitere Aktionen" aus, und wählen Sie dann " Nach oben " oder " Nach unten" aus. Sie können felder auch auswählen und dann in die gewünschte Reihenfolge ziehen.

   

Den Steuerungstyp einer Karte ändern

Sie können den Steuerelementtyp einer Karte leicht ändern. Bei Exmaple können Sie eine einzeilige Textkarte in eine mehrzeilige Textdatei ändern, damit Benutzer mehr Platz zum Eingeben von Informationen haben.

1. Öffnen Sie Ihre App zum Bearbeiten in Power Apps Studio.

2. Wählen Sie das Formular aus, und wählen Sie dann "Felder" aus.

3. Wählen Sie "Felddetails erweitern" aus, wobei es sich um den Abwärtspfeil neben dem Feld handelt, das Sie bearbeiten möchten.

4. Wählen Sie das Dropdownmenü für den Steuerelementtyp und dann einen anderen Steuerelementtyp aus. Wechseln Sie beispielsweise von "Text bearbeiten" zu " Mehrzeiligen Text bearbeiten".

   

Ändern der Größe einer Karte

Sie können Steuerelemente in einer gesperrten Karte verschieben und ihre Größe ändern.

Sie bearbeiten die Steuerelemente in einer Karte, ohne zu ändern, mit welchem Feld die Karte verbunden ist.

1. Wählen Sie im Formular die Datenkarte aus, die Sie anpassen möchten, z. B. "Kontoname".

2. Ziehen Sie, um die Texteingabe innerhalb der Karte zu verschieben, und verwenden Sie die Griffe, um die Größe zu ändern. Dadurch wird der Abstand und die Lesbarkeit verbessert, ohne die Karte zu entsperren.

   

Entsperren einer Karte

Um Änderungen vorzunehmen, z. B. das Löschen eines Steuerelements oder das Hinzufügen eines neuen Steuerelements, muss die Karte entsperrt werden.

Wenn Sie einem Formular ein Feld hinzufügen, erstellt Power Apps eine Datenkarte für Sie und richtet die grundlegenden Formeln ein, die die Karte mit der Datenquelle verbinden. Standardmäßig sperrt Power Apps diese Karten, sodass Sie diese Verbindung nicht versehentlich unterbrechen. Wenn Sie mehr Kontrolle benötigen, z. B. ein benutzerdefiniertes Layout, zusätzliche Steuerelemente oder unterschiedliche Formeln, können Sie die Karte entsperren.

Der folgende Screenshot zeigt ein Formular mit einer gesperrten Datenkarte.

Die Schlüsseleinstellung ist DataField. Sie teilt Power Apps, für welches Feld (Spalte) diese Karte verantwortlich ist. Wenn das Formular übermittelt wird, verwendet Power Apps den Wert DataField, um festzustellen, welches Feld aktualisiert werden soll.

1. Um eine Karte zu entsperren, wählen Sie die Karte aus

2. Wählen Sie im Eigenschaftenbereich die Option "Erweitert" aus.

3. Wählen Sie das Sperrsymbol aus, oder wählen Sie " Entsperren " aus, um Eigenschaften wie "DataField", "DisplayName" oder "Erforderlich" zu ändern.

4. Nachdem Sie die Karte entsperrt haben, bearbeiten Sie die generierten Formeln, und fügen Sie Steuerelemente innerhalb der Karte hinzu oder entfernen Sie sie.

   Gesperrte Eigenschaften	Entsperrte Eigenschaften

Sie übernehmen jetzt die Kontrolle über diese Karte und können sie weiter an Ihre Anforderungen anpassen. Sie verlieren jedoch die Möglichkeit, die Karte wie zuvor von einer Darstellung in eine andere zu ändern (z. B. einzeiligen Text in mehrzeiligen Text). Sie haben die vordefinierte Karte in eine "benutzerdefinierte Karte" umgewandelt, die Sie jetzt steuern.

Interagieren mit einem Formular

Nachdem Sie eine Karte entsperrt haben, können Sie steuern, wie Werte zwischen dem Formular und den Steuerelementen innerhalb der Karte verschoben werden.

Eine hilfreiche Möglichkeit, einen Denkansatz zu Bearbeitungsformularen zu finden, ist: Daten fließen herein, um den aktuellen Datensatz (Standardwerte) anzuzeigen, und Daten fließen heraus, wenn Sie die Formularaktualisierungen übermitteln. Die Karte befindet sich in der Mitte - seine Eigenschaften teilen dem Formular mit, welches Feld es darstellt und welcher Wert gespeichert werden soll.

DataField-Eigenschaft

Die DataField-Eigenschaft der Karte ist die Einstellung "diese Karte bearbeitet dieses Feld". Es hilft Power Apps zu entscheiden, was überprüft werden soll, welcher Wert erforderlich ist und welches Feld aktualisiert werden soll, wenn Sie das Formular übermitteln.

Informationsfluss (eingehend)

Wenn ein Formular einen Datensatz anzeigt, wird dieser Datensatz als ThisItem verfügbar gemacht. Stellen Sie sich ThisItem als die aktuelle Zeile vor, die Sie bearbeiten. Es enthält jedes Feld für diesen Datensatz.

In Dataverse-unterstützten Formularen stimmt das DataField der Karte normalerweise mit dem logischen Namen des Feldes überein. Die Standardformel der Karte verweist häufig auf den aktuellen Datensatz, z. B. "ThisItem.FieldName", und das Eingabesteuerelement in der Karte liest diesen Wert normalerweise über Parent.Default. Dieses Muster hält das Eingabesteuerelement unabhängig von der Datenquelle und ermöglicht es der Karte, das Verhalten beim Fluss des Feldwertes zu kapseln.

Die meisten Karten legen ihre Default-Eigenschaft auf den Wert des aktuellen Datensatzes fest, z. B. ThisItem.FieldName. Sie können diesen Wert optional transformieren, z. B. Text formatieren, bevor er in der Eingabe angezeigt wird.

Innerhalb der Karte verwendet das Eingabesteuerelement in der Regel Parent.Default , sodass immer der von der Karte bereitgestellte Wert angezeigt wird. Dieser Ansatz hält die Karte "selbstständig". Wenn Sie die Standardformel der Karte später ändern, müssen Sie keine Formeln innerhalb der Karte neu schreiben.

Standardmäßig werden in den Metadaten der Datenquelle die Eigenschaften DefaultValue und controls/control-card.md basierend auf der Eigenschaft "controls/control-card.md " festgelegt. Sie können diese Formeln mit Ihrer eigenen Logik überschreiben, indem Sie die Funktionen/function-datasourceinfo.md-Funktion verwenden, um die Metadaten der Datenquelle zu integrieren.

Informationsfluss (ausgehend)

Wenn der Benutzer "Speichern" auswählt, wird in der Regel SubmitForm aufgerufen. Das Formular sammelt Werte aus jeder Datenkarte und schreibt sie zurück in die Datenquelle. Es verwendet das DataField jeder Karte, um zu wissen , welches Feld aktualisiert werden soll.

Um Änderungen aus einem Bearbeitungsformular zu speichern, verwenden Sie SubmitForm(FormName) (z. B. über die Schaltfläche Speichern). Wenn Sie die Eingaben nach einer erfolgreichen Übermittlung löschen möchten, folgen Sie "ResetForm(FormName)". Wenn Sie einen neuen Datensatz erstellen möchten, anstatt einen vorhandenen Datensatz zu bearbeiten, legen Sie die DefaultMode-Eigenschaft des Formulars auf FormMode.New fest, bevor der Benutzer mit der Eingabe von Daten beginnt.

Das Formular liest auch die Update-Eigenschaft jeder Karte – dies ist der Wert, der für dieses Feld gespeichert wird. Wenn Sie vor dem Speichern einen Wert bereinigen müssen, z. B. das Entfernen zusätzlicher Leerzeichen, das Konvertieren von Text in eine Zahl oder das Umkehren einer Formatierungsänderung, die Sie in "Standard" vorgenommen haben, ist Update in der Regel der richtige Ort, um ihn zu erledigen.

Valid bedeutet im Wesentlichen "ist dieses Feld in Ordnung, um es abzusenden?" Power Apps verwendet die Datenquellenregeln und die Erforderlich-Einstellung, um dies zu entscheiden. Wenn der Wert ungültig ist, enthält die Error-Eigenschaft der Karte eine Meldung, die Dem Benutzer angezeigt werden kann, häufig über die Bezeichnung "Fehlermeldung " auf der Karte.

Wenn das DataField einer Karte leer ist, ist die Karte nicht an ein Beliebiges Feld gebunden – es handelt sich lediglich um einen Container, den Sie für das Layout verwenden können. In diesem Fall haben die Werte "Update" und " Valid " keine Auswirkungen darauf, was beim Senden des Formulars gespeichert wird.

Analyse eines Beispiels

Werfen Sie einen genaueren Blick darauf, was sich in einer typischen Dateneingabekarte befindet. Die folgenden Screenshots verteilten die Steuerelemente, sodass Sie jedes einzelne Element deutlich sehen können.

In der nächsten Abbildung werden die Steuerelemente in der Kartenansicht beschriftet, damit Sie das, was Sie auf dem Bildschirm sehen, mit dem in der Baumansicht übereinstimmen können.

Dies sind die wichtigsten Steuerelemente, die in der Regel auf einer Karte angezeigt werden:

Diese Steuerelemente stellen in der Regel keine direkte Verbindung mit Dataverse her. Stattdessen lesen sie einfache Werte aus der übergeordneten Karte mithilfe von "Parent", und die Karte verarbeitet die Verbindung mit der Datenquelle. Die folgenden Formeln sind häufige Beispiele.