L’interface Divalto - Techform

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

...

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.

...

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é-établipréétabli

...

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

2. Appel Authentification Techform et appel du configurateur Techform après authentification

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 fichier XML 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.

...

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

Avertissement
BEL a finir la suite

Code chemin pour le service 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) .

...

La première URL indique l’URL du web service du configurateur.

La seconde indique l’URL à invoquer pour l’accès au configurateur après envoi des paramètres.

Avertissement
Il va dans quel zoom le deuxième??URL Web

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, un code de web service d’accès au configurateur web Techform.

...

Note : l’ancien code chemin utilisé par le client lourd reste valide

...

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

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

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)

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

Image Added

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.

...

Avertissement
Il y en a 3ème de chemin??

Paramétrage services webOn 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 y 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)

Contactez votre administrateur pour lui demander de vérifier si les services web sont actifs, et celui-ci en particulier

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”.

...

Info
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 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