Funkcija GUID-a

Članak
10/16/2024

Odnosi se na: Aplikacije radnog područja Tijekovi radne površine CLI aplikacija Power Platform utemeljenih na modelu

Pretvara GUID (globalno jedinstveni identifikator) niz u GUID vrijednost ili stvara novu GUID vrijednost.

Opis

Upotrijebite funkciju GUID kako biste pretvorili niz koji sadrži heksadecimalni prikaz GUID-a u vrijednost GUID koja se može proslijediti u neku bazu podataka. GUID vrijednosti koriste se kao ključevi u sustavima baza podataka kao što su Microsoft Dataverse i SQL Server.

Proslijeđeni niz može sadržavati velika ili mala slova, ali mora imati 32 heksadecimalne znamenke u bilo kojem od sljedećih oblika:

"123e4567-e89b-12d3-a456-426655440000"( crtice na standardnim mjestima)
"123e4567e89b12d3a456426655440000" (bez crtica)

Ako ne navedete nijedan argument, ova funkcija stvara novi GUID.

Da biste GUID vrijednost pretvorili u niz, samo je upotrijebite u kontekstu niza. GUID vrijednost pretvorit će se u heksadecimalni niz prikazan s crticama i malim slovima.

Prilikom generiranja novog GUID-a, ova funkcija koristi pseudoslučajne brojeve za stvaranje GUID-a verzije 4 IETF RFC 4122. Pri pretvorbi nekog niza u GUID, ova funkcija podržava bilo koju verziju GUID-a prihvaćanjem bilo kojeg niza od 32 heksadecimalne znamenke.

Promjenjive funkcije

GUID je promjenjiva funkcija kada se koristi bez argumenta. Svaki put kada se zatraži rezultat te funkcije, vraća drugačiju vrijednost.

Kad se upotrijebi u nekoj formuli s protokom podataka, promjenjiva funkcija vratit će drugačiju vrijednost samo ako se ponovno zatraži rezultat formule u kojoj se koristi. Ako se u formuli ništa drugo ne promijeni, ona će imati istu vrijednost sve vrijeme rada vaše aplikacije.

Na primjer, kontrola oznake za koju je svojstvo Text postavljeno na GUID() neće se mijenjati dok je vaša aplikacija aktivna. Samo će zatvaranje i ponovno otvaranje aplikacije rezultirati drugačijom vrijednosti.

Funkcija će se ponovno zatražiti ako čini dio formule u kojoj se promijenilo nešto drugo. Ako postavimo svojstvo Text kontrole Label na ovu formulu, GUID se generira svaki put kada korisnik promijeni vrijednost kontrole Text input:

TextInput1.Text & " " & GUID()

Kada se koristi u formuli ponašanja, GUID će se izračunati svaki put kad se zatraži rezultat formule. Dodatne informacije potražite u primjerima kasnije u ovoj temi.

Sintaksa

GUID( [ GUIDString ] )

GUIDString – Nije obavezno. Tekstni niz koji sadrži heksadecimalni prikaz GUID-a. Ako nije unesen niz, stvara se novi GUID.

GUID ( bez teksta)

Netipizirano - Obavezno. netipizirani objekt koji predstavlja GUID. Prihvatljive vrijednosti ovise o netipiziranom davatelju. Za JSON, očekuje se da će netipizirani objekt biti GUID predstavljen kao JSON niz.

Primjeri

Osnovna upotreba

Da biste vratili GUID vrijednost na temelju heksadecimalnog prikaza niza:

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

GUID niz možete unijeti i bez crtica. Ova formula vraća istu GUID vrijednost:

GUID( "0f8fad5bd9cb469fa16570867728950e" )

Koristi se u kontekstu za postavljanje polja Status novog zapisa baze podataka na dobro utvrđenu vrijednost:

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

Vjerojatno ne želite prikazivati GUID-ove svojim korisnicima, ali vam GUID-ovi mogu pomoći u uklanjanju pogrešaka u aplikaciji. Da biste pokazali vrijednost polja Status u zapisu koji ste stvorili u prethodnom primjeru, postavite svojstvo Text kontrole Label na ovu formulu:

First( Products ).Status

Kontrola Label pokazat će f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

Stvaranje tablice GUID-ova

Postavite svojstvo OnSelect neke kontrole Button na ovu formulu:
```
ClearCollect( NewGUIDs, ForAll( Sequence(5), GUID() ) )
```
Ova formula stvara jednostupčanu tablicu koja se koristi za ponavljanje pet puta, što rezultira s pet GUID-ova.
Dodajte kontrolu Data table, postavite svojstvo Items na NewGUIDs i pokažite polje Value.
Dok držite tipku Alt, odaberite gumb klikom ili dodirom.

Data table prikazuje popis GUID-ova:
Ponovno odaberite gumb kako biste prikazali drugačiji popis GUID-ova:

Da biste generirali jedan GUID umjesto tablice, koristite sljedeću formulu:

Set( NewGUID, GUID() )

Dijeli putem