Delen via

PeoplePicker controle (preview)

  • Artikel

[Dit artikel maakt deel uit van de voorlopige documentatie en kan nog veranderen.]

Een besturingselement dat wordt gebruikt om een laadervaring te maken.

Notitie

Volledige documentatie en broncode vindt u in de GitHub-opslagplaats voor codeonderdelen.

Besturingselement PeoplePicker.

Belangrijk

  • Dit is een preview-functie.
  • Preview-functies zijn niet bedoeld voor productiegebruik en bieden mogelijk beperkte functionaliteit. Deze functies zijn beschikbaar vóór een officiële release zodat klanten vroeg toegang kunnen krijgen en feedback kunnen geven.

Omschrijving

De personenkiezer (PeoplePicker) wordt gebruikt om een of meer entiteiten, zoals personen of groepen, uit een lijst te selecteren. Het maakt het opstellen van een e-mail aan iemand, of het toevoegen van een gebruiker aan een groep, gemakkelijk als u de volledige naam of het e-mailadres niet weet.

Dit codeonderdeel biedt een wrapper rond het Fluent UI-besturingselement PeoplePicker voor gebruik in canvas-apps en aangepaste pagina's. Zie onderdeeldocumentatie voor best practices.

Belangrijke eigenschappen

Eigenschappen Omschrijving
Items De vooraf geselecteerde persona(leden) die in Peoplepicker moeten worden weergegeven
Suggestions_Items Lijst met voorgestelde leden om uit te kiezen. Deze eigenschap van een gegevensset is vereist.
PeoplePickerType Type Peoplepicker dat moet worden gebruikt.
MaxPeople Maximaal aantal gebruikers dat moet worden toegestaan voor selectie
NoResultFoundMesage Bericht dat moet worden weergegeven als er geen resultaat wordt gevonden op basis van de opgegeven zoektekst.
MinimumSearchTermLength Minimale lengte van zoekterm die moet worden ingevoerd voordat de suggesties worden verstrekt.
SearchTermToShortMessage Aangepast bericht dat moet worden weergegeven wanneer de zoektekst kleiner is dan MinimumSearchTermLength.
Error De personenkiezer kan rood worden gemarkeerd om aan te geven dat deze een bepaalde fout bevat waarvoor validatie is vereist.
ShowSecondaryText Geef Ja of Nee op, afhankelijk van of de secundaire tekst (bijvoorbeeld JobTitle) moet worden weergegeven of niet.

Items eigenschappen

Eigenschappen Omschrijving
PersonaName Weergavenaam van de persona.
PersonaKey De sleutel voor het identificeren van het specifieke item. De sleutel moet uniek zijn.
PersonaImgUrl URL of Base64-inhoud van persona-afbeelding (profielfoto).
PersonaRole Secundaire tekst, bij voorkeur functietitel van de persona
PersonaPresence Optioneel - Aanwezigheid van de persoon die moet worden weergegeven - geeft de aanwezigheid niet weer als deze niet is gedefinieerd. Een van de volgende waarden is vereist: away, blocked, busy, dnd, none, offline, online
PersonaOOF Optioneel - Waar of Onwaar, gebaseerd op het feit of de persona al dan niet op kantoor is.

Suggestions_Items eigenschappen

Eigenschappen Omschrijving
SuggestionName Weergavenaam van de persona.
SuggestionKey De sleutel voor het identificeren van het specifieke item. De sleutel moet uniek zijn.
SuggestionImgUrl URL of Base64-inhoud van persona-afbeelding (profielfoto).
SuggestionRole Secundaire tekst, bij voorkeur functietitel van de persona
SuggestionPresence Optioneel - Aanwezigheid van de persoon die moet worden weergegeven - geeft de aanwezigheid niet weer als deze niet is gedefinieerd. Een van de volgende waarden is vereist: away, blocked, busy, dnd, none, offline, online
SuggestionOOF Optioneel - Waar of Onwaar, gebaseerd op het feit of de persona al dan niet op kantoor is.

Aanvullende eigenschappen

Eigenschappen Omschrijving
Theme Accepteert een JSON-tekenreeks die is gegenereerd met Ontwerper van Fluent UI Theme (windows.net). Als u dit leeg laat, wordt het standaardthema gebruikt dat door Power Apps is gedefinieerd.
AccessibilityLabel Arialabel voor schermlezers
InputEvent Een gebeurtenis waarnaar het besturingselement moet worden verzonden Ondersteunt SetFocus als een InputEvent.

Voorbeelden

PeoplePicker ondersteunt andere bronnen waaruit de invoercollectie kan worden opgehaald. Hieronder volgen de voorbeelden van het gebruik van het onderdeel PeoplePicker.

Connector voor Office 365-gebruikers

  1. Voeg de connector Office 365-gebruikers toe als gegevensbron.

  2. Wijs de onderstaande Power Fx-formule toe aan de eigenschap Bij zoeken van het besturingselement om een verzameling te maken met de naam 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. Stel de eigenschap Suggestions_Items in op UserCollection.

    Notitie

    De bovenstaande formule bevat een opeenvolgend verzoek om UserPhoto op te halen, waardoor de laadtijd toeneemt. Als u geen foto's nodig hebt en de zoektijd wilt verkorten, gebruikt u de volgende formule in de eigenschap Suggestions_Items van het besturingselement in plaats van UserCollection: 

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

Op dit punt functioneert het besturingselement en kunnen geselecteerde leden worden verkregen uit de eigenschap SelectedPeople.

PeoplePicker1.SelectedPeople

Met Dataverse-tabellen - Microsoft Entra-gebruikers of Gebruikers

  1. Stel de eigenschap Suggestions_Items in door het onderstaande codefragment op te geven.

    Voeg gebruikers of specifieke gebruikers (met behulp van onderstaande code) vanuit tabel toe aan de verzameling items (onder eigenschap Suggestions_Items) van PeoplePicker.

    -AAD Users tafel

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

    -Users tafel

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

  2. Wijs de kolommen toe op basis van uw behoefte met behulp van AddColumns(). Hieronder ziet u een voorbeeld van de toewijzing van kolommen en eigenschappen:

    Eigenschapsnaam Kolom van AADUser-tabel Kolom van gebruikerstabel
    SuggestionKey "mail" "internalemailaddress"
    SuggestionName "displayname" "fullname"
    SuggestionRole "jobtitle" "jobtitle"

Op dit punt moet de personenkiezer werken en kunnen de geselecteerde leden worden opgehaald uit de eigenschap SelectedPeople.

PeoplePicker1.SelectedPeople

Beperkingen

Dit canvasonderdeel kan alleen worden gebruikt in canvas-apps en aangepaste pagina's.