Freigeben über


Choices-Funktion

Gilt für: Canvas-Apps Modellgesteuerte Apps Power Pages

Gibt eine Tabelle mit den möglichen Werten für eine Suchspalte zurück.

Beschreibung

Die Choices Funktion gibt eine Tabelle der möglichen Werte für eine Nachschlagespalte zurück.

Verwenden Sie die Choices Funktion, um eine Liste der Auswahlmöglichkeiten für Den Benutzer bereitzustellen. Diese Funktion wird in der Regel zusammen mit dem Combo box-Steuerelement in Bearbeitungsformularen verwendet.

Bei einem Nachschlagevorgang entspricht die Zurückgegebene Tabelle Choices der Fremdtabelle, die dem Nachschlagevorgang zugeordnet ist. Durch die Verwendung Choicesmüssen Sie die Fremdtabelle als zusätzliche Datenquelle hinzufügen. Choices gibt alle Spalten der Fremdtabelle zurück.

Da Choices eine Tabelle zurückgegeben wird, können Sie "Filter", "Sortieren", "AddColumns" und alle anderen Tabellenbearbeitungsfunktionen verwenden, um die Tabelle zu filtern, zu sortieren und zu gestalten.

Zu diesem Zeitpunkt können Sie die Stellvertretung nicht delegierenChoices. Wenn diese Einschränkung ein Problem für Ihre App hervorruft, fügen Sie die Tabelle als Datenquelle hinzu, und verwenden Sie diese.

Choices spaltennamen müssen nicht Zeichenfolgen sein und in doppelte Anführungszeichen eingeschlossen werden, im Gegensatz zu showColumns, Search und anderen Tabellenfunktionen. Geben Sie die Formel so an, als würden Sie direkt auf die Spalte verweisen.

Spaltenverweise müssen direkt auf die Datenquelle verweisen. Wenn beispielsweise Accounts die Datenquelle ist und nach SLA gesucht wird, lautet der Spaltenverweis Accounts.SLA. Der Verweis kann eine Funktion, eine Variable oder ein Steuerelement durchlaufen. 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. 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.

Zu diesem Zeitpunkt können Sie nur Suchspalten mit SharePoint und Microsoft Dataverse verwenden.

Syntax

Choices( Spaltenverweis [, Textfilter ] )

  • column-reference – Erforderlich. Eine Suchspalte einer Datenquelle Setzen Sie den Spaltennamen nicht in doppelte Anführungszeichen. Der Verweis muss direkt auf die Spalte der Datenquelle hergestellt werden und darf weder eine Funktion noch ein Steuerelement durchlaufen.
  • Textfilter – Optional. Filtert die Liste der Auswahlmöglichkeiten, indem nur Auswahlmöglichkeiten zurückgegeben werden, die mit dem in text-filter angegebenen Text beginnen. Wenn eine leere Zeichenfolge angegeben wird, werden alle Auswahlmöglichkeiten zurückgegeben.

Beispiele

Choices für einen Nachschlagevorgang

  1. Erstellen Sie eine Datenbank in Dataverse und Auswählen im Feld Beispiel-Apps und -Daten einschließen .

    Es werden viele Tabellen wie z.B. Kunden erstellt.

    Hinweis: Tabellennamen sind bei make.powerapps.com Singular und bei Power Apps Studio Plural.

    Ausschnitt aus einer Liste der Felder aus der Tabelle in Dataverse für Apps, in der hervorgehoben wird, dass „Primärer Kontakt“ ein Suchfeld ist

    Die Tabelle Konten hat eine Spalte für den Primären Kontakt, die eine Suchspalte für die Tabelle Kontakte darstellt.

    Eine unvollständige Liste der Felder aus der Kontakttabelle in der Dataverse

    Für jedes Konto wird entweder ein Kontakt als primärer Kontakt festgelegt oder die Spalte bleibt leer.

  2. Generieren Sie eine App aus der Tabelle Konten .

  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.

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

  4. Wählen Sie auf der Registerkarte Eigenschaften im rechten Bereich die Option Felder bearbeiten aus.

    Den Bereich „Daten“ öffnen

  5. Wählen Sie im Bereich Felder die Option Feld hinzufügen aus.

  6. Suchen Sie nach dem Feld Primärer Kontakt, aktivieren Sie das Kontrollkästchen und wählen Sie dann Hinzufügen.

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

    Das Feld Primärer Kontakt wird am unteren Rand des Formulars angezeigt. Wenn das Feld einen Fehler anzeigt, wählen Sie Datenquellen aus der Registerkarte Ansicht, wählen Sie die Auslassungspunkte (...) für die Datenquelle Accounts und wählen Sie dann Aktualisieren.

  7. (Optional) Ziehen Sie das Feld Primärer Kontakt aus dem unteren Bereich der Liste in den oberen Bereich.

  8. Klicken Sie auf der Karte für den Primären Kontakt auf das Combo box-Steuerelement.

    Die Items-Eigenschaft dieses Steuerelements wird auf eine Formel festgelegt, die die Spalte entweder durch Anzeigename wie im ersten Beispiel oder durch ihren logischen Namen wie im zweiten Beispiel identifiziert:

    • Choices( Accounts.'Primary Contact' )

    • Choices( Accounts.primarycontactid )

      Ein Canvasbildschirm mit einem Formularsteuerelement. Das Kombinationsfeld-Steuerelement in der primären Visitenkarte ist ausgewählt, und die Items-Eigenschaft mit der Formel Choices( Accounts.'Primary Contact' ) wird angezeigt.

  9. Zur Veranschaulichung können wir die vollständige Tabelle anzeigen, die von der Choices Funktion in einem Datentabellensteuerelement zurückgegeben wird. Klicken Sie auf der Registerkarte Home auf Neuer Bildschirm und anschließend auf Leer.

  10. Klicken Sie auf der Registerkarte Einfügen auf die Option Data table.

  11. Legen Sie die Items Eigenschaft der flexiblen Höhe des Data table Steuerelements auf diese Formel fest:

    Choices( Accounts.'Primary Contact' )

  12. In der Mitte des Data table-Steuerelements wählen Sie den Link, der Wählen Sie die Felder... startet, aktivieren Sie dann die Kontrollkästchen für das Feld oder die Felder, die Sie anzeigen möchten (z. B. firstname und lastname).

    Ein Canvasbildschirm mit einem Datentabellensteuerelement. Die Items-Eigenschaft ist auf die Formel Choicesfestgelegt ( Accounts.'Primary Contact' ), und in der Tabelle werden die Spalten Vorname und Nachname für die erste Gruppe von Datensätzen aus der Tabelle Kontakte angezeigt.