Deli z drugimi prek

PeoplePicker nadzor (predogled)

[Ta članek je del predizdajne dokumentacije in se lahko spremeni.]

Ta kontrolnik se uporablja za ustvarjanje izkušnje nalaganja.

opomba,

Celotno dokumentacijo in izvorno kodo najdete v repozitoriju komponent kode GitHub .

Nadzor PeoplePicker.

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) vam omogoča, da s seznama izberete eno ali več entitet, kot so osebe ali skupine. Omogoča lažje pisanje e-pošte nekomu ali dodajanje v skupino, če ne poznate njegovega polnega imena ali e-poštnega naslova.

Ta komponenta kode zagotavlja ovojnico okoli kontrolnika Fluent UI PeoplePicker za uporabo v platnu in na straneh po meri. ... Za najboljše prakse glejte dokumentacijo komponent.

Lastnosti ključa

Lastnost Description
Items Predhodno izbrana persona (člani), ki se bo prikazala na Peoplepickerju.
Suggestions_Items Seznam predlaganih članov, med katerimi lahko izbirate. To je obvezna lastnost nabora podatkov.
PeoplePickerType Vrsta izbirnika ljudi, ki ga želite uporabiti.
MaxPeople Največje dovoljeno število uporabnikov za izbiro.
NoResultFoundMesage Sporočilo, ki se prikaže, če na podlagi navedenega iskalnega besedila ni najdenih rezultatov.
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 Označite izbirnik oseb z rdečo barvo, da označite, da vsebuje napako, ki zahteva preverjanje.
ShowSecondaryText Določite Da ali Ne, odvisno od tega, ali naj se prikaže sekundarno besedilo (na primer Naziv delovnega mesta) ali ne.

Lastnosti elementov

Lastnost Description
PersonaName Prikazno ime persone.
PersonaKey Ključ identificira določen element in mora biti edinstven.
PersonaImgUrl Vsebina URL-ja ali Base64 slike persone (slika profila).
PersonaRole Sekundarno besedilo, po možnosti naziv delovnega mesta persone.
PersonaPresence (Neobvezno) Prisotnost osebe, ki jo želite prikazati. Prisotnost se ne prikaže, če ni določena. Vrednost je lahko ena od naslednjih: away, blocked, busy, dnd, none, offline ali online.
PersonaOOF (Neobvezno) Pravilno ali napačno, glede na to, ali je oseba odsotna ali ne.

Lastnosti predlogov_predmetov

Lastnost Description
SuggestionName Prikazno ime persone.
PersonaKey Ključ identificira določen element in mora biti edinstven.
SuggestionImgUrl Vsebina URL-ja ali Base64 slike persone (slika profila).
SuggestionRole Sekundarno besedilo, po možnosti naziv delovnega mesta persone.
SuggestionPresence (Neobvezno) Prisotnost osebe, ki jo želite prikazati. Prisotnost se ne prikaže, če ni določena. Vrednost je lahko ena od naslednjih: away, blocked, busy, dnd, none, offline ali online.
PersonaOOF (Neobvezno) Pravilno ali napačno, glede na to, ali je oseba odsotna ali ne.

Dodatne lastnosti

Lastnost Description
Theme Sprejme niz JSON, ki je ustvarjen z oblikovalnikom tem Fluent UI Theme Designer (windows.net). Če pustite polje prazno, se uporabi privzeta tema, ki jo definira Power Apps .
AccessibilityLabel Oznaka aria za bralnik zaslona.
InputEvent Dogodek, ki bo poslan kontrolniku. Podpira SetFocus kot InputEvent.

Primeri

Komponenta podpira dodatne vire za pridobivanje vhodne zbirke. PeoplePicker Sledijo primeri uporabe komponente.

Uporabniški povezovalnik storitve Office 365

  1. Dodajte uporabniški povezovalnik storitve Office 365 kot vir podatkov.

  2. Dodelite formulo lastnosti kontrolnika *On Search*, da ustvarite zbirko z imenom *a12> Power Fx . 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. Če ne uporabljate fotografij, lahko lastnost Suggestions_Items nastavite na UserCollection.

    Formula vključuje zaporedno zahtevo za pridobitev UserPhoto, kar poveča čas nalaganja. Če ne potrebujete fotografij in želite skrajšati čas iskanja, uporabite naslednjo formulo v lastnosti kontrolnika Suggestions_Items namesto UserCollection:

    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

Z Dataverse tabelami (Microsoft Entra Uporabniki ali Uporabniki)

  1. Nastavite lastnost Suggestions_Items .

    Dodajte uporabnike ali določene uporabnike iz tabele v zbirko elementov (pod lastnostjo Suggestions_Items ) v PeoplePicker.

    • AAD Users tabela:

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

    • Users tabela:

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

  2. Stolpce preslikajte glede na svoje potrebe z uporabo AddColumns(). Tukaj je primer preslikave lastnosti stolpcev:

    Ime lastnosti Stolpec tabele AADUser Stolpec tabele uporabnika
    SuggestionKey "mail" "internalemailaddress"
    SuggestionName "displayname" "fullname"
    SuggestionRole "jobtitle" "jobtitle"

Na tej točki kontrolnik za izbiro oseb deluje in izbrane člane je mogoče 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.

  • Last updated on