GUID funció

S'aplica a: Aplicacions de llenç Copilot Studio Fluxos d'escriptori Aplicacions basades en models Funcions del Power Platform CLI Dataverse

Convertiu una GUID cadena (identificador únic globalment) en un GUID valor o creeu-ne un de nou GUID .

Descripció

Utilitzeu la GUID funció per convertir una cadena amb la representació hexadecimal d'a GUID en un GUID valor que podeu passar a una base de dades. Els sistemes de bases de dades com Microsoft Dataverse i SQL Server utilitzen GUID valors com a claus.

La cadena pot tenir majúscules o minúscules, però ha de ser de 32 dígits hexadecimals en un d'aquests formats:

• "123e4567-e89b-12d3-a456-426655440000" (guions en ubicacions estàndard)
• "123e4567e89b12d3a456426655440000" (sense guionets)

Si no especifiqueu cap argument, la funció crea un nou GUID.

Per convertir un GUID valor en una cadena, utilitzeu-lo en un context de cadena. El GUID valor es converteix en una cadena hexadecimal amb guions i lletres minúscules.

Quan es genera un nou GUID, la funció utilitza nombres pseudoaleatoris per crear una versió 4 IETF RFC 4122GUID. Quan es converteix una cadena a GUID, la funció admet qualsevol GUID versió acceptant qualsevol cadena de 32 dígits hexadecimals.

Funcions volàtils

GUID és una funció volàtil quan s'utilitza sense argument. Cada vegada que s'avalua la funció, torna un valor diferent.

Quan utilitzeu una funció volàtil en una fórmula de flux de dades, només retorna un valor diferent si es torna a avaluar la fórmula. Si no canvia res més a la fórmula, manté el mateix valor mentre l'aplicació està oberta.

Per exemple, si definiu la propietat Text d'un control d'etiqueta a GUID(), no canviarà mentre l'aplicació estigui activa. Només obtindreu un valor diferent quan tanqueu i torneu a obrir l'aplicació.

La funció es torna a avaluar si forma part d'una fórmula on canvia alguna cosa més. Per exemple, si definiu la propietat Text d'un control Label en aquesta fórmula, es genera a GUID cada vegada que l'usuari canvia el valor del control d'entrada Text :

TextInput1.Text &" " & GUID()

Quan utilitzeu GUID una fórmula de comportament, s'avalua cada vegada que s'avalua la fórmula. Per obtenir més informació, vegeu els exemples que trobareu més endavant en aquest tema.

Sintaxi

GUID( [ GUIDString ] )

• GUIDString – Opcional. Cadena de text que té la representació hexadecimal d'un GUID. Si no proporcioneu una cadena, la funció crea un nou GUID.

GUID( Dinàmic )

• Dinàmic : obligatori. Valor dinàmic que representa un GUIDvalor . Els valors acceptables depenen del proveïdor sense tipificar. Per a JSON, s'espera que el valor dinàmic sigui representat GUID com una cadena JSON.

Exemples

Ús bàsic

Per retornar un GUID valor basat en la representació de la cadena hexadecimal:

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

També podeu proporcionar la GUID cadena sense guionets. Aquesta fórmula retorna el mateix GUID valor:

GUID( "0f8fad5bd9cb469fa16570867728950e" )

S'utilitza en el context, per definir el camp Estat d'un registre de base de dades nou en un valor ben definit:

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

Probablement no vulgueu mostrar GUID als usuaris, però els GUID us poden ajudar a depurar l'aplicació. Per mostrar el valor del camp Estat del registre que heu creat a l'exemple anterior, definiu la propietat Text d'un control Etiqueta en aquesta fórmula:

First( Products ).Status

El control Etiqueta mostra f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

Crear una taula de GUID

1. Definiu la propietat OnSelect d'un control Botó a aquesta fórmula:

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

   Aquesta fórmula crea una taula d'una sola columna que s'utilitza per iterar cinc vegades i que resulta en cinc GUID.

2. Afegiu un control Taula de dades, definiu-ne la propietat Items com a NewGUIDs i mostreu el camp Valor.

3. Manteniu premuda la tecla Alt i seleccioneu el botó.

   La taula de dades mostra una llista de GUID:

   

4. Torneu a seleccionar el botó per mostrar una nova llista de GUID:

   

Per generar una taula única GUID en lloc d'una taula, utilitzeu aquesta fórmula:

Set( NewGUID, GUID() )