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”

...

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.

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.

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.

Traitement des Affaires industrielles à l'état opportunité - Compléments (V10.11)

Paramétrages complémentaires (V10.11)

Choix de paramétrage

• Pour garantir la compatibilité ascendante de la gestion des affaires et opportunités d’affaire, seules les familles d’affaires en dépendance d’une étape d’affaire sont extraites comme type d’affaire / type d’opportunité vers weavy

• Pour garantir la compatibilité ascendante, seules les étapes d’affaires avec une dépendance à une famille d’affaire nommée, (et non ‘*’ toutes les familles’) sont extraites vers weavy.
  Pour une étape d’affaire, plusieurs dépendances peuvent être définies.

Précisions : Pour garantir la compatibilité ascendante en standard, nous recommandons de créer de nouvelles familles d’affaire pour exploiter cette fonctionnalité.

Principes de synchronisation

• La famille d'affaire définit un type d'affaire dans weavy. Lorsque la famille d'affaire est enregistrée comme une dépendance d'une étape d'affaire (dealtype) :

  • l'étape d'affaire 'opportunité'  est synchronisée avec l'étape d'affaire (dealstep)

  • la définition du fichier Affaire.txt ne change pas de version, mais :

    • le type est encodé (AFRPRJ-XXX, avec AFRPRJ = affaire à l'état opportunité, XXX = code famille d'affaire. (Par exemple pour la famille TRX le type reçu est AFRPRJ-TRX, enregistré comme un generictype de datatype = 'DEAL_DEALTYPE'
      (pour une affaire à l'état affaire, le type aurait un format AFR-TRX)

    • l'étape d'affaire est encodée (DEAL_STEP-AFRPRJ-XXX-CODEETAPEAFFAIRE)

Le statut (CE2) de l'affaire n’est plus alimenté à partir de weavy. Le traitement de mise à jour de l'étape d'affaire s’effectue comme depuis le Zoom Affaire.

Fonctionnement (V10.11)

Infinity vers CRM

Evolution du webhook affaire, les opportunités sont désormais envoyés vers la CRM.

...

CRM vers Infinity

Evolution du fichier affaire.txt généré par la CRM.

...

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.

...

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 

...