Megosztás a következőn keresztül:


PeoplePicker Vezérlés (előzetes verzió)

[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ó.

PeoplePicker vezérlő.

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ő

  1. A Office 365 Felhasználói összekötő hozzáadása adatforrásként.

  2. 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"
        )
    )
    
  3. Állítsa a Suggestions_Items tulajdonságot UserCollection é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 a UserCollection 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

  1. Á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 alatt PeoplePicker).

    - AAD Users asztal

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

    - Users asztal

    Search('Users', Self.SearchText,"fullname","internalemailaddress")
    
  2. 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ó.