GUID функция

Отнася се за: Приложения за платно Copilot Studio Работен плот потоци Модел-управлявани приложения Power Platform CLI Dataverse функции

Преобразуване на низ (глобален GUIDеднозначен идентификатор) в GUID стойност или създаване на нова GUID стойност.

Описание

Използвайте функцията GUID , за да преобразувате низ с шестнадесетично представяне на GUIDGUID стойност, която можете да предадете на база данни. Системите за бази данни като Microsoft Dataverse и SQL Server използват GUID стойности като ключове.

Низът може да съдържа главни или малки букви, но трябва да съдържа 32 шестнадесетични цифри в един от следните формати:

• "123e4567-e89b-12d3-a456-426655440000" (тирета на стандартни места)
• "123e4567e89b12d3a456426655440000" (без тирета)

Ако не зададете аргумент, функцията създава нов GUID.

За да преобразувате GUID стойност в низ, използвайте я в контекст на низ. Стойността GUID се преобразува в шестнадесетичен низ с тирета и малки букви.

При генериране на нов GUID, функцията използва псевдо-случайни числа, за да създаде версия 4 IETF RFC 4122GUID. При преобразуване на низ 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

1. Задайте свойството OnSelect на контролата Бутон на тази формула:

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

   Тази формула създава таблица с една колона, която се използва за повторение пет пъти, което води до пет GUID.

2. Добавете Таблица с данни контрол, задайте елементи свойството на NewGUIDs, и покажете полето стойност.

3. Задръжте натиснат клавиша Alt и изберете бутона.

   Таблицата с данни показва списък с GUIDs:

   

4. Изберете бутона отново, за да се покаже нов списък с GUID:

   

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

Set( NewGUID, GUID() )