GUID funkcija

Taikoma: "Canvas apps Copilot Studio Desktop " srautus modeliu pagrįstos programos "Power Platform" CLI "Dataverse" funkcijos

Konvertuokite GUID (globaliai unikalų identifikatorių) eilutę į GUID reikšmę arba sukurkite naują GUID reikšmę.

Aprašas

GUID Naudokite funkciją norėdami konvertuoti eilutę su šešioliktainiu atvaizdu GUID į reikšmę, GUID kurią galite perduoti duomenų bazei. Duomenų bazių sistemos, pvz., "Microsoft Dataverse" ir "SQL Server", naudoja GUID reikšmes kaip raktus.

Eilutė gali turėti didžiąsias arba mažąsias raides, bet ją turi sudaryti 32 šešioliktainiai skaitmenys vienu iš šių formatų:

• "123e4567-e89b-12d3-a456-426655440000( brūkšneliai standartinėse vietose)
• "123e4567e89b12d3a456426655440000" (be brūkšnelių)

Jei nenurodysite argumento, funkcija sukurs naują GUID.

Norėdami konvertuoti GUID reikšmę į eilutę, naudokite ją eilutės kontekste. Reikšmė GUID konvertuojama į šešioliktainę eilutę su brūkšneliais ir mažosiomis raidėmis.

Generuojant naują GUID, funkcija naudoja pseudo atsitiktinius skaičius, kad sukurtų 4 versiją IETF RFC 4122GUID. Konvertuojant eilutę į GUID, funkcija palaiko bet kurią GUID versiją, priimdama bet kurią 32 šešioliktainių skaitmenų eilutę.

Kintamos funkcijos

GUID yra kintama funkcija, kai naudojama be argumento. Kiekvieną kartą įvertinus funkciją, ji pateikia kitą reikšmę.

Kai duomenų srauto formulėje naudojate kintamą funkciją, ji grąžina kitą reikšmę tik tada, jei formulė yra iš naujo vertinama. Jei formulėje niekas daugiau nesikeičia, kol programa atidaryta, ji išlaiko tą pačią reikšmę.

Pavyzdžiui, jei etiketės valdiklio ypatybę Tekstas nustatysite kaip GUID(), ji nesikeis, kol programėlė bus aktyvi. Kitą reikšmę gausite tik tada, kai uždarysite ir iš naujo atidarysite programą.

Funkcija yra iš naujo vertinama, jei ji yra formulės, kurioje kas nors keičiasi, dalis. Pavyzdžiui, jei nustatote žymės valdiklio ypatybę Tekstas šiai formulei, a GUID generuojamas kiekvieną kartą, kai vartotojas pakeičia teksto įvesties valdiklio reikšmę:

TextInput1.Text & " " & ( GUID)

Kai naudojate GUIDveikimo būdo formulėje, ji įvertinama kaskart, kai formulė įvertinama. Daugiau informacijos žr. toliau šioje temoje pateiktuose pavyzdžiuose.

Sintaksė

GUID( [ GUIDString ] )

• GUIDString - Neprivaloma. Teksto eilutė, kurios šešioliktainis atvaizdavimas yra GUID. Jei eilutės nepateiksite, funkcija sukurs naują GUID.

GUID( Dinaminė )

• Dinaminis – būtinas. Dinaminė reikšmė, nurodanti GUID. Priimtinos reikšmės priklauso nuo neįvesto teikėjo. JSON dinaminė reikšmė turėtų būti GUID nurodyta kaip JSON eilutė.

Pavyzdžiai

Pagrindinis naudojimas

Norėdami grąžinti GUID reikšmę pagal šešioliktainį eilutės atvaizdą:

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

Taip pat galite pateikti GUID eilutę be brūkšnelių. Ši formulė pateikia tą pačią GUID reikšmę:

GUID( "0f8fad5bd9cb469fa16570867728950e" )

Naudojama kontekste, norint naujo duomenų bazės įrašo lauką Būsena nustatyti kaip nusistovėjusią reikšmę:

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

Tikriausiai nenorite rodyti GUID vartotojams, tačiau GUID gali padėti derinti programą. Norėdami rodyti lauko Būsena reikšmę įraše, kurį sukūrėte ankstesniame pavyzdyje, nustatykite valdiklio Etiketė ypatybę Tekstas į šią formulę:

First( Products ).Status

Žymos valdiklis rodo f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

GUID identifikatorių lentelės kūrimas

1. Mygtuko valdiklio ypatybę OnSelect nustatykite kaip šią formulę:

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

   Ši formulė sukuria vieno stulpelio lentelę, kartojamą penkis kartus ir taip gaunant penkis GUID.

2. Įtraukite duomenų lentelės valdiklį, jo ypatybę Items nustatykite kaip NewGUIDs ir parodykite lauką Value.

3. Laikykite nuspaudę klavišą Alt ir pasirinkite mygtuką.

   Duomenų lentelėje rodomas GUID sąrašas:

   

4. Dar kartą pasirinkite mygtuką, kad būtų rodomas naujas GUID sąrašas:

   

Norėdami sugeneruoti vieną GUID , o ne lentelę, naudokite šią formulę:

Set( NewGUID, GUID() )