GUID функція

Застосовується до: Програми Canvas Copilot Studio Desktop flows Model-driven apps Power Platform CLI Dataverse functions

Перетворіть рядок (глобальний 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 – це мінлива функція, яка використовується без аргументу. Після кожного обчислення функція повертає інше значення.

Якщо у формулі потоку даних використовується нестабільна функція, вона повертає інше значення, лише якщо формулу переоцінено. Якщо у формулі нічого іншого не зміниться, вона зберігає таке ж значення, поки програма відкрита.

Наприклад, якщо для властивості Text елемента керування надписом установити 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" )

У цьому контексті використовується для встановлення для поля Status (Стан) нового запису бази даних усталеного значення.

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. Додайте елемент керування Таблиця даних, установіть для його властивості Items значення NewGUIDs та відобразіть поле Value (Значення).

3. Утримуючи натиснутою клавішу Alt, натисніть кнопку.

   Таблиця даних відобразить список GUID.

   

4. Натисніть кнопку ще раз, щоб відобразити новий список guids:

   

Щоб створити одну GUID таблицю замість неї, скористайтеся такою формулою:

Set( NewGUID, GUID() )