GUID funktsioon

Kehtib järgmise kohta: Lõuendirakendused Copilot Studio töölauavood Mudelipõhised rakendused Power Platform CLI Dataverse'i funktsioonid

Teisendage GUID (globaalne ainuidentifikaator) string väärtuseks GUID või looge uus GUID väärtus.

Kirjeldus

GUID Selle funktsiooni abil saate teisendada stringi kuueteistkümnendkujulise GUID kujutisega GUID väärtuseks, mille saate andmebaasi edastada. Andmebaasisüsteemid (nt Microsoft Dataverse ja SQL Server) kasutavad GUID võtmetena väärtusi.

String võib sisaldada suur- või väiketähti, kuid ühes järgmistest vormingutest peab see olema 32 kuueteistkümnendarvu.

• "123e4567-e89b-12d3-a456-426655440000"( sidekriipsud standardsetes asukohtades)
• "123e4567e89b12d3a456426655440000" (sidekriipsud puuduvad)

Kui te argumenti ei määra, loob funktsioon uue GUID.

Väärtuse teisendamiseks GUID stringiks kasutage seda stringi kontekstis. Väärtus GUID teisendatakse sidekriipsude ja väiketähtedega kuueteistkümnendstringiks.

Uue GUIDversiooni loomisel kasutab funktsioon versiooni 4 IETF RFC 4122GUID loomiseks pseudojuhuste arvu. Stringi teisendamisel i GUIDtoetab funktsioon mis tahes GUID versiooni, aktsepteerides mis tahes 32 kuueteistkümnendkohalise arvuga stringi.

Lendfunktsioonid

GUID on muutlik funktsioon, kui seda kasutatakse ilma argumendita. Iga kord, kui funktsiooni hinnatakse, tagastab funktsioon teistsuguse väärtuse.

Kui kasutate andmevoovalemis muutlikku funktsiooni, tagastab see teistsuguse väärtuse ainult siis, kui valem on ümber hinnatud. Kui valemis ei muutu midagi muud, jääb see samaks ka siis, kui rakendus on avatud.

Näiteks kui määrate sildi juhtelemendi atribuudi Tekst väärtuseks GUID(), ei muutu see, kui teie rakendus on aktiivne. Saate teistsuguse väärtuse ainult siis, kui sulgete rakenduse ja avate selle uuesti.

Funktsioon hinnatakse ümber, kui see on osa valemist, kus midagi muud muutub. Näiteks kui määrate sellele valemile sildi juhtelemendi atribuudi Tekst, luuakse iga GUID kord, kui kasutaja muudab juhtelemendi Tekst väärtust:

TextInput1.Text & " " & GUID()

Kui kasutate GUIDkäitumisvalemis, hinnatakse seda iga kord, kui valemit väärtustatakse. Lisateabe saamiseks vaadake käesoleva teema näiteid tagapool.

Süntaks

GUID( [ GUIDString ] )

• GUIDString - Valikuline. Tekstistring, mille kuueteistkümnendkuju on GUID. Kui te stringi ei sisesta, loob funktsioon uue GUID.

GUID( Dünaamiline )

• Dünaamiline – nõutav. Dünaamiline väärtus, mis tähistab .GUID Sobivad väärtused sõltuvad tippimata pakkujast. JSON-i puhul on dünaamiline väärtus eeldatavasti GUID esitatud JSON-stringina.

Näited

Põhiline kasutus

Kuueteistkümnendstringi esitusel põhineva väärtuse tagastamiseks GUID tehke järgmist.

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

Samuti saate stringi GUID sisestada sidekriipse kasutamata. See valem tagastab sama GUID 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" ) } )

Ilmselt ei soovi te kasutajatele GUID-sid kuvada, kuid GUID-d aitavad teil rakendust siluda. Eelmises näites loodud kirje välja Olek väärtuse kuvamiseks seadke sildi juhtelemendi atribuudi Tekst väärtuseks järgmine valem:

First( Products ).Status

Sildi juhtelemendis kuvatakse f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

GUID-i tabeli loomine

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

2. Lisage juhtelement Data table, seadke selle atribuut Üksused väärtusele NewGUIDs ja kuvage väli Väärtus.

3. Hoidke all muuteklahvi (Alt) ja valige nupp.

   Andmetabelis kuvatakse GUID-ide loend.

   

4. Uue GUID-ide loendi kuvamiseks valige nupp uuesti.

   

Tabeli asemel ühe GUID genereerimiseks kasutage järgmist valemit.

Set( NewGUID, GUID() )