Comparteix a través de

PeoplePicker control (versió preliminar)

  • Article

[Aquest article forma part de la documentació preliminar i està subjecte a canvis.]

Control utilitzat per crear una experiència de càrrega.

Nota

Trobareu la documentació completa i el codi font al dipòsit de components de codi de GitHub.

Control de PeoplePicker.

Important

  • Aquesta és una característica de visualització prèvia.
  • Les característiques de visualització prèvia no estan dissenyades per a un entorn de producció i poden tenir una funcionalitat restringida. Aquestes característiques estan disponibles abans d’un llançament oficial de producte per tal que els clients el puguin utilitzar abans i enviar-nos els seus comentaris.

Descripció

El selector d'usuaris (PeoplePicker) s'utilitza per seleccionar una o diverses entitats, com ara persones o grups, d'una llista. Facilita la redacció d'un correu electrònic a algú o l'addició a un grup, si no en sabeu el nom complet o l'adreça electrònica.

Aquest component de codi proporciona un embolcall al voltant del control Fluent UI PeoplePicker per utilitzar-lo en llenços i pàgines personalitzades. Vegeu la documentació del component per veure pràctiques recomanades.

Propietats de la clau

Propietat Descripció
Items La Persona(membres) preseleccionada per mostrar al Peoplepicker
Suggestions_Items Llista de membres suggerits dels que voleu triar. Aquesta és una propietat de conjunt de dades obligatòria
PeoplePickerType Tipus de PeoplePicker que s'utilitzarà.
MaxPeople Nombre màxim d'usuaris permesos per a la selecció
NoResultFoundMesage Missatge que es mostra si no es troba cap resultat basant-se en el text de cerca especificat.
MinimumSearchTermLength Longitud mínima del terme de cerca que s'introduirà abans de proporcionar els suggeriments.
SearchTermToShortMessage Missatge personalitzat que es mostrarà quan el text de cerca sigui inferior a MinimumSearchTermLength.
Error Per ressaltar el selector de persones en vermell per representar que té un cert error que requereix validació.
ShowSecondaryText Especifiqueu Sí o no, en funció de si es mostra o no el text secundari (per exemple, JobTitle).

Propietats dels Items

Propietat Descripció
PersonaName Nom de visualització de la persona.
PersonaKey La clau identifiqui l'element específic. La clau ha de ser única.
PersonaImgUrl Contingut de l'adreça URL o de Base64 de la imatge Persona (foto de perfil).
PersonaRole Text secundari, preferiblement JobTitle de la persona
PersonaPresence Opcional: Presència de la persona que es mostrarà; no es mostrarà la presència si no està definida. El valor hauria de ser d'una de les opcions següents: away, blockedbusy, dnd, noneoffline, online
PersonaOOF Opcional: Cert o Fals, segons si la persona si és fora de l'oficina o no.

Propietats dels Suggestions_Items

Propietat Descripció
SuggestionName Nom de visualització de la persona.
SuggestionKey La clau identifiqui l'element específic. La clau ha de ser única.
SuggestionImgUrl Contingut de l'adreça URL o de Base64 de la imatge Persona (foto de perfil).
SuggestionRole Text secundari, preferiblement JobTitle de la persona
SuggestionPresence Opcional: Presència de la persona que es mostrarà; no es mostrarà la presència si no està definida. El valor hauria de ser d'una de les opcions següents: away, blockedbusy, dnd, noneoffline, online
SuggestionOOF Opcional: Cert o Fals, segons si la persona si és fora de l'oficina o no.

Propietats addicionals

Propietat Descripció
Theme Accepta una cadena JSON generada mitjançant el Fluent UI Theme Designer (windows.net). Deixant aquest camp en blanc s'utilitzarà el tema per defecte definit per Power Apps.
AccessibilityLabel Etiqueta aria de lector de pantalla
InputEvent Una incidència que s'enviarà al control. Admet SetFocus com un InputEvent.

Exemples

PeoplePicker admet altres fonts des d'on es pot recuperar la col·lecció d'entrades. A continuació es presenten exemples sobre com utilitzar el component PeoplePicker.

Connector d'usuaris de l'Office 365

  1. Afegir el connector d'usuaris de l'Office 365 com a font de dades.

  2. Assigneu la fórmula del Power Fx a la propietat On Search del control per crear una col·lecció anomenada 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. Definiu la propietat Suggestions_Items com a UserCollection.

    Nota

    La fórmula anterior inclou una sol·licitud consecutiva per obtenir UserPhoto, la qual cosa augmenta el temps de càrrega. Si no necessiteu fotos i voleu reduir el temps de cerca, utilitzeu la fórmula següent a la propietat Suggestions_Items del control en comptes de UserCollection: 

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

En aquest moment el control està funcionant i els membres seleccionats es poden obtenir de la propietat SelectedPeople.

PeoplePicker1.SelectedPeople

Amb taules - Dataverse Usuaris Microsoft Entra o Usuaris

  1. Per configurar la propietat Suggestions_Items, especifiqueu el fragment de codi següent.

    Afegiu usuaris o usuaris específics (amb el codi següent) de la taula a la col·lecció d'elements (a la propietat Suggestions_Items) de PeoplePicker.

    - Taula AAD Users

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

    - Taula Users

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

  2. Assigneu les columnes segons la vostra necessitat mitjançant AddColumns(). A continuació es mostra un exemple de l'Assignació de propietats de columna:

    Nom de la propietat Columna de taula AADUser Columna de taula User
    SuggestionKey "mail" "internalemailaddress"
    SuggestionName "displayname" "fullname"
    SuggestionRole "jobtitle" "jobtitle"

En aquest moment, el selector de persones hauria d'estar funcionant i els membres seleccionats es poden obtenir de la propietat SelectedPeople.

PeoplePicker1.SelectedPeople

Limitacions

Aquest component del llenç només es pot utilitzar a les aplicacions del llenç i a les pàgines personalitzades.