GUID функциясы
Қолданылады: Canvas қолданбалары Жұмыс үстелі ағындары Үлгіге негізделген қолданбалар Power Platform CLI
GUID (глобалдық бірегей идентификатор) жолын GUID мәніне түрлендіреді немесе жаңа GUID мәнін жасайды.
Сипаттама
GUID функциясын GUID идентификаторының он алтылық көрінісін қамтитын жолды дерекқорға өткізуге болатын GUID мәніне түрлендіру үшін пайдаланыңыз. GUID мәндерін сияқты Microsoft Dataverse және SQL Server сияқты дерекқор жүйелері кілттер ретінде пайдаланады.
Өткізілген жол жоғарғы регистрдегі немесе төменгі регистрдегі әріптерді қамти алады, бірақ ол мына пішімдердегі 32 он алтылық цифрлар болуы керек:
- "123e4567-e89b-12d3-a456-426655440000" (стандартты орындардағы сызықшалар)
- "123e4567e89b12d3a456426655440000" (дефис жоқ)
Аргументті көрсетпесеңіз, бұл функция жаңа GUID жасайды.
GUID мәнін жолға түрлендіру үшін бар болғаны оны жол контекстінде пайдаланыңыз. GUID мәні сызықшалар және төменгі регистрдегі әріптер бар он алтылық көріністегі жолға түрлендіріледі.
Жаңа GUID жасау кезінде бұл функция 4 нұсқалы IETF RFC 4122 GUID жасау үшін жалған кездейсоқ сандарды пайдаланады. Жолды GUID функциясына түрлендіру кезінде бұл функция 32 он алтылық цифрдан тұратын кез келген жолды қабылдау арқылы кез келген GUID нұсқасын қолдайды.
Өзгермелі функциялар
GUID аргументсіз пайдаланылғанда өзгермелі функция болып табылады. Функция есептелген сайын ол басқа мәнді қайтарады.
Деректер ағыны формуласында пайдаланғанда, өзгермелі функция өзі орналасқан формула қайта есептелсе ғана басқа мәнді қайтарады. Егер формулада басқа ештеңе өзгермесе, ол бағдарламаңыздың орындалуының бүкіл барысында бір мәнге ие болады.
Мысалы, Мәтін сипаты GUID() деп орнатылған белгі басқару элементі бағдарламаңыз белсенді кезде өзгермейді. Тек бағдарламаны жабу және қайта ашу басқа мәнге әкеледі.
Функция басқа бірдеңе өзгерген формуланың бөлігі болса қайта есептеледі. Мысалы, Белгі басқару элементінің Мәтін сипатын осы формулаға орнатсақ, GUID пайдаланушы Мәтінді енгізу басқару элементінің мәнін өзгерткен сайын жасалады:
TextInput1.Мәтін & " " & 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 кестесін жасау
Түйме басқару элементінің OnSelect сипатын мына формулаға орнатыңыз:
ClearCollect( NewGUIDs, ForAll( Sequence(5), GUID() ) )
Бұл формула бес рет итерацияны орындау үшін (бұл бес GUID идентификаторына әкеледі) пайдаланылатын бір бағандық кестені жасайды.
Деректер кестесі басқару элементін қосыңыз, оның Элементтер сипатын NewGUIDs деп орнатыңыз және Мән өрісін көрсетіңіз.
Alt пернесін басып тұрып, басу немесе түрту арқылы түймешікті таңдаңыз.
Деректер кестесі GUID идентификаторларының тізімін көрсетеді:
GUID идентификаторларының басқа тізімін көрсету үшін түймені қайтадан таңдаңыз:
Кесте орнына бір GUID жасау үшін мына формуланы пайдаланыңыз:
Set( NewGUID, GUID() )