Share via

Controlul PeoplePicker (versiune preliminară)

  • Articol

[Acest articol este documentație de prelansare și poate suferi modificări.]

Un control folosit pentru a crea o experiență de încărcare.

Notă

Documentația completă și codul sursă se găsesc în depozitul de componente de cod GitHub.

Controlul PeoplePicker.

Important

  • Aceasta este o caracteristică de previzualizare.
  • Caracteristicile în regim de previzualizare nu sunt destinate utilizării în producție și pot avea funcționalitate restricționată. Aceste caracteristici sunt disponibile înainte de lansarea oficială, astfel încât clienții să poată obține acces din timp și să poată oferi feedback.

Descriere

Selectorul de persoane (PeoplePicker) este utilizat pentru a selecta una sau mai multe entități, cum ar fi persoane sau grupuri, dintr-o listă. Aceasta vă ajută să compuneți un e-mail către o persoană sau să o adăugați cu ușurință într-un grup dacă nu îi cunoașteți numele complet sau adresa de e-mail.

Această componentă de cod oferă un înveliș în jurul controlului PeoplePicker Fluent UI pentru utilizare în pagini proiectate pe pânză și personalizate. Consultați documentația componentei pentru cele mai bune practici.

Proprietăți cheie

Proprietate Descriere
Items Personajul preselectat (membrii) care să apară în Peoplepicker
Suggestions_Items Lista de membri sugerați dintre care să alegeți. Aceasta este o proprietate obligatorie de set de date
PeoplePickerType Tipul de Peoplepicker care urmează a fi utilizat.
MaxPeople Numărul maxim de utilizatori care poate fi permis pentru selecție
NoResultFoundMesage Mesaj care va fi afișat dacă nu se găsește niciun rezultat pe baza textului de căutare specificat.
MinimumSearchTermLength Lungimea minimă a termenului de căutare care trebuie introdus înainte de a oferi sugestiile.
SearchTermToShortMessage Mesaj personalizat care va fi afișat atunci când textul de căutare este mai mic de MinimumSearchTermLength.
Error Pentru a evidenția selectorul de persoane în roșu cu scopul de a reprezenta faptul că are o anumită eroare ce necesită validare.
ShowSecondaryText Specificați Da sau nu, dacă textul secundar (de exemplu, JobTitle) va fi afișat sau nu.

Proprietăți Items

Proprietate Descriere
PersonaName Numele de afișare al Personajului.
PersonaKey Cheia identifică elementul specific. Cheia trebuie să fie unică.
PersonaImgUrl Url-ul sau conținutul Base64 al Imaginii Personajului (Imagine de profil).
PersonaRole Text secundar, de preferință JobTitle al Personajului
PersonaPresence Opțional – Prezența persoanei de afișat – nu va afișa prezența dacă este nedefinit. Valoarea ar trebui să fie din una dintre următoarele: away, blocked, busy, dnd, none, offline, online
PersonaOOF Opțional – Adevărat sau Fals, dacă personajul este sau nu este Absent de la birou.

Proprietăți Suggestions_Items

Proprietate Descriere
SuggestionName Numele de afișare al Personajului.
SuggestionKey Cheia identifică elementul specific. Cheia trebuie să fie unică.
SuggestionImgUrl Url-ul sau conținutul Base64 al Imaginii Personajului (Imagine de profil).
SuggestionRole Text secundar, de preferință JobTitle al Personajului
SuggestionPresence Opțional – Prezența persoanei de afișat – nu va afișa prezența dacă este nedefinit. Valoarea ar trebui să fie din una dintre următoarele: away, blocked, busy, dnd, none, offline, online
SuggestionOOF Opțional – Adevărat sau Fals, dacă personajul este sau nu este Absent de la birou.

Proprietăți suplimentare

Proprietate Descriere
Theme Acceptă un șir JSON care este generat utilizând Fluent UI Theme Designer (windows.net). Dacă este lăsat necompletat, se va folosi tema implicită definită de Power Apps.
AccessibilityLabel Aria-label pentru cititor de ecran
InputEvent Un eveniment de trimis controlului. Acceptă SetFocus ca InputEvent.

Exemple

PeoplePicker acceptă alte surse de unde poate fi preluată colecția de intrare. Următoarele sunt exemple despre cum să utilizați componenta PeoplePicker.

Conectorul utilizatorilor Office 365

  1. Adăugați Conectorul utilizatorilor Office 365 ca sursă de date.

  2. Atribuiți formula de mai jos Power Fx la proprietatea de control În căutare pentru a crea o colecție numită 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. Setați proprietatea Suggestions_Items pentru UserCollection.

    Notă

    Formula de mai sus include o solicitare consecutivă pentru a obține UserPhoto, ceea ce mărește timpul de încărcare. Dacă nu aveți nevoie de fotografii și doriți să reduceți timpul de căutare, utilizați următoarea formulă în Suggestions_Items proprietatea controlului în loc de UserCollection: 

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

În acest moment, controlul funcționează și membrii selectați pot fi obținuți din proprietatea SelectedPeople.

PeoplePicker1.SelectedPeople

Cu Dataverse tabele - Microsoft Entra Utilizatori sau Utilizatori

  1. Configurați Proprietatea Suggestions_Items specificând fragmentul de cod de mai jos.

    Adăugați utilizatori sau anumiți utilizatori (folosind codul de mai jos) din tabel în colecția de articole (sub proprietatea Suggestions_Items) a PeoplePicker.

    -AAD Users tabel

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

    -Users tabel

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

  2. Mapați coloanele în funcție de nevoile dvs. folosind AddColumns(). Mai jos se află un exemplu de Mapare coloană-proprietăți:

    Nume proprietate Coloană de tabel AADUser Coloană de tabel User
    SuggestionKey „mail" „internalemailaddress"
    SuggestionName „displayname" „fullname"
    SuggestionRole „jobtitle" „jobtitle"

În acest moment, selectorul de persoane ar trebui să funcționeze, iar membrii selectați pot fi obținuți din Proprietatea SelectedPeople.

PeoplePicker1.SelectedPeople

Limitări

Această componentă planșă de lucru poate fi utilizată numai în aplicații planșă de lucru și pagini personalizate.