GUID Fonction

S’applique à : Les applications Canvas Copilot Studio Desktop circulent des applications basées sur des modèles et des fonctions Dataverse power Platform CLI

Convertissez une GUID chaîne (identificateur global unique) en valeur GUID ou créez une nouvelle GUID valeur.

Description

Utilisez la GUID fonction pour convertir une chaîne avec la représentation hexadécimale d’un GUID en une GUID valeur que vous pouvez transmettre à une base de données. Les systèmes de base de données tels que Microsoft Dataverse et SQL Server utilisent GUID des valeurs en tant que clés.

La chaîne peut avoir des lettres majuscules ou minuscules, mais il doit contenir 32 chiffres hexadécimaux dans l’un des formats suivants :

• "123e4567-e89b-12d3-a456-426655440000" (traits d’union aux emplacements standard)
• "123e4567e89b12d3a456426655440000" (sans trait d’union)

Si vous ne spécifiez pas d’argument, la fonction crée un nouvel GUIDargument .

Pour convertir une GUID valeur en chaîne, utilisez-la dans un contexte de chaîne. La GUID valeur se convertit en chaîne hexadécimale avec des traits d’union et des lettres minuscules.

Lors de la génération d’un nouveau GUID, la fonction utilise des nombres pseudo-aléatoires pour créer une version 4 IETF RFC 4122GUID. Lors de la conversion d’une chaîne en une GUID, la fonction prend en charge n’importe quelle version en acceptant n’importe quelle GUID chaîne de 32 chiffres hexadécimaux.

Fonctions volatiles

GUID est une fonction volatile lorsqu’elle est utilisée sans argument. Chaque fois que la fonction est évaluée, elle retourne une valeur différente.

Lorsque vous utilisez une fonction volatile dans une formule de flux de données, elle retourne une valeur différente uniquement si la formule est réévaluée. Si rien d’autre n’est modifié dans la formule, il conserve la même valeur pendant que votre application est ouverte.

Par exemple, si vous définissez la propriété Text d’un contrôle GUIDd’étiquette sur (), elle ne change pas pendant que votre application est active. Vous obtenez une valeur différente uniquement lorsque vous fermez et rouvrez l’application.

La fonction est réévaluée si elle fait partie d’une formule où quelque chose d’autre change. Par exemple, si vous définissez la propriété Text d’un contrôle Label sur cette formule, un GUID est généré chaque fois que l’utilisateur modifie la valeur du contrôle d’entrée de texte :

TextInput1.Text & " & GUID()

Lorsque vous utilisez GUID une formule de comportement, elle est évaluée chaque fois que la formule est évaluée. Pour plus d’informations, consultez les exemples plus loin dans cette rubrique.

Syntaxe

GUID( [ GUIDString ] )

• GUIDString – Facultatif. Chaîne de texte qui a la représentation hexadécimale d’un GUID. Si vous ne fournissez pas de chaîne, la fonction crée un nouveau GUID.

GUID( Dynamique )

• Dynamique : obligatoire. Valeur dynamique qui représente un GUID. Les valeurs acceptables dépendent du fournisseur non typé. Pour JSON, la valeur dynamique est censée être représentée GUID sous forme de chaîne JSON.

Examples

Utilisation de base

Pour retourner une GUID valeur basée sur la représentation sous forme de chaîne hexadécimale :

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

Vous pouvez également fournir la GUID chaîne sans traits d’union. Cette formule retourne la même GUID valeur :

GUID( "0f8fad5bd9cb469fa16570867728950e" )

Utilisé en contexte pour définir le champ Statut d’un nouvel enregistrement de base de données sur une valeur bien établie :

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

Vous ne souhaitez probablement pas afficher les GUID aux utilisateurs, mais les GUID peuvent vous aider à déboguer votre application. Pour afficher la valeur du champ État dans l’enregistrement que vous avez créé dans l’exemple précédent, définissez la propriété Text d’un contrôle Label sur cette formule :

First( Products ).Status

Le contrôle Label affiche f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

Créer une table de GUID

1. Définissez la propriété OnSelect d’un contrôle Button sur la formule suivante :

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

   Cette formule crée un tableau d’une seule colonne qui est utilisé pour effectuer cinq itérations, ce qui produit cinq GUID.

2. Ajoutez un contrôle Data table, définissez sa propriété Items sur NewGUIDs et affichez le champ Value.

3. Maintenez la touche Alt enfoncée et sélectionnez le bouton.

   La table de données affiche une liste de GUID :

   

4. Sélectionnez à nouveau le bouton pour afficher une nouvelle liste de GUID :

   

Pour générer un seul GUID au lieu d’une table, utilisez cette formule :

Set( NewGUID, GUID() )