Функція GUID-файлів

Стаття
03/22/2024

Застосовується до: програм 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 ця функція використовує псевдовипадкові числа для створення GUID IETF RFC 4122 версії 4. У разі перетворення рядка на GUID ця функція підтримує всі версії GUID, приймаючи будь-який рядок із 32 шістнадцяткових цифр.

Змінні функції

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

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

Наприклад, елемент керування «Підпис», для якого властивість Text було настроєно відповідно до формули GUID(), не змінюватиметься, доки програма буде активною. Інше значення відобразиться лише в разі закриття та повторного відкриття програми.

Функцію буде обчислено повторно, якщо вона є частиною формули, у якій щось змінилося. Якщо настроїти властивість Text елемента керування Підпис відповідно до нижченаведеної формули, наприклад, GUID формуватиметься під час кожного змінення користувачем значення елемента керування Ввід тексту.

TextInput1.Text & " " & GUID()

У разі використання у формулі поведінки, функція GUID буде обчислюватися під час кожного обчислення формули. Нижче в цьому розділі наведено приклади з докладними відомостями.

Синтаксис

GUID( [ GUIDString ] )

GUIDString – необов’язковий аргумент. Текстовий рядок, що містить GUID в шістнадцятковій формі. Якщо не вказати рядок, буде створено новий GUID.

GUID( Untyped )

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

First( Products ).Status

Елемент керування Підпис відобразить f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

Створення таблиці ідентифікаторів GUID

Настройте властивість OnSelect елемента керування Кнопка відповідно до наведеної нижче формули.
```
ClearCollect( NewGUIDs, ForAll( Sequence(5), GUID() ) )
```
Ця формула створює таблицю з одним стовпцем, що використовується для п’ятикратної ітерації, у результаті чого отримуються п’ять GUID.
Додайте елемент керування Таблиця даних, установіть для його властивості Items значення NewGUIDs та відобразіть поле Value (Значення).
Тримаючи натиснутою клавішу Alt, виберіть кнопку (клацніть або торкніться її).

Таблиця даних відобразить список GUID.
Натисніть кнопку ще раз, щоб відобразити інший список GUID.

Щоб замість таблиці створити один GUID, використайте нижчезазначену формулу.

Set( NewGUID, GUID() )

Поділитися через