Importer et exporter
L’import et l’export déplacent une définition de workflow entre instances, sauvegardes ou dépôts Git — sans exporter les credentials (par design).
🔁 Exporter
- Ouvre le workflow.
- Menu ⋯ → Export (ou équivalent).
- Enregistre le fichier
.knot.json.
Le fichier contient :
- version du schéma Knot ;
- nodes, edges (
source/target) ; - réglages de trigger ;
- références aux credentials par identifiant logique, pas les secrets.
🔁 Importer
- Workflows → Import.
- Sélectionne le
.knot.json. - Résous les credentials manquants (mapping vers tes entrées chiffrées locales).
- Simulate puis active.
🔁 Compatibilité de versions
| Situation | Comportement attendu |
|---|---|
| Même version Knot | Import transparent |
| Version plus récente → plus ancienne | Champs ignorés ou erreur explicite |
| Migration majeure | Suivre les notes de version Knot Core |
Conserve les exports dans ton outil de backup avec la version Knot (knot_version dans les métadonnées d’export quand disponible).
🔁 Bonnes pratiques
- Un fichier = un workflow métier (évite les monolithes).
- Versionne les
.knot.jsondans Git côté équipe (sans secrets). - Documente les credentials requis dans le README interne du projet.
🔁 Templates publics
Les exemples examples/*.knot.json du dépôt Knot Core utilisent uniquement des données fictives (Demo Industries, @example.com). Parfait pour apprendre sans fuite de données client.