Функция за GUID

Статия
03/22/2024

Отнася се за: Приложения за платно Потоци на работния плот Приложения, управлявани Power Platform от модел CLI

Преобразува GUID (Globally Unique Identifier) низ в 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, тази функция поддържа всяка GUID версия, като приема всеки низ от 32 шестнадесетични цифри.

Нестабилни функции

GUID е променлива функция, когато се използва без аргумент. Всеки път, когато функцията се оценява, тя връща различна стойност.

Когато се използва във формула на потока от данни, летливата функция ще върне различна стойност само ако формулата, в която се появява, е преоценена. Ако нищо друго не се промени във формулата, то тя ще има една и съща стойност по време на изпълнението на приложението ви.

Например, контрол на етикета, за който Текст свойството е настроено на GUID() няма да се промени, докато приложението ви е активно. Само затварянето и повторното отваряне на приложението ще доведе до различна стойност.

Функцията ще бъде преоценена, ако е част от формула, в която се е променило нещо друго. Ако зададем свойството Текст на етикет контрола върху тази формула, например, GUID се генерира всеки път, когато потребителят промени стойността на Въвеждане на текст контрола на:

TextInput1.Text & " " & GUID()

Когато се използва във формула на поведение, GUID ще бъде оценяван всеки път когато се оценява формула. За повече информация вижте примерите по-надолу в тази тема.

Синтаксис

GUID( [ GUIDString ] )

GUIDString – По избор. Текстов низ, който съдържа шестнадесетично представяне на GUID. Ако не е предоставен низ, се създава нов GUID.

GUID ( невъведен)

Невъведено - Задължително. Нетипизиран обект , който представлява GUID. Приемливите стойности зависят от нетипизирания доставчик. За JSON, нетипизираният обект се очаква да бъде GUID, представен като JSON низ.

Примери

Основна употреба

За да върнете 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 натиснат, изберете бутона, като щракнете върху него или го докоснете.

Таблицата с данни показва списък с GUIDs:
Изберете бутона отново, за да се покаже различен списък с GUIDs:

За да генерирате единичен GUID вместо таблица, използвайте тази формула:

Set( NewGUID, GUID() )

Споделяне чрез