PeoplePicker controllo (anteprima)

[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]

Un comando utilizzato per creare un'esperienza di caricamento.

Annotazioni

La documentazione e il codice sorgente completi sono disponibili nel repository dei componenti del codice GitHub.

Controllo PeoplePicker.

Importante

  • Si tratta di una funzionalità di anteprima.
  • Le funzionalità di anteprima non sono destinate all'uso in produzione e potrebbero avere funzionalità limitate. Queste funzioni sono disponibili prima di una versione ufficiale, in modo che i clienti possano ottenere l'accesso anticipato e fornire commenti e suggerimenti.

Descrizione

Il controllo Selezione persone (PeoplePicker) consente di selezionare una o più entità, ad esempio persone o gruppi, da un elenco. Facilita la composizione di un messaggio e-mail destinato a qualcuno o l'aggiunta di un utente a un gruppo nei casi in cui non conosci il nome completo o l'indirizzo e-mail del destinatario del messaggio o dell'utente da aggiungere.

Questo componente di codice fornisce un wrapper intorno al controllo PeoplePicker di Fluent UI da usare nelle app canvas e nelle pagine personalizzate. Vedi la documentazione del componente per le procedure consigliate.

Proprietà chiave

Proprietà Descrizione
Items Gli utenti preselezionati (membri) da visualizzare in PeoplePicker.
Suggestions_Items Elenco dei membri suggeriti tra cui scegliere. Questa è una proprietà di set di dati obbligatoria.
PeoplePickerType Tipo di PeoplePicker da usare.
MaxPeople Numero massimo di utenti consentiti per la selezione.
NoResultFoundMesage Messaggio da mostrare se non viene trovato alcun risultato in base al testo di ricerca specificato.
MinimumSearchTermLength Lunghezza minima termine di ricerca da inserire prima di fornire i suggerimenti.
SearchTermToShortMessage Messaggio personalizzato da visualizzare quando il testo di ricerca è inferiore a MinimumSearchTermLength.
Error Evidenzia il selettore delle persone in rosso per indicare che contiene un errore che richiede convalida.
ShowSecondaryText Specifica Sì o No, a seconda che il testo secondario (ad esempio JobTitle) debba essere visualizzato o meno.

Proprietà degli Elementi

Proprietà Descrizione
PersonaName Nome visualizzato della persona.
PersonaKey La chiave identifica l'elemento specifico e deve essere univoca.
PersonaImgUrl Contenuto URL o Base64 dell'immagine del profilo personale (immagine del profilo).
PersonaRole Testo secondario, preferibilmente il JobTitle della persona utente.
PersonaPresence (Opzionale) presenza della persona da visualizzare. La presenza non viene visualizzata se non definita. Il valore può essere: away, blocked, busy, dnd, none, offline, or online.
PersonaOOF (Facoltativo) Vero o Falso, a seconda che la persona sia fuori sede o meno.

Proprietà di Suggestions_Items

Proprietà Descrizione
SuggestionName Nome visualizzato della persona.
PersonaKey La chiave identifica l'elemento specifico e deve essere univoca.
SuggestionImgUrl Contenuto URL o Base64 dell'immagine del profilo personale (immagine del profilo).
SuggestionRole Testo secondario, preferibilmente il JobTitle della persona utente.
SuggestionPresence (Opzionale) presenza della persona da visualizzare. La presenza non viene visualizzata se non definita. Il valore può essere: away, blocked, busy, dnd, none, offline, or online.
PersonaOOF (Facoltativo) Vero o Falso, a seconda che la persona sia fuori sede o meno.

Proprietà aggiuntive

Proprietà Descrizione
Theme Accetta una stringa JSON generata utilizzando la finestra di progettazione del tema dell'interfaccia utente Fluent (windows.net). Se lasciato vuoto, viene usato il tema predefinito specificato da Power Apps.
AccessibilityLabel Etichetta ARIA per lettore di schermo.
InputEvent Evento da inviare al controllo. Supporta SetFocus come un InputEvent.

Examples

Il componente PeoplePicker supporta origini aggiuntive per il recupero della raccolta di input. Di seguito sono riportati gli esempi di come usare il componente.

Connettore degli Utenti di Office 365

  1. Aggiungere il connettore per gli utenti Office 365 come origine dati.

  2. Assegna una formula Power Fx alla proprietà On Search del controllo per creare una raccolta denominata UserCollection.

    ClearCollect(
    UserCollection,
    AddColumns(
        Filter(
            Office365Users.SearchUser(
                {
                    searchTerm: Self.SearchText,
                    top: 500
                }
            ),
            !(Mail in Self.SelectedPeople.PersonaKey)
        ),
        "SuggestionImgUrl",
        Substitute(
            JSON(
                Office365Users.UserPhotoV2(Id),
                JSONFormat.IncludeBinaryData
            ),
            """",
            ""
        ),
        "SuggestionKey",
        Mail,
        "SuggestionName",
        DisplayName,
        "SuggestionRole",
        JobTitle,
        "SuggestionPresence",
        "away"
    )
)

  3. Facoltativamente, se non utilizzi foto, imposta la proprietà Suggestions_Items su UserCollection.

    La formula include una richiesta consecutiva per ottenere UserPhoto, che aumenta il tempo di caricamento. Se non hai bisogno di foto e vuoi ridurre il tempo di ricerca, usa la seguente formula nella proprietà Suggestions_Items del controllo al posto di UserCollection:

    AddColumns(
    Office365Users.SearchUser({ searchTerm: Self.SearchText, top: 500 }),
    "SuggestionKey", Mail, 
    "SuggestionName", DisplayName,
    "SuggestionRole", JobTitle
)

A questo punto il controllo funziona ed è possibile ottenere membri selezionati dalla proprietà SelectedPeople.

PeoplePicker1.SelectedPeople

Con le tabelle Dataverse (utenti o utenti Microsoft Entra)

  1. Imposta la proprietà Suggestions_Items.

    Aggiungi Utenti o utenti specifici dalla tabella alla raccolta di elementi (nella proprietà Suggestions_Items) di PeoplePicker.

    • Tabella AAD Users:

      Search('AAD Users', Self.SearchText,"displayname" ,"mail")

    • Tabella Users:

      Search('Users', Self.SearchText,"fullname","internalemailaddress")

  2. Mappa le colonne in base alle tue esigenze usando AddColumns(). Di seguito è riportato un esempio di mappatura Colonna-Proprietà.

    Nome proprietà Colonna della tabella AADUser Colonna della tabella Utente
    ChiaveSuggerimento email indirizzoemailinterno
    SuggestionName "nome visibile" nome completo
    RuoloSuggerimento titolo di lavoro titolo di lavoro

A questo punto, il controllo Selezione persone funziona e i membri selezionati possono essere ottenuti dalla proprietà SelectedPeople.

PeoplePicker1.SelectedPeople

Limitations

Questo componente canvas può essere usato solo nelle app canvas e nelle pagine personalizzate.

  • Last updated on