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.
Un paramétrage ERP est donc nécessaire pour réaliser cette étape indispensable
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
L’utilisateur saisit une pièce commerciale avec des articles nécessitant une configuration.
Authentification Techform et appel du configurateur
Le service Login renvoie le cookie de session, à utiliser dans les prochains échanges
Envoi des paramètres et appel du configurateur en mode Web (navigateur). La saisie de pièce est bloquée pendant ce temps
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)
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
Appel de l’intégration des données de configuration. Un ID (GUID) est fourni par Techform, et enregistré dans Divalto pour éventuel rappel de la configuration depuis la pièce.
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) 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.
DANS L’APPLICATION TIERCE
L’utilisateur saisit une pièce commerciale avec des articles configurables dans l’application tierce, il s’authentifie à Techform
Le service Login renvoie le cookie de session, à utiliser dans les prochains échanges
Envoi des paramètres et appel du configurateur web par l’application tierce
Configuration terminée, le middleware Techform renvoie les données de configuration
L’application tierce envoie la commande vers l’ERP
Intégration de la pièce dans l’ERP
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.
Envoi des configurations vers Divalto
Intégration des données Techform (fichiers XML)
Retour d’information intégration données Techform
Retour d’information création de pièce
Paramétrage ERP
BEL a finir ce chapitre, tout n’est pas clair
Codes chemin pour les services web
??combien?? de codes chemins sont nécessaires.
Il sont tous référencés dans la table de Paramétrage de services web (MURLSW) du menu Administration.
Service web unique pour échanges configurateur
Son nom est libre mais il est recommandé : TECHFORM_MIDDLEWARE
Capture, détails sur ce qu’il faut mettre
Service web pour article configurateur
La seconde indique l’URL à invoquer pour l’accès au configurateur après envoi des paramètres
Il va dans quel zoom le deuxième??URL Web ça vient d’où??
Il y en a 3ème de chemin?? Il en faut 1 par “configuration ??”
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
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
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
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)
Contactez votre administrateur pour lui demander de vérifier si les services web sont actifs, et celui-ci en particulier
GUILLAUME : le SOAP n’est plus supporté par la plateforme CLoud a partir de Septembre. On a bien vu avec Techform pour qu’ils appellent ce SW en mode REST?? (même si le SW est dans synchro_infinity_agileo, ce n’est pas le sujet). Sinon on a un souci
Utilisation du configurateur
Le configurateur s’appuie principalement sur deux imports par fichier XML:
La création de NOMENCLATURE Import de données techniques
BEL c’est du gtpp150? ou autre pour faire le lien
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
Information technique surcharge : plusieurs champs de données envoyés à Techform sont disponibles, et peuvent être affectés en surcharge (gttmconf000 / Initialiser_DatasetSession_Specifique) via un enregistrement qui comporte un tableau de 5 valeurs par type
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 que 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.