L’interface Divalto - Techform

Techform est un configurateur qui peut compléter la création de commande de Divalto ERP.

Historiquement, les deux produits devaient être installés en client lourd sur un poste, mais depuis la version ERP 10.9 un nouveau mode d'échange est en place pour permettre une communication par services web.

Le mode de communication a donc évolué avec les produits, mais les principes et flux de données sont restés inchangés, ainsi que les formats de fichiers XML échangés.

SOMMAIRE

Principe des échanges

Il existe 2 flux ou manières d’utiliser le configurateur Techform avec Divalto ERP

• Flux interactif : Mode interactif en saisie de pièce, pour configurer un nouvel article à vendre

• Flux silencieux : Import de pièce, pour importer une configuration déjà conçue par une application tierce (comme un site web de vente)

Commun aux deux flux : l’authentification

Afin de dialoguer avec Techform, un premier échange de services web est requis pour gérer l’authentification.

Cet échange a pour but d’obtenir un jeton (token) de session, qui sera utilisé pour la suite des échanges dans l’un ou l’autre des flux.

Flux interactif (configuration depuis la saisie de commande)

Dans ce mode de communication, un utilisateur est connecté à l’ERP en client léger.

Les échanges entre Divalto ERP et Techform sont donc synchrones en suivant un déroulement préétabli

1. L’utilisateur saisit une pièce commerciale avec des articles nécessitant une configuration.

2. Authentification Techform et appel du configurateur

3. Le service Login renvoie le cookie de session, à utiliser dans les prochains échanges

4. Envoi des paramètres et appel du configurateur en mode Web (navigateur). La saisie de pièce est bloquée pendant ce temps

5. En fin de configuration, Techform invoque un service web Divalto et envoie les données de configuration validées par l’utilisateur (sous forme de 2 fichiers XML : NOMENCLATURE et PIECES)

6. Le service Web Divalto récupère le contenu des fichiers et les enregistre dans leur format brut (fichiers XML), prêts à être intégrés

7. Appel de l’intégration des données de configuration. Un ID (GUID) est fourni par Techform, et enregistré dans Divalto dans le mouvement de pièce pour éventuel rappel de la configuration depuis la pièce.

8. Retour en saisie de pièces

Flux silencieux (import de configuration)

Ce mode est utilisé pour des commandes provenant d’une source externe à Divalto (ex : un site web de vente) sur laquelle la configuration a déjà été complétée dans Techform.

A noter que dans ce mode, nous n’utiliserons pas la plateforme BtoE Techform dans la mesure où les pièces commerciales peuvent contenir des articles configurés et des articles négoces non visibles par Techform.

L’envoi des commandes vers Divalto sera donc à la charge de l’application tierce.

1. DANS L’APPLICATION TIERCE

   1. L’utilisateur saisit une pièce commerciale avec des articles configurables dans l’application tierce, il s’authentifie à Techform

   2. Le service Login renvoie le cookie de session, à utiliser dans les prochains échanges

   3. Envoi des paramètres et appel du configurateur web par l’application tierce

   4. Configuration terminée, le middleware Techform renvoie les données de configuration

2. L’application tierce envoie la commande vers l’ERP

3. Intégration de la pièce dans l’ERP

4. L’intégration de pièce détecte des articles configurés sur la pièce en cours (présence d’un GUID), appel d’un service web Techform pour récupérer les configurations détaillées.

5. Envoi des configurations vers Divalto

6. Intégration des données Techform (fichiers XML)

7. Retour d’information intégration données Techform

8. Retour d’information création de pièce

Paramétrage ERP

Codes de services web

Pour le fonctionnement avec Techform il faudra

• un service web, commun à tous les flux, utilisé pour l’authentification (appelé Middleware)

• un service web par configurateur Techform. Par exemple si Techforme comporte des articles configurables “porte de garage” et “fenêtre”, il faudra 2 services web

Il sont tous référencés dans la table de Paramétrage de services web (MURLSW) du menu Administration / Dématérialisation / Paramétrage services web

Service web unique pour échanges configurateur

Informations à saisir:

• Son CODE SERVICE WEB est libre mais il est recommandé : TECHFORM_MIDDLEWARE

• TYPE DE SERVICE WEB : Configurateur

• Il devra comporter : URL, Login et Mot de passe

Les autres champs (mode d’attente, paiement par défaut, URL Web) ne sont pas utilisés

Service web pour article configurateur

Informations à saisir:

• Son CODE SERVICE WEB est libre mais il est recommandé d’utiliser la configuration techform, par exemple ici TECHFORM_TIROIR

• TYPE DE SERVICE WEB : Configurateur

• URL (1) : c’est l’URL de l’API côté Techform pour le dialogue

• URL Web (2) : c’est l’URL de l’application web Techform pour ouvrir le navigateur (accès au configurateur après envoi des paramètres)

Les autres champs (mode d’attente, paiement par défaut) ne sont pas utilisés. Le login et le mot de passe ne sont pas utilisés ; c’est le service d’authentification qui est chargé de l’identification

Fiche dossier Production

Sur le dossier production, le code du chemin d’entrée des fichiers est inchangé (Fichiers interfaces ; utilisé historiquement pour recevoir les fichiers XML). Il sert uniquement d’emplacement de stockage temporaire lors des échanges.

Un paramètre a été ajouté pour indiquer le code du service web du middleware Techform, ce service web gère toutes les opérations transversales, notamment l’authentification. On renseigne donc le code du service web créé précédemment, ici TECHFORM_MIDDLEWARE dans le champ Service web du middleware

Fiche article

L’article est celui qui sera mis dans une commande afin de déclencher le configurateur.

Il porte donc, sur la fiche article dans le champ “Service web configurateur”, le code de service web d’accès au configurateur article web Techform créé précédemment, par exemple ici TECHFORM_TIROIR, et sert ainsi de déclencheur à la configuration.

Note : l’ancien code chemin (Chemin du configurateur) utilisé par le client lourd reste valide, mais non utilisé dans ce cas.

Paramétrage services web entrants

Les services web entrant vers Divalto ERP doivent être opérationnels car il en a un spécifique à la liaison Techform.

Il s’agit du INTEGRER_CONFIG_PIECE en tant qu’action de service de SYNCHRO_INFINITY_AGILEO.

Ce service web permet de récupérer

• le flux de création de devis par dépose de fichier XML (flux silencieux, GG_TECHFORM_DEVIS)

• le flux de création de nomenclature par dépose de fichier XML (flux interactif, GG_TECHFORM_NOMENCLATURE)

• (ce service web ne sert que de transfert de fichiers, il n’y a aucun traitement métier à l’intérieur)

Utilisation du configurateur

Le configurateur s’appuie principalement sur deux imports par fichier XML:

• La création de NOMENCLATURE Import de données techniques

• La création ou complétion de PIECE, soit lors de la saisie de pièce, soit via Datahub Pièce commerciale (V10.5)

Appel du configurateur (flux interactif)

Le configurateur est appelé automatiquement à la validation d’une ligne de pièce sur un article configurable, ce dernier étant détecté parce que l’article indiqué sur la ligne a été paramétré comme “configurateur externe”.

La saisie de pièce est mise en attente le temps de la configuration, l’utilisateur peut reprendre la main dès qu’il a terminé les actions dans Techform. Des informations sont envoyées au configurateur (dossier, établissement, tiers, référence, …) et l’identifiant Techform est stocké sur la ligne de pièce (MOUV.ConfigurateurGuid) pour déterminer notamment s’il s’agit d’une création ou modification

A la fin de la configuration, Techform fait appel aux services web en déposant les fichiers XML NOMENCLATURE et PIECES pour leur intégration à la volée, et donc traiter la complétion de la pièce en cours de saisie ainsi que l’import de données techniques (nomenclature).

Import du configurateur (flux silencieux)

Dans ce mode il n’y a pas d’interaction utilisateur dans Divalto.

C’est l’application tierce est le déclencheur. Un devis ou une commande sera intégrée par service web, avec une nomenclature, selon les fichiers XML (NOMENCLATURE et PIECES) déposés au service web ERP entrant depuis Techform.

• La gestion de la pièce commerciale est faite par le Datahub (création de commande) qui intègre la récupération des informations complémentaires Techform lors du traitement par le Datahub.

• La gestion des données techniques est faite par l’import de donnée techniques