GUID Función

Aplícase a: Aplicacións de lenzo Copilot Studio Fluxos de escritorio Aplicacións baseadas en modelos Funcións de Power Platform CLI Dataverse

Converte unha cadea GUID (identificador único globalmente) nun GUID valor ou crea un novo GUID valor.

Descripción

Use a GUID función para converter unha cadea coa representación hexadecimal de a GUID nun GUID valor que pode pasar a unha base de datos. Os sistemas de bases de datos como Microsoft Dataverse e SQL Server usan GUID valores como claves.

A cadea pode ter letras maiúsculas ou minúsculas, pero debe ser de 32 díxitos hexadecimais nun destes formatos:

• "123e4567-e89b-12d3-a456-426655440000" (guións en localizacións estándar)
• "123e4567e89b12d3a456426655440000" (sen guións)

Se non especificas un argumento, a función crea un novo GUIDargumento.

Para converter un GUID valor nunha cadea, utilízao nun contexto de cadeas. O GUID valor convértese nunha cadea hexadecimal con trazos e letras minúsculas.

Ao xerar un novo GUID, a función usa números pseudoaleatorios para crear unha versión 4 IETF RFC 4122GUID. Ao converter unha cadea a GUID, a función soporta calquera GUID versión aceptando calquera cadea de 32 díxitos hexadecimais.

Funcións volátiles

GUID É unha función volátil cando se usa sen argumento. Cada vez que se avalía a función, devólvese un valor diferente.

Cando se usa unha función volátil nunha fórmula de fluxo de datos, devolve un valor diferente só se se reavalia a fórmula. Se non cambia nada máis na fórmula, mantén o mesmo valor mentres a aplicación está aberta.

Por exemplo, se estableces a propiedade Texto dun control de etiqueta en GUID(), non cambia mentres a aplicación estea activa. Obtén un valor diferente só cando pecha e volve abrir a aplicación.

A función é reavaliada se forma parte dunha fórmula na que cambia outra cousa. Por exemplo, se establece a propiedade Texto dun control Etiqueta nesta fórmula, xérase a GUID cada vez que o usuario cambia o valor do control de entrada de texto :

TextInput1.Text & " " & GUID()

Cando se usa GUID unha fórmula de comportamento, avalíase cada vez que se avalía a fórmula. Para obter máis información, consulte os exemplos máis adiante neste tema.

Sintaxe

GUID( [ GUIDString ] )

• GUIDString – Opcional. Cadea de texto que ten a representación hexadecimal dun GUID. Se non fornece unha cadea, a función crea un novo GUID.

GUID( Dinámica )

• Dinámica - Obrigatoria. Valor dinámico que representa un GUID. Os valores aceptables dependen do provedor non tipificado. Para JSON, espérase que o valor dinámico sexa representado GUID como unha cadea JSON.

Exemplos

Uso básico

Para devolver un GUID valor baseado na representación de cadeas hexadecimales:

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

Tamén podes proporcionar a cadea GUID sen trazos. Esta fórmula devolve o mesmo GUID valor:

GUID( "0f8fad5bd9cb469fa16570867728950e" )

Emprégase en contexto, para configurar o campo Estado dun novo rexistro de base de datos cun valor ben establecido:

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

Probablemente non queiras mostrar GUID aos usuarios, pero os GUID poden axudarche a depurar a túa aplicación. Para mostrar o valor do campo Estado no rexistro que creou no exemplo anterior, estableza a propiedade Texto dun control Etiqueta nesta fórmula:

First( Products ).Status

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

Crear unha táboa de GUID

1. Axuste a propiedade OnSelect dun control de botón nesta fórmula:

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

   Esta fórmula crea unha táboa dunha única columna que se usa para repetir cinco veces, obtendo cinco GUID.

2. Engada un control de Táboa de datos, estableza a súa propiedade Elementos en NewGUIDs e mostra o campo Valor.

3. Manteña premida a tecla Alt e seleccione o botón.

   A táboa de datos mostra unha lista de GUID:

   

4. Seleccione de novo o botón para mostrar unha nova lista de GUIDs:

   

Para xerar unha única GUID táboa en lugar dunha táboa, use esta fórmula:

Set( NewGUID, GUID() )