Kontrolnik PeoplePicker (predogledna različica)

  • Članek

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

Kontrolnik 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) 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

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

  2. 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"
    )
)

  3. Nastavite lastnost Suggestions_Items na UserCollection.

    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 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

S Dataverse tabelami - Microsoft Entra Uporabniki ali Uporabniki

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

    - Tabela AAD Users

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

    - Tabela Users

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

  2. 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.