GUID Функция

Келесілерге қолданылады: Кенеп бағдарламалары Copilot Studio Жұмыс үстелі ағындары Модельге негізделген бағдарламалар Power Platform CLI Dataverse функциялары

Жолды (жаһандық бірегей идентификатор) GUID мәнге түрлендіріңіз GUID немесе жаңа GUID мән жасаңыз.

Сипаттама

Функцияны a GUID оналтылық бейнесі бар жолды дерекқорға беруге болатын мәнге GUID түрлендіру үшін пайдаланыңызGUID. Microsoft Dataverse және SQL Server сияқты дерекқор жүйелері мәндерді кілт ретінде пайдаланады GUID .

Жолда үлкен немесе кіші әріптер болуы мүмкін, бірақ ол мына пішімдердің бірінде 32 оналтылық цифрдан тұруы керек:

• "123e4567-e89b-12d3-a456-426655440000" (стандартты орындардағы сызықшалар)
• "123e4567e89b12d3a456426655440000" (дефис жоқ)

Егер аргументті көрсетпесеңіз, функция жаңа GUID.

Мәнді GUID жолға түрлендіру үшін оны жол контекстінде пайдаланыңыз. GUID Мән дефистер мен кіші әріптермен оналтылық жолға түрлендіріледі.

Жаңасын GUIDқұру кезінде функция 4 IETF RFC 4122GUID нұсқасын жасау үшін псевдо-кездейсоқ сандарды пайдаланады. Жолды a GUID-ге түрлендіргенде, функция 32 он алтылық саннан тұратын кез-келген жолды қабылдау арқылы кез-келген GUID нұсқаны қолдайды.

Өзгермелі функциялар

GUID Бұл функция - бұл дәлелсіз пайдаланылған кезде құбылмалы функция. Функция есептелген сайын ол басқа мәнді қайтарады.

Деректер ағыны формуласында құбылмалы функцияны пайдаланғанда, формула қайта есептелсе ғана басқа мәнді қайтарады. Егер формулада басқа ештеңе өзгермесе, бағдарлама ашық болған кезде ол бірдей мәнді сақтайды.

Мысалы, жапсырма басқару элементінің Мәтін сипатын () мәнінеGUID орнатсаңыз, бағдарлама белсенді болған кезде ол өзгермейді. Бағдарламаны жауып, қайта ашқанда ғана басқа мәнге ие боласыз.

Функция басқа нәрсе өзгеретін формуланың бөлігі болса, қайта бағаланады. Мысалы, егер Жапсырма басқару элементінің Мәтін сипатын осы формулаға орнатсаңыз, пайдаланушы Мәтінді енгізу басқару элементінің мәнін өзгерткен сайын a GUID жасалады:

TextInput1.Text & " " & GUID()

Мінез-құлық формуласын пайдаланғандаGUID, формула есептелген сайын ол бағаланады. Қосымша ақпарат алу үшін осы тақырыпта кейінірек келетін мысалдарды қараңыз.

Синтаксис

GUID( [ GUIDString ] )

• GUIDstring – Қосымша. 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-ді көрсеткіңіз келмеуі мүмкін, бірақ GUID қолданбаны жөндеуге көмектеседі. Алдыңғы мысалда жасалған жазбадағы Күй өрісінің мәнін көрсету үшін Жапсырма басқару элементінің Мәтін сипатын мына формулаға орнатыңыз:

First( Products ).Status

Жапсырма басқару элементі f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4 көрсетеді.

GUID кестесін жасау

1. Түйме басқару элементінің OnSelect сипатын мына формулаға орнатыңыз:

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

   Бұл формула бес рет итерацияны орындау үшін (бұл бес GUID идентификаторына әкеледі) пайдаланылатын бір бағандық кестені жасайды.

2. Деректер кестесі басқару элементін қосыңыз, оның Элементтер сипатын NewGUIDs деп орнатыңыз және Мән өрісін көрсетіңіз.

3. Alt пернесін басып тұрып, түймешігін таңдаңыз.

   Деректер кестесі GUID идентификаторларының тізімін көрсетеді:

   

4. Жаңа GUID тізімін көрсету үшін батырманы қайтадан басыңыз:

   

Кестенің орнына жалғыз GUID құру үшін мына формуланы пайдаланыңыз:

Set( NewGUID, GUID() )