GUID funkcija

Velja za: Aplikacije Canvas Copilot Studio Desktop tokovi Modelno vodene aplikacije Power Platform CLI Dataverse funkcije

Pretvorite GUID niz (globalni enolični identifikator) v GUID vrednost ali ustvarite novo GUID vrednost.

Opis

S funkcijo GUID pretvorite niz s šestnajstiško GUID predstavitvijo vrednosti v vrednost, ki GUID jo lahko prenesete v zbirko podatkov. Sistemi zbirke podatkov, kot sta Microsoft Dataverse in SQL Server, uporabljajo GUID vrednosti kot ključe.

Niz ima lahko velike ali male črke, vendar mora biti 32 šestnajstiški števk v eni od teh oblik zapisa:

• "123e4567-e89b-12d3-a456-426655440000" (vezanji na standardnih mestih)
• "123e4567e89b12d3a456426655440000" (brez vezajev)

Če ne navedete argumenta, funkcija ustvari nov GUID.

Če želite vrednost GUID pretvoriti v niz, jo uporabite v kontekstu niza. Vrednost GUID se pretvori v šestnajstiški niz z vezaji in malimi črkami.

Pri ustvarjanju nove funkcije GUIDfunkcija uporablja psevdo-naključna števila za ustvarjanje različice 4 IETF RFC 4122GUID. Pri pretvorbi niza v , GUIDGUID funkcija podpira katero koli različico tako, da sprejme kateri koli niz z 32 šestnajstiškimi števkami.

Spremenljive funkcije

GUID je spremenljiva funkcija, če jo uporabljate brez argumenta. Vsakič, ko je funkcija ovrednotena, vrne drugačno vrednost.

Če v formuli podatkovnega toka uporabite funkcijo volatile, vrne drugačno vrednost le, če je formula znova ovrednotena. Če se v formuli ne spremeni nič drugega, ohrani enako vrednost, ko je program odprt.

Če na primer lastnost Besedilo kontrolnika oznake GUIDnastavite na (), se ne spremeni, ko je program aktiven. Drugačno vrednost dobite le, ko zaprete in znova odprete aplikacijo.

Funkcija je znova ovrednotena, če je del formule, kjer se nekaj drugega spremeni. Če na primer lastnost Besedilo kontrolnika Oznaka nastavite na to formulo, se ustvari vsakič, GUID ko uporabnik spremeni vrednost kontrolnika za vnos besedila:

TextInput1.Text & " " & GUID()

Ko uporabite v GUIDformuli vedenja, se ta ovrednoti vsakič, ko je formula ovrednotena. Če želite več informacij, glejte primere v nadaljevanju te teme.

Sintaksa

GUIDNe, ne

• GUIDString – Izbirno. Besedilni niz, ki ima šestnajstiško predstavitev .GUID Če niza ne podate, funkcija ustvari nov GUID.

GUID(Dinamična)

• Dinamično – obvezno. Dinamična vrednost, ki predstavlja GUID. Sprejemljive vrednosti so odvisne od netipkanega ponudnika. Za JSON se pričakuje, da bo dinamična vrednost predstavljena GUID kot niz JSON.

Primeri

Osnovna uporaba

Če želite vrniti vrednost GUID , ki temelji na šestnajstiški predstavitvi nizov:

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

Niz lahko vnesete tudi GUID brez vezajev. Ta formula vrne isto GUID vrednost:

GUID( "0f8fad5bd9cb469fa16570867728950e" )

Uporabljeno v kontekstu nastavite polje Status novega zapisa zbirke podatkov na dobro določeno vrednost:

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

Verjetno ne želite uporabnikom prikazati GUID-ov, vendar pa lahko z GUID-ji pomagate pri iskanju napak v aplikaciji. Če želite prikazati vrednost polja »Stanje « v zapisu, ki ste ga ustvarili v prejšnjem primeru, nastavite lastnost Textkontrolnika »Oznaka « na to formulo:

First( Products ).Status

Kontrolnik » Oznaka« prikazuje f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

Ustvarjanje tabele GUID-jev

1. Nastavite lastnost OnSelect kontrolnika Button na to formulo:

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

   Ta formula ustvari tabelo z enim stolpcem, ki se uporabi za petkratno ponovitev, da nastane pet GUID-ov.

2. Dodajte kontrolnik Data table, nastavite njegovo lastnost Items na NewGUIDs in prikažite polje Vrednost.

3. Pridržite tipko Alt in izberite gumb.

   Podatkovna tabela prikaže seznam GUID-ov:

   

4. Če želite prikazati nov seznam GUID-ov, znova izberite gumb:

   

Če želite namesto tabele GUID ustvariti eno samo, uporabite to formulo:

Set( NewGUID, GUID() )