GUID-függvény
A következőkre vonatkozik:
Vászonalapú alkalmazások Asztali folyamatok Modellvezérelt alkalmazások Power Platform CLI
Átalakít egy GUID (Globally Unique Identifier, globálisan egyedi azonosító) sztringet egy GUID-értékké, vagy létrehoz egy új GUID-értéket.
Ismertetés
A GUID hexadecimális értékét tartalmazó sztring adatbázisoknak átadható GUID-értékké való átalakításához használhatja a GUID függvényt. A GUID-értékeket az olyan adatbázis-kezelő rendszerek, mint a Microsoft Dataverse vagy az SQL Server kulcsként használják.
Az átadott sztring kis- és nagybetűs karaktereket is tartalmazhat, de mindkét formátumban 32 hexadecimális karakterből kell állnia:
- "123e4567-e89b-12d3-a456-426655440000"( kötőjelek szabványos helyeken)
- "123e4567e89b12d3a456426655440000"( kötőjel nélkül)
Ha nem ad meg argumentumot, akkor ez a függvény létrehoz egy új GUID-t.
Egy GUID-érték sztringgé való átalakításához használja a GUID-értéket egy sztring kontextusában. A rendszer átalakítja a GUID-értéket egy kötőjeleket és kisbetűket tartalmazó hexadecimális sztringgé.
Új GUID létrehozásakor a függvény álvéletlen számokat használ a 4-es verziójú IETF RFC 4122 GUID létrehozásához. Ha egy karakterláncot GUID-értékké alakít át, a függvény a GUID összes verzióját támogatja, és bármelyik 32 hexadecimális karaktert elfogadja.
Környezetfüggő függvények
A 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 egy adatfolyamképletben környezetfüggő függvényt használ, akkor a függvény csak akkor fog más értéket visszaadni, ha újraértékeli a képletet, amelyben a függvény szerepel. Ha semmi más nem változik a képletben, akkor az alkalmazás végrehajtása során végig ugyanazzal az értékkel fog rendelkezni.
Például egy címkevezérlő, amelynek a Text tulajdonsága GUID() értékre van állítva, nem fog változni, amíg az alkalmazás aktív. Csak az alkalmazás bezárása és ismételt megnyitása fog más értéket eredményezni.
A rendszer újraértékeli a függvényt, ha az egy olyan képlet része, amelyben valami más módosult. Ha például a képlet Címke vezérlőjének Text tulajdonságát beállítjuk, minden alkalommal létrejön egy GUID, amikor a felhasználó módosítja a Szövegbevitel vezérlő értékét:
TextInput1.Text & " " & GUID()
A GUIDviselkedési képletben való használatakor a rendszer a képlet minden értékelésekor ki fogja értékelni a GUID azonosítót is. 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ő. A GUID hexadecimális megjelenítését tartalmazó szöveges sztring. Ha nincs megadva sztring, akkor a rendszer egy új GUID-t hoz létre.
GUID( nem típusos )
- Untyped - Kötelező. be nem írt objektum ez egy GUID azonosítót jelöl. Az elfogadható értékek a típus nélküli szolgáltatótól függőek. A JSON esetében a típus nélküli objektum várhatóan JSON-sztringként megjelenő GUID.
Példák
Alapvető használat
GUID-érték visszaadása hexadecimális sztringábrázolás alapján:
GUID( "0f8fad5b-d9cb-469f-a165-70867728950e" )
Másik lehetőségként kötőjelek nélkül is megadhatja a GUID-sztringet. Ez a képlet ugyanazt a GUID-é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 szeretné, hogy a felhasználók is láthassák a GUID azonosítókat, azonban a GUID-k segítenek az alkalmazás hibáinak megkeresésében. Az előző példában létrehozott rekord Állapot mezője értékének megjelenítéséhez állítsa a Címke vezérlő Text tulajdonságát a következő képletre:
First( Products ).Status
A Címke vezérlő a következő értéket jeleníti meg: f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.
GUID-k táblázatának létrehozása
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.
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.
Az ALT billentyű lenyomva tartása mellett válassza ki a gombot kattintással vagy koppintással.
Az adattábla egy GUID-listát jelenít meg:
Kattintson újra a gombra, ha másik GUID-listát szeretne megjeleníteni:
Ha tábla helyett csupán egyetlen GUID-t szeretne létrehozni, a következő képletet használja:
Set( NewGUID, GUID() )