GUID функция

Применимо к: Приложения На основе холста Copilot Studio Desktop поддерживают функции 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функция использует псевдослучайные числа для создания rfC 4 IETF RFC 4122GUID. При преобразовании строки в функцию GUIDподдерживается любая версия, принимая любую GUID строку из 32 шестнадцатеричных цифр.

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

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

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

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

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

First( Products ).Status

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

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

1. Назначьте свойству OnSelect элемента управления Button следующую формулу:

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

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

2. Добавьте элемент управления Data table, задайте его свойству Items значение NewGUIDs и откройте поле Значение.

3. Удерживайте клавишу ALT и нажмите кнопку.

   Таблица данных показывает список идентификаторов GUID.

   

4. Нажмите кнопку еще раз, чтобы отобразить новый список идентификаторов GUID:

   

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

Set( NewGUID, GUID() )