Transform
Le composant Transform vous permet de transformer une source de données, interne (collection PandaSuite) ou externe (API REST, JSON), pour l’adapter au format attendu par un autre service ou composant, sans écrire une seule ligne de code. C’est un véritable pont entre le monde PandaSuite (collections, références, multi-références) et les formats externes (tableaux JSON, services tiers).
Il détecte automatiquement les éléments compatibles avec des types Panda et utilise des fonctions quand des types PandaSuite sont détectés (ex. parseCord)
pour traiter des chaînes GPS séparées par ;
Pourquoi un composant dédié ?
Avant l’introduction de ce composant, il fallait combiner plusieurs fonctions avancées pour reformater des données. Transform simplifie et centralise cette tâche dans une interface visuelle et intuitive.
Cas d’utilisations
- Vous possédez déjà une collection PandaSuite et vous devez envoyer ces données à un service externe (Airtable, REST API, Firebase…) qui attend un tableau bien précis.
- Vous appelez une API externe (via le composant HTTP) ; la réponse est un tableau d’objets que PandaSuite ne reconnaît pas encore comme une collection exploitable.
- Vous souhaitez uniformiser ou enrichir vos données : supprimer des champs inutiles, ajouter des valeurs calculées, renommer des clés, convertir des coordonnées GPS, etc.
Mise en Place du Composant
Insertion dans le Projet
- Ouvrez votre projet PandaSuite Studio.
- Dans le menu des Composants, recherchez Transform.
- Glissez-déposez le composant dans votre scène.
Caractéristiques du composant
Propriétés
Propriété | Description | Particularités |
---|---|---|
Source | Lien vers un tableau ou une collection. | Obligatoire |
Mode | Type de transformation. Actuellement fixé à Map (désactivé dans l’interface, prévu pour de futurs modes). | Lecture seule |
Format | Choix du format de sortie : Tableau (tableau JavaScript) ou Collection . | Impacte la manière dont PandaSuite expose le résultat |
Item | Gabarit JSON qui décrit comment chaque élément de la source est transformé. | Auto-généré à partir de la source, entièrement éditable |
Aperçu en temps réel
Double-cliquez sur le composant Transform pour entrer dans son contexte. Vous disposez de deux vues :
- JSON : affiche la réponse brute telle qu’elle sera fournie aux autres composants.
- Table : aperçu tabulaire, plus lisible pour valider rapidement votre mapping.
Exemples pratiques
Préparer l’envoi d’une collection PandaSuite vers Airtable
Objectif : mettre à jour la table « Records » d’Airtable depuis une Collection PandaSuite.
- Source : sélectionnez votre collection PandaSuite (par exemple leads).
- Format : choisissez
Tableau
(Airtable attend un tableau d’objets). - Élément auto-généré : Transform a pré-rempli le JSON avec tous les champs de leads.
- Supprimez les clés inutiles.
- Encapsulez le tout dans le nœud fields.
- Ajoutez, si nécessaire, des champs statiques ou des bindings (ex. : date actuelle)
- Envoi : utilisez ce Transform comme Corps de la requête PATCH ou POST du composant HTTP.

Formulaire collecte de leads
Ajoutez ce template en quelques clics à votre compte. Modifiez et personnalisez-le en toute liberté.
→ Ajouter ce template à votre compteConvertir la réponse d’une API en collection PandaSuite
Objectif : afficher les records d’Airtable (format natif API) dans un Collection / Liste.
- Source :
- Configurez la requête GET vers Airtable via le composant HTTP
- La réponse contient un tableau
records
- Sélectionnez
records
(le tableau) comme Source de Transform.
-
Format : choisissez
Collection
. -
Élément auto-généré : Transform détecte la structure et propose des clés telles que
fields.Name
,fields.Image
, etc. -
La sortie du Transform devient la Source d’un composant Collection / Liste ; profitez alors des références, multi-références, filtres, pages dynamiques…

Paris City Guide
Ajoutez ce template en quelques clics à votre compte. Modifiez et personnalisez-le en toute liberté.
→ Ajouter ce template à votre compteBonnes pratiques
- Toujours tester la transformation dans le panneau d’aperçu avant de connecter d’autres composants.
- Nommer clairement votre Transform (ex.
Transform to Airtable
ouAPI → Collection
) pour garder la logique lisible. - Centralisez les transformations : un Transform peut être utilisé comme source par plusieurs composants (HTTP, Condition, etc.).
- Gardez l’Élément léger ; plus il est simple, plus la maintenance est facile.
FAQ
Le JSON de sortie semble correct mais mon API renvoie une erreur ; que faire ?
Vérifiez les en-têtes et le format (array vs. object). Utilisez l’aperçu JSON pour confirmer.
Puis-je chaîner plusieurs Transform ?
Oui. La sortie d’un Transform peut être la source d’un second Transform pour des transformations plus complexes.
Transform impacte-t-il ma collection d’origine ?
Non. Il lit uniquement la source et crée un nouvel objet en sortie ; vos données restent intactes.