L’interface Divalto - Techform
Techform est un configurateur qui peut compléter la création de commande de Divalto ERP.
...
SOMMAIRE
| 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.
...
| Info |
|---|
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.
...
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 dans le mouvement de pièce 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 de vente) sur laquelle la configuration a déjà été complétée dans Techform.
...
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
...
| Avertissement |
|---|
BEL a finir ce chapitre, tout n’est pas clair |
Codes chemin pour les services web
...
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
Son nom 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
| Info |
|---|
C’est votre interlocuteur Techform qui saura fournir l’URL ainsi que le compte d’accès spécifiques |
Les autres champs (mode d’attente, paiement par défaut, URL Web) ne sont pas utilisés
Service web pour article configurateur
...
La seconde indique l’URL à invoquer pour l’accès 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)
| Avertissement |
|---|
Il va dans quel zoom le deuxième??URL Web ça vient d’où?? |
| Avertissement |
|---|
| Info |
C’est votre interlocuteur Techform et/ou votre référent Techform interne qui saura fournir l’URL et l’URL Web, propre à chaque article configurateur |
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.
...
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)
Contactez votre administrateur pour lui demander de vérifier si les services web sont actifs, et celui-ci en particulier
| Avertissement |
|---|
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
| Avertissement |
|---|
BEL c’est du gtpp150? ou autre pour faire le lien |
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”.
...
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 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