GUID-funktsioon
Kehtib: Lõuendirakendused Töölauavood Mudelipõhised rakendused Power Platform CLI
Teisendab GUID(globaalne ainuidentifikaator) stringi GUID-väärtuseks ja loob uue GUID-väärtuse.
Kirjeldus
Kasutage funktsiooni GUID, et teisendada string, mis sisaldab GUIDi kuueteistkümnendsüsteemis esitust, GUID-väärtuseks, mida saab edastada andmebaasi. GUID-väärtusi kasutatakse andmebaasisüsteemides nagu Microsoft Dataverse ja SQL Server klahvidena.
Edastatud string võib sisaldada suur- või väiketähti, kuid see peab olema 32 kuueteistkümnendsüsteemis numbrit kummaski sellises vormingus.
- "123e4567-e89b-12d3-a456-426655440000" (sidekriipsud standardsetes asukohtades)
- "123e4567e89b12d3a456426655440000" (sidekriipse pole)
Kui te ei määra argumenti, loob see funktsioon uue GUID-i.
Kui soovite teisendada GUID-väärtust stringiks, kasutage seda lihtsalt stringi kontekstis. GUID-i väärtus teisendatakse kuueteistkümnendsüsteemis stringiks, millel on sidekriipsud ja väiketähed.
Uue GUID-i loomisel kasutab see funktsioon pseudo-juhuslikke numbreid, et luua versiooni 4 IETF RFC 4122 GUID. Kui teisendate stringi GUID-i, toetab see funktsioon mis tahes GUID-i versiooni, nõustudes mis tahes stringiga, milles on 32 kuueteistkümnendsüsteemis numbrit.
Lendfunktsioonid
GUID on lendfunktsioon, kui seda kasutatakse ilma argumendita. Iga kord, kui funktsiooni hinnatakse, tagastab funktsioon teistsuguse väärtuse.
Kui kasutatakse andmevoo valemis, tagastab lendfunktsioon teistsuguse väärtuse vaid juhul, kui valem, milles see kuvatakse, on uuesti hinnatud. Kui valemis ei muutu miski muu, on sellel teie rakenduse käitamisel sama väärtus.
Näiteks sildi juhtelement, millel atribuudi Tekst väärtuseks on seatud GUID(), ei muutu, kui rakendus on aktiivne. Ainult rakenduse sulgemine ja uuesti avamine toob kaasa teistsuguse väärtuse.
Funktsiooni hinnatakse uuesti juhul, kui see on osa valemist, milles on midagi muud muutunud. Näiteks kui määrate atribuudi Tekst juhtelemendil Silt sellele valemile, luuakse GUID iga kord, kui kasutaja muudab juhtelemendi Tekstisisend väärtust:
TextInput1.Text & " " & GUID()
Kui kasutatakse valemis käitumise valem, GUIDi analüüsitakse iga kord, kui valemit analüüsitakse. Lisateabe saamiseks vaadake käesoleva teema näiteid tagapool.
Süntaks
GUID( [ GUIDString ] )
- GUIDString – valikuline. Tekstistring, mis sisaldab GUID-i kuueteistkümnendsüsteemis esitust. Kui stringi pole saadaval, luuakse uus GUID.
GUID( Untyped )
- Tüüpimata – nõutav. Tüüpimata objekt, mis esindab GUID-d. Aktsepteeritavad väärtused sõltuvad tüüpimata pakkujast. JSON-i puhul eeldatakse, et tüüpimata objekt on GUID, mida esindab JSON-i string.
Näited
Põhiline kasutus
Et tagastada GUID-väärtus, mis põhineb kuueteistkümnendsüsteemis stringi esitusel:
GUID( "0f8fad5b-d9cb-469f-a165-70867728950e" )
Samuti saate lisada GUID-i stringi ilma sidekriipsuta. See valem annab tulemuseks sama GUID-i väärtuse.
GUID( "0f8fad5bd9cb469fa16570867728950e" )
Kasutatakse kontekstis, et seada uue andmebaasikirje väli Olek väljakujunenud väärtusele:
Patch( Products, Default( Products ), { Status: GUID( "F9168C5E-CEB2-4faa-B6BF-329BF39FA1E4" ) } )
Tõenäoliselt ei soovi te oma kasutajatele GUID-i kuvada, kuid GUID-i abil saab rakendust siluda. Et kuvada eelmise näites loodud kirje välja Olek, seadke atribuut Tekst juhtelemendil Silt sellele valemile:
First( Products ).Status
Juhtelement Silt kuvab f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.
GUID-i tabeli loomine
Seadke atribuut OnSelect juhtelemendil Button sellele valemile:
ClearCollect( NewGUIDs, ForAll( Sequence(5), GUID() ) )
See valem loob ühe veeruga tabeli, mida kasutatakse viis korda itereerimiseks, tulemuseks on viis GUID-i.
Lisage juhtelement Data table, seadke selle atribuut Üksused väärtusele NewGUIDs ja kuvage väli Väärtus.
Hoides all Alt klahvi, valige nupp klõpsamise või koputamisega.
Andmetabelis kuvatakse GUID-ide loend.
Teistsuguse GUID-ide loendi kuvamiseks valige uuesti nupp.
Ühe GUID-i loomiseks tabeli asemel kasutage seda valemit.
Set( NewGUID, GUID() )