Funzione Choices in PowerAppsChoices function in PowerApps

Restituisce una tabella dei valori possibili per una colonna di ricerca.Returns a table of the possible values for a lookup column.

DescrizioneDescription

La funzione Choices restituisce una tabella dei valori possibili per una colonna di ricerca.The Choices function returns a table of the possible values for a lookup column.

Usare la funzione Choices per offrire un elenco di scelte da cui l'utente può scegliere.Use the Choices function to provide a list of choices for your user to select from. Questa funzione viene comunemente usata con il controllo Casella combinata nei form di modifica.This function is commonly used with the Combo box control in edit forms.

Per una ricerca, la tabella restituita da Choices corrisponde alla tabella esterna associata alla ricerca.For a lookup, the table that Choices returns matches the foreign table that's associated with the lookup. Usando Choices si elimina la necessità di aggiungere la tabella esterna come origine dati aggiuntiva.By using Choices, you eliminate the need to add the foreign table as an additional data source. Choices restituisce tutte le colonne della tabella esterna.Choices returns all columns of the foreign table.

Poiché Choices restituisce una tabella, è possibile usare Filter, Sort, AddColumns e tutte le altre funzioni di modifica delle tabelle per filtrare, ordinare e definire la forma di una tabella.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.

Attualmente, non è possibile delegare Choices.At this time, you can't delegate Choices. Se questa limitazione costituisce un problema nell'app, aggiungere l'entità esterna come origine dati e usarla direttamente.If this limitation poses a problem in your app, add the foreign entity as a data source, and use it directly.

A differenza di ShowColumns, Search e altre funzioni di tabella, la funzione Choices non richiede che i nomi di colonna siano stringhe e vengano racchiusi tra virgolette doppie.Choices doesn't require column names to be strings and enclosed in double quotes, unlike the ShowColumns, Search, and other table functions. Specificare la formula come se si facesse riferimento direttamente alla colonna.Provide the formula as if you were referencing the column directly.

I riferimenti di colonna devono essere diretti all'origine dati.Column references must be direct to the data source. Ad esempio, se l'origine dati è Accounts e la ricerca è SLA, il riferimento alla colonna sarà Accounts.SLA.For example, if the data source is Accounts and the lookup is SLA, the column reference would be Accounts.SLA. Il riferimento non può essere passato tramite una funzione, una variabile o un controllo.The reference can't pass through a function, a variable, or a control. Nel caso dell'esempio, se Accounts viene passato a un controllo Gallery, usare la formula Gallery.Selected.SLA per fare riferimento al contratto di servizio (SLA) per l'account selezionato.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. Tuttavia, poiché il riferimento viene passato tramite un controllo, non può essere passato alla funzione Columns: è necessario usare Accounts.SLA.However, this reference has passed through a control, so it can't be passed to the Columns function - you must still use Accounts.SLA.

A questo punto, è possibile utilizzare le colonne di ricerca solo con SharePoint e Common Data Service.At this time, you can use lookup columns only with SharePoint and Common Data Service.

SintassiSyntax

Choices( riferimento colonna )Choices( column-reference )

  • riferimento colonna: obbligatorio.column-reference – Required. Colonna di ricerca di un'origine dati.A lookup column of a data source. Non racchiudere il nome di colonna tra virgolette doppie.Don't enclose the column name in double quotes. Il riferimento deve essere un riferimento diretto alla colonna dell'origine dati e non può essere passato tramite una funzione o un controllo.The reference must be directly to the column of the data source and not pass through a function or a control.

EsempiExamples

Choices per una ricercaChoices for a lookup

  1. Creare un database in Common Data Service e selezionare la casella Includi le app e i dati di esempio .Create a database in Common Data Service, and select the Include sample apps and data box.

    Vengono create numerose entità, ad esempio Accounts.Many entities, such as Accounts, are created.

    Nota: I nomi di entità sono singolari in web.powerapps.com e plurale in PowerApps Studio.Note: Entity names are singular on web.powerapps.com and plural in PowerApps Studio.

    Un elenco parziale dei campi dall'entità account in Common Data Service per le app, evidenziando che "contatto principale" è un campo di ricerca

    L'entità Accounts include una colonna Contatto principale che costituisce una ricerca nell'entità Contacts.The Accounts entity has a Primary Contact column, which is a lookup to the Contacts entity.

    Elenco parziale dei campi dell'entità Contact nel Common Data Service

    Per ogni account, viene impostato un contatto come contatto principale oppure il contatto principale è blank.For each account, a contact is designated as the primary contact, or the primary contact is blank.

  2. Generare un'app dall'entità Accounts.Generate an app from the Accounts entity.

  3. Nell'elenco delle schermate e dei controlli accanto al margine sinistro, scorrere fino a visualizzareEditScreen1 e quindi selezionare EditForm1.In the list of screens and controls near the left edge, scroll down until EditScreen1 appears, and then select EditForm1 just under it.

    Nella barra di spostamento di sinistra selezionare EditForm1 in EditScreen1

  4. Nella scheda Proprietà del riquadro di destra selezionare modifica campi.On the Properties tab of the right pane, select Edit fields.

    Aprire il riquadro dati

  5. Nel riquadro campi selezionare Aggiungi campo.In the Fields pane, select Add field.

  6. Cercare il campo contatto principale , selezionare la relativa casella di controllo e quindi selezionare Aggiungi.Search for the Primary Contact field, select its check box, and then select Add.

    Selezionare Accounts per aprire il riquadro Dati

    Il campo contatto principale viene visualizzato nella parte inferiore del modulo.The Primary Contact field appears at the bottom of the form. Se nel campo viene visualizzato un errore, selezionare origini dati nella scheda Visualizza , selezionare i puntini di sospensione (...) per l'origine dati account , quindi selezionare Aggiorna.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. (facoltativo) Trascinare il campo Contatto principale dalla parte inferiore alla parte superiore dell'elenco dei campi.(optional) Drag the Primary Contact field from the bottom to the top of the list of fields.

  8. Nella scheda per Contatto principale selezionare il controllo Casella combinata.In the card for Primary Contact, select the Combo box control.

    La proprietà Items di tale controllo è impostata su una formula che identifica la colonna in base al nome visualizzato, come nel primo esempio, o al nome logico, come nel secondo esempio: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 )

      Schermata canvas con un controllo form.

  9. Nella scheda Home selezionare Nuova schermata e quindi Vuoto.On the Home tab, select New screen, and then select Blank.

  10. Nella scheda Inserisci selezionare Tabella dati.On the Insert tab, select Data table.

  11. Impostare la proprietà Items del controllo tabella di dati sulla formula seguente:Set the Items property of the Data table control to this formula:

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

  12. Al centro del controllo tabella di dati , selezionare il collegamento che inizia a scegliere i campie quindi selezionare le caselle di controllo per il campo o i campi che si desidera visualizzare (ad esempio, FirstName e 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).

    Schermata canvas con un controllo tabella dati.