PeoplePicker नियंत्रण (पूर्वावलोकन)

[यह आलेख रिलीज़-पूर्व दस्तावेज़ है और परिवर्तन के अधीन है.]

लोडिंग अनुभव बनाने के लिए उपयोग किया जाने वाला नियंत्रण.

नोट

पूर्ण दस्तावेज़ीकरण और स्रोत कोड GitHub कोड घटक रिपॉजिटरी में मिला.

महत्त्वपूर्ण

• यह एक पूर्वावलोकन सुविधा है.
• पूर्वावलोकन सुविधाएँ उत्पादन में उपयोग के लिए नहीं होती हैं और इनकी कार्यक्षमता प्रतिबंधित हो सकती हैं. यह सुविधाएँ आधिकारिक रिलीज़ से पहले उपलब्ध होती हैं ताकि ग्राहक शीघ्र पहुँच प्राप्त कर सकें और प्रतिक्रिया प्रदान कर सकें.

विवरण

पीपुल पिकर (PeoplePicker) का उपयोग सूची से एक या अधिक संस्थाओं, जैसे लोगों या समूहों को चुनने के लिए किया जाता है. यदि आप किसी का पूरा नाम या ईमेल पता नहीं जानते हैं तो यह किसी को ईमेल लिखना या उन्हें समूह में जोड़ना आसान बनाता है.

यह कोड घटक कैनवास और कस्टम पृष्ठों में उपयोग के लिए Fluent UI PeoplePicker नियंत्रण के चारों ओर एक रैपर प्रदान करता है। सर्वोत्तम प्रथाओं के लिए घटक दस्तावेज़ीकरण देखें.

मुख्य गुण

गुण	विवरण
Items	Peoplepicker पर प्रदर्शित होने के लिए पूर्व-चयनित व्यक्तित्व(सदस्य)
Suggestions_Items	चुनने के लिए सुझाए गए सदस्यों की सूची. यह आवश्यक डेटासेट गुण है
PeoplePickerType	उपयोग किए जाने वाले Peoplepicker का प्रकार.
MaxPeople	चयन के लिए उपयोगकर्ताओं की अधिकतम संख्या की अनुमति दी जानी चाहिए
NoResultFoundMesage	यदि निर्दिष्ट खोज पाठ के आधार पर कोई परिणाम नहीं मिलता है तो दिखाया जाने वाला संदेश.
MinimumSearchTermLength	सुझाव देने से पहले न्यूनतम शब्द खोजें लंबाई दर्ज की जानी चाहिए.
SearchTermToShortMessage	खोज टेक्स्ट MinimumSearchTermLength से कम होने पर दिखाया जाने वाला कस्टम संदेश.
Error	पीपुल पिकर को लाल रंग में हाइलाइट करने के लिए यह दर्शाने के लिए कि इसमें कुछ त्रुटि है जिसके लिए सत्यापन की आवश्यकता है.
ShowSecondaryText	माध्यमिक पाठ (उदाहरण के लिए, जॉबटाइटल) दिखाया जाना है या नहीं, इस पर निर्भर करते हुए हां या नहीं निर्दिष्ट करें.

Items गुण

गुण	विवरण
PersonaName	व्यक्तित्व का डिस्प्ले नाम.
PersonaKey	कुंजी विशिष्ट आइटम की पहचान करती है. यह कुंजी अनूठी होना चाहिए.
PersonaImgUrl	व्यक्तित्व छवि की Url या Base64 सामग्री (प्रोफ़ाइल पिक्चर).
PersonaRole	माध्यमिक पाठ, अधिमानतः व्यक्तित्व का जॉबटाइटल
PersonaPresence	वैकल्पिक - प्रदर्शित करने के लिए व्यक्ति की उपस्थिति - अपरिभाषित होने पर उपस्थिति प्रदर्शित नहीं होगी. मान इनमें से कोई एक होना चाहिए: away, blocked, busy, dnd, none, offline, online
PersonaOOF	वैकल्पिक - सही या गलत, इस आधार पर कि व्यक्ति कार्यालय से बाहर है या नहीं.

Suggestions_Items गुण

गुण	विवरण
SuggestionName	व्यक्तित्व का डिस्प्ले नाम.
SuggestionKey	कुंजी विशिष्ट आइटम की पहचान करती है. यह कुंजी अनूठी होना चाहिए.
SuggestionImgUrl	व्यक्तित्व छवि की Url या Base64 सामग्री (प्रोफ़ाइल पिक्चर).
SuggestionRole	माध्यमिक पाठ, अधिमानतः व्यक्तित्व का जॉबटाइटल
SuggestionPresence	वैकल्पिक - प्रदर्शित करने के लिए व्यक्ति की उपस्थिति - अपरिभाषित होने पर उपस्थिति प्रदर्शित नहीं होगी. मान इनमें से कोई एक होना चाहिए: away, blocked, busy, dnd, none, offline, online
SuggestionOOF	वैकल्पिक - सही या गलत, इस आधार पर कि व्यक्ति कार्यालय से बाहर है या नहीं.

अतिरिक्त गुण

गुण	विवरण
Theme	Fluent UI थीम डिज़ाइनर (windows.net) का उपयोग करके उत्पन्न JSON स्ट्रिंग को स्वीकार करता है. इसे खाली छोड़ने से Power Apps द्वारा परिभाषित डिफ़ॉल्ट थीम का उपयोग किया जाएगा.
AccessibilityLabel	स्क्रीन पढ़ने वालों का आरिया-लेबल
InputEvent	नियंत्रण को भेजने के लिए एक इवेंट. SetFocus के रूप में InputEvent का समर्थन करता है.

उदाहरण

PeoplePicker अन्य स्रोतों का समर्थन करता है जहाँ से इनपुट संग्रह को पुनः प्राप्त किया जा सकता है. PeoplePicker घटक का उपयोग करने के तरीके के उदाहरण नीचे दिए गए हैं.

Office 365 उपयोगकर्ता कनेक्टर

1. डेटा स्रोत के रूप में Office 365 उपयोगकर्ता कनेक्टर जोड़ें.

2. नियंत्रण के ऑन सर्च गुण पर UserCollection नामक संग्रह बनाने के लिए नीचे दिया गया Power Fx फ़ॉर्मूला असाइन करें.

   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. Suggestions_Items गुण को UserCollection पर सेट करें.

   नोट

   उपरोक्त सूत्र में UserPhoto प्राप्त करने के लिए लगातार अनुरोध शामिल है, जो लोडिंग समय को बढ़ाता है. यदि आपको फ़ोटो की आवश्यकता नहीं है और खोज समय कम करना चाहते हैं, तो नियंत्रण के UserCollection के बजाय निम्न Suggestions_Items गुण का उपयोग करें:
   

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

इस बिंदु पर नियंत्रण कार्य कर रहा है और चयनित सदस्यों को SelectedPeople गुण से प्राप्त किया जा सकता है.

PeoplePicker1.SelectedPeople

तालिकाओं के साथ Dataverse - Microsoft Entra उपयोगकर्ता या उपयोगकर्ता

1. नीचे कोड स्निपेट निर्दिष्ट करके Suggestions_Items गुण सेट करें.

   तालिका से उपयोगकर्ता या विशिष्ट उपयोगकर्ता (नीचे दिए गए कोड का उपयोग करके) को PeoplePicker के आइटम संग्रह ( Suggestions_Items संपत्ति के अंतर्गत) में जोड़ें.

   -AAD Users तालिका

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

   -Users तालिका

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

2. AddColumns() का उपयोग करके अपनी आवश्यकता के अनुसार कॉलम मैप करें. नीचे कॉलम-प्रॉपर्टी मैपिंग का एक उदाहरण दिया गया है:

   गुण नाम	AADUser तालिका स्तंभ	उपयोगकर्ता तालिका स्तंभ
   SuggestionKey	"mail"	"internalemailaddress"
   SuggestionName	"displayname"	"fullname"
   SuggestionRole	"jobtitle"	"jobtitle"

इस बिंदु पर, पीपुल पिकर काम कर रहे होंगे और चयनित सदस्यों को चयनित लोगों की संपत्ति से प्राप्त किया जा सकता है.

PeoplePicker1.SelectedPeople

सीमाएँ

इस कैनवास घटक का उपयोग केवल कैनवास ऐप और कस्टम पृष्ठों में ही किया जा सकता है.