Del via

PeoplePicker Kontrolelement (forhåndsversion)

  • Artikel

[Denne artikel er dokumentation til den foreløbige udgivelse. Der kan forekomme ændringer.]

Et kontrolelement, der bruges til at oprette en indlæsningsoplevelse.

Bemærk

Fuld dokumentation og kildekode fundet i GitHub-kodekomponenters lager.

Kontrolelementet Personvælger.

Vigtigt

  • Dette er en forhåndsversion af funktionen.
  • Forhåndsversionsfunktioner er ikke beregnet til produktionsformål og kan have begrænset funktionalitet. Disse funktioner er tilgængelige før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.

Beskrivelse

Personvælgeren (PeoplePicker) bruges til at vælge et eller flere objekter, f.eks. personer eller grupper, på en liste. Det gør det nemt at oprette en mail til en person eller at føje vedkommende til en gruppe, hvis du ikke kender vedkommendes fulde navn eller mailadresse.

Denne kodekomponent tilføjer en ombryder rundt om kontrolelementet Personvælger på Fluent-brugergrænsefladen til brug i lærredapps og på brugerdefinerede sider. Se komponentdokumentationen for at få oplysninger om bedste praksis.

Nøgleegenskaber

Egenskab Beskrivelse
Items Den forudvalgte karakter (medlemmer), der skal vises i personvælger
Suggestions_Items Liste over foreslåede medlemmer, der skal vælges fra. Dette er en påkrævet egenskab for datasæt
PeoplePickerType Type af personvælger, der skal bruges.
MaxPeople Det højeste antal brugere, der kan vælges
NoResultFoundMesage Meddelelse, der skal vises, hvis der ikke blev fundet et resultat på baggrund af den angivne søgetekst.
MinimumSearchTermLength Minimumlængde på søgeord, der skal angives, før du får forslagene.
SearchTermToShortMessage Brugerdefineret meddelelse, der skal vises, når søgeteksten er mindre end MinimumSearchTermLength.
Error Fremhævelse af personvælgeren med rødt for at vise, at der er visse fejl, som krævede validering.
ShowSecondaryText Angiv Ja eller Nej, afhængigt af om den sekundære tekst (f.eks. JobTitle) skal vises eller ej.

Items Egenskaber

Egenskab Beskrivelse
PersonaName Vist navn på karakter.
PersonaKey Nøglen identificerer det specifikke element. Nøglen skal være entydig.
PersonaImgUrl URL-adresse eller Base64-indhold af Persona Image(Profile Picture).
PersonaRole Sekundær tekst, helst JobTitle for karakteren
PersonaPresence Valgfrit – Tilstedeværelse af den person, der skal vises – tilstedeværelse vises ikke, hvis den ikke er defineret. Værdien skal komme fra en af følgende: away, blocked, busy, dnd, none, offline, online
PersonaOOF Valgfrit – True eller False, afhængigt af om karakteren er til stede eller ej.

Suggestions_Items Egenskaber

Egenskab Beskrivelse
SuggestionName Vist navn på karakter.
SuggestionKey Nøglen identificerer det specifikke element. Nøglen skal være entydig.
SuggestionImgUrl URL-adresse eller Base64-indhold af Persona Image(Profile Picture).
SuggestionRole Sekundær tekst, helst JobTitle for karakteren
SuggestionPresence Valgfrit – Tilstedeværelse af den person, der skal vises – tilstedeværelse vises ikke, hvis den ikke er defineret. Værdien skal komme fra en af følgende: away, blocked, busy, dnd, none, offline, online
SuggestionOOF Valgfrit – True eller False, afhængigt af om karakteren er til stede eller ej.

Yderligere egenskaber

Egenskab Beskrivelse
Theme Accepterer en JSON-streng, der oprettes ved hjælp af Fluent UI Theme-designer (windows.net). Hvis du lader dette være tomt, vises standardtemaet, defineret af Power Apps.
AccessibilityLabel Aria-label til skærmlæsere
InputEvent En hændelse, der skal sendes til kontrolelementet. Understøtter SetFocus som en InputEvent.

Eksempler

PeoplePicker Understøtter andre kilder, hvorfra inputsamlingen kan hentes. Her følger nogle eksempler på, hvordan komponenten PeoplePicker kan bruges.

Office 365 Users-connector

  1. Tilføj Office 365-brugerconnectoren som en datakilde.

  2. Tildel nedenstående Power Fx-formel til egenskaben On Search for kontrolelementet for at oprette en samling kaldet 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. Angiv egenskaben Suggestions_Items til UserCollection.

    Bemærk

    Ovenstående formel indeholder en på hinanden følgende anmodning om at hente UserPhoto, hvilket øger indlæsningstiden. Hvis du ikke har brug for billeder og vil reducere søgetiden, skal du bruge følgende formel i Suggestions_Items-egenskaben for kontrolelementet i stedet for UserCollection:

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

På dette tidspunkt fungerer kontrolelementet, og der kan hentes udvalgte medlemmer fra SelectedPeople-egenskaben.

PeoplePicker1.SelectedPeople

Med Dataverse-tabeller – Microsoft Entra-brugere eller brugere

  1. Opret egenskaben Suggestions_Items ved at angive nedenstående kodestykke.

    Føj brugere eller bestemte brugere (ved hjælp af nedenstående kode) fra tabellen til elementsamlingen (under Suggestions_Items-egenskaben) for PeoplePicker.

    -AAD Users bord

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

    -Users bord

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

  2. Tilknyt kolonnerne efter behov ved hjælp af AddColumns(). Nedenfor er der et eksempel på tilknytning af kolonneegenskaber:

    Egenskabsnavn AADUser-tabelkolonne User-tabelkolonne
    SuggestionKey "mail" "internalemailaddress"
    SuggestionName "displayname" "fullname"
    SuggestionRole "jobtitle" "jobtitle"

På dette tidspunkt bør personvælgeren arbejde, og de valgte medlemmer kan hentes fra SelectedPeople-egenskaben.

PeoplePicker1.SelectedPeople

Begrænsninger

Denne lærredkomponent kan kun bruges i lærredapps og brugerdefinerede sider.