Поділитися через

PeoplePicker control (підготовча версія)

  • Стаття

[Ця стаття стосується попередньої версії, і її буде змінено.]

Елемент керування використовується для створення інтерфейсу завантаження.

Нотатка

Повна документація та вихідний код із репозиторію компонентів коду GitHub.

Управління PeoplePicker.

Важливо

  • Це функція попереднього перегляду.
  • Підготовчі функції призначені для невиробничого використання і можуть бути обмежені. Ці функції доступні до офіційного випуску, щоб клієнти могли ознайомитися з ними заздалегідь і залишити відгуки.

Опис

Засіб вибору користувачів (PeoplePicker) використовується для вибору однієї або кількох сутностей, наприклад людей або груп, зі списку. Він спрощує створення повідомлень електронної пошти або додавання осіб до груп у тих випадках, коли точне ім'я або електронна адреса невідомі.

Цей компонент коду надає обгортку навколо елемента керування Fluent UI PeoplePicker для використання на полотні та користувацьких сторінках. Див. документацію компонента для отримання рекомендацій.

Ключові властивості

Властивість Опис
Items Попередньо вибраний портрет(учасники), які з’являтимуться в елементі Peoplepicker
Suggestions_Items Список пропонованих учасників, з-поміж яких можна вибирати. Ця властивість набору даних є обов’язковою
PeoplePickerType Тип елемента Peoplepicker, який потрібно використовувати.
MaxPeople Максимальна кількість користувачів, яких можна буде вибирати
NoResultFoundMesage Повідомлення, яке відображатиметься у випадку, якщо результат не знайдено на основі вказаного тексту пошуку.
MinimumSearchTermLength Мінімальна довжина умови пошуку, яку потрібно ввести, перш ніж пропозиції почнуть надаватися.
SearchTermToShortMessage Настроюване повідомлення, які відображатиметься, якщо текст пошуку менший за MinimumSearchTermLength.
Error Щоб виділити засіб вибору користувачів червоним, сигналізуючи про те, що виникла певна помилка, яка потребує перевірки.
ShowSecondaryText Задайте значення «Так» чи «Ні», залежно від того, чи слід відображати допоміжний текст (наприклад, JobTitle, назву посади).

Items Властивості

Властивість Опис
PersonaName Коротке ім’я портрета.
PersonaKey Ключ визначає певний елемент. Ключ має бути унікальним.
PersonaImgUrl URL-адреса або вміст Base64 зображення портрета (зображення профілю).
PersonaRole Допоміжний текст, бажано назва посади портрета
PersonaPresence Необов’язково. Присутність особи, що відображатиметься — присутність не відображатиметься, якщо не визначено. Дозволені такі значення: away, blocked busy, dnd, none, offline online
PersonaOOF Необов’язково . Істина чи Хибність, залежно від того, чи присутність портрета «Не в офісі», чи ні.

Suggestions_Items Властивості

Властивість Опис
SuggestionName Коротке ім’я портрета.
SuggestionKey Ключ визначає певний елемент. Ключ має бути унікальним.
SuggestionImgUrl URL-адреса або вміст Base64 зображення портрета (зображення профілю).
SuggestionRole Допоміжний текст, бажано назва посади портрета
SuggestionPresence Необов’язково. Присутність особи, що відображатиметься — присутність не відображатиметься, якщо не визначено. Дозволені такі значення: away, blocked busy, dnd, none, offline online
SuggestionOOF Необов’язково . Істина чи Хибність, залежно від того, чи присутність портрета «Не в офісі», чи ні.

Додаткові властивості

Властивість Опис
Theme Приймає рядок JSON, створений за допомогою конструктора тем Fluent UI (windows.net). Якщо залишити це значення пустим, використовуватиметься тема, визначена Power Apps.
AccessibilityLabel Підпис aria-label для невізуальних екранів
InputEvent Подія, яку потрібно надіслати елементу керування. Підтримує SetFocus як InputEvent.

Приклади

PeoplePicker підтримує інші джерела, звідки можна отримати вхідну колекцію. Нижче наведено приклади використання компонента PeoplePicker.

З'єднувач «Користувачі Office 365»

  1. Додайте з'єднувач «Користувачі Office 365» в якості джерела даних.

  2. Призначте наведену нижче формулу Power Fx як значення властивості On Search («Під час пошуку») елемента керування, щоб створити колекцію під назвою 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. Установіть для властивості Suggestions_Items значення UserCollection.

    Нотатка

    Наведена вище формула містить послідовний запит отримання UserPhoto, що збільшує час завантаження. Якщо фотографія не потрібна, а час пошуку є критичним, замість UserCollection використовуйте у властивості Suggestions_Items наведену нижче формулу. 

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

На даний момент елемент керування функціонує, а вибраних учасників можна отримати з властивості SelectedPeople .

PeoplePicker1.SelectedPeople

З Dataverse таблицями - Microsoft Entra Користувачі або Користувачі

  1. Настройте властивість Suggestions_Items , зазначивши фрагмент коду, наведений нижче.

    Додайте Users («Користувачі») або певних користувачів (за допомогою наведеного нижче коду) з таблиці до колекції елементів (під властивістю Suggestions_Items) PeoplePicker.

    -AAD Users стіл

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

    -Users стіл

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

  2. Зіставте стовпці відповідно до потреб, використовуючи AddColumns(). Нижче наведено приклад зіставлення властивостей стовпців.

    Ім'я властивості Стовпець таблиці AADUser Стовпець таблиці User («Користувач»)
    SuggestionKey "mail" "internalemailaddress"
    SuggestionName "displayname" "fullname"
    SuggestionRole "jobtitle" "jobtitle"

На цьому етапі вибір людей має працювати, а вибраних учасників можна отримати з властивості SelectedPeople.

PeoplePicker1.SelectedPeople

Обмеження

Цей компонент полотна можна використовувати лише в компонованих програмах і настроюваних сторінках.