Organisation par Projets et Tags

Conseils pour structurer efficacement vos déclencheurs et flux dans Ecosystem.

Prérequis

Pour créer des Apps et des ressources, consultez la documentation Ressources.

Les Apps : regroupez par système

Astuce : Une App par système externe

Créez une App pour chaque système avec lequel vous interagissez :

• Shopify (e-commerce)
• SAP (ERP)
• Mailchimp (marketing)

Avantages :

• Organisation visuelle claire
• Cartographie des échanges automatique
• Regroupement logique des ressources

Attention

Une fois créée, le nom de l'App ne peut plus être modifié et l'App ne peut pas être supprimée. Choisissez bien vos noms !

Associer les Apps

Pensez à associer vos Apps à :

Élément	Où associer	Pourquoi
Déclencheurs	Champ "App"	Identifier la source des données
Nœuds HTTP	Champ "App"	Identifier le système appelé
Ressources	Champ "App"	Regrouper les actions par système

→ Cela alimente la cartographie des échanges de données.

Les Tags : facilitez la recherche

Astuce : Stratégie de taggage

Définissez une convention de tags pour votre équipe :

Par domaine : commandes, stocks, clients Par type : api, batch, realtime Par priorité : critique, standard

Nomenclature recommandée

Déclencheurs

Format suggéré

[type]-[domaine]-[action]

Exemples :

• api-commandes-creation
• file-produits-import
• cron-stocks-sync-daily
• webhook-paiements-confirmation

Flux

Format suggéré

[action]-[domaine]-[détail]

Exemples :

• traiter-commande-ecommerce
• synchroniser-stocks-erp
• envoyer-notification-client

Nœuds

Pro Tip : Renommez vos nœuds !

Un flux avec des nœuds bien nommés est beaucoup plus facile à maintenir.

Exemples :

• Récupérer les détails commande
• Valider le montant
• Envoyer vers ERP

Les Notes dans les flux

Documentez vos flux

Les Notes sont des nœuds qui ne s'exécutent pas mais documentent votre workflow.

Utilisez-les pour :

• Expliquer une partie complexe
• Spécifier un fonctionnement particulier
• Grouper visuellement des nœuds liés

Exemple d'organisation

📁 Projet: Integration E-commerce

📦 Apps:
├── 🛒 Shopify
├── 📊 SAP
└── 📧 Mailchimp

🎯 Déclencheurs:
├── webhook-shopify-commandes [Tags: commandes, realtime]
├── cron-sync-stocks-daily [Tags: stocks, batch]
└── api-produits-creation [Tags: produits, api]

🔄 Flux:
├── traiter-commande-vers-sap
├── synchroniser-stocks-wms
└── exporter-clients-mailchimp

Checklist organisation

Avant de déployer, vérifiez

• Les Apps sont créées pour chaque système
• Les Tags sont utilisés de manière cohérente
• Les nœuds des flux sont renommés
• Les Notes documentent les parties complexes

En savoir plus

• Créer une ressource
• Apps et cartographie