Support Power Platform - Apps - Automate - SharePoint - Copilot

Fonctions Données

Compose (Message)

L’action se nomme Message (et non Compose ou Composer) dans les actions de type Données.

Proche dans le principe du fonctionnement d’une variable.

Cas d’usage :

  • Construire des chaînes de texte dynamiques (concaténer des valeurs ou expressions).
  • Calculer ou transformer des valeurs, sans avoir à créer une variable formelle.
  • Structurer des données JSON, en vue d’une utilisation ultérieure dans votre flux.

La sortie de l’action Composer est en lecture seule : utiliser Composer dès qu’une données ne doit pas être modifiée, utiliser à la place des variables quand la valeur de la variable doit être modifiée.

Compose = concat(outputs('Prénom'), ' ', outputs('Nom'))
Compose = formatDateTime(utcNow(), 'dd-MM-yyyy HH:mm')
{
  "nom": "@{outputs('Nom')}",
  "age": @{outputs('Age')}
}

Rôles dans les flux

ÉlémentComposeInitialiser une variable
TypeAction de traitement statiqueAction de stockage réutilisable
But principalCalculer ou contenir une valeur intermédiaireStocker une valeur modifiable
Modifiable ensuite ?❌ Non✅ Oui
Lisible dans un tableau ?✅ Oui (facile à lire dans le suivi du flux)✅ Oui aussi
Nom spécifiqueNon (juste "Sortie de Compose")Oui, vous donnez un nom à la variable
Réutilisation dans un Apply to each✔️ (souvent plus performant)✔️ mais un peu plus verbeux
Cas d’usagePréféré
Vous stockez un JSON temporairement sans le modifier✅ Compose (plus léger)
Vous devez mettre à jour la valeur ensuite✅ Initialiser une variable
Vous réutilisez plusieurs fois la valeur dans un flux complexe✅ Variable (mieux identifié)
Vous êtes dans un Apply to each avec performance critique✅ Compose (moins de surcharge mémoire)

Analyser JSON (Parse JSON)

Cas d'usage :

  • Extraire des données spécifiques d'une réponse d'API.
  • Désérialiser des données stockées sous forme de chaîne JSON.
  • Valider la structure d'un JSON reçu.

Sous la propriété Schéma, cliquer sur Utiliser un exemple de charge utile pour générer un schéma, puis coller un exemple de code JSON :

image.png

Après Validation, le schéma est affiché. Coller ensuite le code JSON (ou un autre) dans Content :

image.png

Interroger ensuite le JSON :

body('Analyser_JSON')['utilisateur']['nom'] donnerait "Jean Dupont"

body('Analyser_JSON')['utilisateur']['adresse']['ville'] donnerait "Paris"

body('Analyser_JSON')['utilisateur']['roles'][0] donnerait "administrateur"

Sélectionner (Select)

(Différent de la fonction Select)

Transforme un tableau en un nouveau tableau avec une structure différente. Vous pouvez choisir les propriétés à inclure, les renommer ou créer de nouvelles propriétés basées sur des expressions

Cas d'usage :

  • Réduire un grand tableau à seulement quelques colonnes nécessaires.
  • Renommer des colonnes pour correspondre à un schéma cible.
  • Créer des propriétés calculées dans le nouveau tableau.

Un JSON fourni par un étape (par exemple Liste des éléments SharePoint) :

[
    {
        "ProductID": "P001",
        "Name": "Clavier mécanique",
        "Description": "Clavier ergonomique avec rétroéclairage",
        "Price": 99.99,
        "Category": "Périphériques",
        "Stock": 150
    },
    {
        "ProductID": "P002",
        "Name": "Souris sans fil",
        "Description": "Souris optique avec autonomie longue durée",
        "Price": 49.50,
        "Category": "Périphériques",
        "Stock": 200
    }
]

Dans Carte (Map) :

image.png

L’expression avec item() est de la forme : item()['Price']