Dela via

PeoplePicker Kontroll (förhandsversion)

  • Artikel

[Den här artikeln är en förhandsversion av dokumentationen och kan komma att ändras.]

En kontroll som används för att skapa en inläsningsupplevelse.

Kommentar

Fullständig dokumentation och källkod finns i lagringsplatsen för GitHub-kodkomponenter.

PeoplePicker-kontroll.

Viktigt!

  • Detta är en förhandsversion.
  • Förhandsversionsfunktioner ska inte användas i produktion och funktionerna kan vara begränsade. Funktionerna är tillgängliga före den officiella publiceringen så att kunderna kan få tillgång tidigare och ge oss feedback.

Description

Personväljaren (PeoplePicker) används för att välja en eller flera entiteter, till exempel personer eller grupper, från en lista. Det gör det enkelt att skapa ett e-postmeddelande till någon eller lägga till dem i en grupp om du inte känner till deras fullständiga namn eller e-postadress.

Den här kodkomponenten fungerar som en adapter runt kontrollen Fluent UI PeoplePicker att använda arbetsyteappar och på anpassade sidor. Metodtips finns i komponentdokumentationen.

Nyckelegenskaper

Property Description
Items Den förvalda profil (medlemmarna) som ska visas på Peoplepicker
Suggestions_Items Lista över förslag på medlemmar att välja bland. Detta är en obligatorisk dataset-egenskap
PeoplePickerType Typ av Peoplepicker som ska användas.
MaxPeople Maximalt antal användare som kan väljas
NoResultFoundMesage Meddelande som ska visas om inget resultat hittas baserat på den angivna söktexten.
MinimumSearchTermLength Ange sökterm längd innan du ger några förslag.
SearchTermToShortMessage Anpassat meddelande som ska visas när söktexten är mindre än MinimumSearchTermLength.
Error För att markera personer med rött för att representera att den har ett visst fel som krävs för validering.
ShowSecondaryText Ange Ja eller Nej, beroende på om den sekundära texten (till exempel JobTitle) ska visas eller inte.

Items Egenskaper

Property Description
PersonaName Visningsnamn för profilen.
PersonaKey Nyckeln identifierar det specifika objektet. Nycklarna måste vara unika.
PersonaImgUrl URL- eller Base64-innehåll i Profil bild (profilbild).
PersonaRole Sekundär text, helst JobTitle för Persona
PersonaPresence Valfritt – Närvaro av den person som ska visas, närvaro visas inte om den inte hardefinierats. Värdet ska vara från något av följande: away, blocked, busy, dnd, none, offline, online
PersonaOOF Valfritt – Sant eller Falskt, baserat på om profilen är frånvarande eller inte.

Suggestions_Items Egenskaper

Property Description
SuggestionName Visningsnamn för profilen.
SuggestionKey Nyckeln identifierar det specifika objektet. Nycklarna måste vara unika.
SuggestionImgUrl URL- eller Base64-innehåll i Profil bild (profilbild).
SuggestionRole Sekundär text, helst JobTitle för Persona
SuggestionPresence Valfritt – Närvaro av den person som ska visas, närvaro visas inte om den inte hardefinierats. Värdet ska vara från något av följande: away, blocked, busy, dnd, none, offline, online
SuggestionOOF Valfritt – Sant eller Falskt, baserat på om profilen är frånvarande eller inte.

Ytterligare egenskaper

Property Description
Theme Godkänner en JSON-sträng som genereras med Fluent UI temadesigner (windows.net). Om du lämnar detta tomt används standardstandarden som definieras av Power Apps.
AccessibilityLabel Aria-etikett för skärmläsare
InputEvent En händelse att skicka till kontrollen. Stödjer SetFocus som en InputEvent.

Exempel

PeoplePicker Stöder andra källor som indatainsamlingen kan hämtas från. Här följer några exempel på hur komponenten PeoplePicker används.

Office 365 anslutningsprogram som används

  1. Lägg till Office 365 anslutningsprogram som används som datakälla.

  2. Tilldela Power Fx formeln nedan till egenskapen On Search för kontrollen för att skapa en samling med namnet 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. Ange egenskapen Suggestions_Items till UserCollection.

    Kommentar

    Formeln ovan innehåller en efter varandra följande begäran om att få UserPhoto, vilket ökar inläsningstiden. Om du inte behöver några bilder och vill minska söktiden använder du följande formel för Suggestions_Items egenskapen för kontrollen i stället för UserCollection:

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

Så här långt fungerar kontrollen och valda medlemmar hämtas från SelectedPeople egenskapen.

PeoplePicker1.SelectedPeople

Med Dataverse tabeller – Microsoft Entra-användare och användare

  1. Konfigurera egenskapen Suggestions_Items genom att ange koden nedan kodavsnitt.

    Lägg till användare eller specifika användare (med koden nedan) från tabellen till objektsamlingen (under Suggestions_Items egenskapen) PeoplePicker.

    -AAD Users bord

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

    -Users bord

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

  2. Mappa kolumnerna efter dina behov med hjälp av AddColumns(). Nedan följer ett exempel på Kolumnegenskapsmappning:

    Egenskapsnamn AADUser tabellkolumn Kolumnen användartabell
    SuggestionKey "mail" "internalemailaddress"
    SuggestionName "displayname" "fullname"
    SuggestionRole "jobtitle" "jobtitle"

Så här långt bör personväljaren fungera och de valda medlemmarna kan hämtas från egenskapen SelectedPeople.

PeoplePicker1.SelectedPeople

Begränsningar

Den här arbetsytekomponenten kan endast användas i arbetsyteappar och på anpassade sidor.