Guide Orchestria
Transformation de données sans code

Orchestria est une plateforme no-code qui vous permet de créer des transformation de données intelligents. Que vous travailliez avec du JSON, XML, CSV, PDF ou du texte brut, vous pouvez automatiser vos processus de transformation sans écrire une seule ligne de code. L'intelligence artificielle génère le code de transformation pour vous — vos données ne quittent jamais votre machine.

1 Créer sa première transformation

La vidéo ci-dessus montre le parcours complet. L'essentiel à retenir :

  • Mode simple : un assistant guidé (nom, formats, échantillons, instructions, récapitulatif, génération). Mode expert : tout dans une seule fenêtre.
  • Formats : JSON, XML, CSV, texte ou PDF en entrée et en sortie. En CSV, précisez le séparateur et la présence d'une ligne d'en-tête.
  • Échantillons : un exemple réel de vos données d'entrée et le résultat attendu. C'est ce qui permet à l'IA de comprendre la transformation.
  • Instructions : décrivez en quelques phrases ce que la transformation doit faire. Citez les champs par leur nom, avec la notation pointée pour les objets imbriqués (« client.adresse.ville »).
  • Génération : à l'enregistrement, l'IA génère le code ; vous testez ensuite le résultat, puis vous le faites évoluer par le chat.

⚠️ Les échantillons sont envoyés à l'IA pour générer le code de transformation : anonymisez-les.

💡 Exemples d'instructions efficaces :

  • • « Extraire les commandes dont le montant dépasse 100 € et formater la date en JJ/MM/AAAA »
  • • « Filtrer les clients actifs, trier par date d'inscription décroissante »
  • • « Ajouter un champ "total_ttc" calculé avec une TVA à 20 % »

2 Appeler sa transformation par API

La vidéo ci-dessus montre le parcours complet. L'essentiel à retenir :

  • URL d'appel : l'icône « œil » de la liste affiche l'URL unique et permanente de la transformation. L'appel se fait en POST, avec vos données dans le corps de la requête.
  • Clé API : créez-la dans Développeur → Clés API et transmettez-la dans l'en-tête Authorization (« Bearer » suivi de la clé). Ne la partagez jamais : elle donne accès à vos transformations.
  • Historique : chaque appel apparaît dans les Logs, avec son statut et son résultat.
cURL bash 
curl -X POST https://orchestria.io/api/flows/YOUR_FLOW_UID/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: text/csv" \
  --data-binary @commandes.csv

3 Automatiser avec le routage

La vidéo ci-dessus montre le parcours complet. L'essentiel à retenir :

  • Entrée : un connecteur SFTP surveille un dossier et relève automatiquement les nouveaux fichiers (avec archivage optionnel) ; un connecteur HTTP interroge régulièrement une API. Chaque relève, même vide, compte dans votre quota : choisissez une fréquence adaptée.
  • Sortie : le résultat est envoyé vers un webhook (une URL de votre système) ou déposé en fichier sur un serveur SFTP.
  • Routage : la page Routage relie une transformation à ses connecteurs d'entrée et de sortie. Un connecteur se crée une fois et se réutilise sur plusieurs transformations.
  • Authentification : aucune, Bearer Token, Basic Auth ou Sign-In (connexion préalable qui fournit un jeton).

4 Enchaîner des transformations

Le résultat d'une transformation devient l'entrée de la suivante : par exemple, une commande CSV convertie en XML, puis envoyée à la facturation (XML → JSON) et à la logistique (XML → CSV). Le diagramme de la page Routage montre la chaîne, un bandeau signale une chaîne sans sortie, et les Logs gardent la trace de chaque relais.

5 Le DNS virtuel

Un DNS virtuel donne une adresse stable (par exemple « production » et « recette ») qui pointe vers la transformation de votre choix. Vous testez une nouvelle version sur l'adresse de recette, puis vous basculez l'adresse de production vers elle : vos systèmes appelants n'ont rien à changer, et le retour arrière est immédiat.

6 Traiter des documents PDF

La vidéo ci-dessus montre le parcours complet. L'essentiel à retenir :

  • Extraction : l'IA Vision lit chaque PDF et remplit un modèle JSON (numéro, date, émetteur, montants, lignes…). Le modèle est proposé à partir de votre exemple ; vous pouvez renommer, retirer ou ajouter des champs, partir d'un modèle prédéfini (Facture, Bon de commande, Devis, Bon de livraison) et vérifier avec « Tester le modèle ».
  • Transformation : le JSON extrait est ensuite transformé vers votre format de sortie, comme pour toute transformation.
  • Validation : la page « Validations PDF » montre le PDF et les données côte à côte, le score et le détail des contrôles, permet de corriger le JSON, de valider ou de rejeter, un par un ou en masse.

Les 3 modes de validation

  • 🚀 Automatique : exécution immédiate après l'extraction, sans vérification humaine. Pour des documents standardisés et fiables.
  • ⚖️ Contrôlé : un score de cohérence est calculé selon le type de document (totaux, TVA, numéro, date…). Au-dessus du seuil (95 % par défaut), exécution automatique ; en dessous, mise en attente de validation.
  • 👁️ Manuel : chaque PDF attend une validation humaine avant exécution.

Envoyer un PDF par l'API

cURL bash 
curl -X POST https://orchestria.io/api/flows/YOUR_FLOW_UID/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/pdf" \
  -H "X-Filename: invoice.pdf" \
  --data-binary @invoice.pdf

En mode Contrôlé ou Manuel, la réponse est 202 avec "status": "pending_validation" tant que le document n'est pas validé.

🔒 Conformité RGPD

  • Consentement explicite avant chaque extraction IA
  • PDF temporaires supprimés automatiquement après validation
  • Expiration automatique : 7 jours maximum

7 Alertes, journaux et diagnostic

La vidéo ci-dessus montre le parcours complet. L'essentiel à retenir :

  • Règles d'alerte : demandez-les au chat de la transformation, en français courant (« alerte-moi si le montant TTC dépasse 10 000 € »), ou dès la création.
  • Emails : cochez « Alertes email » sur la transformation. Vous recevez un email à chaque exécution qui déclenche une règle, un email ❌ quand une exécution échoue, puis un ✅ quand tout refonctionne.
  • Journaux : la page Logs liste toutes les exécutions (filtres par transformation, statut, dates) ; le lien d'un email d'alerte ouvre directement l'exécution concernée.
  • Diagnostic : le détail d'une exécution donne la cause lisible de l'erreur et le détail technique ; le bouton « Expliquer » (plans Pro et plus) en fait une analyse par l'IA.

8 Votre compte et vos outils

Chaque plan fixe des quotas mensuels, visibles dans la barre de quotas en haut de l'application et dans « Mon compte » :

  • Transformations : nombre de transformations que vous pouvez créer.
  • Exécutions : chaque appel compte, qu'il réussisse ou échoue.
  • Tokens IA : consommés à la création, par le chat et par l'extraction des PDF.

La vidéo montre aussi les réglages du compte (langue, fuseau horaire, fournisseur d'IA), le changement de plan, la documentation PDF et la documentation API (Swagger) d'une transformation, et son verrouillage.

9 Choix du fournisseur IA

Orchestria supporte plusieurs fournisseurs d'intelligence artificielle. Vous pouvez choisir celui qui correspond le mieux à vos besoins en termes de qualité et de coût.

Fournisseurs disponibles

OpenAI

Fournisseur de référence du marché. Haute précision pour la génération de transformations et l'extraction PDF. Recommandé pour les cas d'usage critiques nécessitant une fiabilité maximale.

Mistral (défaut)

74% moins cher qu'OpenAI avec une qualité équivalente. Excellent rapport qualité/prix pour la majorité des cas d'usage. Supporte également l'extraction PDF.

Comment changer de fournisseur

Rendez-vous dans Mon Compte → Paramètres pour sélectionner votre fournisseur IA. Le changement s'applique immédiatement à toutes vos opérations : création de transformations, modifications via le chat IA, et extraction PDF.

💡 Mistral est sélectionné par défaut pour optimiser vos coûts. Les deux fournisseurs consomment vos crédits IA de la même manière.

10 Sécurité et Confidentialité

La protection de vos données est notre priorité absolue. Orchestria est conçu pour garantir une confidentialité totale de vos données métier.

Séparation IA et données

L'intelligence artificielle est utilisée uniquement lors de la création de la transformation pour générer le code de transformation. Elle n'a accès qu'aux échantillons que vous fournissez, jamais à vos données réelles de production. Vos payloads d'exécution ne transitent jamais par les services d'IA.

Aucun stockage des données

Les données que vous envoyez pour exécution sont traitées en mémoire puis immédiatement supprimées. Orchestria ne conserve aucun payload, ce qui rend impossible la rejouabilité d'une exécution mais garantit une conformité RGPD totale. Seules les métadonnées (statut, horodatage, utilisateur) sont conservées pour les logs.

Protection des échantillons

Les échantillons de données que vous fournissez lors de la création d'une transformation restent stockés dans votre compte de manière sécurisée et ne sont jamais partagés avec des tiers. Ces échantillons sont nécessaires au fonctionnement de la transformation et peuvent être modifiés en éditant la transformation.

IA et documents PDF

Lors de la création ou modification d'une transformation PDF, le document est transmis à l'IA pour le traitement. Seul le mode "PDF Vision" utilise l'IA pour l'extraction des données à chaque exécution. Ce mode consomme plus de ressources et doit être utilisé en connaissance de cause pour les documents complexes ou scannés.

11 Limites techniques

Pour garantir des performances optimales et une stabilité du service pour tous, Orchestria applique certaines limites techniques aux payloads traités.

Taille maximale des payloads

La taille maximale d'une requête (payload d'entrée) est de 10 Mo. Cette limite s'applique uniformément à tous les formats (JSON, XML, CSV, texte) et à toutes les méthodes d'exécution (API REST, webhooks, connecteurs). Au-delà de cette limite, vous recevrez une erreur 413 (Request Entity Too Large).

Capacités par format

Une limite de 10 Mo permet de traiter environ 500 000 objets JSON simples, 100 000 à 200 000 lignes CSV, ou 20 000 éléments XML complexes. Cette capacité couvre 95 à 98% des cas d'usage d'intégration standard. Pour des volumes plus importants, nous recommandons de découper vos données en plusieurs appels ou de nous contacter pour discuter d'une solution adaptée à vos besoins.

↑ Retour en haut