GUID függvény

A következőkre vonatkozik: Vászonalapú alkalmazások Copilot Studio Desktop folyamatok Modellalapú alkalmazások Power Platform CLI Dataverse-függvények

Alakítsa át (globálisan egyedi azonosító) sztringet GUID értékkéGUID, vagy hozzon létre egy új GUID értéket.

Ismertetés

GUID A függvény használatával egy olyan sztringet alakíthat át, amelynek hexadecimális ábrázolása egy GUIDGUID adatbázisnak átadható értékké. Az olyan adatbázisrendszerek, mint a Microsoft Dataverse és az SQL Server, kulcsként használnak GUID értékeket.

A sztring tartalmazhat nagybetűket vagy kisbetűket, de az alábbi formátumok egyikében 32 hexadecimális számjegynek kell lennie:

• "123e4567-e89b-12d3-a456-426655440000"( kötőjelek szabványos helyeken)
• "123e4567e89b12d3a456426655440000"( kötőjel nélkül)

Ha nem ad meg argumentumot, a függvény létrehoz egy újat GUID.

Ha egy értéket sztringgé GUID szeretne alakítani, használja karakterlánc-környezetben. Az GUID érték hexadecimális sztringgé alakul kötőjelekkel és kisbetűkkel.

Új GUIDlétrehozásakor a függvény pszeudo-véletlenszerű számokkal hozza létre a 4-es verziójú IETF RFC 4122-esGUID verzióját. Sztringek GUIDkonvertálásakor a függvény bármilyen GUID verziót támogat, ha elfogadja a 32 hexadecimális számjegyből álló sztringet.

Környezetfüggő függvények

GUID változó függvény, ha argumentum nélkül használják. A függvény minden egyes értékelés során más értéket ad vissza.

Ha változó függvényt használ egy adatfolyam-képletben, az csak akkor ad vissza egy másik értéket, ha a képletet újraértékelik. Ha a képletben semmi más nem változik, az ugyanazt az értéket tartja meg, amíg az alkalmazás meg van nyitva.

Ha például egy címkevezérlő GUIDSzöveg tulajdonságát ()) állítja be, az nem változik, amíg az alkalmazás aktív. Csak az alkalmazás bezárásakor és újbóli megnyitásakor kap egy másik értéket.

A függvényt újraértékesíti a rendszer, ha egy képlet része, ahol valami más változik. Ha például egy Címke vezérlőelem Szöveg tulajdonságát állítja be erre a képletre, a rendszer minden alkalommal létrehoz egy GUID értéket, amikor a felhasználó módosítja a szövegbeviteli vezérlő értékét:

TextInput1.Text & " & GUID()

Ha egy viselkedési képletben használjaGUID, a függvény minden alkalommal kiértékeli, amikor a képletet kiértékeli. További tudnivalókat a témakör későbbi részében szereplő példákban talál.

Szintaxis

GUID( [ GUIDString ] )

• GUIDString – Nem kötelező. Olyan szöveges sztring, amelynek hexadecimális ábrázolása egy GUID. Ha nem ad meg sztringet, a függvény létrehoz egy újat GUID.

GUID( Dinamikus )

• Dinamikus – Kötelező. Dinamikus érték, amely egy GUID. Az elfogadható értékek a nem beírt szolgáltatótól függenek. JSON esetén a dinamikus érték várhatóan JSON-sztringként GUID jelenik meg.

Példák

Alapvető használat

Hexadecimális sztring-ábrázoláson GUID alapuló érték visszaadása:

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

A sztringet GUID kötőjelek nélkül is megadhatja. Ez a képlet ugyanazt GUID az értéket adja vissza:

GUID( "0f8fad5bd9cb469fa16570867728950e" )

Kontextusban használva egy új adatbázisrekord Állapot mezőjének jól körülhatárolt értékre történő beállítása:

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

Valószínűleg nem szeretne grafikus GUID-ket megjeleníteni a felhasználóknak, de a GRAFIKUS GUID-k segíthetnek az alkalmazás hibakeresésében. Az előző példában létrehozott rekord Állapot mezőjének megjelenítéséhez állítsa a Címke vezérlőelem Szöveg tulajdonságát a következő képletre:

First( Products ).Status

A Címke vezérlőelem az f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4 értéket jeleníti meg.

GUID-k táblázatának létrehozása

1. Egy Gomb vezérlőelem OnSelect tulajdonságát állítsa be a következő képletre:

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

   Ez a képlet olyan egyoszlopos táblázatot hoz létre, amelynek ötszöri iterálása révén létrejön öt GUID.

2. Adjon hozzá egy Adattábla vezérlőelemet, állítsa az Items tulajdonságot NewGUIDs értékre, majd jelenítse meg az Érték mezőt.

3. Tartsa lenyomva az Alt billentyűt, és válassza a gombot.

   Az adattábla egy GUID-listát jelenít meg:

   

4. A GUID-k új listájának megjelenítéséhez kattintson ismét a gombra:

   

Ha egyetlen GUID táblát szeretne létrehozni táblázat helyett, használja a következő képletet:

Set( NewGUID, GUID() )