Jaa

PeoplePicker Valvonta (esiversio)

  • Artikkeli

[Tämä artikkeli sisältää julkaisua edeltävää materiaalia ja voi muuttua.]

Latauskokemuksen luova ohjausobjekti.

Muistiinpano

Täydellinen dokumentaatio ja lähdekoodi löytyvät koodikomponenttien GitHub-säilöstä.

PeoplePicker-ohjausobjekti.

Tärkeä

  • Tämä on esiversiotoiminto.
  • Esiversiotoimintoja ei ole tarkoitettu tuotantokäyttöön, ja niiden toiminnot voivat olla rajoitettuja. Nämä toiminnot ovat käytettävissä ennen virallista julkaisua, jotta asiakkaat voivat käyttää niiden ennakkojulkaisua ja antaa palautetta.

Description

Käyttäjien valintaa (PeoplePicker) käytetään yhden tai useamman entiteettien, kuten ihmisten tai ryhmien, valitsemiseen luettelosta. Jos et tiedä käyttäjän koko nimeä tai sähköpostiosoitetta, se helpottaa sähköpostiviestin luontia tai lisäämistä ryhmään.

Tämä koodikomponentti paketoi Fluent UI:n PeoplePicker-ohjausobjektin, jota käytetään pohjaan perustuvissa sovelluksissa ja mukautetuilla sivuilla. Katso parhaat käytännöt komponenttien dokumentaatiosta.

Tärkeimmät ominaisuudet

Ominaisuus Description
Items PeoplePicker-valinnassa näkyvä valmiiksi valittu henkilötyyppi(jäsenet)
Suggestions_Items Luettelo ehdotetuista jäsenistä, jotka voidaan valita. Tämä tietojoukon ominaisuus on pakollinen
PeoplePickerType Käytettävän PeoplePicker-valinnan tyyppi.
MaxPeople Valinnassa sallittu käyttäjien enimmäismäärä
NoResultFoundMesage Sanoma, joka näytetään, jos määritetyllä hakutekstillä ei löydy tuloksia.
MinimumSearchTermLength Syötettävän hakusanan vähimmäispituus enne ehdotusten näyttämistä.
SearchTermToShortMessage Mukautettu viesti, joka näytetään, kun hakuteksti on lyhyempi kuin MinimumSearchTermLength.
Error Jos haluat korostaa käyttäjävalitsinta punaisena ilmaisemaan, että siinä on tietty tarkistusvirhe.
ShowSecondaryText Määritä Kyllä tai Ei sen mukaan, näytetäänkö toissijainen teksti (esimerkiksi JobTitle).

Items Majoituspaikkaa

Ominaisuus Description
PersonaName Henkilötyypin näyttönimi.
PersonaKey Avain, joka tunnistaa tietyn kohteen. Avaimen täytyy olla yksilöllinen.
PersonaImgUrl Henkilötyypin kuvan (profiilikuvan) Url- tai Base64-sisältö.
PersonaRole Toissijainen teksti, mielellään henkilötyypin JobTitle
PersonaPresence Valinnainen – näytettävän henkilön tavoitettavuus – tavoitettavuus ei näy, jos tätä ei ole määritetty. Arvon on oltava jokin seuraavista: away, blocked, busy, dnd, none, offline, online
PersonaOOF Valinnainen – Tosi tai Epätosi sen mukaan, onko henkilö Poissa vai ei.

Suggestions_Items Majoituspaikkaa

Ominaisuus Description
SuggestionName Henkilötyypin näyttönimi.
SuggestionKey Avain, joka tunnistaa tietyn kohteen. Avaimen täytyy olla yksilöllinen.
SuggestionImgUrl Henkilötyypin kuvan (profiilikuvan) Url- tai Base64-sisältö.
SuggestionRole Toissijainen teksti, mielellään henkilötyypin JobTitle
SuggestionPresence Valinnainen – näytettävän henkilön tavoitettavuus – tavoitettavuus ei näy, jos tätä ei ole määritetty. Arvon on oltava jokin seuraavista: away, blocked, busy, dnd, none, offline, online
SuggestionOOF Valinnainen – Tosi tai Epätosi sen mukaan, onko henkilö Poissa vai ei.

Lisäominaisuudet

Ominaisuus Description
Theme Hyväksyy Fluent UI Theme Designer (windows.net) -sovelluksella luodun JSON-merkkijonon. Tämän kentän jättäminen tyhjäksi käyttää Power Appsin määrittämää oletusteemaa.
AccessibilityLabel Näytönlukuohjelman aria-otsikko
InputEvent Ohjausobjektiin lähetettävä tapahtuma. Tukee SetFocus-tapahtumaa InputEvent-tapahtumana.

Esimerkkejä

PeoplePicker Tukee muita lähteitä, joista syötekokoelma voidaan noutaa. Seuraavassa on esimerkkejä PeoplePicker-osan käytöstä.

Office 365 -käyttäjien yhdistimet

  1. Lisää Office 365 -käyttäjät -yhdistin tietolähteeksi.

  2. Määritä alla oleva Power Fx -kaava ohjausobjektin Haettaessa-ominaisuudelle ja luo kokoelma, jonka nimi on 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. Määritä Suggestions_Items -ominaisuudeksi UserCollection.

    Muistiinpano

    Yllä oleva kaava sisältää peräkkäisen pyynnön UserPhoto-kohteeseen, mikä lisää latausaikaa. Jos et tarvitse kuvia ja haluat lyhentää hakuaikaa, käytä ohjausobjektin Suggestions_Items -ominaisuudessa seuraavaa kaavaa UserCollectionin asemesta:

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

Ohjausobjekti toimii tässä vaiheessa, ja valitut jäsenet voi noutaa SelectedPeople-ominaisuudesta.

PeoplePicker1.SelectedPeople

Dataverse-taulukot – Microsoft Entra -käyttäjät tai käyttäjät

  1. Määritä Suggestions_Items-ominaisuus määrittämällä alla oleva koodikatkelma.

    Lisää käyttäjät tai tietyt käyttäjät (käyttämällä alla olevaa koodia) taulukosta PeoplePickerin kohteiden kokoelmaan (Suggestions_Items-ominaisuuden alle).

    -AAD Users pöytä

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

    -Users pöytä

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

  2. Yhdistä sarakkeet tarpeen mukaan AddColumns()-toiminnon avulla. Alla on esimerkki sarake-ominaisuuden määrityksestä:

    Ominaisuuden nimi AADUser-taulukkosarake Käyttäjätaulukkosarake
    SuggestionKey "mail" "internalemailaddress"
    SuggestionName "displayname" "fullname"
    SuggestionRole "jobtitle" "jobtitle"

Tässä vaiheessa käyttäjien valitsimen tulisi toimia ja valitut jäsenet voidaan hakea SelectedPeople-ominaisuudesta.

PeoplePicker1.SelectedPeople

Rajoitukset

Tätä pohjaan perustuvaa komponenttia voi käyttää vain pohjaan perustuvissa sovelluksissa ja mukautetuilla sivuilla.