Ovládací prvok PeoplePicker (verzia Preview)
[Tento článok je predbežnou dokumentáciou a môže sa zmeniť.]
Ovládací prvok používaný na vytvorenie prostredia na načítanie.
Poznámka
Úplnú dokumentáciu a zdrojový kód nájdete v odkladacom priestore komponentov kódu GitHub.
Dôležité
- Toto je ukážková funkcia.
- Funkcie ukážky nie sú určené na produkčné účely a môžu mať obmedzenú funkčnosť. Tieto funkcie sú k dispozícii pred oficiálnym vydaním, aby k nim mohli zákazníci získať rýchly prístup a poskytnúť odozvu.
Description
Výber ľudí (PeoplePicker
) sa používa na výber jednej alebo viacerých entít, ako sú ľudia alebo skupiny, zo zoznamu. Uľahčuje to napísanie e-mailu niekomu alebo jeho pridanie do skupiny, ak nepoznáte jeho celé meno alebo e-mailovú adresu.
Tento komponent kódu poskytuje obal okolo ovládacieho prvku Fluent UI PeoplePicker na použitie na plátne a vlastných stránkach. Najlepšie postupy nájdete v dokumentácii k súčasti.
Vlastnosti kľúča
Vlastnosť | Description |
---|---|
Items |
Vopred vybratá osoba (členovia), ktorá sa zobrazí v prvku Peoplepicker |
Suggestions_Items |
Zoznam navrhovaných členov na výber. Toto je požadovaná vlastnosť množiny údajov |
PeoplePickerType |
Typ prvku Peoplepicker, ktorý sa má použiť. |
MaxPeople |
Maximálny počet používateľov, ktorých je možné vybrať |
NoResultFoundMesage |
Správa, ktorá sa zobrazí, ak sa na základe zadaného textu vyhľadávania nenájde žiadny výsledok. |
MinimumSearchTermLength |
Pred poskytnutím návrhov je potrebné zadať minimálnu dĺžku hľadaného výrazu. |
SearchTermToShortMessage |
Vlastná správa, ktorá sa zobrazí, keď je hľadaný text menší ako MinimumSearchTermLength. |
Error |
Ak chcete zvýrazniť výber ľudí červenou farbou, aby ste vyjadrili, že obsahuje určitú chybu, ktorá si vyžaduje overenie. |
ShowSecondaryText |
Zadajte Áno alebo Nie v závislosti od toho, či sa má alebo nemá zobraziť sekundárny text (napríklad JobTitle). |
Vlastnosti Items
Vlastnosť | Description |
---|---|
PersonaName |
Zobrazovaný názov osoby. |
PersonaKey |
Kľúč identifikuje konkrétnu položku. Kľúč musí byť jedinečný. |
PersonaImgUrl |
Url alebo Base64 obsah obrázku osoby (profilový obrázok). |
PersonaRole |
Sekundárny text, najlepšie JobTitle osoby |
PersonaPresence |
Voliteľné – Prítomnosť osoby na zobrazenie – nebude zobrazovať prítomnosť, ak nie je definovaná. Hodnota by mala byť z jednej z nasledujúcich možností: away , blocked , busy , dnd , none , offline , online |
PersonaOOF |
Voliteľné – Pravda alebo Nepravda, podľa toho, či je osoba mimo kancelárie alebo nie. |
Vlastnosti Suggestions_Items
Vlastnosť | Description |
---|---|
SuggestionName |
Zobrazovaný názov osoby. |
SuggestionKey |
Kľúč identifikuje konkrétnu položku. Kľúč musí byť jedinečný. |
SuggestionImgUrl |
Url alebo Base64 obsah obrázku osoby (profilový obrázok). |
SuggestionRole |
Sekundárny text, najlepšie JobTitle osoby |
SuggestionPresence |
Voliteľné – Prítomnosť osoby na zobrazenie – nebude zobrazovať prítomnosť, ak nie je definovaná. Hodnota by mala byť z jednej z nasledujúcich možností: away , blocked , busy , dnd , none , offline , online |
SuggestionOOF |
Voliteľné – Pravda alebo Nepravda, podľa toho, či je osoba mimo kancelárie alebo nie. |
Ďalšie vlastnosti
Vlastnosť | Description |
---|---|
Theme |
Akceptuje reťazec JSON, ktorý je vygenerovaný pomocou aplikácie Fluent UI Theme Designer (windows.net). Ak toto necháte prázdne, použije sa predvolený motív definovaný v Power Apps. |
AccessibilityLabel |
Označenie aria-label pre čítačky obrazovky |
InputEvent |
Udalosť, ktorá sa má odoslať ovládaciemu prvku. Podporuje SetFocus ako InputEvent . |
Príklady
PeoplePicker
podporuje iné zdroje, z ktorých je možné získať kolekciu vstupov. Nasledujú príklady použitia súčasti PeoplePicker
.
Konektor používateľov Office 365
Pritajte konektor Používatelia Office 365 ako zdroj údajov.
Priraďte nižšie uvedený vzorec Power Fx k vlastnosti On Search ovládacieho prvku a vytvorte kolekciu s názvom
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" ) )
Nastavte vlastnosť
Suggestions_Items
naUserCollection
.Poznámka
Vyššie uvedený vzorec zahŕňa následnú požiadavku na získanie UserPhoto, čo predlžuje čas načítania. Ak nepotrebujete fotografie a chcete skrátiť čas vyhľadávania, použite nasledujúci vzorec vo vlastnosti
Suggestions_Items
ovládacieho prvku namiestoUserCollection
:AddColumns( Office365Users.SearchUser({ searchTerm: Self.SearchText, top: 500 }), "SuggestionKey", Mail, "SuggestionName", DisplayName, "SuggestionRole", JobTitle )
V tomto bode ovládanie funguje a vybraných členov je možné získať z vlastnosti SelectedPeople
.
PeoplePicker1.SelectedPeople
S Dataverse tabuľkami - Microsoft Entra Používatelia alebo Používatelia
Nastavte vlastnosť
Suggestions_Items
zadaním úryvku kódu nižšie.Pridajte používateľov alebo konkrétnych používateľov (pomocou kódu nižšie) z tabuľky do kolekcie položiek (pod vlastnosťou
Suggestions_Items
) vPeoplePicker
.- Tabuľka
AAD Users
Search('AAD Users', Self.SearchText,"displayname" ,"mail")
- Tabuľka
Users
Search('Users', Self.SearchText,"fullname","internalemailaddress")
Mapujte stĺpce podľa vašich potrieb pomocou AddColumns(). Nižšie je uvedený príklad mapovania vlastností stĺpcov:
Názov vlastnosti Tabuľka so stĺpcom AADUser Tabuľka so stĺpcom User SuggestionKey "mail" "internalemailaddress" SuggestionName "displayname" "fullname" SuggestionRole "jobtitle" "jobtitle"
V tomto bode by mal nástroj na výber ľudí fungovať a vybratých členov možno získať z vlastnosti SelectedPeople.
PeoplePicker1.SelectedPeople
Obmedzenia
Tento komponent plátna je možné použiť iba v aplikáciách plátna a vlastných stránkach.