Функция GUID

Статья
03/22/2024

Применимо к: приложениям на основе холста классическим потокам приложениям на основе модели интерфейсу командной строки Power Platform

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

Описание

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

Передаваемая строка может содержать прописные или строчные буквы, но она должна состоять из 32 шестнадцатеричных цифр в любом из следующих форматов:

"123e4567-e89b-12d3-a456-426655440000" (дефисы в стандартных местах)
"123e4567e89b12d3a456426655440000" (без дефисов)

Если аргумент не задан, эта функция создает новый идентификатор GUID.

Чтобы преобразовать значение GUID в строку, просто используйте его в контексте строки. Значение GUID будет преобразовано в представление шестнадцатеричной строки с дефисами и строчными буквами.

При создании нового GUID эта функция использует псевдослучайные числа для создания GUID версии 4 IETF RFC 4122. При преобразовании строки в GUID эта функция поддерживает любую версию GUID, принимая любую строку из 32 шестнадцатеричных цифр.

Переменные функции

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

При использовании в формуле потока данных, переменная функция возвращает другое значение только при повторном вычислении формулы, в которой она указывается. Если в формуле нет никаких других изменений, она будет иметь одно и то же значение во время выполнения приложения.

Например, элемент управления "метка", с назначенным свойством Text имеет значение GUID(), будет неизменным, пока приложение будет активным. Другое значение возвращается только после закрытия и повторного открытия приложения.

Если функция является частью формулы в которой изменилось что-то еще, она будет вычислена повторно. Если задать элементу управления Label свойство Text, для этой формулы, например, идентификатор GUID генерируется каждый раз, когда пользователь меняет значение в элементе управления Text input:

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 своим пользователям, но они могут помочь отладить приложение. Чтобы показать значение поля Status в записи, созданной в предыдущем примере, установите для этой формулы свойство Text элемента управления Label:

First( Products ).Status

Элемент управления Label покажет f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

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

Назначьте свойству OnSelect элемента управления Button следующую формулу:
```
ClearCollect( NewGUIDs, ForAll( Sequence(5), GUID() ) )
```
Эта формула создает таблицу с одним столбцом, которая используется для пятикратной итерации, в результате чего возвращаются пять идентификаторов GUID.
Добавьте элемент управления Data table, задайте его свойству Items значение NewGUIDs и откройте поле Значение.
Удерживая нажатой клавишу ALT, выберите кнопку, нажав ее.

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

Чтобы создать единственный идентификатор GUID вместо таблицы, используйте следующую формулу:

Set( NewGUID, GUID() )