Aller au contenu

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

  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éDescriptionParticularités
SourceLien vers un tableau ou une collection.Obligatoire
ModeType de transformation. Actuellement fixé à Map (désactivé dans l’interface, prévu pour de futurs modes).Lecture seule
FormatChoix du format de sortie : Tableau (tableau JavaScript) ou Collection.Impacte la manière dont PandaSuite expose le résultat
ItemGabarit 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.
Préparer l’envoi d’une collection PandaSuite vers Airtable

Formulaire collecte de leads

Ajoutez ce template en quelques clics à votre compte. Modifiez et personnalisez-le en toute liberté.

→ Ajouter ce template à votre compte

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

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

  1. 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.
  1. Format : choisissez Collection.

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

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

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

Paris City Guide

Ajoutez ce template en quelques clics à votre compte. Modifiez et personnalisez-le en toute liberté.

→ Ajouter ce template à votre compte

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.