Gérer les Interactions Divalto infinity - Divalto weavy

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