Share via

Ovládací prvek PeoplePicker (Preview)

  • Článek

[Tento článek představuje předběžnou dokumentaci a může se změnit.]

Ovládací prvek používaný k vytvoření prostředí pro načítání.

Poznámka:

Úplná dokumentace a zdrojový kód jsou k dispozici v úložišti komponent kódu GitHubu.

Ovládací prvek PeoplePicker.

Důležité

  • Toto je funkce Preview.
  • Funkce Preview nejsou určené pro normální používání a mohou mít omezené fungování. Jsou to funkce, které jsou poskytnuté před svým oficiálním vydáním, aby si je zákazníci mohli co nejdříve vyzkoušet a mohli nám napsat své názory.

Description

Výběr osob (PeoplePicker) slouží k výběru jedné nebo více entit, jako jsou lidé nebo skupiny, ze seznamu. Usnadňuje napsat někomu e-mail nebo jej přidat do skupiny, pokud neznáte celé jméno nebo e-mailovou adresu.

Tato komponenta kódu poskytuje obálku kolem ovládacího prvku Fluent UI PeoplePicker pro použití v plátně a na vlastních stránkách. Osvědčené postupy naleznete v dokumentaci komponent.

Hlavní vlastnosti

Vlastnost Description
Items Předem vybraná osoba (členové), která se zobrazí v Peoplepicker
Suggestions_Items Seznam doporučených členů k výběru. Toto je povinná vlastnost datové sady
PeoplePickerType Typ ovládacího prvku PeoplePicker, který se má použít.
MaxPeople Maximální počet uživatelů, kteří mohou být vybráni
NoResultFoundMesage Zpráva, která se zobrazí, pokud na základě zadaného hledaného textu nebudou nalezeny žádné výsledky.
MinimumSearchTermLength Minimální délka hledaného termínu, který je třeba zadat před poskytnutím návrhů.
SearchTermToShortMessage Vlastní zpráva, která se zobrazí, když je hledaný text menší než MinimumSearchTermLength.
Error Chcete-li zvýraznit výběr osob červeně, aby bylo zřejmé, že obsahuje určitou chybu, která vyžaduje ověření.
ShowSecondaryText Zadejte Ano nebo Ne v závislosti na tom, zda se má či nemá zobrazit sekundární text (například Pracovní pozice).

Vlastnosti Items

Vlastnost Description
PersonaName Zobrazované jméno osoby.
PersonaKey Klíč identifikuje konkrétní položku. Tento klíč musí být jedinečný.
PersonaImgUrl Adresa URL nebo obsah Base64 obrázku osoby (profilový obrázek).
PersonaRole Sekundární text, nejlépe pracovní pozice osoby
PersonaPresence Volitelné – přítomnost osoby k zobrazení – přítomnost nebude zobrazena, pokud není definována. Hodnota musí být jedna z následujících: away, blocked, busy, dnd, none, offline, online
PersonaOOF Volitelné – true nebo false podle toho, zda je osoba mimo kancelář či nikoli.

Vlastnosti Suggestions_Items

Vlastnost Description
SuggestionName Zobrazované jméno osoby.
SuggestionKey Klíč identifikuje konkrétní položku. Tento klíč musí být jedinečný.
SuggestionImgUrl Adresa URL nebo obsah Base64 obrázku osoby (profilový obrázek).
SuggestionRole Sekundární text, nejlépe pracovní pozice osoby
SuggestionPresence Volitelné – přítomnost osoby k zobrazení – přítomnost nebude zobrazena, pokud není definována. Hodnota musí být jedna z následujících: away, blocked, busy, dnd, none, offline, online
SuggestionOOF Volitelné – true nebo false podle toho, zda je osoba mimo kancelář či nikoli.

Další vlastnosti

Vlastnost Description
Theme Přijímá řetězec JSON, který je generován pomocí návrháře motivů Fluent UI (windows.net). Ponecháte-li toto prázdné, použije se výchozí motiv definovaný Power Apps.
AccessibilityLabel Popisek Aria pro čtečky obrazovky
InputEvent Událost, která se má odeslat do ovládacího prvku. Podporuje SetFocus jako InputEvent.

Příklady

PeoplePicker podporuje další zdroje, ze kterých lze načíst vstupní kolekci. Níže jsou uvedeny příklady, jak používat komponentu PeoplePicker.

Konektor Office 365 Users

  1. Přidání konektoru Office 365 Users jako zdroj dat.

  2. Přiřaďte níže uvedený vzorec Power Fx k vlastnosti On Search ovládacího prvku, čímž vytvoříte kolekci s názvem 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 vlastnost Suggestions_Items na UserCollection.

    Poznámka:

    Výše uvedený vzorec zahrnuje po sobě jdoucí požadavek pro získání UserPhoto, což prodlužuje dobu načítání. Pokud nepotřebujete fotografie a chcete zkrátit dobu hledání, použijte následující vzorec ve vlastnosti Suggestions_Items ovládacího prvku místo UserCollection:

    AddColumns(
    Office365Users.SearchUser({ searchTerm: Self.SearchText, top: 500 }),
    "SuggestionKey", Mail, 
    "SuggestionName", DisplayName,
    "SuggestionRole", JobTitle
)

V tomto okamžiku je ovládací prvek funkční a vybrané členy lze získat z vlastnosti SelectedPeople.

PeoplePicker1.SelectedPeople

S tabulkami Dataverse – Uživatelé Microsoft Entra nebo Uživatelé

  1. Nastavte vlastnost Suggestions_Items zadáním níže uvedeného fragmentu kódu.

    Přidejte uživatele nebo konkrétní uživatele (pomocí níže uvedeného kódu) z tabulky do kolekce položek (ve vlastnosti Suggestions_Items) ovládacího prvku PeoplePicker.

    - Tabulka AAD Users

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

    - Tabulka Users

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

  2. Mapujte sloupce podle svých potřeb pomocí AddColumns(). Níže je uveden příklad mapování vlastností sloupců:

    Název vlastnosti Sloupec tabulky AADUser Sloupec tabulky User
    SuggestionKey "mail" "internalemailaddress"
    SuggestionName "displayname" "fullname"
    SuggestionRole "jobtitle" "jobtitle"

V tomto okamžiku by měl fungovat výběr osob a vybrané členy lze získat z vlastnosti SelectedPeople.

PeoplePicker1.SelectedPeople

Omezení

Tuto komponentu plátna lze použít pouze v aplikacích plátna a vlastních stránkách.