Zdieľať cez

Ovládací prvok PeoplePicker (verzia Preview)

  • Článok

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

Ovládací prvok PeoplePicker.

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

  1. Pritajte konektor Používatelia Office 365 ako zdroj údajov.

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

  3. Nastavte vlastnosť Suggestions_Items na UserCollection.

    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 namiesto UserCollection: 

    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

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

    - Tabuľka AAD Users

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

    - Tabuľka Users

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

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