Kontrolnik PeoplePicker (predogledna različica)
[Ta članek je del predizdajne dokumentacije in se lahko spremeni.]
Ta kontrolnik se uporablja za ustvarjanje izkušnje nalaganja.
opomba,
Celotno gradivo in izvirna koda sta na voljo v skladišču komponent kode storitve GitHub.
Pomembno
- To je funkcija predogleda.
- Poskusne funkcije niso za komercialno uporabo, njihovo delovanje je lahko omejeno. Te funkcije so na voljo še pred uradno izdajo, da lahko stranke predčasno dostopajo do njih in posredujejo povratne informacije.
Description
Izbirnik oseb (PeoplePicker
) se uporablja za izbiro ene ali več entitet s seznama, kot so osebe ali skupine. Poenostavi sestavljanje e-poštnega sporočila neki osebi ali dodajanje te osebe v skupino, tudi če ne poznate njenega polnega imena ali e-poštnega naslova.
Ta komponenta kode zagotavlja ovoj okoli kontrolnika Fluent UI PeoplePicker za uporabo na platnu in straneh po meri. Primeri najboljših praks so na voljo v gradivu komponente.
Lastnosti ključa
Lastnost | Description |
---|---|
Items |
Vnaprej izbrana persona (člani), ki bo prikazana v orodju Peoplepicker |
Suggestions_Items |
Seznam predlaganih članov, med katerimi lahko izbirate. To je obvezna lastnost nabora podatkov |
PeoplePickerType |
Vrsta orodja Peoplepicker, ki bo uporabljena. |
MaxPeople |
Največje dovoljeno število uporabnikov za izbiro |
NoResultFoundMesage |
Sporočilo, ki bo prikazano, če na podlagi podanega besedila iskanja ne bo mogoče najti nobenega rezultata. |
MinimumSearchTermLength |
Najmanjša dolžina izraza za iskanje, ki jo je treba vnesti, preden podate predloge. |
SearchTermToShortMessage |
Sporočilo po meri, ki se bo prikazalo, če bo besedilo za iskanje krajše od MinimumSearchTermLength. |
Error |
Za označevanje izbirnika ljudi z rdečo barvo, ki označuje prisotnost določene napake, ki jo je treba preveriti. |
ShowSecondaryText |
Izberite Da ali Ne, odvisno od tega, ali naj bo sekundarno besedilo (na primer JobTitle) prikazano ali ne. |
Lastnosti Items
Lastnost | Description |
---|---|
PersonaName |
Prikazano ime persone. |
PersonaKey |
Ključ za identifikacijo določenega elementa. Ključ mora biti enoličen. |
PersonaImgUrl |
Vsebina URL-ja ali Base64 slike persone (slika profila). |
PersonaRole |
Sekundarno besedilo, po možnosti JobTitle persone |
PersonaPresence |
Izbirno – prisotnost osebe za prikaz – prisotnost ne bo prikazana, če ni določena. Vrednost mora biti ena od naslednjih: away , blocked , busy , dnd , none , offline , online |
PersonaOOF |
Izbirno – »True« ali »False«, glede na to, ali je persona v službi ali ne. |
Lastnosti Suggestions_Items
Lastnost | Description |
---|---|
SuggestionName |
Prikazano ime persone. |
SuggestionKey |
Ključ za identifikacijo določenega elementa. Ključ mora biti enoličen. |
SuggestionImgUrl |
Vsebina URL-ja ali Base64 slike persone (slika profila). |
SuggestionRole |
Sekundarno besedilo, po možnosti JobTitle persone |
SuggestionPresence |
Izbirno – prisotnost osebe za prikaz – prisotnost ne bo prikazana, če ni določena. Vrednost mora biti ena od naslednjih: away , blocked , busy , dnd , none , offline , online |
SuggestionOOF |
Izbirno – »True« ali »False«, glede na to, ali je persona v službi ali ne. |
Dodatne lastnosti
Lastnost | Description |
---|---|
Theme |
Sprejme niz JSON, ki je ustvarjen z oblikovalnikom tem Fluent UI Theme Designer (windows.net). Če pustite to polje prazno, bo uporabljena privzeta tema, določena za Power Apps. |
AccessibilityLabel |
Oznaka aria za bralnik zaslona |
InputEvent |
Dogodek, ki bo poslan kontrolniku. Podpira SetFocus kot InputEvent . |
Primeri
PeoplePicker
podpira druge vire, od koder je mogoče pridobiti vhodno zbirko. Sledijo primeri uporabe komponente PeoplePicker
.
Uporabniški povezovalnik storitve Office 365
Dodajte uporabniški povezovalnik storitve Office 365 kot vir podatkov.
Dodelite spodnjo formulo Power Fx lastnosti Pri iskanju kontrolnika, da ustvarite zbirko, poimenovano
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" ) )
Nastavite lastnost
Suggestions_Items
naUserCollection
.opomba,
Zgornja formula vključuje zaporedno zahtevo za pridobitev elementa UserPhoto, kar podaljša čas nalaganja. Če ne potrebujete fotografij in želite skrajšati čas iskanja, uporabite naslednjo formulo v lastnosti
Suggestions_Items
kontrolnika namestoUserCollection
:AddColumns( Office365Users.SearchUser({ searchTerm: Self.SearchText, top: 500 }), "SuggestionKey", Mail, "SuggestionName", DisplayName, "SuggestionRole", JobTitle )
Na tej točki kontrolnik deluje in izbrane člane je mogoče pridobiti iz lastnosti SelectedPeople
.
PeoplePicker1.SelectedPeople
S Dataverse tabelami - Microsoft Entra Uporabniki ali Uporabniki
Nastavite lastnost
Suggestions_Items
tako, da določite spodnji izrezek kode.Dodajte uporabnike ali določene uporabnike (z uporabo spodnje kode) iz tabele v zbirko elementov (pod lastnostjo
Suggestions_Items
) orodjaPeoplePicker
.- Tabela
AAD Users
Search('AAD Users', Self.SearchText,"displayname" ,"mail")
- Tabela
Users
Search('Users', Self.SearchText,"fullname","internalemailaddress")
Preslikajte stolpce glede na vaše potrebe z uporabo elementa AddColumns(). Spodaj je primer preslikave lastnosti stolpca:
Ime lastnosti Stolpec tabele AADUser Stolpec tabele uporabnika SuggestionKey "mail" "internalemailaddress" SuggestionName "displayname" "fullname" SuggestionRole "jobtitle" "jobtitle"
Na tej točki bi moral izbirnik ljudi delovati in bi moralo biti mogoče izbrane člane pridobiti iz lastnosti SelectedPeople.
PeoplePicker1.SelectedPeople
Omejitve
Ta komponenta delovnega območja se lahko uporablja samo v aplikacijah s platnom in na straneh po meri.