# Transform

> Transformez n’importe quelle source de données – interne ou externe – vers le format dont vous avez besoin (tableau, collection…) sans écrire une seule ligne de code.

https://docs.pandasuite.com/fr/essentials/components/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).

Le composant 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 `;`.

> **Info : Pourquoi un composant dédié ?**
>
> Avant l’introduction de ce composant, il fallait combiner plusieurs fonctions avancées pour reformater des données. Le composant **Transform** simplifie et centralise cette tâche dans une interface visuelle et intuitive.

## Cas d'utilisation

- 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](https://docs.pandasuite.com/fr/essentials/components/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 dans PandaSuite Studio.
2. Dans le menu des **Composants**, recherchez **Transform**.
3. Ajoutez 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** ou **Collection**.                                                                                        | Contrôle la façon dont PandaSuite expose le résultat                                                       |
| **Élément** | Gabarit JSON qui décrit comment chaque élément de la source est transformé. En mode **Collection**, il est généré à partir de la source courante. | Éditable. En mode **Collection**, utilisez le bouton de configuration auto pour le générer ou le régénérer |

### Générer ou régénérer le mapping de l’Élément

Quand **Format** est réglé sur **Collection**, le champ **Élément** s’appuie sur la structure actuelle de la source.

Si vous changez **Source**, PandaSuite vide le mapping courant de **Élément** pour éviter de conserver un schéma obsolète.

Si **Élément** est vide, cliquez sur le bouton de configuration auto à côté de **Élément** pour générer le mapping à partir de la source courante.

Si un mapping existe déjà et que la source change, utilisez ce même bouton pour le régénérer, puis vérifiez le résultat dans l’aperçu **JSON** ou **Table**.

[Image : Transform avec les records d'Airtable en Source et le format Collection : le champ Item, encore vide, et son bouton d'auto-configuration, encadrés]

### 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** : une vue en grille des données, 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](https://docs.pandasuite.com/fr/essentials/components/http/).

[Image : Transform réglé pour Airtable : Source leads, Format Array, et un Item dont les champs sont regroupés dans le nœud fields, encadrés]

[Modèle : Formulaire collecte de leads](https://pandasuite.com/fr/templates/formulaire-collecte-leads-hors-ligne/)

### 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](https://docs.pandasuite.com/fr/essentials/components/http/)
- La réponse contient un tableau *records*
- Sélectionnez *records* (le tableau) comme **Source** de Transform.

2. **Format** : choisissez **Collection**.

3. **Élément** auto-généré :
   Transform détecte la structure et propose des clés telles que `fields.Name`, `fields.Image`, etc.
   Si vous changez ensuite le tableau source, cliquez sur le bouton de configuration auto pour régénérer **Élément** avant de réutiliser la sortie.

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

[Image : Transform réglé sur la réponse Airtable : Source records, Format Collection et un Item avec les champs Airtable (Address, Category, GPS…), encadrés]

[Modèle : Paris City Guide](https://pandasuite.com/fr/templates/collection-adresses-paris/)

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