Informations générales

Vue d’ensemble ADIB est un framework d’intégration modulaire développé pour permettre un échange de données fluide entre différents systèmes tels que bases de données, fichiers, webservices, portails et plateformes cloud. Chaque module dans ADIB définit :

Source/Destination Role : Détermine si un module fournit des données (Source), reçoit des données (Destination) ou prend en charge les deux.
Pre/Post Processing : Étapes optionnelles exécutées avant ou après le transfert de données pour la validation, la transformation ou le nettoyage.
Webservice : Les modules Webservice connectent ADIB à des points de terminaison web externes. Selon la configuration, ils peuvent agir comme Source, Destination ou les deux.

Les clients d’intégration doivent configurer les Step Parameters appropriés pour interagir avec chaque module. Ces paramètres varient selon le module et déterminent comment il se connecte, traite et échange les données.

Catégories et descriptions des modules

Data File Modules

Excel / CSV

Role : Source et Destination
Description : Lit ou écrit des données structurées aux formats .xlsx ou .csv.
Use Cases : Catalogues produits, listes de prix, exportations/importations de données.

Database Modules

MySQL

Role : Source et Destination
Description : Se connecte aux bases de données MySQL pour des opérations de lecture/écriture.
Notes : Prend en charge uniquement les bases compatibles MySQL.

Oracle

Role : Source et Destination
Description : Intègre les bases Oracle en utilisant la syntaxe SQL Oracle.

MSSQL

Role : Source et Destination
Description : Se connecte à Microsoft SQL Server avec la syntaxe T-SQL.
Notes : Prend en charge les procédures stockées et certaines commandes MSSQL spécifiques.

InternalDB (SQLite)

Role : Source et Destination
Description : Base de données SQLite intégrée pour le stockage temporaire ou en cache.
Use Case : Traitement hors ligne, staging ou transformation de données.

Modules basés sur XML

XML

Role : Destination Only
Description : Écrit des données dans des fichiers XML selon des schémas définis.

Template Writer

Role : Destination Only
Description : Génère des sorties XML à l’aide de templates pour des exports structurés.
Use Case : Sortie XML template pour les échanges système-à-système.

Modules de systèmes externes

Supplier Portal

Role : Source et Destination (limité)
Description : Intégration avec des portails définis par les fournisseurs pour une synchronisation restreinte (ex. : synchronisation de produits).

DB2Mail

Role : Destination (basé sur événement)
Description : Envoie automatiquement des notifications par e-mail lorsque des produits sont créés, mis à jour ou supprimés.
Use Case : Alertes basées sur les événements et triggers de synchronisation.

Modules Webservice individuels

Elasticsearch2Database

Role : Source
Description : Lit des données depuis Elasticsearch et les écrit dans une base relationnelle.
Use Cases : Migration de données, analyses.

CS-Elastic

Role : Source et Destination
Description : Transfère des données entre ContentServ et Elasticsearch.
Use Cases : Synchronisation des données de portail, construction d’index de recherche.

CS Elasticsearch CSV Export

Role : Source
Description : Exporte les données produit de l’index Elastic de ContentServ en CSV.
Use Cases : Export massif pour BI ou migration de données.

CS Elasticsearch Transform

Role : Destination
Description : Transforme les données entre deux indices Elasticsearch.
Use Cases : Adaptation des données CS Elastic pour utilisation sur portail.

Workflow Actions

Role : Module d’exécution / automatisation
Description : Exécute les tâches en file d’attente, actions ou étapes de workflow.
Use Cases : Automatisation des processus d’intégration.

Portal-Changes

Role : Source et Destination
Description : Suit et écrit les changements de données du portail dans l’index Elastic et les resynchronise avec ContentServ.
Use Cases : Suivi des changements côté portail et resynchronisation.

Pre / Post Process Modules

Ces modules sont utilisés pour effectuer des actions avant (Pre) ou après (Post) une opération principale de données.

Module	Description
FTP / SFTP	Transfert de fichiers avant ou après traitement (supporte SFCC)
Email	Envoi d’e-mails de notification (post uniquement)
SCP / RSYNC	Synchronisation de fichiers (peu utilisé)
Shell	Exécute des scripts Shell avant ou après un Job
Prepare File with Timestamp	Renomme les fichiers avec horodatage
Archive File after Import	Déplace les fichiers traités vers un dossier d’archive
Replace Pattern in File	Effectue rechercher/remplacer dans les fichiers
Delete Old Logs from Elastic	Supprime les anciens logs Elasticsearch par horodatage
Delete Files or Directories	Nettoie fichiers ou dossiers après traitement
Azure Upload	Téléverse des fichiers sur Microsoft Azure (similaire à FTP)

Cloud Modules

CS Cloud Data Export (PIM/DAM)

Role : Source
Description : Déclenche l’export des flux de données depuis ContentServ Cloud et télécharge les résultats au format CSV.
Use Cases : Export de données produit ou d’assets.

CS Cloud Data Import (PIM/DAM)

Role : Destination
Description : Importe les données dans ContentServ Cloud (fonctionnalité limitée).
Limitations : Fonctionne uniquement pour des imports d’attributs simples, pas pour des sous-tables.

CS Cloud Data Model

Role : Source ou Destination
Description : Exporte ou importe le modèle de données entre ADIB et ContentServ.

CS Cloud Configuration

Sous-modules :
- CS Analysis Job : Récupère l’état du système ContentServ (ex. : IDs d’objets).
- CS Analysis : Analyse l’état du système et les dépendances.
- Install : Déploie les modules Conigon depuis GitLab dans ContentServ.

Tableau récapitulatif des modules

Module	Source	Destination	Description
Excel / CSV	✔️	✔️	Échange de données basé sur fichiers
MySQL	✔️	✔️	Lecture/écriture DB
Oracle	✔️	✔️	Lecture/écriture DB
MSSQL	✔️	✔️	Lecture/écriture DB
InternalDB (SQLite)	✔️	✔️	Cache local
XML	❌	✔️	Export XML
Template Writer	❌	✔️	Sortie XML template
Supplier Portal	✔️	✔️ (limité)	Intégration fournisseur
DB2Mail	❌	✔️	Notifications par e-mail
Elasticsearch2Database	✔️	✔️	Elastic → DB
Webservice General	✔️	✔️	Intégration REST/SOAP
SW Cust/Order	✔️	✔️	Synchronisation client/commande
SW Articles/Variants	✔️	✔️	Synchronisation produits
CS-Elastic	✔️	✔️	ContentServ ↔ Elastic
Workflow Actions	✔️	✔️	Automatisation basée sur file d’attente
Portal-Changes	✔️	✔️	Suivi des changements portail
Elastic Search	❌	✔️	Écriture dans index Elastic
CS Elastic CSV Export	✔️	❌	Elastic → CSV Export
CS Elastic Transform	✔️	✔️	Transformation Elastic → Elastic
Source2Edit Portal	✔️	❌	Source personnalisée portail

Modèle de licence

Conigon ADIB est composé de plusieurs modules qui peuvent être licenciés individuellement. Cette approche modulaire permet :

De commencer petit et de monter en charge plus tard.
D’ajouter de nouveaux modules ou serveurs d’intégration selon les besoins.
De ne payer que pour les modules réellement utilisés.