PeoplePicker έλεγχος (έκδοση προεπισκόπησης)

Άρθρο
03/21/2023

[Αυτό το άρθρο αποτελεί τεκμηρίωση προέκδοσης και ενδέχεται να αλλάξει.]

Ένα στοιχείο ελέγχου που χρησιμοποιείται για τη δημιουργία μιας εμπειρίας φόρτωσης.

Σημείωμα

Βρέθηκε πλήρης τεκμηρίωση και πηγαίος κώδικας στο αρχείο φύλαξης στοιχείων κωδικών GitHub.

Στοιχείο ελέγχου PeoplePicker.

Σημαντικό

Αυτή είναι μια δυνατότητα προεπισκόπησης.
Οι λειτουργίες προεπισκόπησης δεν προορίζονται για παραγωγική χρήση και ενδέχεται να έχουν περιορισμένη λειτουργικότητα. Αυτές οι δυνατότητες είναι διαθέσιμες πριν από μια επίσημη κυκλοφορία έτσι ώστε οι πελάτες να έχουν πρόσβαση από νωρίς και να κάνουν σχόλια.

Description

Ο επιλογέα ατόμων (PeoplePicker) χρησιμοποιείται για την επιλογή μίας ή περισσότερων οντοτήτων, όπως ατόμων ή ομάδων, από μια λίστα. Διευκολύνει τη σύνταξη ενός μηνύματος ηλεκτρονικού ταχυδρομείου σε κάποιον ή την προσθήκη του σε μια ομάδα, εύκολη αν δεν γνωρίζετε το πλήρες όνομα ή τη διεύθυνση ηλεκτρονικού ταχυδρομείου του.

Αυτό το στοιχείο κώδικα παρέχει ένα πρόγραμμα περιτύλιξης γύρω από το στοιχείο ελέγχου περιβάλλοντος εργασίας χρήστη Fluent UI PeoplePicker για χρήση σε εφαρμογές καμβά και προσαρμοσμένες σελίδες. Ανατρέξτε στην τεκμηρίωση στοιχείων για βέλτιστες πρακτικές.

Ιδιότητες κλειδιού

Ιδιότητα	Description
`Items`	Τα προεπιλεγμένα άτομα(μέλη) που θα εμφανίζονται στο PeoplePicker
`Suggestions_Items`	Λίστα των προτεινόμενων μελών από τα οποία μπορείτε να επιλέξετε. Αυτή είναι μια απαιτούμενη ιδιότητα συνόλου δεδομένων
`PeoplePickerType`	Τύπος Peoplepicker για να χρησιμοποιηθεί.
`MaxPeople`	Μέγιστος αριθμός χρηστών για να επιτραπεί για επιλογή
`NoResultFoundMesage`	Μήνυμα προς εμφάνιση εάν δεν βρεθεί αποτέλεσμα με βάση το καθορισμένο κείμενο αναζήτησης.
`MinimumSearchTermLength`	Ελάχιστο μήκος όρου αναζήτησης για καταχώρηση πριν από την παροχή των προτάσεων.
`SearchTermToShortMessage`	Προσαρμοσμένο μήνυμα που θα εμφανίζεται όταν το κείμενο αναζήτησης είναι μικρότερο από το MinimumSearchTermLength.
`Error`	Για να επισημάνετε με κόκκινο τον επιλογέα ατόμων για να αναπαρασταθεί ότι έχει κάποιο σφάλμα που απαιτούσε επικύρωση.
`ShowSecondaryText`	Καθορίστε Ναι ή Όχι, ανάλογα με το εάν θα εμφανίζεται ή όχι το Δευτερεύον κείμενο (για παράδειγμα, JobTitle).

`Items` Καταλύματα

Ιδιότητα	Description
`PersonaName`	Εμφανιζόμενο όνομα της εικονικής προσωπικότητας.
`PersonaKey`	Το κλειδί προσδιορίζει το συγκεκριμένο στοιχείο. Τα κλειδί πρέπει να είναι μοναδικό.
`PersonaImgUrl`	Περιεχόμενο διεύθυνσης Url ή Base64 της εικόνας εικονικής προσωπικότητας (Εικόνα προφίλ).
`PersonaRole`	Δευτερεύον κείμενο, κατά προτίμηση jobTitle της εικονικής προσωπικότητας
`PersonaPresence`	Προαιρετικό - Η παρουσία του ατόμου που θα εμφανιστεί - δεν θα εμφανίζει την παρουσία αν δεν έχει οριστεί. Η τιμή πρέπει να περιλαμβάνει ένα από τα εξής: `away`, `blocked`, `busydnd`, `none`, `offline`, `online`
`PersonaOOF`	Προαιρετικό - Αληθές ή Ψευδές, Ανάλογα με το εάν η εικονική προσωπικότητα είναι εκτός γραφείου ή όχι.

`Suggestions_Items` Καταλύματα

Ιδιότητα	Description
`SuggestionName`	Εμφανιζόμενο όνομα της εικονικής προσωπικότητας.
`SuggestionKey`	Το κλειδί προσδιορίζει το συγκεκριμένο στοιχείο. Τα κλειδί πρέπει να είναι μοναδικό.
`SuggestionImgUrl`	Περιεχόμενο διεύθυνσης Url ή Base64 της εικόνας εικονικής προσωπικότητας (Εικόνα προφίλ).
`SuggestionRole`	Δευτερεύον κείμενο, κατά προτίμηση jobTitle της εικονικής προσωπικότητας
`SuggestionPresence`	Προαιρετικό - Η παρουσία του ατόμου που θα εμφανιστεί - δεν θα εμφανίζει την παρουσία αν δεν έχει οριστεί. Η τιμή πρέπει να περιλαμβάνει ένα από τα εξής: `away`, `blocked`, `busydnd`, `none`, `offline`, `online`
`SuggestionOOF`	Προαιρετικό - Αληθές ή Ψευδές, Ανάλογα με το εάν η εικονική προσωπικότητα είναι εκτός γραφείου ή όχι.

Πρόσθετες ιδιότητες

Ιδιότητα	Description
`Theme`	Αποδέχεται μια συμβολοσειρά JSON που δημιουργείται με τη χρήση της Σχεδίασης θέματος περιβάλλοντος εργασίας χρήστη Fluent (windows.net). Αν αφήσετε αυτό το κενό, θα χρησιμοποιηθεί το προεπιλεγμένο θέμα που ορίζεται από το Power Apps.
`AccessibilityLabel`	Ετικέτα aria προγράμματος ανάγνωσης οθόνης
`InputEvent`	Ένα συμβάν για αποστολή στο στοιχείο ελέγχου. Υποστηρίζει το SetFocus ως `InputEvent`.

Παραδείγματα

PeoplePicker Υποστηρίζει άλλες πηγές από όπου μπορεί να ανακτηθεί η συλλογή δεδομένων. Ακολουθούν τα παραδείγματα για τον τρόπο χρήσης του στοιχείου PeoplePicker.

Σύνδεση χρηστών Office 365

Προσθέστε τη σύνδεση Office 365 ως προέλευση δεδομένων.

Αναθέστε τον παρακάτω τύπο Power Fx στην ιδιότητα Σε αναζήτηση του στοιχείου ελέγχου για να δημιουργήσετε μια συλλογή που ονομάζεται 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"
    )
)

Ορίστε την ιδιότητα Suggestions_Items σεUserCollection.

Σημείωμα

Ο παραπάνω τύπος περιλαμβάνει μια διαδοχική αίτηση για λήψη του UserPhoto, που αυξάνει τον χρόνο φόρτωσης. Εάν δεν χρειάζεστε φωτογραφίες και θέλετε να μειώσετε τον χρόνο αναζήτησης, χρησιμοποιήστε τον παρακάτω τύπο στην ιδιότητα Suggestions_Items του στοιχείου ελέγχου αντί για UserCollection:
```
AddColumns(
    Office365Users.SearchUser({ searchTerm: Self.SearchText, top: 500 }),
    "SuggestionKey", Mail, 
    "SuggestionName", DisplayName,
    "SuggestionRole", JobTitle
)
```

Σε αυτό το σημείο, το στοιχείο ελέγχου λειτουργεί και είναι δυνατό να ληφθούν επιλεγμένα μέλη από την ιδιότητα SelectedPeople.

PeoplePicker1.SelectedPeople

Με τους πίνακες Dataverse - Χρήστες AAD ή χρήστες Microsoft Entra

Ρυθμίστε την ιδιότητα Suggestions_Items καθορίζοντας το παρακάτω τμήμα κώδικα.

Προσθέστε χρήστες ή συγκεκριμένους χρήστες (χρησιμοποιώντας τον παρακάτω κώδικα) από τον πίνακα στη συλλογή στοιχείων (κάτω από την ιδιότητα Suggestions_Items) του PeoplePicker.

-AAD Users τραπέζι
```
Search('AAD Users', Self.SearchText,"displayname" ,"mail")
```
-Users τραπέζι
```
Search('Users', Self.SearchText,"fullname","internalemailaddress")
```

Αντιστοιχίστε τις στήλες σύμφωνα με τις ανάγκες σας χρησιμοποιώντας το AddColumns(). Ακολουθεί ένα παράδειγμα αντιστοίχισης στηλών-ιδιοτήτων:

Όνομα ιδιότητας	Στήλη πίνακα AADUser	Στήλη πίνακα χρήστη
SuggestionKey	"mail"	"internalemailaddress"
SuggestionName	"displayname"	"fullname"
SuggestionRole	"jobtitle"	"jobtitle"

Στο σημείο αυτό, ο επιλογέας ατόμων θα πρέπει να λειτουργεί και τα επιλεγμένα μέλη μπορούν να ληφθούν από την ιδιότητα SelectedPeople.

PeoplePicker1.SelectedPeople

Περιορισμοί

Αυτό το στοιχείο καμβά μπορεί να χρησιμοποιηθεί μόνο σε εφαρμογές καμβά, προσαρμοσμένες σελίδες.

Κοινή χρήση μέσω

PeoplePicker έλεγχος (έκδοση προεπισκόπησης)

Description

Ιδιότητες κλειδιού

`Items` Καταλύματα

`Suggestions_Items` Καταλύματα

Πρόσθετες ιδιότητες

Παραδείγματα

Σύνδεση χρηστών Office 365

Με τους πίνακες Dataverse - Χρήστες AAD ή χρήστες Microsoft Entra

Περιορισμοί

Σχόλια

Πρόσθετοι πόροι

Κοινή χρήση μέσω

PeoplePicker έλεγχος (έκδοση προεπισκόπησης)

Description

Ιδιότητες κλειδιού

Items Καταλύματα

Suggestions_Items Καταλύματα

Πρόσθετες ιδιότητες

Παραδείγματα

Σύνδεση χρηστών Office 365

Με τους πίνακες Dataverse - Χρήστες AAD ή χρήστες Microsoft Entra

Περιορισμοί

Σχόλια

Πρόσθετοι πόροι

`Items` Καταλύματα

`Suggestions_Items` Καταλύματα