1 Synchronisation des équipements et des historiques de localisation équipement (V10.12)

Synchronisation des équipements et des historiques de localisation équipement (V10.12)

A partir de la version 10.12 de l’ERP et la version 6.2 de Weavy, la synchronisation des équipements évolue afin d’intégrer la synchronisation et l’historisation des localisations dans la CRM et dans l’ERP.

Dans les versions antérieures, la synchronisation ERP-CRM ne tolérait qu’une seule localisation sur un équipement : la localisation sur le site enregistrée comme localisation principale sur le matériel.

Les anciennes interactions en création, modification des équipements dans la CRM et des matériels dans l’ERP sont remplacées, et il est obligatoire d’exécuter le traitement en migration d’une version antérieure vers la version 10.12.

Principes :

La localisation d’un équipement sur un site d’intervention dans la CRM est enregistrée dans l’ERP comme un évènement sur le matériel, plus précisément, une intervention sur le matériel, d’un type dédié (le type est à définir dans le dossier Installation Maintenance; dans la visite guidée, nous proposons le type LOCALISATION).
La localisation à l’instant “t” est calculée et indiquée dans la localisation actuelle du matériel.

La gestion des localisations sur le zoom matériel, se fait au moyen de 2 nouveaux points de menu :

Nouvelle localisation : permet la création d’une localisation.
Historique des localisations : liste des localisations permettant la modification et la suppression, selon les droits de l’utilisateur.

La date de début de localisation dans l’ERP est obligatoire; si non renseignée dans la CRM, elle sera positionnée au 01/01/1900.

Fonctionnement

Génération d’un équipement depuis un devis travaux ou une pièce de gestion commerciale

Sur un devis travaux validé, menu validation > génération des équipements :
- Crée la localisation sur le site avec code localisation = code site (table GMTLOC) si nécessaire.
- Crée le matériel, et affecte la localisation principale = localisation correspondant au site
- Crée la localisation équipement : (table GMACT)
  - code intervention : ‘LOCALISATION’
  - localisation : localisation principale
  - date de début : date de génération
  - date de fin : non renseignée
  - statut : en cours
- Crée l'équipement et sa localisation par webhook avec attente du compte-rendu d’exécution.
  - webhook WHK_equipement : code equipment = code matériel (RMCOD)
  - webhook WHK_equipmentaddress : code equipmentaddress = numéro d’intervention (ACTNO)
Affiche un message de bonne exécution et passe les icônes de la couleur rouge à la couleur verte en cas de bonne exécution.

Création d’un équipement en CRM WEB

La création de l'équipement sur un site crée la localisation; date de début, date de fin non renseignée.
- déclenche une notification sur l'équipement (ExtDataUpdateAsync_Equipment) et crée une demande de création d'équipement dans les échanges externes.
  - (Si la notification n’est pas active, l’équipement et la localisation seront synchronisés par l’agent)
Synchronisation par le Webservice intégrationequipement (Notification )
- crée le matériel
  - Localisation principale = Site de la localisation équipement (création préalable si nécessaire)
  - Crée la correspondance code matériel - Id equipment (MMOBITEMP n° 25 - Equipement)
- crée l’intervention de localisation (GMACT)
  - code intervention : ‘LOCALISATION’
  - localisation : localisation principale
  - date de début : 01/01/1900 (non renseignée dans weavy)
  - date de fin : non renseignée
  - statut : encours
  - Crée la correspondance code intervention (actno) - Id equipmentaddress (MMOBITEMP n° 31 - Equipement localisation (nouveau type de correspondance))
Recodifie immédiatement par rebond webhook
- mise à jour codeequipment de l'équipement
- mise à jour codeequipmentaddress de la localisation de l'équipement

Création d’un matériel (ERP GRM)

Contexte d’exécution :
- en contrôle strict des matériels dans les interactions ERP-CRM (à partir de la V10.12) : seuls les matériels dont le type est ‘utilisé en CRMWeb’ sont synchronisés avec la CRM.
Saisie en création du matériel, localisation principale obligatoire pour permettre la synchronisation (condition : la localisation principale est un site).
- Si la localisation principale est renseignée, le traitement propose d’enchainer et de créer automatiquement l’intervention de localisation à la date/heure actuelle, en laissant la possibilité de modifier cet horodatage avant validation.
- si oui :
  - crée l’intervention de localisation;
    - code intervention : ‘LOCALISATION’
    - date de début = date saisie,
    - date de fin non renseignée
  - Crée l'équipement et la localisation en presque temps réel (par ICP entité MATERIELLOCALISATION)
    - webhook WHK_equipement : code equipment = code matériel
    - webhook WHK_equipmentaddress : code equipmentaddress = numéro d’intervention
- si non :
  - Saisie manuelle de l’intervention de localisation :
    - ‘Nouvelle localisation’ et création de la localisation sur le matériel.
      à la validation, le traitement contrôle dans weavy
    - Crée de la localisation par ICP entité MATERIELLOCALISATION
    - webhook WHK_equipement : code equipment = code matériel
    - webhook WHK_equipmentaddress : code equipmentaddress = numéro d’intervention

Ajout - modification d’une localisation sur un équipement existant dans la CRMWeb

Une localisation équipement mise à jour (création - modification) en CRM, hors création par l'équipement, est synchronisée uniquement par l’agent() (traitement planifié)

Event [Infinity] Export - Action [Infinity Export Equipment and type : extraction des localisations modifiées fichier equipmentaddressV6.2.txt
Agent : Infinity / Kit de connexion import
Synchronisation mobile
- Contrôle d’existence de la localisation dans MMOBITEMP
- Si non,
  - création de la localisation (GMTLOC) si nécessaire à partir du code site
  - création de l’intervention de localisation
    - code intervention : ‘LOCALISATION’
    - localisation = localisation correspondant au site
    - date de début = date saisie
    - date de fin non renseignée
    - statut encours
  - Recodifie immédiatement par rebond webhook (ICP entité MATERIELLOCALISATION)
    - mise à jour codeequipment de l'équipement
    - mise à jour codeequipmentaddress de la localisation de l'équipement
- Si oui
  - Modification de l’intervention de localisation déterminée par la correspondance
Cas particulier : si une localisation est désactivée par un arbitrage ou volontairement (date de fin est inférieure à la date de début)
- création ou modification de la localisation (selon le cas, comme précédemment)
- statut = désactivé; le statut désactivé autorise une date de fin inférieure à la date de début
- date de début = date de début CRM
- date de fin = date de fin CRM

Ajout - modification d’une localisation sur un matériel dans l’ERP

Une intervention de localisation d’un matériel peut être modifiée par le menu : Historique des localisations. Ce menu est soumis à la licence IM.
A noter qu’il n’est pas autorisé de modifier une intervention de localisation désactivée dans l’ERP. La modification devra être faire en CRM.

La saisie est contrôlée à la validation, mais avant validation :

dans l’ERP :
- date de début <= date de fin (pour un statut en cours)
- pas de recouvrement de localisation en cas de localisation multiples
- la localisation doit être un site
dans weavy :
- la modification en cours de validation est transmise à weavy (Webhook equipmentaddress) pour simulation; le webservice évalue la modification et renvoie le statut de la mise à jour et un commentaire comme si la modification avait été appliquée.
- en cas d’anomalie
  - recouvrement de localisations dans weavy
  - équipement sous contrat actif sur une localisation (modification de la localisation interdite)
  - ou autre contrôle de cohérence,
    la modification n’est pas autorisée.

Il est possible de créer une nouvelle intervention de localisation d’un matériel par le menu : Nouvelle localisation. Ce menu est soumis à la licence IM.

La saisie est pilotée, et initialisée :

code intervention : ‘LOCALISATION’
localisation : doit être une localisation liée à un site
date de début prévisionnelle : initialisée à date-heure actuelle
date de fin non initialisée
statut encours non modifiable en validation

NB : il n’existe pas de processus d’arbitrage des localisations d’un matériel en saisie d’une intervention de localisation.
Il faudra déclarer une date de fin sur une intervention de localisation puis créer la localisation suivante à partir de la date de début. La date de début de la localisation suivante doit être strictement supérieure à la date de fin de la localisation précédente.

Suppression d’une localisation d’un équipement (CRM) / d’un matériel (ERP)

La suppression d’une localisation n’est pas synchronisée; il faudra supprimer la localisation sur l'équipement en CRM et l’intervention de localisation sur le matériel dans l’ERP.

La suppression d’une localisation d’un équipement dans la CRMWeb n’est plus autorisée dans la solution IM/Field Service sauf pour un administrateur.

La suppression d’une intervention de localisation sur un matériel GRM est également soumise à confidentialité.

A la validation de la suppression dans l’ERP, un message d’avertissement sera proposé à l’utilisateur pour valider l’opération.

La suppression d’une localisation est tracée dans le livre de bord.

Paramétrage

Il est obligatoire de définir le code intervention à utiliser pour identifier une intervention de localisation.
Le code intervention GRM pour suivi des localisations se trouve dans le dossier ‘Installation Maintenance’, onglet ‘Intervention’ , tableau Interactions CRM Web.
NB : définir un code intervention réservé à l’historisation des localisations équipements (par exemple LOCALISATION)

Utilisation

Liste des matériels sur un site à date en sélection des équipements (ERP) dans le devis travaux

Ajout du critère : Localisation : ….. au ….. dans le Zoom des matériels :

permet de consulter la liste des matériels sur un site (code localisation = code site) à la date donnée. Le zoom est piloté en sélection des équipements par le devis travaux.
la date est initialisée par le délai à défaut la date du devis.

Ajout d’une date dans la recherche des équipements CRM par webhook équipements :

permet de consulter la liste des équipements sur un site à la date donnée. La date est initialisé par le délai à défaut la date du devis.
Il est possible de modifier la date de la recherche en utilisant le bouton ‘Filtre CRM’

02 ERP 10.12

Synchronisation des équipements et de l'historique des localisations (V10.12)