Funkcja GUID

Artykuł
03/22/2024

Dotyczy: Aplikacje oparte na kanwie Przepływy pulpitu Aplikacje oparte na modelach Power Platform CLI

Umożliwia skonwertowanie ciągu identyfikatora GUID (Globally Unique Identifier) na wartość identyfikatora GUID lub utworzenie nowej wartości identyfikatora GUID.

Opis

Użyj funkcji GUID, aby skonwertować ciąg zawierający reprezentację szesnastkową identyfikatora GUID na wartość identyfikatora GUID, którą można przekazać do bazy danych. Wartości identyfikatorów GUID są używane jako klucze w systemach baz danych, takich jak Microsoft Dataverse lub SQL Server.

Przekazany ciąg może zawierać wielkie lub małe litery, ale musi składać się z 32 cyfr szesnastkowych w jednym z następujących formatów:

"123e4567-e89b-12d3-a456-426655440000" (dywizy w standardowych lokalizacjach)
„123e4567e89b12d3a456426655440000” (bez łączników)

Jeśli argument nie jest określony, ta funkcja tworzy nowy identyfikator GUID.

Aby skonwertować wartość identyfikatora GUID na ciąg, po prostu użyj go w kontekście ciągu. Wartość identyfikatora GUID zostanie skonwertowana na ciąg zawierający łączniki i małe litery.

Przy generowaniu nowego identyfikatora GUID funkcja używa pseudo-losowych numerów do utworzenia identyfikatora GUID w wersji 4 IETF RFC 4122. Przy konwertowaniu ciągu na identyfikator GUID ta funkcja obsługuje dowolną wersję identyfikatora GUID, akceptując każdy ciąg o wartościach szesnastkowych 32.

Funkcje nietrwałe

Funkcja GUID to funkcja nietrwała, jeśli zostanie użyta bez argumentu. Każde wywołanie funkcji zwraca inną wartość.

Funkcja nietrwała używana w formule przepływu danych zwróci inną wartość tylko wtedy, gdy formuła, w której ta funkcja się znajduje, zostanie obliczona ponownie. Jeśli nic w formule się nie zmieni, funkcja będzie mieć tę samą wartość podczas wykonywania aplikacji.

Na przykład kontrolka etykiety z właściwością Text ustawioną na GUID() nie ulegnie zmianie, gdy aplikacja jest aktywna. Tylko zamknięcie i ponowne otwarcie aplikacji spowoduje wyświetlenie nowej wartości.

Funkcja zostanie obliczona ponownie, jeśli jest częścią formuły, w której zmienił się inny element. Jeśli na przykład ustawimy właściwość Text kontrolki Label na tę formułę, identyfikator GUID będzie generowany za każdym razem, gdy użytkownik zmieni wartość kontrolki Text input:

TextInput1.Text & " " & GUID()

W przypadku użycia w formule zachowania funkcja GUID będzie obliczana zawsze, gdy będzie obliczana wartość formuły. Aby uzyskać więcej informacji, zobacz przykłady w dalszej części tego tematu.

Składnia

GUID( [ GUIDString ] )

GUIDString – wartość opcjonalna. Ciąg tekstowy, który zawiera reprezentację szesnastkową identyfikatora GUID. Jeśli ciąg nie jest podany, zostanie utworzony nowy identyfikator GUID.

GUID( Untyped )

Bez typu — wymagane. Obiekt bez typu reprezentujący identyfikator GUID. Dopuszczalne wartości są zależne od niewpisanego dostawcy. W przypadku JSON obiekt bez typu powinien mieć identyfikator GUID reprezentowany jako ciąg JSON.

Przykłady

Podstawowy sposób użycia

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

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

Ciąg identyfikatora GUID możesz także podać bez łączników. Ta formuła zwraca tę samą wartość identyfikatora GUID:

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 wyświetlać identyfikatorów GUID użytkownikom, ale mogą one pomóc w debugowaniu aplikacji. Aby wyświetlić wartość pola Status w rekordzie utworzonym w poprzednim przykładzie, ustaw właściwość Text kontrolki Label na następującą formułę:

First( Products ).Status

Zostanie wyświetlona kontrolka Labelf9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

Tworzenie tabeli identyfikatorów GUID

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.
Dodaj kontrolkę Data table, ustaw jej właściwość Items na wartość NewGUIDs i wyświetl pole Wartość.
Trzymając naciśnięty klawisz Alt, wybierz przycisk przez kliknięcie lub dotknięcie.

Tabela danych zawiera listę identyfikatorów GUID:
Wybierz przycisk ponownie, aby wyświetlić inną listę identyfikatorów GUID:

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

Set( NewGUID, GUID() )

Share via