Funzione Choices
Si applica a:
App canvas App basate su modello
Restituisce una tabella dei valori possibili per una colonna di ricerca.
Description
La funzione Choices restituisce una tabella dei valori possibili per una colonna di ricerca.
Usare la funzione Choices per offrire un elenco di scelte da cui l'utente può scegliere. Questa funzione viene comunemente usata con il controllo Combo box nei moduli di modifica.
Per una ricerca, la tabella restituita da Choices corrisponde alla tabella esterna associata alla ricerca. Usando Choices si elimina la necessità di aggiungere la tabella esterna come origine dati aggiuntiva. Choices restituisce tutte le colonne della tabella esterna.
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.
Attualmente, non è possibile delegare Choices. Se questa limitazione costituisce un problema nell'app, aggiungere la tabella esterna come origine dati e usarla direttamente.
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. Specificare la formula come se si facesse riferimento direttamente alla colonna.
I riferimenti di colonna devono essere diretti all'origine dati. Ad esempio, se l'origine dati è Accounts e la ricerca è SLA, il riferimento alla colonna sarà Accounts.SLA. Il riferimento non può essere passato tramite una funzione, una variabile o un controllo. 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. Tuttavia, poiché il riferimento viene passato tramite un controllo, non può essere passato alla funzione Columns: è necessario usare Accounts.SLA.
Attualmente, è possibile usare le colonne di ricerca solo con SharePoint e Microsoft Dataverse.
Sintassi
Choices( column-reference [, text-filter ] )
- column-reference: obbligatorio. Colonna di ricerca di un'origine dati. Non racchiudere il nome di colonna tra virgolette doppie. Il riferimento deve essere un riferimento diretto alla colonna dell'origine dati e non può essere passato tramite una funzione o un controllo.
- text-filter: facoltativo. Filtra l'elenco di scelte restituendo solo le scelte che iniziano con il testo specificato in text-filter. Se viene specificata una stringa vuota, verranno restituite tutte le scelte.
Esempi
Choices per una ricerca
Creare un database in Dataverse e selezionare la casella Includi dati e app di esempio.
Vengono create numerose tabelle, ad esempio Account.
Nota: I nomi delle tabelle sono singolari su make.powerapps.com e plurali in Power Apps Studio.
La tabella Account include una colonna Contatto principale che costituisce una ricerca nella tabella Contatti.
Per ogni account, viene impostato un contatto come contatto principale oppure il contatto principale è blank.
Genera un'app dalla tabella Account.
Nell'elenco delle schermate e dei controlli accanto al margine sinistro, scorrere fino a visualizzareEditScreen1 e quindi selezionare EditForm1.
Nella scheda Proprietà del riquadro destro selezionare Modifica campi.
Nel riquadro Campi selezionare Aggiungi campo.
Cercare il campo Contatto primario, selezionare la relativa casella di controllo, quindi selezionare Aggiungi.
Il campo Contatto primario appare nella parte inferiore del modulo. Se il campo mostra un errore, selezionare Origini dati nella scheda Visualizzazione, selezionare i puntini di sospensione (...) per l'origine dati Accounts, quindi selezionare Aggiorna.
(facoltativo) Trascinare il campo Contatto principale dalla parte inferiore alla parte superiore dell'elenco dei campi.
Nella scheda per Contatto principale selezionare il controllo Combo box.
La proprietà Items di quel controllo è impostata su una formula che identifica la colonna con il relativo nome visualizzato, come nel primo esempio, o il nome logico, come nel secondo esempio:
Choices( Accounts.'Primary Contact' )
Choices( Accounts.primarycontactid )
A scopo illustrativo, possiamo visualizzare la tabella completa restituita dalla funzione Choices in un controllo Data table. Nella scheda Home selezionare Nuova schermata e quindi Vuoto.
Nella scheda Inserisci selezionare Data table.
Impostare la proprietà Items del controllo Data table su questa formula:
Choices( Accounts.'Primary Contact' )
Nel controllo Data table, selezionare il collegamento che inizia con Scegliere i campi..., quindi selezionare le caselle di controllo per il campo o i campi che si desidera mostrare (ad esempio, firstname e lastname).
