GUID फलन

इस पर लागू होता है: कैनवास ऐप्लिकेशन Copilot Studio Desktop flows मॉडल-चालित ऐप्लिकेशन Power Platform CLI Dataverse फ़ंक्शंस

किसी (GUIDवैश्विक रूप से अद्वितीय पहचानकर्ता) स्ट्रिंग को मान GUID में कनवर्ट करें या कोई नया GUID मान बनाएँ.

वर्णन

एक के GUID हेक्साडेसिमल प्रतिनिधित्व के साथ एक स्ट्रिंग को एक मान GUID में बदलने के लिए फ़ंक्शन का GUID उपयोग करें जिसे आप डेटाबेस में पास कर सकते हैं। Microsoft Dataverse और SQL Server जैसे डेटाबेस सिस्टम कुंजी के रूप में मानों का उपयोग करते GUID हैं।

स्ट्रिंग में अपरकेस या लोअरकेस अक्षर हो सकते हैं, लेकिन इनमें से किसी एक प्रारूप में यह 32 हेक्साडेसिमल अंक होना चाहिए:

• "123e4567-e89b-12d3-a456-426655440000" (मानक स्थानों में हाइफ़न)
• "123e4567e89b12d3a456426655440000" (कोई हाइफ़न नहीं)

यदि आप कोई तर्क निर्दिष्ट नहीं करते हैं, तो फ़ंक्शन एक नया GUID.

किसी मान GUID को स्ट्रिंग में बदलने के लिए, इसे स्ट्रिंग संदर्भ में उपयोग करें। GUID मान हाइफ़न और लोअरकेस अक्षरों के साथ एक हेक्साडेसिमल स्ट्रिंग में परिवर्तित हो जाता है।

एक नया GUIDउत्पन्न करते समय, फ़ंक्शन संस्करण 4 आईईटीएफ आरएफसी 4122GUID बनाने के लिए छद्म-यादृच्छिक संख्याओं का उपयोग करता है। एक स्ट्रिंग को ए में GUIDपरिवर्तित करते समय, फ़ंक्शन 32 हेक्साडेसिमल अंकों की किसी भी स्ट्रिंग को स्वीकार करके किसी भी GUID संस्करण का समर्थन करता है।

अस्थिर फ़ंक्शन

GUID एक अस्थिर फ़ंक्शन है जब एक तर्क के बिना उपयोग किया जाता है। हर बार जब फ़ंक्शन का मूल्यांकन किया जाता है, तो यह एक अलग मान देता है.

जब आप डेटा-प्रवाह सूत्र में एक वाष्पशील फ़ंक्शन का उपयोग करते हैं, तो यह केवल तभी एक अलग मान लौटाता है जब सूत्र का पुनर्मूल्यांकन किया जाता है। यदि सूत्र में कुछ और नहीं बदलता है, तो यह आपके ऐप के खुले रहने पर समान मान रखता है।

उदाहरण के लिए, अगर आप लेबल नियंत्रण की टेक्स्ट प्रॉपर्टी को () परGUID सेट करते हैं, तो आपके ऐप्लिकेशन के सक्रिय रहने के दौरान यह नहीं बदलता है. आपको एक अलग मूल्य तभी मिलता है जब आप ऐप को बंद करते हैं और फिर से खोलते हैं।

फ़ंक्शन का पुनर्मूल्यांकन किया जाता है यदि यह एक सूत्र का हिस्सा है जहां कुछ और बदलता है। उदाहरण के लिए, यदि आप किसी लेबल नियंत्रण के पाठ गुण को इस सूत्र पर सेट करते हैं, तो प्रत्येक बार जब उपयोगकर्ता पाठ इनपुट नियंत्रण का मान परिवर्तित करता है, तो एक जनरेट GUID होता है:

पाठइनपुट 1. पाठ और " और GUID()

जब आप किसी व्यवहार सूत्र में उपयोग करते GUID हैं, तो हर बार सूत्र का मूल्यांकन करने पर इसका मूल्यांकन किया जाता है. अधिक जानकारी के लिए, इस विषय में आगे दिए गए उदाहरण देखें.

सिंटैक्स

GUID( [ GUIDString ] )

• GUIDString – वैकल्पिक. एक टेक्स्ट स्ट्रिंग जिसमें a का GUIDहेक्साडेसिमल प्रतिनिधित्व होता है। यदि आप एक स्ट्रिंग की आपूर्ति नहीं करते हैं, तो फ़ंक्शन एक नया GUIDबनाता है।

GUID( गतिशील )

• गतिशील - आवश्यक। गतिशील मान जो एक का GUIDप्रतिनिधित्व करता है। स्वीकार्य मान टाइप न किए गए प्रदाता पर निर्भर करते हैं। JSON के लिए, गतिशील मान को JSON स्ट्रिंग के रूप में दर्शाए जाने GUID की उम्मीद है।

उदाहरण

मूल उपयोग

हेक्साडेसिमल स्ट्रिंग प्रतिनिधित्व के आधार पर एक GUID मान वापस करने के लिए:

GUID( "0f8fad5b-d9cb-469f-a165-70867728950e" )

आप बिना हाइफ़न के स्ट्रिंग भी GUID प्रदान कर सकते हैं। यह सूत्र समान GUID मान लौटाता है:

GUID( "0f8fad5bd9cb469fa16570867728950e" )

इस संदर्भ में उपयोग किया जाता है, नए डेटाबेस रिकॉर्ड की स्थिति फ़ील्ड को अच्छे से स्थापित मान पर सेट करने के लिए:

Patch( Products, Default( Products ), { Status: GUID( "F9168C5E-CEB2-4faa-B6BF-329BF39FA1E4" ) } )

आप शायद उपयोगकर्ताओं को GUID नहीं दिखाना चाहते हैं, लेकिन GUIDs आपके ऐप को डीबग करने में आपकी मदद कर सकते हैं। पिछले उदाहरण में आपके द्वारा बनाए गए रिकॉर्ड में स्थिति फ़ील्ड का मान दिखाने के लिए, किसी लेबल नियंत्रण का पाठ गुण को इस सूत्र पर सेट करें:

First( Products ).Status

लेबल नियंत्रण f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4 दिखाता है।

GUID की एक तालिका बनाएँ

1. बटन नियंत्रण के OnSelect गुण को इस सूत्र पर सेट करें:

   ClearCollect( NewGUIDs, ForAll( Sequence(5), GUID() ) )
   

   यह सूत्र एकल-स्तंभ तालिका बनाता है, जिसका उपयोग पाँच बार पुनरावृत्ति करने के लिए किया जाता है, जिसके परिणामस्वरूप पाँच GUID बनते हैं.

2. एक डेटा तालिका नियंत्रण जोड़ें, उसके आइटम गुण को NewGUIDs पर सेट करें और मान फ़ील्ड दिखाएँ.

3. Alt कुंजी दबाए रखें और बटन का चयन करें।

   डेटा तालिका GUID की सूची दिखाती है:

   

4. GUIDs की नई सूची दिखाने के लिए फिर से बटन का चयन करें:

   

किसी तालिका के बजाय एकल GUID जनरेट करने के लिए, इस सूत्र का उपयोग करें:

Set( NewGUID, GUID() )