Préambule

Les kits de connexion Divalto weavy sont un ensemble d'outils permettant de démarrer rapidement l'interfaçage Divalto weavy avec un ERP existant.
Ils intègrent des flux essentiels du type clients, contacts, articles, historiques …
En aucun cas, ils ne gèrent l'ensemble des fonctionnalités disponibles dans l'ERP. Ils sont plutôt une aide pour démarrer un projet, et votre paramétrage viendra compléter les besoins dans le contexte de votre projet.

La dernière version du kit est la 6.1 pour être en phase avec la version WINTER’23 de Divalto weavy.

Depuis Divalto weavy V5.7 - Winter’22, le ControlCenter est remplacé par l’Agent qui est intégré à Divalto weavy Studio.

Pour tout nouveau projet en mode SAAS l’Agent sera la version configurée par défaut.

Pour l’instant le kit de connexion est maintenu dans les deux versions : ControlCenter et Agent.

Une documentation concernant l’Agent et le kit de connexion est disponible : Kit Divalto infinity - Agent

Introduction

Nouveautés V.6.1
Mise à jour de la surcharge DIVINF basée sur la version WINTER’23 de Divalto weavy.

Nouveautés V.6.0
Mise à jour de la surcharge DIVINF basée sur la version SUMMER’23 de Divalto weavy.

Nouveautés V.5.7
Mise à jour de la surcharge DIVINF basée sur la version WINTER’22 de Divalto weavy.

Nouveautés V.5.6
Mise à jour de la surcharge DIVINF basée sur la version SUMMER’22 de Divalto weavy.

Nouveautés V.5.5
Mise à jour de la surcharge DIVINF basée sur la version WINTER'21 de Divalto weavy.

Nouveautés V.5.4
Mise à jour de la surcharge DIVINF basée sur la version SUMMER'21 de Divalto weavy.

Nouveautés V.5.3
Mise à jour de la surcharge DIVINF basée sur la version WINTER'20 de Divalto weavy.

Nouveautés V.5.2
Mise à jour de la surcharge DIVINF basée sur la version SUMMER'20 de Divalto weavy.
Nouveautés V.5

Le kit de connexion infinity contient dorénavant une surcharge (DIVINF) dédiée à Divalto infinity. C'est une surcharge basée sur la version SUMMER'19 de Divalto weavy.
Les nouveaux projets Divalto weavy connectés à Divalto infinity seront créés à partir d'un Master Divalto weavy dédié à infinity afin de bénéficier des mises à jour futures. Indiquer à vos interlocuteurs habituels Divalto que vous souhaitez un projet avec la surcharge infinity lors de la demande de création de projets.
Sous certaines conditions, il est possible d'insérer la surcharge infinity dans un projet existant. Se référer à la fin de ce document.

Le kit de connexion Divalto infinity rassemble un ensemble d'outils vous permettant de démarrer rapidement un projet Divalto weavy connecté à un ERP Divalto infinity.
Les versions supportées sont :

Pour de plus amples informations sur la rétrocompatibilité vous pouvez vous référer à la documentation Kit Divalto infinity - Rétrocompatibilité.

Prérequis

Divalto weavy

Vérifier la version de votre master Divalto weavy

Avec l'explorateur de bases de données du Studio Divalto weavy, exécuter la requête :

select * from sw_data_confvariable where codeconfvariable like '%master%'

La colonne Value doit être supérieure à 1.4.20181018.

A partir du master Winter 19, les interfaces du kit infinity ne sont plus présentes par défaut.

Divalto infinity

Selon votre version de Divalto infinity :

Infinity 7.5e

Infinity 10.3

Infinity 10.4

Infinity 10.5

Infinity 10.6

Infinity 10.7

Infinity 10.8

Infinity 10.9

Infinity 10.10

Infinity 10.11

Contrainte : Dossier

Divalto weavy n'étant pas multi dossiers, il faut créer un projet Divalto weavy par dossier à interfacer.

Constitution du kit

Le kit de connexion est composé des éléments suivants :

Pour les mises à jour des kits déjà installés :
Importer les nouvelles interfaces via l'import de configuration du Studio.

Les versions Divalto weavy en synthèse

V 5.0.0.1

La version 5 amène la surcharge infinity pour Divalto weavy. Cette surcharge permet de gérer l'algorithme de prix infinity dans Divalto weavy, en s'appuyant sur les tables tarifs infinity et un écran particulier de gestion de prix en saisie de pièces.

  • Ajouts des tables liées aux tarifs infinity

  • Ajout d'un écran de paramétrage des prix en saisie de pièces

  • Ajout d'events d'export pour la partie service (type d'équipement, type d'intervention, équipements)

  • Echanges d'URL avec Divalto infinity (URL web weavy et webhooks)

  • Corrections et améliorations diverses

V 5.2.0.0

  • Mise à jour par rapport au Master Divalto weavy SUMMER'20

  • Corrections dans les exports vers infinity

  • Corrections et améliorations diverses (voir Kit Divalto infinity - Release Notes)

V 5.3.0.0

  • Mise à jour par rapport au Master Divalto weavy WINTER'20

  • Nouvelles interfaces pour le vertical Installation & Maintenance

  • Corrections et améliorations diverses (voir Kit Divalto infinity - Release Notes)

V 5.4.0.0

V 5.5.0.0

  • Mise à jour par rapport au Master Divalto weavy WINTER'21

  • Mise en place de l'horodatage sur les fichiers en mode différentiel (ControlCenter + Backend)

  • Corrections et améliorations diverses (voir Kit Divalto infinity - Release Notes)

V 5.6.0.0

V 5.7.0.0

V 6.0.0.0

V 6.1.0.0

Flux Divalto infinity vers Divalto weavy

Données communes

Les données traitées dans ce flux sont :

Ajoutées en V5.3 :

Ajoutées en V5.4 :

Ajoutées en V5.5 :

Ajoutées en V5.6 :

Ajoutées en V5.7 :

Ajoutées en V6.0 :

Ajoutées en V6.1

Utilisateurs/Clients

Ajoutées en V5.4 :

Ajoutées en V5.5 :

Ajoutées en V5.6 :

Ajoutées en V6.0 :

Ajoutées en V6.1

Concernant les historiques de document, afin que les lignes de commentaires des pièces apparaissent en Front, elles sont rattachées à un article « virtuel » dont la référence est SW_INTERNAL_COMMENT. Cet article est marqué comme indisponible à la vente.

Articles

Ajoutées en V5.2 :

Ajoutées en V5.5 :

Ajoutées en V5.7 :

Ajoutées en V6.0 :

Tarifs

Ajoutées en V5 :

Ajoutées en V5.7 :

Ajoutées en V6.0 :

Remarques importantes :
Se reporter à la documentation sur l'algorithme de prix standard de Divalto weavy (voir Kit Divalto infinity - Algorithme de prix dans la surcharge infinity).
D'autre part, il est important de noter que dans Divalto weavy, le prix affiché lors du parcours du catalogue est un prix « statique », l'algorithme de prix est invoqué lors de la saisie de pièce. Ce prix « statique » est le prix issu du code tarif par défaut du dossier de Divalto infinity.

CRM

Evénements

Ajoutées en V6.0 :

Les champs de type RichText n'étant pas gérés sur les players Divalto weavy, le texte RichText des événements est convertit en format texte avant d'être envoyé vers Divalto weavy. En retour, Divalto weavy ne remontera que du format texte.
D'autre part, les questionnaires/rubriques sont maintenant gérés, mais uniquement les IMPLICITE par défaut. Les pièces jointes liées aux événements sont envoyées vers Divalto weavy, et sont également intégrées en retour dans Infinity.

Affaires et projets

Ajoutées en V6.0 :

Ajoutées en V6.1

Cette version du kit extrait les affaires de Divalto infinity 10.2, par défaut. Toutefois, une extraction d'une version 7.5e est toujours disponible dans le kit, qu'il faudra activer manuellement et désactiver celle de la 10.2
D'autre part, les pièces jointes liées aux projets et aux affaires sont envoyées vers Divalto weavy, mais ne sont pas intégrées en retour dans Infinity.

Champs personnalisés (Questionnaires/Rubriques)

Mapping d'ID

Du fait du mode déconnecté, Divalto weavy affecte des identifiants qui sont globalement uniques.
A l'intégration dans Infinity, ce dernier affecte, dans la majorité des cas, un nouveau numéro basé sur les compteurs paramétrés dans Infinity.
En retour dans Divalto weavy, les éléments initialement créés en mobilité, sont recodifiés avec les identifiants d'Infinity, en utilisant les fonctionnalités « recode » des backends.

Contrats et abonnements

Ajoutées en V5.4 :

Ajoutées en V5.7 :

L'extraction des contrats permet d'initialiser un projet Divalto weavy avec les contrats existants. Sont extraits les contrats en état actif et provisoire. Ils seront créés côté Divalto weavy en état nouveau afin de pouvoir paramétrer le côté opérationnel avant de les lancer et générer les interventions associées.

IM : Installation et Maintenance

Ajoutées en V5.3 :

Ajoutées en V5.4 :

Ajoutées en V5.5 :

Ajoutées en V5.7 :

Ajoutées en V6.1

Statistiques

Ajoutées en V5.5 :

Ajoutées en V5.7 :

Module Froid

Nouvelles extractions disponibles à partir de la V6.0

Flux Divalto weavy vers infinity

Le retour d'informations de Divalto weavy vers Infinity utilise le pack d'interface mobile existant de Divalto infinity.
Pour une utilisation compatible avec Divalto weavy, il est nécessaire de positionner l'option « inhiber la gestion des utilisateurs mobile » dans la configuration du connecteur.
Les flux traités sont les suivants :

Pour plus de détails sur l'interface mobile de Divalto infinity, se reporter aux documentations disponibles dans le connecteur mobile côté infinity (Mapping des tables échangées).

* Si votre version de Divalto infinity est inférieure à une 10.4, il faudra désactiver ces Events dans le planning d'events « [Infinity] Export ».

Remarques

V2.1

Depuis la version 2.1, la remontée des données dans Infinity ne se fait plus par un batch qui déclenche l'import, mais par un scrutateur Infinity. C'est la méthode conseillée, en particulier pour la version X.2 vis-à-vis de la gestion des licences.

V3

  • Adaptation pour le mode SaaS (implique une nouvelle manière plus simple d'installer/configurer le kit)

  • Echanges des Questionnaires/Rubriques avec les champs personnalisés de Divalto weavy (uniquement pour les questionnaires IMPLICITE en standard)

  • Intégration des documents joints dans Infinity

  • Intégration des bons de livraisons (directs ou issus d'une commande) dans Infinity

  • Extraction des devis clients/prospects

  • Intégration des modifications de fiches clients dans Infinity

  • Ajout des flux pour Divalto SAV (tous désactivés par défaut)

  • Corrections et améliorations diverses

V4

Date de visite

Ajout d'un nouveau backend « 50. Customer - 8. Visit date update.swd ». Il est nécessaire de l'éditer afin de prendre en compte vos types d'événements propres à votre projet. De base, le backend s'appuie sur les codes de type d'événements « Appointment » et « VisitReport », qui dans le kit standard ne sont pas échangés avec infinity.

Import de fichiers joint liés au Document (devis/commande/bons de livraison)

Par défaut, le kit de connexion ne remonte pas de fichiers joints à ces documents, car en standard dans Divalto weavy, les PDF ne sont pas systématiquement générés. Toutefois, dans le contexte du projet, de nouveaux flux peuvent être ajoutés pour remonter ces PJ. Se baser sur l'event « Export Files » pour la génération des enregistrements de File.txt, FileEntity.txt et les fichiers.
Pour les documents, le critère à respecter pour le champ EntityValue de FileEntity :
TypeDeTiers | TypedeDocument | Numéro de document
Avec TypeDeTiers = (C)lient ou (P)rospect
TypeDeDocument = (C)ommande, (D)evis
FileEntity.EntityType = DOCUMENT
Pour un bon de livraison, FileEntity.Type= LIVRAISON et FileEntity.EntityValue = TypeTiers | NumLiv.

Import des interventions hors contrats

En standard, nous considérons que les interventions effectuées dans le cadre d'un contrat ne sont pas exportées vers infinity, dans la mesure où ce dernier se charge de la facturation à partir des informations des contrats. En revanche, les interventions hors contrats, nécessitant une facturation distincte, sont exportées en standard par le kit. Si dans votre contexte, ce fonctionnement ne vous convient pas, vous pouvez les règles d'export dans l'event associé.
Les interventions hors contrats sont exportées dans des bons de livraisons avec en pièce jointe le rapport PDF. Cet export utilise les mêmes fichiers qu'une livraison, exceptée l'entête qui utilise EntLivraisonV2.txt.
Les temps passés sur l'intervention sont cumulés par type de temps sur des lignes articles. Ces articles sont à associer au préalable aux types de temps dans le paramétrage Divalto weavy.

Echange des contrats

Dans le principe, les contrats sont à créer côté Divalto weavy avec leur paramétrage opérationnel (gammes d'opérations, fréquence d'interventions, …). Une fois lancés, ils sont exportés dans infinity, afin de gérer l'aspect facturation dans infinity.
L'export des contrats d'infinity sont présents dans l'objectif d'initialiser la base Divalto weavy avec l'existant. Ces exports sont à exécuter une fois, et sont désactivés par défaut. Seuls les contrats actifs et provisoires sont exportés.
A partir de Divalto weavy, ne sont exportés que les contrats lancés et qui ont été créés sur Divalto weavy. Ils arriveront en provisoire dans infinity, où ils devront être retouchés afin de gérer les aspects facturation, puis passés en actif.

V4.1

Repackaging des backends et events afin de procéder à l'import via l'import d'une configuration du Studio. Cet import est identique à l'import d'un nouveau master, et permet d'arbitrer ce qu'il faut appliquer sur son projet.

Il est obligatoire d'avoir un Studio en version 4.8.6 minimum.

V5

L'ordre des Backends existants a été modifié afin de permettre une résolution code-ID par les Backends dès le 1er import. Les flux en question ont été préfixés par « 35. ».
Les nouveaux projets Divalto weavy doivent être créés à partir d'un Master infinity intégrant directement la surcharge infinity pour Divalto weavy.
Sous conditions, et uniquement si votre projet Divalto weavy est issu au minimum d'un Master SUMMER'18, il est possible d'insérer la surcharge DIVINF dans votre projet existant. Ce processus ne peut être industrialisé. Contactez vos interlocuteurs Divalto habituels pour qu'ils vous assistent dans cette démarche.

V5.2

L'ordre des Backends existants a été modifié pour les IDMapping afin d'assurer une meilleure gestion de la recodification des tables concernées. Les flux en question ont été préfixés par « 25. ».
L'ordre de Backends existants a été modifié afin de permettre une résolution code-ID liés aux tarifs infinity par les Backends Customer et Prospect dès le 1er import. Les flux en question ont été préfixés par « 35. ».
L'export des devis sur les prospects sera pris compte directement par l'Event « Export Documents » sans validation externe.
La liste des modifications se trouve dans Kit Divalto infinity - Release Notes.

V5.3

Un nouveau flux de données DIM (Installation & Maintenance) a été mis en place.
Utilisation d'une nouvelle constante (%DECODING_NAME%) pour décoder le nom et le prénom du collaborateur dans le ControlCenter.
Dans les contrats, le type générique CONTRACT_TYPE n'est plus utilisé car remplacé par la table des types de contrat sw_data_contracttype.
Dans les activités par élément d'affaire le type générique DEAL_DEALACTIVITY n'est plus utilisé car remplacé par la table des types d'activités sw_data_ timetypeactivity.
La liste des modifications se trouve dans Kit Divalto infinity - Release Notes.

V5.4

L'application de conversion de fichiers pour le DataHub de Divalto infinity "ConvertForDataHub.exe" (version 1.0.0.1) horodate le fichier .dhub de destination (file_[YYYYMMDDhhmmss].dhub) et supprime le fichier .txt d'origine.
Un nouveau flux d'import d'urls (ControlCenter + Backend) qui permet d'ouvrir les écrans Divalto infinity en mode client léger depuis le BO Divalto weavy a été mis en place. Ce flux permet également d'importer l'url d'appel du webservice Divalto infinity qui permet notamment la création de devis travaux.
Nous n'exportons pas les rubriques dans le Control Center (définition et données) dont le code rubrique n'est pas conforme (sont autorisés uniquement les lettres : A->Z, a->z, les chiffres : 0->9 et le caractère spécial : _).
Dans l'event « [Infinity] Export Deals » l'action « DelStep » n'est plus générée par défaut car non gérée en standard dans l'import Divalto infinity.
La liste des modifications se trouve dans Kit Divalto infinity - Release Notes.

V5.5

Mise en place de l'horodatage sur les fichiers en mode différentiel (ControlCenter + Backend) sous la forme "file-[DATETIME].csv". Il est important d'avoir importé tous les fichiers en attente avant d'installer l'horodatage des fichiers.
Un nouveau flux d'export des mouvements de stock (Event + Scrutateur mobile infinity) a été mis en place.
L'export des feuilles de temps liées aux interventions n'est plus converti au format datahub mais envoyé au scrutateur mobile, ce qui permet de faire des surcharges.
Rattrapage sur l'évolution des statuts des affaires/opportunités pour utiliser les nouveaux types génériques « DEAL_STATUS_V2 » et « OPPORTUNITY_STATUS ».
Gestion des quantités théoriques/réelles sur les fiches de stock (ControlCenter + Backend).
Les anciens modules « SAV » ont été supprimés du ControlCenter.
La liste des modifications se trouve dans Kit Divalto infinity - Release Notes.

V5.6

A partir de cette version, si un fichier d'export (Event) est modifié (ajout d’un nouveau champ) il sera indicé avec le n° de version (ex : xxxxV56.txt).

L’outil de conversion de champs dynamiques « ConvertToDynamicFields.exe » doit être en dernière version (1.0.0.3) pour prendre en compte cette évolution.

L’import des adresses des équipements a été mis en mode différentiel avec horodatage.

La liste des modifications se trouve dans Kit Divalto infinity - Release Notes.

V5.7

Gestion des fichiers joints en différentiel (ControlCenter + Backend).

Un nouveau flux d'import de variables externes (ControlCenter + Backend) a été mis en place.

Un nouveau flux d’import de modèles de contrat (ControlCenter + Backend) a été mis en place.

Un nouveau flux d’import pour les types de mesures compteurs (ControlCenter + Backend) a été mis en place.

Le flux des contacts a été modifié pour tenir compte de l’activation possible de la gestion de la numérotation des contacts en automatique dans Divalto infinity (ControlCenter + Backend + Event).

Le flux des affaires/opportunités a évolué pour prendre en compte les affaires de type opportunité de Divalto infinity (ControlCenter + Backend + Event).

Dans l’import des articles et des tables annexes liées, exclusion des articles indicés (ControlCenter).

Dans l’import des stocks, prise en compte de la table des réservations (MRES) pour le calcul de la quantité réservée (ControlCenter).

L’ordre d’export des clients et des entêtes d’historique a été modifié dans le ControlCenter et placé après les tables liées pour palier au problème de création d’enregistrements pendant l’export.

La liste des modifications se trouve dans Kit Divalto infinity - Release Notes.

V6.0

Gestion du code société Divalto infinity en alphanumérique (ControlCenter/Agent) dans l’ensemble des requêtes d’extractions.

Un nouveau flux d’import concernant un ensemble d’extractions pour le module Froid (ControlCenter/Agent + Backend) a été mis en place.

Un nouveau flux d’export pour les caractéristiques froid des équipements (Event) a été mis en place.

Un nouveau flux d’import pour les encours clients (ControlCenter/Agent + Backend) a été mis en place.

Un nouveau flux d’import pour les adresses des événements (ControlCenter/Agent + Backend) a été mis en place.

Un nouveau flux d’import pour les adresses des rendez-vous (ControlCenter/Agent + Backend) a été mis en place.

Un nouveau flux d’import pour les traductions des descriptions articles (ControlCenter/Agent + Backend) a été mis en place.

Un nouveau flux d’import pour les chiffres clés des affaires (ControlCenter/Agent + Backend) a été mis en place.

Un nouveau flux d’import pour le référencement client (ControlCenter/Agent + Backend) a été mis en place.

Le flux d’import des historiques de pièces a évolué pour prendre en compte les devis travaux clients et prospects.

Le flux d’import des articles a évolué pour prendre en compte les articles dont la fin de validité est dépassée suite à la gestion d’une date de fin dans Divalto weavy.

Les fichiers batchs (.cmd) ont été versionnés afin de bien identifier les versions installées.

La liste des modifications se trouve dans Kit Divalto infinity - Release Notes.

V6.1

Un nouveau flux d’import pour le suivi de facturation des interventions (ControlCenter/Agent + Backend) a été mis en place.

Un nouveau flux d’import pour les tiers à facturer (ControlCenter/Agent + Backend) a été mis en place.

Un nouveau flux d’import pour les motifs de non facturation des interventions (ControlCenter/Agent + Backend) a été mis en place.

Un nouveau flux d’import pour les adresses des contacts (ControlCenter/Agent + Backend) a été mis en place.

Les flux d’import des clients et des prospects ont évolués pour prendre en compte les clients/prospects dont la fin de validité est dépassée suite à la gestion d’une date de fin dans Divalto weavy.

Le flux d’import des adresses a évolué pour prendre en compte les adresses dont la fin de validité est dépassée suite à la gestion d’une date de fin dans Divalto weavy ainsi que le contact principal.

Le flux d’import des articles a évolué pour prendre en compte le tarif d'une autre référence.

Le flux d’import des équipements a évolué pour prendre en compte l'équipement parent issu d’un arbre intervallaire dans Divalto infinity.

Les flux d’import des affaires/opportunités, des types d’affaires/opportunités, des types d'étapes et des étapes ont évolués pour prendre en compte les familles d’affaires.

Le flux d’export des pièces pour les interventions prend en compte la gestion des gratuits en exportant des lignes complémentaires.

La liste des modifications se trouve dans Kit Divalto infinity - Release Notes.