GUID funkcija

Odnosi se na: Canvas apps Copilot Studio Desktop flows Model-driven apps Power Platform CLI Dataverse functions

Pretvorite GUID niz (globalno jedinstveni identifikator) u GUID vrijednost ili stvorite novu GUID vrijednost.

Opis

Pomoću funkcije GUID pretvorite niz heksadecimalnim prikazom vrijednosti GUID u vrijednost GUID koju možete proslijediti u bazu podataka. Sustavi baza podataka kao što su Microsoft Dataverse i SQL Server koriste GUID vrijednosti kao ključeve.

Niz može sadržavati velika ili mala slova, ali mora imati 32 heksadecimalnog broja u jednom od sljedećih oblika:

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

Ako ne navedete argument, funkcija stvara novi GUID.

Da biste vrijednost GUID pretvorili u niz, koristite je u kontekstu niza. Vrijednost GUID se pretvara u heksadecimalni niz s crticama i malim slovima.

Prilikom generiranja novog , GUIDfunkcija koristi pseudo-slučajne brojeve za stvaranje verzije 4 IETF RFC 4122GUID. Prilikom pretvaranja niza u GUID, GUID funkcija podržava bilo koju verziju prihvaćanjem bilo kojeg niza od 32 heksadecimalnih znamenki.

Promjenjive funkcije

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

Kada koristite nepostojanu funkciju u formuli toka podataka, ona vraća drugu vrijednost samo ako se formula vrednuju. Ako se ništa drugo ne promijeni u formuli, zadržava istu vrijednost dok je aplikacija otvorena.

Ako, primjerice, svojstvo TekstGUIDkontrole oznake postavite na (), to se neće promijeniti dok je aplikacija aktivna. Drugu vrijednost dobit ćete samo kada zatvorite i ponovno otvorite aplikaciju.

Funkcija se procjenjuje ako je dio formule u kojoj se nešto drugo mijenja. Ako, primjerice, svojstvo Tekst kontrole natpisa postavite na ovu formulu, GUID generirat će se svaki put kada korisnik promijeni vrijednost kontrole za unos teksta:

TextInput1.Text & " " & GUID()

Kada je koristite GUID u formuli ponašanja, ona se procjenjuje svaki put kada se formula procjenjuje. Dodatne informacije potražite u primjerima kasnije u ovoj temi.

Sintaksa

GUID( [ GUIDString ] )

• GUIDString – Nije obavezno. Tekstni niz s heksadecimalnim prikazom .GUID Ako ne napišete niz, funkcija stvara novi GUID.

GUID( Dinamični )

• Dinamično – obavezno. Dinamična vrijednost koja predstavlja GUID. Prihvatljive vrijednosti ovise o netipiziranom davatelju usluga. Za JSON se očekuje da dinamička vrijednost bude GUID predstavljena kao niz JSON.

Primjeri

Osnovna upotreba

Da biste vratili vrijednost GUID na temelju heksadecimalnog prikaza niza:

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

Niz možete navesti i GUID 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 pokazati GUID-ove korisnicima, ali GUID oznake mogu vam pomoći pri ispravljanju pogrešaka u aplikaciji. Da bi se u zapisu koji ste stvorili u prethodnom primjeru prikazala vrijednost polja Status, svojstvo Tekst kontrole natpisa postavite na ovu formulu:

First( Products ).Status

Kontrola oznake prikazuje f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

Stvaranje tablice GUID-ova

1. 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.

2. Dodajte kontrolu Data table, postavite svojstvo Items na NewGUIDs i pokažite polje Value.

3. Pritisnite i držite tipku Alt pa odaberite gumb.

   Data table prikazuje popis GUID-ova:

   

4. Ponovno odaberite gumb da biste prikazali novi popis GUID-ova:

   

Da biste generirali jednu GUID umjesto tablice, koristite ovu formulu:

Set( NewGUID, GUID() )