Bagikan melalui

PeoplePicker kontrol (pratinjau)

  • Artikel

[Artikel ini adalah dokumentasi prarilis dan dapat berubah.]

Kontrol digunakan untuk membuat pengalaman memuat.

Catatan

Dokumentasi lengkap dan kode sumber yang ditemukan di repositori komponen kode GitHub.

Kontrol PeoplePicker.

Penting

  • Ini adalah fitur pratinjau.
  • Fitur pratinjau tidak dibuat untuk penggunaan produksi dan mungkin memiliki fungsionalitas yang dibatasi. Fitur ini tersedia sebelum rilis resmi agar pelanggan bisa memperoleh akses awal dan memberikan tanggapan.

Description

Pemilih orang (PeoplePicker) digunakan untuk memilih satu atau beberapa entitas, seperti orang atau grup, dari daftar. Menulis email ke seseorang atau menambahkannya ke grup akan mudah dilakukan jika Anda tidak mengetahui nama lengkap atau alamat emailnya.

Komponen kode ini menyediakan pembungkus di sekitar kontrol PeoplePicker UI Fluent untuk digunakan di kanvas & halaman kustom. Lihat dokumentasi komponen untuk praktik terbaik.

Properti kunci

Properti Description
Items Persona (anggota) yang dipilih sebelumnya untuk ditampilkan di Peoplepicker
Suggestions_Items Daftar Anggota yang Disarankan untuk pilihan. Properti ini adalah properti himpunan data yang diperlukan
PeoplePickerType Jenis Peoplepicker yang akan digunakan.
MaxPeople Jumlah maksimum pengguna yang diizinkan untuk pilihan
NoResultFoundMesage Pesan yang akan ditampilkan jika tidak ada hasil yang ditemukan berdasarkan teks pencarian yang ditentukan.
MinimumSearchTermLength panjang istilah pencarian Minimum untuk dimasukkan sebelum memberikan saran.
SearchTermToShortMessage Pesan kustom untuk ditampilkan bila teks pencarian kurang dari MinimumSearchTermLength.
Error Untuk menyorot pemilih warna merah menunjukkan bahwa pemilih memiliki kesalahan tertentu yang memerlukan validasi.
ShowSecondaryText Tentukan Ya atau tidak, tergantung pada apakah teks Kedua (contoh: JobTitle) akan ditampilkan atau tidak.

Items Properti

Properti Description
PersonaName Nama tampilan Persona.
PersonaKey Kunci mengidentifikasi Item spesifik. Kunci harus unik.
PersonaImgUrl Url atau Konten Base64 Gambar Persona (Gambar Profil).
PersonaRole Teks Kedua, Sebaiknya JobTitle Persona
PersonaPresence Opsional - Kehadiran orang untuk ditampilkan - tidak akan menampilkan kehadiran jika tidak tertentu. Nilai harus dari salah satu dari berikut ini: away, blocked, busy dnd,, none, offline, online
PersonaOOF Opsional - Benar atau Salah, Berdasarkan apakah persona di Sedang libur atau tidak.

Suggestions_Items Properti

Properti Description
SuggestionName Nama tampilan Persona.
SuggestionKey Kunci mengidentifikasi Item spesifik. Kunci harus unik.
SuggestionImgUrl Url atau Konten Base64 Gambar Persona (Gambar Profil).
SuggestionRole Teks Kedua, Sebaiknya JobTitle Persona
SuggestionPresence Opsional - Kehadiran orang untuk ditampilkan - tidak akan menampilkan kehadiran jika tidak tertentu. Nilai harus dari salah satu dari berikut ini: away, blocked, busy dnd,, none, offline, online
SuggestionOOF Opsional - Benar atau Salah, Berdasarkan apakah persona di Sedang libur atau tidak.

Properti tambahan

Properti Description
Theme Menerima string JSON yang dihasilkan menggunakan Desainer Tema Fluent UI (windows.net). Membiarkan ini kosong akan menggunakan tema default yang didefinisikan oleh Power Apps.
AccessibilityLabel Aria-label pembaca layar
InputEvent Aktivitas untuk dikirim ke kontrol. Mendukung SetFocus sebagai InputEvent.

Contoh

PeoplePicker mendukung sumber lain dari mana koleksi input dapat diambil. Berikut adalah contoh cara menggunakan komponen PeoplePicker.

Konektor pengguna Office 365

  1. Tambahkan konektor pengguna Office 365 sebagai sumber data.

  2. Tetapkan rumus Power Fx di bawah ini ke properti On Search dari kontrol untuk membuat kumpulan yang disebut 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. Atur properti Suggestions_Items ke UserCollection.

    Catatan

    Rumus di atas mencakup permintaan berturut-turut untuk mendapatkan UserPhoto, yang akan meningkatkan waktu pemuatan. Jika Anda tidak memerlukan foto dan ingin mengurangi waktu pencarian, gunakan rumus berikut di properti Suggestions_Items kontrol, bukan UserCollection: 

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

Pada titik ini kontrol berfungsi dan anggota yang dipilih dapat diperoleh dari properti SelectedPeople.

PeoplePicker1.SelectedPeople

Dengan Dataverse tabel - Microsoft Entra Pengguna atau Pengguna

  1. Atur Properti Suggestions_Items dengan menentukan daftar di bawah cuplikan kode.

    Tambahkan Pengguna atau pengguna tertentu (menggunakan kode di bawah) dari tabel ke kumpulan item (di dalam properti Suggestions_Items) dari PeoplePicker.

    -AAD Users meja

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

    -Users meja

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

  2. Petakan kolom sesuai kebutuhan Anda menggunakan AddColumns(). Di bawah ini adalah contoh Pemetaan Kolom-Properti:

    Nama Properti Kolom Tabel AADUser Kolom Tabel Pengguna
    SuggestionKey "mail" "internalemailaddress"
    SuggestionName "displayname" "fullname"
    SuggestionRole "jobtitle" "jobtitle"

Pada titik ini, pemilih orang seharusnya berfungsi dan anggota yang dipilih dapat diperoleh dari Properti SelectedPeople.

PeoplePicker1.SelectedPeople

Pembatasan

Komponen kanvas ini hanya dapat digunakan pada aplikasi kanvas dan halaman kustom.