Auswahlfunktion in Power appsChoices function in Power Apps

Gibt eine Tabelle mit den möglichen Werten für eine Suchspalte zurück.Returns a table of the possible values for a lookup column.

BeschreibungDescription

Die Funktion Choices gibt eine Tabelle mit den möglichen Werten für eine Suchspalte zurück.The Choices function returns a table of the possible values for a lookup column.

Verwenden Sie die Funktion Choices, um eine Liste mit Auswahlmöglichkeiten für den Benutzer zu erstellen.Use the Choices function to provide a list of choices for your user to select from. Diese Funktion wird in der Regel zusammen mit dem Kombinationsfeld-Steuerelement in Bearbeitungsformularen verwendet.This function is commonly used with the Combo box control in edit forms.

Bei Suchvorgängen stimmt die Tabelle, die die Funktion Choices zurückgibt mit der Fremdtabelle überein, die dem Suchvorgang zugeordnet ist.For a lookup, the table that Choices returns matches the foreign table that's associated with the lookup. Wenn Sie die Funktion Choices verwenden, ist es nicht mehr notwendig die Fremdtabelle als zusätzliche Datenquelle hinzuzufügen.By using Choices, you eliminate the need to add the foreign table as an additional data source. Die Funktion Choices gibt alle Spalten der Fremdtabelle zurück.Choices returns all columns of the foreign table.

Da die Funktion Choices eine Tabelle zurückgibt, können Sie die Funktionen Filter, Sort und AddColumns sowie alle weiteren Funktionen verwenden, die zur Bearbeitung einer Tabelle beitragen und die Tabelle filtern, sortieren und formen.Because Choices returns a table, you can use Filter, Sort, AddColumns, and all the other table-manipulation functions to filter, sort, and shape the table.

Zu diesem Zeitpunkt können Sie keine Optionendelegieren.At this time, you can't delegate Choices. Wenn diese Einschränkung ein Problem für Ihre App hervorruft, fügen Sie die Fremdentität als Datenquelle hinzu, und verwenden Sie diese.If this limitation poses a problem in your app, add the foreign entity as a data source, and use it directly.

Für die Funktion Choices ist es nicht wie bei den Funktionen ShowColumns und Search sowie anderen Tabellenfunktionen erforderlich, dass Spaltennamen Zeichenfolgen darstellen und in doppelten Anführungszeichen stehen.Choices doesn't require column names to be strings and enclosed in double quotes, unlike the ShowColumns, Search, and other table functions. Geben Sie die Formel so an, als würden Sie direkt auf die Spalte verweisen.Provide the formula as if you were referencing the column directly.

Spaltenverweise müssen direkt auf die Datenquelle verweisen.Column references must be direct to the data source. Wenn beispielsweise Accounts die Datenquelle ist und nach SLA gesucht wird, lautet der Spaltenverweis Accounts.SLA.For example, if the data source is Accounts and the lookup is SLA, the column reference would be Accounts.SLA. Der Verweis kann eine Funktion, eine Variable oder ein Steuerelement durchlaufen.The reference can't pass through a function, a variable, or a control. Wenn aber Accounts an das Steuerelement Gallery übergeben wird, verwenden Sie die Formel Gallery.Selected.SLA, um auf die SLA für das ausgewählte Konto zu verweisen.Furthering this example, if Accounts is fed to a Gallery control, use the formula Gallery.Selected.SLA to reference the SLA for the selected account. Dieser Verweis hat dann ein Steuerelement durchlaufen und kann daher nicht an die Funktion Columns übergeben werden. Daher müssen Sie weiterhin Accounts.SLA verwenden.However, this reference has passed through a control, so it can't be passed to the Columns function - you must still use Accounts.SLA.

Zu diesem Zeitpunkt können Sie Such Spalten nur mit SharePoint und Common Data Service verwenden.At this time, you can use lookup columns only with SharePoint and Common Data Service.

SyntaxSyntax

Choices( Spalte-Verweis )Choices( column-reference )

  • Spalte-Verweis – Erforderlich.column-reference – Required. Eine Suchspalte einer DatenquelleA lookup column of a data source. Setzen Sie den Spaltennamen nicht in doppelte Anführungszeichen.Don't enclose the column name in double quotes. Der Verweis muss direkt auf die Spalte der Datenquelle hergestellt werden und darf weder eine Funktion noch ein Steuerelement durchlaufen.The reference must be directly to the column of the data source and not pass through a function or a control.

BeispieleExamples

Die Funktion „Choices“ für eine SucheChoices for a lookup

  1. Erstellen Sie in Common Data Service eine Datenbank , und aktivieren Sie das Kontrollkästchen Beispiel-apps und-Daten einschließen .Create a database in Common Data Service, and select the Include sample apps and data box.

    Es werden einige Entitäten wie z.B. Accounts erstellt.Many entities, such as Accounts, are created.

    Hinweis: Entitäts Namen sind in make.powerapps.com und Plural in Power apps Studio Singular.Note: Entity names are singular on make.powerapps.com and plural in Power Apps Studio.

    Eine partielle Liste der Felder aus der Konto Entität in Common Data Service für apps, die darauf hinweist, dass "primärer Kontakt" ein Nachschlage Feld ist.

    Die Entität Accounts weist eine Spalte für den Primären Kontakt auf, die eine Suchspalte für die Entität Contacts darstellt.The Accounts entity has a Primary Contact column, which is a lookup to the Contacts entity.

    Eine partielle Liste der Felder aus der Contact-Entität im Common Data Service

    Für jedes Konto wird entweder ein Kontakt als primärer Kontakt festgelegt oder die Spalte bleibt leer.For each account, a contact is designated as the primary contact, or the primary contact is blank.

  2. Generieren Sie eine App aus der Entität Accounts.Generate an app from the Accounts entity.

  3. Scrollen Sie in der Liste mit den Anzeigen und Steuerelementen in der linken Ecke nach unten, bis EditScreen1 angezeigt wird, und klicken Sie dann darunter auf EditForm1.In the list of screens and controls near the left edge, scroll down until EditScreen1 appears, and then select EditForm1 just under it.

    Auf der linken Navigationsleiste unter „EditScreen1“ auf „EditForm1“ klicken

  4. Wählen Sie auf der Registerkarte Eigenschaften im rechten Bereich Felder bearbeitenaus.On the Properties tab of the right pane, select Edit fields.

    Öffnen des Datenbereichs

  5. Wählen Sie im Bereich Felder die Option Feld hinzufügenaus.In the Fields pane, select Add field.

  6. Suchen Sie nach dem Feld Primäres Kontakt , aktivieren Sie das entsprechende Kontrollkästchen, und wählen Sie dann Hinzufügenaus.Search for the Primary Contact field, select its check box, and then select Add.

    Auf „Accounts“ klicken, um den Bereich „Daten“ zu öffnen

    Das primäre Kontakt Feld wird unten im Formular angezeigt.The Primary Contact field appears at the bottom of the form. Wenn im Feld ein Fehler angezeigt wird, wählen Sie auf der Registerkarte Ansicht die Option Datenquellen aus, wählen Sie die Auslassungs Punkte (...) für die Datenquelle Accounts aus, und klicken Sie dann auf Aktualisieren.If the field shows an error, select Data sources on the View tab, select the ellipsis (...) for the Accounts data source, and then select Refresh.

  7. (Optional) Ziehen Sie das Feld Primärer Kontakt aus dem unteren Bereich der Liste in den oberen Bereich.(optional) Drag the Primary Contact field from the bottom to the top of the list of fields.

  8. Klicken Sie auf der Karte für den Primären Kontakt auf das Kombinationsfeld-Steuerelement.In the card for Primary Contact, select the Combo box control.

    Die Items -Eigenschaft dieses Steuer Elements wird auf eine Formel festgelegt, die die Spalte entweder durch ihren anzeigen Amen, wie im ersten Beispiel, oder durch den logischen Namen identifiziert, wie im zweiten Beispiel dargestellt:The Items property of that control is set to a formula that identifies the column by either its display name, as in the first example, or its logical name, as in the second example:

    • Choices( Accounts.'Primary Contact' )Choices( Accounts.'Primary Contact' )

    • Choices( Accounts.primarycontactid )Choices( Accounts.primarycontactid )

      Eine Canvas-Anzeige mit einem Formularsteuerelement

  9. Zur Veranschaulichung können wir die gesamte Tabelle anzeigen, die von der Auswahl Funktion in einem Datentabellen -Steuerelement zurückgegeben wird.For illustration purposes, we can view the complete table returned by the Choices function in a Data table control. Klicken Sie erst auf der Registerkarte Start auf die Option Neuer Bildschirm und anschließend auf Blank.On the Home tab, select New screen, and then select Blank.

  10. Klicken Sie auf der Registerkarte Einfügen auf die Option Datentabelle.On the Insert tab, select Data table.

  11. Legen Sie die Items -Eigenschaft des Datentabellen -Steuer Elements auf diese Formel fest:Set the Items property of the Data table control to this formula:

    Choices( Accounts.'Primary Contact' )Choices( Accounts.'Primary Contact' )

  12. Wählen Sie in der Mitte des Datentabellen -Steuer Elements den Link aus, der beginnt, Wählen Sie die Felder aus... , und aktivieren Sie dann die Kontrollkästchen für die Felder, die Sie anzeigen möchten (z. b. FirstName und LastName).In the middle of the Data table control, select the link that starts Choose the fields..., and then select the check boxes for the field or fields that you want to show (for example, firstname and lastname).

    Eine Canvas-Anzeige mit einem Datentabellensteuerelement