Del via

PeoplePicker Kontroll (forhåndsversjon)

  • Artikkel

[Denne artikkelen inneholder dokumentasjon for forhåndsversjonen og kan bli endret.]

En kontroll som brukes til å opprette en lastingsopplevelse.

Merk

Full dokumentasjons- og kildekode funnet i GitHub-kodekomponentrepositoriet.

PeoplePicker-kontrollen.

Viktig

  • Dette er en forhåndsversjonsfunksjon.
  • Forhåndsversjonsfunksjonene er ikke ment for produksjonsbruk og kan ha begrenset funksjonalitet. Disse funksjonene er tilgjengelige før en offisiell utgivelse, slik at kunder kan få tidlig tilgang og gi tilbakemelding.

Bekrivelse

Personvelgeren (PeoplePicker) brukes til å velge én eller flere enheter, for eksempel personer eller grupper, fra en liste. Den gjør det enkelt å skrive en e-postmelding til noen eller legge dem til i en gruppe hvis du ikke vet det fulle navnet eller e-postadressen.

Denne kodekomponenten gir en wrapper rundt Fluent UI PeoplePicker-kontrollen for bruk i lerretsapper og på egendefinerte sider. Se komponentdokumentasjon for gode fremgangsmåter.

Nøkkelegenskaper

Egenskap Bekrivelse
Items Den forhåndsvalgte identiteten (medlemmer) som skal vises i personvelgeren
Suggestions_Items Liste over foreslåtte medlemmer å velge fra. Dette er en obligatorisk egenskap for datasett
PeoplePickerType Typen personvelger som skal brukes.
MaxPeople Maksimalt antall bruker(e) det er tillatt å velge
NoResultFoundMesage Melding som skal vises hvis ingen resultater blir funnet basert på den angitte søketeksten.
MinimumSearchTermLength Minimumslengde på søkeord som skal angis før forslagene oppgis.
SearchTermToShortMessage Egendefinert melding som skal vises når søketeksten er kortere enn MinimumSearchTermLength.
Error Hvis du vil fremheve personvelgeren i rødt for å representere at den har en bestemt feil som må valideres.
ShowSecondaryText Angi Ja eller Nei, avhengig av om sekundærteksten (for eksempel JobTitle) skal vises eller ikke.

Items Egenskaper

Egenskap Bekrivelse
PersonaName Visningsnavn for identiteten.
PersonaKey Nøkkelen identifiserer det bestemte elementet. Nøkkelen må være unik.
PersonaImgUrl Nettadresse eller Base64-innhold i identitetsbildet (profilbildet).
PersonaRole Sekundær tekst, helst JobTitle for identiteten
PersonaPresence Valgfritt – Tilgjengeligheten til personen som skal vises – viser ikke tilgjengelighet hvis den ikke er definert. Verdien må være blant følgende: away, blocked, busy, dnd, none, offline, online
PersonaOOF Valgfritt – True eller False, basert på om identiteten er fraværende eller ikke.

Suggestions_Items Egenskaper

Egenskap Bekrivelse
SuggestionName Visningsnavn for identiteten.
SuggestionKey Nøkkelen identifiserer det bestemte elementet. Nøkkelen må være unik.
SuggestionImgUrl Nettadresse eller Base64-innhold i identitetsbildet (profilbildet).
SuggestionRole Sekundær tekst, helst JobTitle for identiteten
SuggestionPresence Valgfritt – Tilgjengeligheten til personen som skal vises – viser ikke tilgjengelighet hvis den ikke er definert. Verdien må være blant følgende: away, blocked, busy, dnd, none, offline, online
SuggestionOOF Valgfritt – True eller False, basert på om identiteten er fraværende eller ikke.

Tilleggsegenskaper

Egenskap Bekrivelse
Theme Godtar en JSON-streng som genereres ved hjelp av Fluent UI Theme Designer (windows.net). Hvis du lar dette stå tomt, bruker du standardtemaet definert av Power Apps.
AccessibilityLabel Skjermleser aria-etikett
InputEvent En hendelse for å sende kontrollen. Støtter SetFocus som en InputEvent.

Eksempler

PeoplePicker Støtter andre kilder der inndatasamlingen kan hentes fra. Nedenfor er eksempler på hvordan du bruker PeoplePicker-komponenten.

Office 365-brukerkobling

  1. Legg til koblingen Office 365 Users som en datakilde.

  2. Tilordne Power Fx-formelen nedenfor til egenskapen On Search for kontrollen for å opprette en samling kalt 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. Angi Suggestions_Items-egenskapen til UserCollection.

    Merk

    Formelen ovenfor omfatter en fortløpende forespørsel om å hente UserPhoto, som øker innlastingstiden. Hvis du ikke trenger bilder og vil redusere søketiden, bruker du følgende formel i egenskapen Suggestions_Items for kontrollen i stedet for UserCollection:

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

Nå fungerer kontrollen, og valgte medlemmer kan hentes fra egenskapen SelectedPeople.

PeoplePicker1.SelectedPeople

Med Dataverse-tabeller – Microsoft Entra-brukere eller brukere

  1. Konfigurer egenskapen Suggestions_Items ved å angi kodesnutten nedenfor.

    Legg til brukere eller bestemte brukere fra tabellen (ved å bruke koden nedenfor) i elementsamlingen (under egenskapen Suggestions_Items) for PeoplePicker.

    -AAD Users bord

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

    -Users bord

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

  2. Tilordne kolonnene etter behov ved å bruke AddColumns(). Nedenfor er et eksempel på tilordning av kolonneegenskap:

    Egenskapsnavn Kolonne i AADUser-tabell Kolonne i User-tabell
    SuggestionKey "mail" "internalemailaddress"
    SuggestionName "displayname" "fullname"
    SuggestionRole "jobtitle" "jobtitle"

Nå skal personvelgeren fungere, og de valgte medlemmene kan hentes fra egenskapen SelectedPeople.

PeoplePicker1.SelectedPeople

Begrensninger

Denne lerretskomponenten kan bare brukes i lerretsapper og egendefinerte sider.