Funkcija GUID
Velja za:
Aplikacije Canvas Namizne tokove Aplikacije, ki temeljijo na modelu Power Platform CLI
Pretvori niz GUID (globalni enolični identifikator) v vrednost GUID ali ustvari novo vrednost GUID.
Opis
Uporabite funkcijo GUID za pretvorbo niza, ki vsebuje šestnajstiško ponazoritev GUID-a v vrednost GUID, ki jo je mogoče poslati v zbirko podatkov. Vrednosti GUID uporabljajo kot ključe sistemi zbirk podatkov, kot sta Microsoft Dataverse in SQL Server.
Poslan niz lahko vsebuje velike ali male črke, vendar mora imeti 32 šestnajstiških števk v katerem koli od teh oblik zapisov:
- "123e4567-e89b-12d3-a456-426655440000" (vezanji na standardnih mestih)
- "123e4567e89b12d3a456426655440000" (brez vezajev)
Če ne navedete argumenta, ta funkcija ustvari novi GUID.
Če želite pretvoriti vrednost GUID v niz, jo preprosto uporabite v kontekstu niza. Vrednost GUID bo pretvorjena v niz s šestnajstiško ponazoritvijo z vezaji in malimi črkami.
Pri ustvarjanju novega GUID-a ta funkcija uporablja psevdonaključne številke, da ustvari IETF RFC 4122 GUID različice 4. Pri pretvorbi niza v GUID ta funkcija podpira katero koli različico GUID-a s sprejemom katerega koli niza 32 šestnajstiških števk.
Spremenljive funkcije
GUID je nestanovitna funkcija, če se uporablja brez argumenta. Vsakič, ko je funkcija ovrednotena, vrne drugačno vrednost.
Ko je uporabljena v formuli podatkovnega pretoka, bo spremenljiva funkcija vrnila drugačno vrednost samo, če je bila formula, v kateri se pojavi, znova ovrednotena. Če se v formuli nič drugega ne spremeni, bo imela isto vrednost v celotnem izvajanju aplikacije.
Npr. kontrolnik oznake, ki ima lastnost Besedilo nastavljeno na GUID() ne bo spremenjen, dokler je aplikacija aktivna. Samo če aplikacijo zaprete in znova odprete, se bo pojavila druga vrednost.
Funkcija bo znova ovrednotena, če je del formule, v kateri je bilo nekaj drugega spremenjeno. Če nastavimo lastnost Besedilo kontrolnika Label na to formulo, se GUID npr. ustvari vsakič, ko uporabnik spremeni vrednost kontrolnika Text input:
TextInput1.Text & " " & GUID()
Ko je uporabljen v formuli vedenja bo GUID ovrednoten vsakič, ko je ovrednotena formula. Če želite več informacij, glejte primere v nadaljevanju te teme.
Sintaksa
GUID( [ GUIDString ] )
- GUIDString – Izbirno. Besedilni niz, ki vsebuje šestnajstiško ponazoritev GUID-a. Če niz ni naveden, je ustvarjen nov GUID.
GUID( Netipizirano )
- Untyped - Zahtevano. predmet brez vrste ki predstavlja GUID. Sprejemljive vrednosti so odvisne od ponudnika brez vrste. Za JSON se pričakuje, da bo predmet brez vrste GUID, ki je predstavljen kot niz JSON.
Primeri
Osnovna uporaba
Vrnitev vrednosti GUID na podlagi šestnajstiške ponazoritve niza:
GUID( "0f8fad5b-d9cb-469f-a165-70867728950e" )
Niz GUID lahko podate tudi brez vezajev. Ta formula vrne isto vrednost GUID:
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 GUID-ov prikazati uporabnikom, lahko pa vam GUID-i pomagajo poiskati in odpraviti napake v aplikaciji. Za prikaz vrednosti polja Stanje v zapisu, ki ste ga ustvarili v prejšnjem primeru, nastavite lastnost Besedilo kontrolnika Label na to formulo:
First( Products ).Status
Kontrolnik Label bo prikazoval f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.
Ustvarjanje tabele GUID-jev
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.
Dodajte kontrolnik Data table, nastavite njegovo lastnost Items na NewGUIDs in prikažite polje Vrednost.
Medtem ko držite tipko Alt, izberite gumb, tako da ga kliknete ali tapnete.
Podatkovna tabela prikaže seznam GUID-ov:
Znova izberite gumb, da prikažete drug seznam GUID-ov:
Če želite ustvariti en GUID namesto tabele, uporabite to formulo:
Set( NewGUID, GUID() )