Freigeben über

PeoplePicker-Steuerelement (Vorschauversion)

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

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

Notiz

Vollständige Dokumentation und Quellcode finden Sie im GitHub-Codekomponenten-Repository.

PeoplePicker-Steuerelement.

Wichtig

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

Beschreibung

Mit der Personenauswahl (PeoplePicker) können Sie eine oder mehrere Entitäten wie Personen oder Gruppen aus einer Liste auswählen. Dadurch wird das Verfassen einer E-Mail an eine andere Person oder das Hinzufügen zu einer Gruppe vereinfacht, wenn Sie den vollständigen Namen oder die E-Mail-Adresse nicht kennen.

Diese Codekomponente bietet einen Wrapper um das Fluent UI PeoplePicker-Steuerelement für die Verwendung in Canvas und benutzerdefinierten Seiten. In der Komponentendokumentation finden Sie bewährte Methoden.

Schlüsseleigenschaften

Eigenschaften Beschreibung
Items Die vorausgewählte Persona(Mitglieder), die in der Personenauswahl angezeigt werden sollen.
Suggestions_Items Liste der vorgeschlagenen Mitglieder, aus der Sie auswählen können. Dies ist eine erforderliche Dataseteigenschaft.
PeoplePickerType Personenauswahltyp, der verwendet werden soll.
MaxPeople Maximale Anzahl von Benutzern, die für die Auswahl zulässig sind.
NoResultFoundMesage Meldung, die angezeigt werden soll, wenn kein Ergebnis basierend auf dem angegebenen Suchtext 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 Markieren Sie die Personenauswahl rot, um anzugeben, dass sie einen Fehler aufweist, der eine Überprüfung erfordert.
ShowSecondaryText Geben Sie "Ja" oder "Nein" an, je nachdem, ob der sekundäre Text (z. B. JobTitle) angezeigt werden soll oder nicht.

Element-Eigenschaften

Eigenschaften Beschreibung
PersonaName Anzeigename der Persona.
PersonaKey Der Schlüssel identifiziert das bestimmte Element und muss eindeutig sein.
PersonaImgUrl URL oder Base64-Inhalt des Persona-Bildes (Profilbild).
PersonaRole Sekundärer Text, vorzugsweise JobTitle der Persona.
PersonaPresence (Optional) Anwesenheit der anzuzeigenden Person. Anwesenheitsinformationen werden nicht angezeigt, wenn sie nicht definiert sind. Der Wert kann entweder away, blocked, busy, dnd, none, offline oder online sein.
PersonaOOF (Optional) Wahr oder Falsch, basierend darauf, ob die Person abwesend ist oder nicht.

Suggestions_Items-Eigenschaften

Eigenschaften Beschreibung
SuggestionName Anzeigename der Persona.
PersonaKey Der Schlüssel identifiziert das bestimmte Element und muss eindeutig sein.
SuggestionImgUrl URL oder Base64-Inhalt des Persona-Bildes (Profilbild).
SuggestionRole Sekundärer Text, vorzugsweise JobTitle der Persona.
SuggestionPresence (Optional) Anwesenheit der anzuzeigenden Person. Anwesenheitsinformationen werden nicht angezeigt, wenn sie nicht definiert sind. Der Wert kann entweder away, blocked, busy, dnd, none, offline oder online sein.
PersonaOOF (Optional) Wahr oder falsch, basierend darauf, ob die Person abwesend ist oder nicht.

Zusätzliche Eigenschaften

Eigenschaften Beschreibung
Theme Akzeptiert eine JSON-Zeichenfolge, die mithilfe des Fluent UI Themen-Designers (windows.net) generiert wird. Wenn sie leer gelassen wird, wird das von 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

Die PeoplePicker Komponente unterstützt zusätzliche Quellen zum Abrufen der Eingabeauflistung. Im Folgenden sind Beispiele für die Verwendung der Komponente aufgeführt.

Office 365 Benutzer-Konnektor

  1. Den Office 365 Benutzerkonnektor als Datenquelle hinzufügen

  2. Weisen Sie der On Search-Eigenschaft des Steuerelements eine Power Fx-Formel zu, um eine Auflistung namens UserCollectionzu 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. Wenn Sie keine Fotos verwenden, legen Sie die Suggestions_Items Eigenschaft optional auf UserCollection.

    Die Formel enthält eine aufeinander folgende Anforderung zum Abrufen von UserPhoto, wodurch die Ladezeit erhöht wird. Wenn Sie keine Fotos benötigen und die Suchzeit verringern möchten, verwenden Sie die folgende Formel in der Suggestions_Items Eigenschaft des Steuerelements anstelle von UserCollection:

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

An diesem Punkt funktioniert das Steuerelement, und ausgewählte Mitglieder können von der SelectedPeople Eigenschaft abgerufen werden.

PeoplePicker1.SelectedPeople

Mit Dataverse-Tabellen (Microsoft Entra Benutzer oder Benutzer)

  1. Legen Sie die Suggestions_Items Eigenschaft fest.

    Fügen Sie Benutzer oder spezifische Benutzer aus der Tabelle zur Elementesammlung (unter Suggestions_Items Eigenschaft) von PeoplePicker hinzu.

    • Tabelle AAD Users:

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

    • Tabelle Users:

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

  2. Ordnen Sie die Spalten entsprechend Ihrem Bedarf mit AddColumns() neu. Hier 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 der SelectedPeople-Eigenschaft abgerufen werden.

PeoplePicker1.SelectedPeople

Einschränkungen

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

  • Last updated on