Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
[Ez a cikk egy előzetes kiadási dokumentáció, amely a későbbiekben változhat.]
Betöltési élmény létrehozására használt vezérlő.
Feljegyzés
A teljes dokumentáció és a forráskód a GitHub kódösszetevő-adattárban található.
Fontos
- Ez egy előnézeti funkció.
- Az előzetes funkciókat nem célszerű termelési környezetben használni, és előfordulhat, hogy korlátozott funkcionalitással rendelkeznek. Ezek a funkciók a hivatalos kiadás előtt érhetők el, hogy az ügyfelek korán megismerkedhessenek velük, és visszajelzést adhassanak róluk.
Description
A Személyválasztó (PeoplePicker
) egy listából egy vagy több entitást jelöl ki, például személyeket vagy csoportokat. Ha nem ismeri a teljes nevét vagy e-mail címét, akkor egyszerűvé teszi e-mail írását vagy csoporthoz való felvételét.
Ez a kódösszetevő burkolót biztosít a Fluent UI PeoplePicker vezérlő köré a vászonon és az egyéni oldalakon való használathoz. Ajánlott eljárásokért tekintse meg az összetevőkkel kapcsolatos dokumentációt.
Kulcs tulajdonságai
Tulajdonság | Description |
---|---|
Items |
Az előre kijelölt általános személy (tagok) a PeoplePickerrel való megjelenéshez |
Suggestions_Items |
A kiválasztni javasolt tagok listája. Ez az adathalmaz-tulajdonság kötelező |
PeoplePickerType |
A használandó PeoplePicker típusa. |
MaxPeople |
A kiválasztásra engedélyezett felhasználó(k) maximális száma |
NoResultFoundMesage |
Üzenet jelenik meg, ha a megadott keresési szöveg alapján nem található eredmény. |
MinimumSearchTermLength |
A keresési kifejezés minimális hossza a javaslatok megadása előtt. |
SearchTermToShortMessage |
Egyéni üzenet, amely akkor jelenik meg, ha a keresési szöveg kisebb a MinimumSearchTermLength értéknél. |
Error |
Ha pirossal van kiemelve a Személyválasztó, akkor az azt jelenti, hogy bizonyos hiba miatt ellenőrzés szükséges. |
ShowSecondaryText |
Adja meg az Igen vagy a Nem értéket attól függően, hogy a másodlagos szöveg (például JobTitle) megjelenik-e. |
Items
kellékek
Tulajdonság | Description |
---|---|
PersonaName |
Az általános személy megjelenítendő neve. |
PersonaKey |
A kulcs azonosítja az adott elemet. A kulcsnak egyedinek kell lennie. |
PersonaImgUrl |
Az általános személy képének (profilképének) URL-címe vagy Base64-tartalma. |
PersonaRole |
Másodlagos szöveg, az általános személy lehetőség szerinti feladata |
PersonaPresence |
Nem kötelező – a megjelenítendő személy jelenlétével nem jelenik meg az állapot, ha nincs meghatározva. Az értéknek a következők egyikének kell lennie: away , blocked , busy , dnd , none , offline , online |
PersonaOOF |
Nem kötelező – Igaz vagy Hamis attól függően, hogy az általános személy irodán kívül van-e vagy sem. |
Suggestions_Items
kellékek
Tulajdonság | Description |
---|---|
SuggestionName |
Az általános személy megjelenítendő neve. |
SuggestionKey |
A kulcs azonosítja az adott elemet. A kulcsnak egyedinek kell lennie. |
SuggestionImgUrl |
Az általános személy képének (profilképének) URL-címe vagy Base64-tartalma. |
SuggestionRole |
Másodlagos szöveg, az általános személy lehetőség szerinti feladata |
SuggestionPresence |
Nem kötelező – a megjelenítendő személy jelenlétével nem jelenik meg az állapot, ha nincs meghatározva. Az értéknek a következők egyikének kell lennie: away , blocked , busy , dnd , none , offline , online |
SuggestionOOF |
Nem kötelező – Igaz vagy Hamis attól függően, hogy az általános személy irodán kívül van-e vagy sem. |
További tulajdonságok
Tulajdonság | Description |
---|---|
Theme |
A Fluent UI tématervező (windows.net) segítségével létrehozott JSON-sztringet fogad el. Ha üresen hagyja az adott témát, a Power Apps által alapértelmezett téma jelenik meg. |
AccessibilityLabel |
Képernyőolvasói területcímke |
InputEvent |
A vezérlőnek küldendő esemény. Támogatja a SetFocus-t mint InputEvent . |
Példák
PeoplePicker
Támogatja azokat a forrásokat, ahonnan a bemeneti gyűjtemény lekérhető. Az alábbiakban példákat talál a PeoplePicker
összetevő használatára.
Office 365 felhasználói összekötő
A Office 365 Felhasználói összekötő hozzáadása adatforrásként.
Rendelje az alábbi Power Fx képletet a vezérlőelem Keresésben tulajdonságához, hogy létrehozzon egy úgynevezett
UserCollection
kollekciót.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" ) )
Állítsa a
Suggestions_Items
tulajdonságotUserCollection
értékre.Feljegyzés
A fenti képlet egy egymást követő kérést tartalmaz a UserPhoto letöltésére, ami megnöveli a betöltési időt. Ha nincs szüksége fényképre, és szeretné csökkenteni a keresési időt, használja a következő képletet a vezérlő
Suggestions_Items
tulajdonságában aUserCollection
helyett:AddColumns( Office365Users.SearchUser({ searchTerm: Self.SearchText, top: 500 }), "SuggestionKey", Mail, "SuggestionName", DisplayName, "SuggestionRole", JobTitle )
Ezen a ponton a vezérlő működik, és a kijelölt tagok bekérthetők a SelectedPeople
tulajdonságból.
PeoplePicker1.SelectedPeople
Táblázatokkal Dataverse -Felhasználók Microsoft Entra vagy Felhasználók
Állítsa be a
Suggestions_Items
tulajdonságot az alábbi kódrészlet megadásával.Felhasználók vagy adott felhasználók hozzáadása (a kód alatt) a táblázatból az elemek gyűjteményéhez (a
Suggestions_Items
tulajdonság alattPeoplePicker
).-
AAD Users
asztalSearch('AAD Users', Self.SearchText,"displayname" ,"mail")
-
Users
asztalSearch('Users', Self.SearchText,"fullname","internalemailaddress")
Az oszlopokat az AddColumns() segítségével szükség szerint leképezi. Az alábbiakban egy példa látható az Oszloptulajdonság leképezésére:
Tulajdonság neve AADUser tábla oszlopa User tábla oszlopa SuggestionKey "mail" "internalemailaddress" SuggestionName "displayname" "fullname" SuggestionRole "jobtitle" "jobtitle"
Ezen a ponton a Személyválasztónak működnie kell, és a kijelölt tagokat be lehet szerezni a SelectedPeople tulajdonságból.
PeoplePicker1.SelectedPeople
Korlátozások
Ez a vászonalapú összetevő csak vászonalapú alkalmazásokban és egyéni oldalakon használható.