Udostępnij przez

Kontrolka Siatka usługi PeoplePicker (Wersja zapoznawcza)

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

Kontrolka używana do tworzenia środowiska ładowania.

Notatka

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

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.

Podpis

Selektor osób (PeoplePicker) umożliwia wybranie z listy jednej lub większej liczby encji, takich jak osoby lub grupy. Ułatwia to napisanie wiadomości e-mail do kogoś lub dodanie go do grupy, jeśli nie znasz jego pełnego imienia i nazwiska ani adresu e-mail.

Ten składnik kodu stanowi opakowanie dla kontrolki Fluent UI PeoplePicker do użycia w kanwie i stronach niestandardowych. Zapoznaj się z dokumentacją składnika, aby poznać najlepsze praktyki.

Właściwości klucza

Właściwości Podpis
Items Wstępnie wybrane osoby (członkowie) do wyświetlenia w Peoplepicker.
Suggestions_Items Lista sugerowanych członków do wyboru. To jest wymagana właściwość zestawu danych.
PeoplePickerType Typ Peoplepicker, które ma być używane.
MaxPeople Maksymalna liczba użytkowników dozwolona do wyboru.
NoResultFoundMesage Komunikat, który zostanie wyświetlony, jeśli nie zostanie znaleziony żaden wynik na podstawie określonego szukanego tekstu.
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óżnij kontrolkę wyboru osób na czerwono, aby wskazać, że wystąpił błąd wymagający weryfikacji.
ShowSecondaryText Określ wartość Tak lub Nie, w zależności od tego, czy tekst pomocniczy (na przykład Stanowisko) ma być wyświetlany, czy nie.

Właściwość Elementy

Właściwości Podpis
PersonaName Nazwa wyświetlana danej osoby.
PersonaKey Klucz identyfikuje konkretny element i musi być unikatowy.
PersonaImgUrl Adres URL lub treść Base64 obrazu osoby (zdjęcie profilowe).
PersonaRole Tekst dodatkowy, najlepiej stanowisko osoby.
PersonaPresence (Opcjonalnie) Obecność osoby do wyświetlenia. Obecność nie jest wyświetlana, jeśli nie jest zdefiniowana. Można wybrać tylko jedną wartość: away, blocked, busy, dnd, none, offline lub online.
PersonaOOF (Opcjonalnie) Prawda lub Fałsz w zależności od tego, czy dana osoba jest poza biurem, czy nie.

Właściwości Suggestions_Items

Właściwości Podpis
SuggestionName Nazwa wyświetlana danej osoby.
PersonaKey Klucz identyfikuje konkretny element i musi być unikatowy.
SuggestionImgUrl Adres URL lub treść Base64 obrazu osoby (zdjęcie profilowe).
SuggestionRole Tekst dodatkowy, najlepiej stanowisko osoby.
SuggestionPresence (Opcjonalnie) Obecność osoby do wyświetlenia. Obecność nie jest wyświetlana, jeśli nie jest zdefiniowana. Można wybrać tylko jedną wartość: away, blocked, busy, dnd, none, offline lub online.
PersonaOOF (Opcjonalnie) Prawda lub Fałsz w zależności od tego, czy dana osoba jest poza biurem, czy nie.

Dodatkowe właściwości

Właściwości Podpis
Theme Akceptuje ciąg JSON generowany przy użyciu Projektanta motywów interfejsu użytkownika (windows.net). Jeśli to pole pozostanie puste, zostanie użyty motyw domyślny zdefiniowany przez Power Apps.
AccessibilityLabel Czytnik ekranu aria-label.
InputEvent Zdarzenie do wysłania do kontroli Obsługuje SetFocus jako element InputEvent.

Przykłady

Składnik PeoplePicker obsługuje dodatkowe źródła do pobierania kolekcji wejściowej. Poniżej przedstawiono przykłady użycia tego składnika.

Łącznik użytkowników Office 365

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

  2. Przypisz formułę Power Fx do właściwości Dotyczące wyszukiwania kontrolki, aby utworzyć kolekcję 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. Opcjonalnie, jeśli nie używasz zdjęć, ustaw właściwość Suggestions_Items na UserCollection.

    Formuła zawiera kolejne żądanie pobrania UserPhoto, co wydłuża czas ładowania. Jeśli nie potrzebujesz zdjęć i chcesz skrócić czas wyszukiwania, użyj następującego wzoru we właściwości Suggestions_Items kontrolki zamiast 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. Ustaw właściwość Suggestions_Items.

    Dodaj użytkowników lub konkretnych użytkowników z tabeli do kolekcji produktów (właściwość Suggestions_Items) PeoplePicker.

    • Tabela AAD Users:

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

    • Tabela Users:

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

  2. Mapuj kolumny zgodnie z potrzebami za pomocą AddColumns(). Oto przykład mapowania właściwości kolumny:

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

W tym momencie kontrolka wyboru osób działa i 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.

  • Last updated on