Funkcja GUID

Dotyczy: Aplikacje kanwy Copilot Studio Desktop przepływy oparte na modelu Aplikacje oparte na modelu Funkcje interfejsu wiersza polecenia platformy Power Platform

Przekonwertuj GUID ciąg (unikatowy identyfikator globalny) na GUID wartość lub utwórz nową GUID wartość.

Opis

GUID Użyj funkcji , aby przekonwertować ciąg z reprezentacją szesnastkową elementu GUID na GUID wartość, którą można przekazać do bazy danych. Systemy baz danych, takie jak Microsoft Dataverse i SQL Server, używają GUID wartości jako kluczy.

Ciąg może mieć wielkie lub małe litery, ale musi mieć 32 cyfry szesnastkowe w jednym z następujących formatów:

• "123e4567-e89b-12d3-a456-426655440000" (łączniki w standardowych lokalizacjach)
• "123e4567e89b12d3a456426655440000"( bez myślników)

Jeśli nie określisz argumentu, funkcja utworzy nowy GUIDelement .

Aby przekonwertować GUID wartość na ciąg, użyj jej w kontekście ciągu. Wartość GUID jest konwertowana na ciąg szesnastkowy z łącznikami i małymi literami.

Podczas generowania nowej GUIDfunkcji funkcja używa pseudolosowych liczb do utworzenia wersji 4 IETF RFC 4122GUID. Podczas konwertowania ciągu na funkcję funkcja obsługuje dowolną GUIDGUID wersję, akceptując dowolny ciąg cyfr szesnastkowych 32.

Funkcje nietrwałe

GUID jest funkcją volatile, gdy jest używana bez argumentu. Każde wywołanie funkcji zwraca inną wartość.

Gdy używasz funkcji volatile w formule przepływu danych, zwraca inną wartość tylko wtedy, gdy formuła zostanie ponownie zwalczona. Jeśli nic innego nie zmieni się w formule, zachowa tę samą wartość podczas otwierania aplikacji.

Jeśli na przykład ustawisz właściwość Text kontrolki etykiety naGUID (), nie zmieni się, gdy aplikacja jest aktywna. Po zamknięciu i ponownym otwarciu aplikacji uzyskasz inną wartość.

Funkcja jest ponownie obliczana, jeśli jest częścią formuły, w której zmienia się coś innego. Jeśli na przykład ustawisz właściwość Text kontrolki Etykieta na tę formułę, wartość jest generowana za każdym razem, GUID gdy użytkownik zmieni wartość kontrolki Wprowadzanie tekstu :

TextInput1.Text & " & GUID()

Gdy używasz GUID w formule zachowania, jest ona obliczana za każdym razem, gdy formuła jest obliczana. Aby uzyskać więcej informacji, zobacz przykłady w dalszej części tego tematu.

Składnia

GUID( [ GUIDString ] )

• GUIDString – Opcjonalnie. Ciąg tekstowy, który ma reprezentację szesnastkową obiektu GUID. Jeśli nie podasz ciągu, funkcja utworzy nowy GUIDelement .

GUID( Dynamiczny )

• Dynamiczny — wymagany. Wartość dynamiczna reprezentująca GUIDwartość . Dopuszczalne wartości zależą od nietypowego dostawcy. W przypadku formatu JSON wartość dynamiczna powinna być reprezentowana GUID jako ciąg JSON.

Przykłady

Podstawowy sposób użycia

Aby zwrócić GUID wartość na podstawie reprezentacji ciągu szesnastkowego:

GUID( "0f8fad5b-d9cb-469f-a165-70867728950e" )

Możesz również podać GUID ciąg bez łączników. Ta formuła zwraca tę samą GUID wartość:

GUID( "0f8fad5bd9cb469fa16570867728950e" )

Użycie w kontekście w celu ustawienia pola Status nowego rekordu bazy danych na dobrze zdefiniowaną wartość:

Patch( Products, Default( Products ), { Status: GUID( "F9168C5E-CEB2-4faa-B6BF-329BF39FA1E4" ) } )

Prawdopodobnie nie chcesz pokazywać użytkownikom identyfikatorów GUID, ale identyfikatory GUID mogą ułatwić debugowanie aplikacji. Aby wyświetlić wartość pola Stan w rekordzie utworzonym w poprzednim przykładzie, ustaw właściwość Text kontrolki Etykieta na następującą formułę:

First( Products ).Status

Kontrolka Etykieta pokazuje f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

Tworzenie tabeli identyfikatorów GUID

1. Ustaw właściwość OnSelect kontrolki Button na następującą formułę:

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

   Ta formuła tworzy jednokolumnową tabelę używaną do wykonania pięciu powtórzeń iteracji, co daje w wyniku pięć identyfikatorów GUID.

2. Dodaj kontrolkę Data table, ustaw jej właściwość Items na wartość NewGUIDs i wyświetl pole Wartość.

3. Przytrzymaj wciśnięcie Alt i wybierz przycisk .

   Tabela danych zawiera listę identyfikatorów GUID:

   

4. Ponownie wybierz przycisk, aby wyświetlić nową listę identyfikatorów GUID:

   

Aby wygenerować pojedynczy element GUID zamiast tabeli, użyj następującej formuły:

Set( NewGUID, GUID() )