Udostępnij za pośrednictwem

PeoplePicker kontrola (wersja zapoznawcza)

  • Artykuł

[Ten artykuł stanowi wstępną wersję dokumentacji i może ulec zmianie.]

Kontrolka używana do tworzenia środowiska ładowania.

Uwaga

Pełna dokumentacja i kod źródłowy znajdują się w repozytorium GitHub komponentów kodu.

Kontrolka PeoplePicker.

Ważne

  • Jest to funkcja w wersji zapoznawczej.
  • Funkcje w wersji zapoznawczej nie są przeznaczone do użytku w środowiskach produkcyjnych i mogą mieć ograniczoną funkcjonalność. Te funkcje są udostępniane przed oficjalnym wydaniem, dzięki czemu klienci mogą szybciej uzyskać do nich dostęp i przekazać opinie na ich temat.

opis

Selektor osób (PeoplePicker) służy do wybierania z listy co najmniej jednej encji, takich jak osoby lub grupy. Dzięki temu można łatwo utworzyć wiadomość e-mail do kogoś lub dodać go do grupy, nawet jeśli nie znasz jego imienia i nazwiska lub adresu e-mail.

Ten składnik kodu udostępnia otokę kontrolki Fluent UI PeoplePicker do użycia w kanwach i na stronach niestandardowych. Zapoznaj się z dokumentacją komponentów, aby zapoznać się z najlepszymi praktykami.

Właściwości klucza

Właściwości opis
Items Wstępnie wybrane osoby (członkowie) do wyświetlenia w selektorze osób
Suggestions_Items Lista sugerowanych członków do wyboru. To jest wymagana właściwość zestawu danych
PeoplePickerType Typ selektora osób, który ma być używany.
MaxPeople Maksymalna liczba użytkowników do wyboru
NoResultFoundMesage Komunikat, który ma być wyświetlany, jeśli na podstawie określonego tekstu wyszukiwania nie znaleziono wyników.
MinimumSearchTermLength Minimalna długość terminu wyszukiwania, która ma zostać wprowadzona przed dostarczeniem sugestii.
SearchTermToShortMessage Komunikat niestandardowy, który ma być wyświetlany, gdy tekst wyszukiwania jest mniejszy niż MinimumSearchTermLength.
Error Wyróżnienie selektora osób na czerwono oznacza, że zawiera on pewne błędy, które wymagały weryfikacji.
ShowSecondaryText Wybierz pozycję Tak lub Nie w zależności od tego, czy ma być wyświetlany tekst pomocniczy (na przykład JobTitle).

Items Właściwości

Właściwości opis
PersonaName Nazwa wyświetlana danej osoby.
PersonaKey Klucz identyfikuje określony element. Klucze muszą być niepowtarzalne.
PersonaImgUrl Adres URL lub treść Base64 obrazu osoby (zdjęcie profilowe).
PersonaRole Tekst pomocniczy, najlepiej element JobTitle dla osoby
PersonaPresence Opcjonalnie — obecność osoby do wyświetlenia — obecność nie będzie wyświetlana, jeśli nie zostanie zdefiniowana. Wartość powinna pochodzić z następującego zbioru: away, blocked, busy, dnd, none, offline, online
PersonaOOF Opcjonalnie — prawda lub fałsz; określa, czy dana osoba jest poza biurem, czy nie.

Suggestions_Items Właściwości

Właściwości opis
SuggestionName Nazwa wyświetlana danej osoby.
SuggestionKey Klucz identyfikuje określony element. Klucze muszą być niepowtarzalne.
SuggestionImgUrl Adres URL lub treść Base64 obrazu osoby (zdjęcie profilowe).
SuggestionRole Tekst pomocniczy, najlepiej element JobTitle dla osoby
SuggestionPresence Opcjonalnie — obecność osoby do wyświetlenia — obecność nie będzie wyświetlana, jeśli nie zostanie zdefiniowana. Wartość powinna pochodzić z następującego zbioru: away, blocked, busy, dnd, none, offline, online
SuggestionOOF Opcjonalnie — prawda lub fałsz; określa, czy dana osoba jest poza biurem, czy nie.

Dodatkowe właściwości

Właściwości opis
Theme Akceptuje ciąg JSON generowany przy użyciu Projektanta motywów interfejsu użytkownika (windows.net). Pozostawienie tego pustego będzie używać domyślnego motywu zdefiniowanego przez ustawienie Power Apps.
AccessibilityLabel Czytnik ekranu aria-label
InputEvent Zdarzenie do wysłania do kontroli Obsługuje SetFocus jako element InputEvent.

Przykłady

PeoplePicker obsługuje inne źródła, z których można pobrać kolekcję danych wejściowych. Poniżej przedstawiono przykłady korzystania ze składnika PeoplePicker.

Łącznik użytkowników Office 365

  1. Dodaj łącznik Użytkownicy usługi Office 365 jako źródło danych.

  2. Przypisz poniższą formułę Power Fx do właściwości On Search kontrolki w celu utworzenia kolekcji o nazwie 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. Ustaw właściwość Suggestions_Items na UserCollection.

    Uwaga

    Powyższa formuła zawiera kolejne żądanie pobrania wartości UserPhoto, co zwiększa czas ładowania. Jeśli nie potrzebujesz zdjęć i chcesz zmniejszyć czas wyszukiwania, użyj następującej formuły we właściwości Suggestions_Items zamiast elementu UserCollection:

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

W tym momencie kontrolka działa, a wybranych członków można pobrać z właściwości SelectedPeople.

PeoplePicker1.SelectedPeople

Z tabelami Dataverse — użytkownicy usługi Microsoft Entra lub użytkownicy

  1. Skonfiguruj właściwość Suggestions_Items, określając poniższy kod wstawki kodu.

    Dodaj użytkowników lub określonych użytkowników (korzystając z kodu poniżej) z tabeli do kolekcji elementów (we właściwości Suggestions_Items) kontrolki PeoplePicker.

    -AAD Users tabela

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

    -Users tabela

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

  2. Mapuj kolumny zgodnie z potrzebami przy użyciu dodatku AddColumns(). Poniżej przedstawiono przykład mapowania właściwości kolumn:

    Nazwa właściwości Kolumna tabeli AADUser Kolumna tabeli User
    SuggestionKey „mail” „internalemailaddress”
    SuggestionName „displayname” „fullname”
    SuggestionRole „jobtitle” „jobtitle”

W tym momencie selektor osób powinien działać, a wybranych członków można uzyskać z właściwości SelectedPeople.

PeoplePicker1.SelectedPeople

Ograniczenia

Tego składnika kanwy można używać tylko w aplikacjach kanwy i na stronach niestandardowych.