Funkcia GUID

Článok
10/16/2024

Vzťahuje sa na: aplikácie plátna toky na počítači aplikácie riadené modelom Power Platform CLI

Konvertuje reťazec GUID (jednoznačný identifikátor GUID) na hodnotu GUID alebo vytvorí novú hodnotu GUID.

Popis

Funkciu GUID použite v prípade, že chcete konvertovať reťazec, ktorý obsahuje identifikátor GUID v šestnástkovom formáte, na hodnotu GUID, ktorú možno preniesť do databázy. Hodnoty GUID sa používajú ako kľúče v databázových systémoch, ako sú napr. Microsoft Dataverse a SQL Server.

Reťazec, ktorý sa odovzdáva, môže obsahovať veľké alebo malé písmená, musí však vždy ísť o 32 šestnástkových číslic v niektorom z nasledujúcich formátov:

"123e4567-e89b-12d3-a456-426655440000" (pomlčky na štandardných miestach)
"123e4567e89b12d3a456426655440000" (bez pomlčiek)

Ak nezadáte žiaden argument, táto funkcia vytvorí nový identifikátor GUID.

Ak chcete konvertovať hodnotu GUID na reťazec, stačí ju použiť v kontexte reťazcov. Hodnota GUID sa konvertuje na šestnástkový zástupný reťazec so spojovníkmi a malými písmenami.

Pri generovaní nového GUID táto funkcia používa pseudonáhodné čísla na vytvorenie verzie 4 IETF RFC 4122 GUID. Pri prevode reťazca na GUID táto funkcia podporuje akúkoľvek verziu GUID akceptovaním ľubovoľného reťazca s 32 hexadecimálnymi číslicami.

Nestále funkcie

GUID je nestála funkcia, keď sa používa bez argumentu. Pri každom vyhodnotení vracia táto funkcia inú hodnotu.

Ak sa nestála funkcia použije vo vzorci toku údajov, vráti v rámci vzorca odlišnú hodnotu len vtedy, keď sa daný vzorec nanovo vyhodnotí. Ak sa vo vzorci nič iné nezmení, bude mať rovnakú hodnotu počas celého spracovania v aplikácii.

Ovládací prvok označenia, ktorého vlastnosť Text je nastavená na hodnotu GUID() sa nezmení, kým je aplikácia aktívna. Odlišná hodnota sa zobrazí až po zavretí a opätovnom otvorení aplikácie.

Funkcia sa nanovo vyhodnotí, ak je súčasťou vzorca, v ktorom sa zmenila aj nejaká iná hodnota. Ak napríklad nastavíme hodnotu vlastnostiText ovládacieho prvku Označenie na tento vzorec, identifikátor GUID sa vygeneruje zakaždým, keď používateľ zmení hodnotu ovládacieho prvkuTextový vstup:

TextInput1.Text & " " & GUID()

Pri použití vo vzorci správania sa funkcia GUID vyhodnocuje pri každom vyhodnotení vzorca. Ďalšie informácie nájdete v príkladoch v tejto téme.

Syntax

GUID( [ Reťazec GUID ] )

GUIDString – voliteľné. Textový reťazec, ktorý obsahuje šestnástkový zápis identifikátora GUID. Ak nie je zadaný žiadny reťazec, vytvorí sa nový identifikátor GUID.

GUID( Nezadané )

Nezadané – povinné. netypový objekt ktorý predstavuje GUID. Prijateľné hodnoty závisia od netypového poskytovateľa. V prípade JSON sa očakáva, že netypový objekt bude GUID reprezentovaný ako reťazec JSON.

Príklady

Základné použitie

Ak sa má vrátiť hodnota GUID založená na šestnástkovom vyjadrení v reťazci:

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

Taktiež môžete zadať reťazec identifikátora GUID bez pomlčiek. Tento vzorec vráti rovnakú hodnotu GUID:

GUID( "0f8fad5bd9cb469fa16570867728950e" )

Použime funkciu v kontexte: ak chcete nastaviť pole Stav nového záznamu databázy na zaužívanú hodnotu:

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

Pravdepodobne nechcete zobrazovať identifikátory GUID používateľom, môžu však byť nápomocné pri ladení aplikácie. Ak chcete zobraziť hodnotu poľa Stav v zázname, ktorý ste vytvorili v predchádzajúcom príklade, nastavte vlastnosť Text ovládacieho prvku Označenie na tento vzorec:

First( Products ).Status

Ovládací prvok Označenie zobrazí f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

Vytvorenie tabuľky identifikátorov GUID

Nastavte vlastnosť OnSelect ovládacieho prvku Tlačidlo na nasledujúci vzorec:
```
ClearCollect( NewGUIDs, ForAll( Sequence(5), GUID() ) )
```
Tento vzorec vytvorí tabuľku s jedným stĺpcom, ktorý sa použije v piatich iteráciách, výsledkom čoho bude päť identifikátorov GUID.
Pridajte ovládací prvok Tabuľka údajov, nastavte jeho vlastnosť Items na hodnotu NewGUIDs a zobrazte pole Hodnota.
Podržte stlačený kláves Alt a kliknutím alebo ťuknutím vyberte tlačidlo.

Tabuľka údajov zobrazuje zoznam identifikátorov GUID:
Ak chcete zobraziť iný zoznam identifikátorov GUID, znova vyberte tlačidlo:

Ak chcete generovať jeden identifikátor GUID namiesto tabuľky, použite tento vzorec:

Set( NewGUID, GUID() )

Zdieľať cez