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 ;

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

1. Ouvrez votre projet PandaSuite Studio.
2. Dans le menu des Composants, recherchez Transform.
3. 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.

1. Source : sélectionnez votre collection PandaSuite (par exemple leads).
2. Format : choisissez Tableau (Airtable attend un tableau d’objets).
3. É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)
4. Envoi : utilisez ce Transform comme Corps de la requête PATCH ou POST du composant HTTP.

Convertir la réponse d’une API en collection PandaSuite

Objectif : afficher les records d’Airtable (format natif API) dans un Collection / Liste.

2. 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.

3. Format : choisissez Collection.

4. Élément auto-généré : Transform détecte la structure et propose des clés telles que fields.Name, fields.Image, etc.

5. 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…

Bonnes 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 ou API → 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.