Grundlegendes zu DatenkartenUnderstand data cards

Card -Steuerelemente sind die Bausteine der Steuerelemente Formular bearbeiten und Formular anzeigen.Card controls are the building blocks of the Edit form and Display form controls. Das Formular stellt den gesamten Datensatz dar, und jede Karte stellt ein einzelnes Feld dieses Datensatzes dar.The form represents the entire record, and each card represents a single field of that record.

Am einfachsten können Sie mit Karten im rechten Bereich interagieren, nachdem Sie ein Formularsteuerelement im Designarbeitsbereich ausgewählt haben.You can interact with cards most easily in the right-hand pane after you select a form control in the design workspace. In diesem Bereich können Sie auswählen, welche Felder auf welche Weise in welcher Reihenfolge angezeigt werden sollen.In that pane, you can choose which fields to show, how to show each field, and in what order to show them. In diesem Beispiel wird ein Bearbeitungsformular-Steuerelement in einer App veranschaulicht, die anhand der SharePoint-Liste Assets erstellt wurde.This example shows an Edit form control in an app built from a SharePoint list that's named Assets.

Weitere Informationen zu den ersten Schritten mit Karten finden Sie unter Add a form (Formular hinzufügen) und Understand data forms (Grundlegendes zu Datenformularen).To get started with cards, see add a form and understand data forms. Im weiteren Verlauf dieses Themas wird ausführlicher erläutert, wie Karten funktionieren, und wie Sie sie anpassen oder sogar Ihre eigenen Karten erstellen können.The remainder of this topic goes into more detail about how cards work and how you can customize or even create your own.

Vordefinierte KartenPredefined cards

PowerApps bietet einen vordefinierten Satz von Smartcards, die für Zeichenfolgen, Zahlen und andere Datentypen geeignet sind.PowerApps offers a predefined set of cards for strings, numbers, and other data types. Im rechten Bereich finden Sie die verfügbaren Varianten; hier können Sie auch die für ein Feld verwendete Karte anpassen:In the right-hand pane, you can see the variations available and change the card used for a field:

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.In this example, a single-line text card is selected, but the URL's text is longer than can be shown on a single line. Ändern Sie diese Karte also in eine Karte für mehrzeiligen Text, damit Ihr Benutzer mehr Spielraum zum Bearbeiten hat:Let's change this to a multi-line text card to give our users more room to edit:

Verschiedene Felder dieser Datenquelle werden nicht angezeigt, Sie können jedoch die einzelnen Felder ein- oder ausblenden, indem Sie das entsprechende Kontrollkästchen aktivieren.Several fields of this data source aren't being shown, but you can show or hide a field by selecting its checkbox. In diesem Beispiel wird veranschaulicht, wie das Feld SecurityCode angezeigt wird.This example illustrates how to show the SecurityCode field.

Eine Karte anpassenCustomize a card

Karten enthalten andere Steuerelemente.Cards comprise other controls. 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 an Edit form control, the user enters data in a standard Text input control that you add from the Insert tab.

Arbeiten wir schrittweise ein Beispiel dafür durch, wie Sie das Erscheinungsbild einer Karte ändern können, indem Sie ihre Steuerelemente bearbeiten.Let's walk through an example of how to change a card's appearance by manipulating controls in it.

  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.First, let's return to the card that we inserted most recently, for the SecurityCode field. Wählen Sie diese Karte aus, indem Sie einmal darauf klicken oder tippen:Select this card by clicking or tapping it once:

  2. Klicken oder tippen Sie auf das Texteingabe-Steuerelement auf der Karte, um es auszuwählen.Select the Text input control inside the card by clicking or tapping the input control itself.

  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:Move this control within the card by dragging the selection box, and resize the control by dragging the handles along the edge of the selection box:

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.You can resize, move, and make other modifications to controls within a card, but you can't delete it without unlocking it first.

Entsperren einer KarteUnlock a card

Karten sind selbst auch Steuerelemente, die über Eigenschaften und Formeln verfügen, genauso wie jedes andere Steuerelement – auch wenn sie selbst wiederum Steuerelemente enthalten.In addition to containing controls, cards themselves are controls that have properties and formulas just like any other control. 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.When you choose to display a field on a form, the right-hand pane automatically creates the card for you and generates the needed formulas. Diese Formeln finden sich auf der Registerkarte Erweitert im rechten Bereich:We can see these formulas in the Advanced tab of the right-hand pane:

Sie sehen umgehend eine der wichtigsten Eigenschaften der Karte: die DataField-Eigenschaft (Datenfeld).We immediately see one of the most important properties of the card: the DataField property. Diese Eigenschaft gibt an, welches Feld der Datenquelle dem Benutzer angezeigt wird und was er auf dieser Karte bearbeiten kann.This property indicates which field of the data source the user sees and can edit in this card.

Auf der Registerkarte Erweitert gibt das Banner am oberen Rand an, dass die Eigenschaften dieser Karte gesperrt sind.On the Advanced tab, the banner at the top indicates that the properties of this card are locked. Außerdem wird neben den Eigenschaften DataField, DisplayName und Required ein Schlosssymbol angezeigt.A lock icon also appears next to the DataField, DisplayName, and Required properties. Diese Formeln wurden im rechten Bereich erstellt, und das Schloss verhindert das versehentliche Ändern dieser Eigenschaften.The right-hand pane created these formulas, and the lock prevents accidental changes to these properties.

Klicken oder tippen Sie auf das Banner oben, um die Smartcard zu entsperren, damit Sie diese Eigenschaften ändern können:Click or tap the banner at the top to unlock the card so that you can modify these properties:

Ändern Sie DisplayName, um ein Leerzeichen zwischen Asset und ID einzufügen.Let's modify the DisplayName to put a space between Asset and ID. Durch diese Änderung ändern Sie das, was für Sie generiert wurde.By making this change, we're altering what was generated for us. Im rechten Bereich hat diese Karte eine andere Bezeichnung:In the right-hand pane, this card has a different label:

Jetzt können Sie diese Karte steuern und noch weiter an Ihre Bedürfnisse anpassen.We've now taken control over this card and can modify it further to fit our need. Allerdings haben Sie nicht mehr wie vorher die Möglichkeit, die Darstellung der Karte zu ändern (z.B. von einzeiligem in mehrzeiligen Text).But we've lost the ability to change the card from one representation to another (for example, single-line text to multi-line text) as we did before. Sie haben die vordefinierten Karte in eine „benutzerdefinierte Karte“ umgewandelt, die Sie nun steuern können.We've transformed the predefined card into a "custom card" that we now control.

Wichtig: Wenn Sie eine Karte entsperrt haben, können Sie sie nicht erneut sperren.Important: You can't relock a card if you unlock it. Entfernen Sie die Karte, und fügen Sie sie nochmals im rechten Bereich ein, um sie erneut zu sperren.To get a card back to a locked state, remove it, and reinsert it in the right-hand pane.

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.You can change the appearance and behavior of an unlocked card in a variety of ways, such as adding and deleting controls within it. Sie können beispielsweise über das Menü Symbole auf der Registerkarte Einfügen eine Sternform hinzufügen.For example, you can add a star shape from the Icons menu on the Insert tab.

Der Stern ist nun Bestandteil der Karte und verbleibt auf dieser, auch wenn Sie z.B. die Karten innerhalb des Formulars neu anordnen.The star is now a part of the card and will travel with it if, for example, you reorder the cards within the form.

Ein weiteres Beispiel: Entsperren Sie die Karte ImageURL, und fügen Sie ihr von der Registerkarte Einfügen ein Bild-Steuerelement hinzu:As another example, unlock the ImageURL card, and then add an Image control to it from the Insert tab:

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:In the formula bar, set the Image property of this control to TextBox.Text, where TextBox is the name of the Text input control that holds the URL:

Tipp: Drücken Sie die ALT-TASTE, um den Namen der einzelnen Steuerelemente anzuzeigen.Tip: Press the Alt key to show the name of each control.

Jetzt sehen Sie die Bilder und können deren URLs bearbeiten.And now we can see the images and edit their URLs. 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.Note that we could have used Parent.Default as the Image property, but it wouldn't have updated if the user changed the URL.

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.We can do the same thing on the second screen of this app, where we use a Display form control to display the details of a record. 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:In this case, we may want to hide the label (set the Visible property of the label, not the card, to false) because the user won't edit the URL on that screen:

Interagieren mit einem FormularInteract with a form

Nach dem Entsperren einer Karte können Sie ändern, wie sie mit dem Formular interagiert, in dem sie enthalten ist.After you unlock a card, you can change how it interacts with the form that contains it.

Im Folgenden finden Sie einige Richtlinien für die Funktionsweise von Steuerelementen mit ihrer Karte und mit dem Formular.Below are some guidelines for how controls should work with their card and how the cards should work with the form. Dies sind nur Richtlinien.These are only guidelines. Genauso wie mit jedem anderen Steuerelement in PowerApps können Sie Formel erstellen, die auf jedes beliebige Steuerelement in PowerApps verweisen – und dies gilt auch für Karten und Steuerelementen auf Karten.As with any control in PowerApps, you can create formulas that reference any other control in PowerApps, and that's no less true for cards and controls within cards. Seien Sie kreativ: Erstellen Sie eine Anwendung auf verschiedene Arten.Be creative: you can create an app in many ways.

DataField-EigenschaftDataField property

Die wichtigste Eigenschaft auf der Karte ist die DataField-Eigenschaft.The most important property on the card is the DataField property. Diese Eigenschaft steuert die Validierung, die Aktualisierung von Feldern und andere Aspekte der Karte.This property drives validation, what field is updated, and other aspects of the card.

Informationsfluss (eingehend)Information flowing in

Als Container stellt das Formular ThisItem für alle Karten, die es enthält, zur Verfügung.As a container, the form makes ThisItem available to all cards within it. Dieser Datensatz enthält alle Felder für den aktuellen, relevanten Datensatz.This record contains all of the fields for the current record of interest.

Die Default-Eigenschaft jeder Karte sollte auf ThisItem.FieldName festgelegt werden.The Default property of every card should be set to ThisItem.FieldName. Unter bestimmten Umständen möchten Sie diesen Wert vor der Zuweisung umwandeln.Under certain circumstances, you might want to transform this value on the way in. Z.B. möchten Sie möglicherweise eine Zeichenfolge formatieren oder einen Wert in eine andere Sprache übersetzen.For example, you might want to format a string or translate the value from one language to another.

Jedes Steuerelement der Karte sollte auf Parent.Default verweisen, um den Wert des Feld abrufen zu können.Each control within the card should reference Parent.Default to get at the field's value. 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.This strategy provides a level of encapsulation for the card so that the card's Default property can change without changing the internal formulas of the card.

Standardmäßig werden die Eigenschaften DefaultValue und Required aus den Metadaten der Datenquelle genommen, auf der Grundlage der DataField-Eigenschaft.By default, DefaultValue and Required properties are taken from the data source's metadata based on the DataField property. Sie können diese Formeln mit Ihrer eigenen Logik überschreiben und die Metadaten der Datenquelle mithilfe der DataSourceInfo-Funktion integrieren.You can override these formulas with your own logic, integrating the data source's metadata by using the DataSourceInfo function.

Informationsfluss (ausgehend)Information flowing out

Nachdem der Benutzer einen Datensatz mithilfe der Steuerelemente auf den Karten geändert hat, speichert die SubmitForm-Funktion die Änderungen der Datenquelle.After the user modifies a record by using controls in the cards, the SubmitForm function saves those changes to the data source. Wenn diese Funktion ausgeführt wird, liest das Formularsteuerelement die Werte der DataField-Eigenschaft jeder Karte, um herauszufinden, welches Feld geändert werden soll.When that function runs, the form control reads the values of each card's DataField property to know what field to change.

Des Formularsteuerelements liest auch den Wert der Update-Eigenschaft jeder Karte.The form control also reads the value of each card's Update property. Dieser Wert wird in der Datenquelle für dieses Feld gespeichert.This value will be stored in the data source for this field. Hier können Sie eine weiter Transformierung anwenden, um eventuell die Transformierung umzukehren, die auf die Default-Formel der Karte angewendet wurde.This is the place to apply another transform, perhaps to reverse the transform that was applied in the card's Default formula.

Die Valid-Eigenschaft wird von den Metadaten der Datenquelle gesteuert, auf Grundlage der DataField-Eigenschaft.The Valid property is driven from the metadata of the data source, based on the DataField property. Außerdem basiert sie auf der Required-Eigenschaft und darauf, ob die Update-Eigenschaft einen Wert enthält.It's also based on the Required property and whether the Update property contains a value. Wenn der Wert für die Update-Eigenschaft nicht gültig ist, bietet die Fehler-Eigenschaft eine benutzerfreundliche Fehlermeldung.If the value on the Update property isn't valid, the Error property provides a user-friendly error message.

Wenn die DataField-Eigenschaft einer Karte blank ist, ist die Smartcard lediglich ein Container für Steuerelemente.If the DataField property of a card is blank, the card is just a container of controls. Seine Eigenschaften Valid und Update werden nicht einbezogen, wenn das Formular gesendet wird.Its Valid and Update properties don't participate when the form is submitted.

Analyse eines BeispielsDissecting an example

Sehen Sie sich die Steuerelemente an, aus denen eine einfache Dateneingabekarte besteht.Let's look at the controls that make up a basic data-entry card. Der Zwischenraum zwischen Steuerelementen wurde verbessert, um sie besser voneinander abgrenzen zu können:The space between controls has been increased to show each more clearly:

Halten Sie die ALT-TASTE gedrückt, um die Namen der Steuerelemente anzuzeigen, aus denen diese Karte besteht:Hold down the Alt key to show the names of the controls that make up this card:

Dies Karte funktioniert durch vier Steuerelemente:Four controls make this card work:

NameName TypType BeschreibungDescription
TextRequiredStarTextRequiredStar Label-Steuerelement (Bezeichnung)Label control Zeigt einen Stern an, der häufig in Dateneingabeformularen verwendet wird, um erforderliche Felder zu kennzeichnenDisplays a star, which is commonly used on data-entry forms to indicate that a field is required.
TextFieldDisplayNameTextFieldDisplayName Label-Steuerelement (Bezeichnung)Label control Zeigt den benutzerfreundlichen Namen dieses Felds an.Displays the user-friendly name of this field. Dieser Name kann von dem im Schema der Datenquelle abweichen.This name can differ from what is in the data source's schema.
InputTextInputText Eingabetext-SteuerelementInput text control Zeigt den anfänglichen Wert des Felds und ermöglicht es dem Benutzer, diesen Wert zu ändernDisplays the initial value of the field and allows the user to change that value.
TextErrorMessageTextErrorMessage Label-Steuerelement (Bezeichnung)Label control Zeigt eine benutzerfreundliche Fehlermeldung für den Benutzer an, wenn ein Problem mit der Validierung auftritt.Displays a user-friendly error message to the user if a problem occurs with validation. Außerdem stellt es sicher, dass das Feld einen Wert hat, wenn einer erforderlich ist.Also ensures that the field has a value if one is required.

Um diese Steuerelemente mit Daten aufzufüllen, können deren Eigenschaften von den Eigenschaften der Karte anhand dieser Schlüsselformeln gesteuert werden.To populate these controls with data, their properties can be driven from the properties of the card, through these key formulas. Beachten Sie, dass keine dieser Formeln auf ein bestimmtes Feld verweist.Note that none of these formulas refers to a specific field. Stattdessen stammen alle Informationen von der Karte.Instead, all information comes from the card.

Control-EigenschaftControl property FormelFormula BeschreibungDescription
TextRequiredStar.VisibleTextRequiredStar.Visible Parent.RequiredParent.Required Der Stern erscheint nur, wenn das Feld erforderlich ist.The star appears only if the field is required. Eine Formel ist erforderlich, die von Ihnen oder den Metadaten der Datenquelle gesteuert wird.Required is a formula that's driven by you or the metadata of the data source.
TextFieldDisplayName.TextTextFieldDisplayName.Text Parent.DisplayNameParent.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.The text-box control shows the user-friendly name, which you or the data source's metadata provides, and which is set on the card's DisplayName property.
InputText.DefaultInputText.Default Parent.DefaultParent.Default Das Texteingabe-Steuerelements zeigt zuerst den Wert des Felds der Datenquelle, wie er vom Standardwert der Karte bereitgestellt wird.The text-input control initially shows the value of the field from the data source, as provided by the card's default value.
TextErrorMessage.TextTextErrorMessage.Text Parent.ErrorParent.Error Wenn ein Überprüfungsproblem auftritt, bietet die Error-Eigenschaft der Karte eine entsprechende Fehlermeldung.If a validation problem occurs, the card's Error property provides an appropriate error message.

Folgende Schlüsselformeln stehen zur Verfügung, um Informationen aus diesen Steuerelementen abzurufen und sie wieder in die Datenquelle einzufügen:To pull information out of these controls and push it back into the data source, we have the following key formulas:

SteuerelementnameControl name FormelFormula BeschreibungDescription
DataCard.DataFieldDataCard.DataField "ApproverEmail""ApproverEmail" Der Name des Felds, das der Benutzer auf dieser Karte anzeigen und bearbeiten kann.The name of the field that the user can display and edit in this card.
DataCard.UpdateDataCard.Update InputText.TextInputText.Text Der zu überprüfende Wert, der wieder in die Datenquelle eingefügt werden soll, wenn SubmitForm ausgeführt wird.The value to validate and push back into the data source when SubmitForm runs.