Freigeben über

PeoplePicker Kontrolle (Vorschauversion)

  • Artikel

[Dieser Artikel ist Teil der Dokumentation zur Vorschauversion und kann geändert werden.]

Ein Steuerelement, das verwendet wird, um eine Ladeerfahrung zu erstellen.

Notiz

Sie finden die vollständige Dokumentation und den Quellcode im GitHub-Codekomponenten-Repository.

PeoplePicker-Steuerelement.

Wichtig

  • Dies ist eine Vorschauversion.
  • Funktionen in der Vorschau sind nicht für den Produktionseinsatz gedacht und können eine eingeschränkte Funktionalität aufweisen. Diese Funktionen stehen vor der offiziellen Veröffentlichung zur Verfügung, damit Kunden frühzeitig Zugriff erhalten und Feedback geben können.

Beschreibung des Dataflows

Die Personenauswahl (PeoplePicker) wird verwendet, um eine oder mehrere Entitäten wie Personen oder Gruppen aus einer Liste auszuwählen. Es macht es einfach, eine E-Mail an jemanden zu verfassen oder ihn einer Gruppe hinzuzufügen, wenn Sie seinen vollständigen Namen oder seine E-Mail-Adresse nicht kennen.

Diese Codekomponente stellt einen Wrapper um das Fluent-Benutzeroberfläche PeoplePicker Steuerelement zur Verwendung in Canvas-Apps und benutzerdefinierten Seiten bereit. Siehe Komponentendokumentation für bewährte Methoden.

Schlüsseleigenschaften

Eigenschaften Beschreibung des Dataflows
Items Die vorausgewählte Persona(Mitglieder), die auf Peoplepicker erscheinen sollen
Suggestions_Items Liste der vorgeschlagenen Mitglieder zur Auswahl. Dies ist eine erforderliche DataSet-Eigenschaft
PeoplePickerType Typ des zu verwendenden PeoplePicker.
MaxPeople Maximale Anzahl von Benutzern, die für die Auswahl zulässig sind
NoResultFoundMesage Meldung, die angezeigt werden soll, wenn basierend auf dem angegebenen Suchtext kein Ergebnis gefunden wird.
MinimumSearchTermLength Mindestlänge des Suchbegriffs, die eingegeben werden muss, bevor die Vorschläge bereitgestellt werden.
SearchTermToShortMessage Benutzerdefinierte Nachricht, die angezeigt wird, wenn der Suchtext kleiner ist als MinimumSearchTermLength
Error Um die Personenauswahl rot hervorzuheben, um darzustellen, dass ein bestimmter Fehler vorliegt, der überprüft werden muss.
ShowSecondaryText Geben Sie Ja oder Nein an, je nachdem, ob der Sekundärtext (z. B. JobTitle) angezeigt werden soll oder nicht.

Items Eigenschaften

Eigenschaften Beschreibung des Dataflows
PersonaName Anzeigenname der Persona.
PersonaKey Der Schlüssel identifiziert den spezifischen Artikel. Die Taste muss eindeutig sein.
PersonaImgUrl URL oder Base64-Inhalt des Persona-Bildes (Profilbild).
PersonaRole Sekundärtext, vorzugsweise JobTitle der Persona
PersonaPresence Optional – Anwesenheit der anzuzeigenden Person – Anwesenheit wird nicht angezeigt, wenn nicht definiert. Wert muss einer der folgenden sein: away, blocked, busy, dnd, none, offline, online
PersonaOOF Optional – Wahr oder Falsch, basierend darauf, ob die Persona im Büro ist oder nicht.

Suggestions_Items Eigenschaften

Eigenschaften Beschreibung des Dataflows
SuggestionName Anzeigenname der Persona.
SuggestionKey Der Schlüssel identifiziert den spezifischen Artikel. Die Taste muss eindeutig sein.
SuggestionImgUrl URL oder Base64-Inhalt des Persona-Bildes (Profilbild).
SuggestionRole Sekundärtext, vorzugsweise JobTitle der Persona
SuggestionPresence Optional – Anwesenheit der anzuzeigenden Person – Anwesenheit wird nicht angezeigt, wenn nicht definiert. Wert muss einer der folgenden sein: away, blocked, busy, dnd, none, offline, online
SuggestionOOF Optional – Wahr oder Falsch, basierend darauf, ob die Persona im Büro ist oder nicht.

Zusätzliche Eigenschaften

Eigenschaften Beschreibung des Dataflows
Theme Akzeptiert eine JSON-Zeichenfolge, die mithilfe des Fluent-UI-Themen-Designers (windows.net) generiert wird. Wenn Sie dieses Feld leer lassen, wird das in Power Apps definierte Standarddesign verwendet.
AccessibilityLabel Aria-Beschriftung für Sprachausgabe
InputEvent Ein Ereignis, das an das Steuerelement gesendet werden soll. Unterstützt SetFocus als InputEvent.

Beispiele

PeoplePicker unterstützt andere Quellen, aus denen die Eingabesammlung abgerufen werden kann. Im folgenden sind die Beispiele, wie die PeoplePicker-Komponente verwendet wird.

Office 365 Benutzerkonnektor

  1. Den Office 365 Benutzerkonnektor als Datenquelle hinzufügen.

  2. Weisen Sie die nachfolgende Power Fx Formel der Eigenschaft Suche Ein des Steuerelements zu, um eine Sammlung namens UserCollection zu erstellen.

    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. Setzen Sie die Eigenschaft Suggestions_Items auf UserCollection.

    Notiz

    Die obige Formel beinhaltet eine fortlaufende Anfrage zum Abrufen von UserPhoto, was die Ladezeit verlängert. Wenn Sie keine Fotos benötigen und die Suchzeit verkürzen möchten, verwenden Sie die folgende Formel in der Eigenschaft Suggestions_Items des Steuerelements anstelle von UserCollection:

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

An diesem Punkt funktioniert die Kontrolle und ausgewählte Mitglieder können von der SelectedPeople Eigenschaft abgerufen werden.

PeoplePicker1.SelectedPeople

Mit Dataverse-Tabellen – Microsoft Entra-Benutzer oder Benutzer

  1. Richten Sie die Suggestions_Items Eigenschaft durch Angabe des folgenden Codes Ausschnittes ein.

    Fügen Sie Benutzer oder bestimmte Benutzer (unter Verwendung des folgenden Codes) aus der Tabelle zur Artikelsammlung hinzu (unter Suggestions_Items Eigenschaft) von PeoplePicker.

    -AAD Users Tisch

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

    -Users Tisch

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

  2. Ordnen Sie die Spalten nach Bedarf mit AddColumns() zu. Nachfolgend finden Sie ein Beispiel für die Zuordnung von Spalteneigenschaften:

    Eigenschaftsname AADUser Tabellenspalte Benutzer-Tabellenspalte
    SuggestionKey „Mail“ „internalemailaddress“
    SuggestionName "displayname" „fullname“
    SuggestionRole „jobtitle“ "jobtitle"

An diesem Punkt sollte die Personenauswahl funktionieren und die ausgewählten Mitglieder können von SelectedPeople Eigenschaft abgerufen werden.

PeoplePicker1.SelectedPeople

Einschränkungen

Diese Canvas-Komponente kann nur in Canvas-Apps und benutzerdefinierten Seiten verwendet werden.