Gérer les Interactions Divalto infinity - Divalto weavy
- 1 Utilitaires
- 1.1 Gérer un mode Trace Utilisateur
- 1.1.1 Activation
- 1.1.2 Administration
- 1.1 Gérer un mode Trace Utilisateur
- 2 Paramétrages
- 3 Connecteur mobile - Gestion des fichiers joints en erreur (V10.9)
- 4 Interactions Divalto Infinity - Divalto Weavy : Synchronisation des contrats (V10.9)
- 5 Interactions Divalto Infinity - Divalto Weavy - Traitement des Affaires industrielles à l'état opportunité (V10.9)
- 5.1 Paramétrage
- 5.2 Fonctionnement
- 6 Synchronisation externe des dépôts via webhook (V10.10)
- 6.1 Paramétrage
- 6.2 Fonctionnement
- 7 Création d’affaire depuis une intervention (V10.10)
- 8 Synchronisation externe des caractéristiques de fluides frigorigènes via webhook (V10.10)
- 8.1 Paramétrage
- 8.2 Fonctionnement
Utilitaires
Gérer un mode Trace Utilisateur
Cette fonctionnalité a pour objectif de permettre à un utilisateur de l'ERP d'activer les traces d'exécution des WebHook et WebservicesDiva lors d'une anomalie de fonctionnement ou en phase de tests.
Activation
Administration / paramètres / paramètres ERP
Le paramétrage et l'activation se fait par le Zoom Paramètre ERP avec 2 entrées :
INHIBER_TRACE_JSON : positionnée par défaut à OUI; activation en passant le paramètre à Non
extrait les fichiers JSON des WebHook weavy et les dépose dans le répertoire défini par le code chemin DLOGPATH .
INHIBER_TRACE_WS : positionnée par défaut à OUI; activation en passant le paramètre à Non
extrait les fichiers JSON des Webservicesdiva (sur données de l'ERP) et les dépose dans le répertoire défini par le code chemin DLOGPATH .
Par défaut, DLOGPATH est paramétré à
C:\Divalto\DivaltoLog\JSON
..\Sites\XXXXXX\ENV\files\ficjoints\DLOGPATH\
Le fichier généré est nommé : JSON_[DOS]_[USER]_AAAAMMJJhhmmss_WHK_[ENTITE]_[ACTION].txt
DOS : dossier
USER : user d'exécution
AAAAMMJJhhmmss : horodatage
ENTITE : entité concernée parmi Customer, Product, Intervention, ....
ACTION : S - pour envoi (Send) / R - pour Réception (Receive)
le nombre de fichiers présents dans le répertoire DLOGPATH est contrôlé et bloqué à 1000 fichiers;
les fichiers sont purgés au bout de 2 jours;
lorsque le nombre maximal de fichiers est atteint, un message et une notification préviennent l'utilisateur; les fichiers présents sont conservés et le paramètre est inhibé.
Administration
pour éviter la consommation non maitrisée de l'espace disque, une gestion de purge est mise en place
délai de rétention = 2 jours par défaut
nombre maximum de fichiers : 1000 par défaut
Lors de la génération d'une trace, le programme va :
supprimer tous le fichiers dont la date de création est antérieure au délai de rétention
compter le nombre de fichiers présents dans le répertoire
lorsque le compteur atteint sa limite
la trace est stoppée : toutes les traces actives sont désactivées
un message d'information est envoyé aux utilisateurs
une notification IA est générée
Paramétrages
Mises à jour asynchrone CRM Web par le traitement Inter-compagnies - gestion des flux externes (évolution V10.7)
Rappel du contexte :
L'inter-compagnies permet de gérer différents types de flux :
la synchronisation de tables entre 2 dossiers,
la synchronisation de pièces entre 2 dossiers,
la synchronisation de pièces back to back entre 2 dossiers,
la caisse autonome,
la synchronisation de tables avec un système externe, en particulier Weavy.
Paramétrages :
activation de l’inter-compagnies
Commerce et logistique > Fichiers > organisation > dossier puis se positionner sur un dossier et accéder à la gestion des tables communes par SHIFT + F7.
Onglet Tables communes 2 - Bloc Compléments : cocher Gestion inter-compagnies
Administration > Inter-compagnies > Code flux externe
déclarer le code flux externe 'WEAVY' dans la table "code flux externe". Attention, seule cette valeur en majuscules est interprétée par les traitements (V10.7)
Administration > inter-compagnies > Flux externe (modifiée en V10.7)
déclarer la liste des entités de chaque groupe à synchroniser avec le code flux externe 'WEAVY'
Exemple complet de paramétrage :
Nous allons nous placer dans un cas d'usage exemple ou l'on souhaite :
synchroniser notre dossier 998 avec son projet Weavy
synchroniser notre dossier 996 avec son projet Weavy
NB : certains objets métiers proposent une fonction "Invoke_TABLE_ExternalFlow" permettant en standard la synchronisation avec Weavy.
Administration > Inter-compagnies > Groupe
Administration > Inter-compagnies > Liens Groupe - Dossier
Administration > Inter-compagnies > Entités
Administration > Inter-compagnies >Liens Entités - Groupe
Administration > Inter-compagnies > Flux externe
Astuces :
Administration > Inter-compagnie > Tracking Inter-compagnie
Après modification du paramétrage, pensez à Mettre à jour le synchronisation ICP : Maj Synchronisateur
Routage
Administration / paramètres / Routage
Porte la définition des URL de routage pour ouvrir une fonctionnalité Infinity à partir d'un système externe (CRM Web et mobile)
cette définition est synchronisée par le script d'export External URL
Interactions CRM Web → Infinity
Création /Mise à jour du site en CRM Web (v10.9) : mise à jour infinity en presque temps réel via notification
Il est possible à partir de WEAVY de créer/modifier un site client. La synchronisation se fait en quasi temps réel dans INFINITY avec création/modification de celle-ci dans le système.
Connecteur mobile - Gestion des fichiers joints en erreur (V10.9)
A partir de la version 10.9, en cas d’erreur d'intégration des fichiers joints des rapports d'intervention (PDF) par le connecteur mobile, ces fichiers sont désormais stockés dans un répertoire “error” horodaté.
Les fichiers “file.txt” et “fileentity.txt” qui contiennent les données d’intégration de ces fichiers et laisser le PDF qui ne sera jamais traité dans le répertoire FileExport
Le(s) fichier(s) PDF sont également déplacé(s) dans le répertoire “error” horodaté afin de vider le répertoire “fileexport”
Interactions Divalto Infinity - Divalto Weavy : Synchronisation des contrats (V10.9)
A partir de la version 10.9 de Infinity et la version 5.7 de Weavy, de nouveaux paramétrages permettent :
La création d'un contrat dans weavy en sélectionnant un modèle de facturation parmi les modèles disponibles (évolution weavy)
Que le contrat soit créé (par la synchronisation) dans infinity à partir du modèle saisi
De proposer, en option, la création du contrat au statut actif (permettant la mise à jour immédiate du contrat dans weavy)
Paramétrage
Paramétrage du statut du contrat à importer dans le menu Administration → Mobilité → Paramétrage mobilité → Synchronisation infinity Mobile (onglet ‘Mobile → Infinity (1)’) :
Fonctionnement
Prérequis : cette fonctionnalité nécessite la connaissance des procédures d’import/export de données entre Weavy et Infinity et la saisie d’un contrat dans Weavy.
Saisie d’un contrat avec un modèle de contrat
Si la date de relance n’est pas renseignée (valeur et unité), la valeur par défaut est de 1 an.
La date de fin indique si le contrat est à durée indéterminée ou non
si elle est renseignée, il s’agit d’un contrat à durée déterminée
si elle n’est pas renseignée, il s’agit d’un contrat à durée indéterminée
Certaines données du contrat dépendent du modèle de contrat. Il s’agit :
du calendrier de facturation
des cases à cocher :
Main d’œuvre incluse
Pièces incluses
Déplacements inclus
Cela signifie que ces données sont reprises du modèle de contrat et non pas des valeurs saisies dans Weavy.
Après avoir lancé la synchronisation vers Infinity, on retrouve le contrat avec les données suivantes :
Onglet ‘Contrat’ :
Contrat à durée indéterminée car la date de fin n'était pas renseignée dans Weavy
La famille de contrat correspond au type de contrat de Weavy
Les données du renouvellement correspondent aux données de relance de Weavy
Onglet ‘Facturation’ :
On retrouve le modèle de contrat
Les 3 cases à cocher (Main d’œuvre incluse, Pièces incluses, Déplacements inclus) sont reprises par défaut du modèle de contrat
Les données du taux sur le prix de vente sont reprises par défaut du modèle de contrat
Onglet ‘Calendrier’
Le calendrier de facturation est généré selon le type de calendrier du modèle de contrat. Ici, le type est trimestriel, d’où la génération d’une ligne tous les trimestres jusqu'à la date d'échéance du contrat.
Si le type du calendrier est ‘Libre’, aucun calendrier n’est généré. Il conviendra de la renseigner manuellement.
Remarque :
Pour importer un contrat au statut ‘actif’, la famille de contrat et le calendrier de facturation sont obligatoires. Si ces données ne sont pas renseignées, le contrat est importé au statut ‘provisoire’.
Pour générer un contrat à durée déterminée, il faut renseigner la date de fin de contrat dans Weavy :
Après avoir lancé la synchronisation vers Infinity, on retrouve le contrat avec les données suivantes :
La date terme du contrat correspond à la date de fin de Weavy.
La date terme initial correspond à la date de fin - 1 jour.
La durée est calculée en fonction des dates début et fin.
Attention : le jour de la date de début et de la date de fin dans Weavy doit être identique pour avoir des mois complets ou années complètes, sinon la durée est exprimée en jours mais elle est limitée à 2 chiffres
Saisie d’un contrat sans modèle de contrat
La principale différence par rapport à un contrat avec modèle est le calendrier de facturation. En effet, la génération du calendrier se base sur l’intervalle de facturation saisi dans l’onglet ‘Facturation’ du contrat dans Weavy (valeur et unité) :
Si aucun intervalle n’est saisi, le calendrier n’est pas généré.
Après avoir lancé la synchronisation vers Infinity, on retrouve le contrat avec les données suivantes :
Le calendrier est généré d’après l’intervalle saisi dans Weavy (dans notre exemple : 6 mois)
Le type du calendrier est toujours ‘Libre’, qu’un calendrier soit généré ou non
Interactions Divalto Infinity - Divalto Weavy - Traitement des Affaires industrielles à l'état opportunité (V10.9)
Paramétrage
A partir de la version 10.9, un nouveau traitement d'import des affaires à l'état ‘opportunité’ (à partir d’une opportunité du nouveau type ‘PRJAFF’) est disponible dans la synchronisation mobile.
Fonctionnement
Les opportunités de type ‘opportunité d’affaire’ exportée de weavy, ont un champ "TypeAffaire" dont la valeur est AFRPRJ.
Elles doivent être intégrées comme affaire à l'état opportunité (table PRJAP) et non comme une opportunité (table PRJAV dans les anciennes versions).
La famille d’affaire est initialisée à partir du paramétrage dossier Mobilité. Un contrôle est effectué à la saisie de la famille d’affaire pour que celle-ci contienne une étape d’affaire initiale pour l'état opportunité.
L’étape d’affaire est initialisée à partir de l’étape d’affaire initiale de l’opportunité de la famille d’affaire.
Remarque : Une ligne est insérée dans la table MMOBITEMP lors de la création de l’affaire de type opportunité avec une clé composée de AFRPRJ et du code affaire.
Synchronisation externe des dépôts via webhook (V10.10)
A partir de la version 10.10, la mise à jour des dépôts entre Infinity et Weavy s’effectue en temps réel ou presque temps réel par le webhook WHK_ProductDepot (icp).
Paramétrage
Paramétrage de l’entité ‘Dépôt’ pour l’Inter-compagnies :
Créer le lien Entité - Groupe :
Administration → Inter-compagnies → Liens Entité - Groupe
Créer le flux externe :
Administration → Inter-compagnies → Flux externe
Fonctionnement
En création ou modification d’un dépôt côté Infinity, la mise à jour côté Weavy se fait automatiquement via le synchronisateur inter compagnies.
Exemple :
Côté Infinity :
Côté Weavy :
Création d’affaire depuis une intervention (V10.10)
A partir de la version 10.10, la création d’une intervention de type SAV va entrainer la création d’une nouvelle affaire.
Paramétrage dossier IM
Au niveau du dossier Installation et maintenance (onglet Intervention) , ajout d’un modèle de l’affaire à suivre par défaut lors de l’utilisation du web service Intégration affaire si le champs “template” n’est pas renseigné.
Paramétrage flux externe (ICP)
Au niveau du paramétrage des flux externes, l’entité “AFFAIRE” doit exister comme suit :
Fonctionnement
A la création d’une intervention dans la CRM ==> déclenchement du web service « Intégration affaire » pour sa création dans infinity
Mise à jour de l’intervention, de l’affaire et des éléments d’affaire dans weavy via ICP.
Synchronisation externe des caractéristiques de fluides frigorigènes via webhook (V10.10)
A partir de la version 10.10, la mise à jour des données liés aux caractéristiques de fluides frigorigènes entre Infinity et Weavy a été ajoutée et s’effectue en temps réel ou presque temps réel par le webhook WHK_Product (icp).
Paramétrage
Paramétrage de l’entité ‘ARTFROID’ pour la gestion des fluides :
Créer le lien Entité - Groupe :
Administration → Inter-compagnies → Liens Entité - Groupe
Créer le flux externe :
Administration → Inter-compagnies → Flux externe
Fonctionnement
En création ou modification d’une caractéristique de fluide frigorigène, la mise à jour côté Weavy se fait automatiquement via le synchronisateur inter compagnies.
Précision technique : Chaque création modification de la fiche ART ou de la sous fiche ARTCOLD crée une ligne dans la table MICPTRACK pour être traité par l' ICP pour lancer le webhook PRODUIT de synchronisation Weavy
Une optimisation est faite pour les cas ou il aurait plusieurs demandes de mise à jour article en attente (sachant que la mise à jour prend toujours les dernières données). La fiche article embarque la donnée CrmUpDateDh qui contient la dernière date de synchronisation Weavy.
A chaque traitement d’une ligne MICPTRACK on compare la plus récente date modification des deux tables (ART et ARTCOLD) avec CrmUpDateDh afin de savoir si le webhook Product pour la mise à jour weavy à besoin d’être relancé.