Introduction

Ce document décrit la liste des évolutions apportées à partir de la version 5.0.0.0 du kit de connexion Divalto infinity.

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

• Un écran particulier de gestion de prix en saisie de pièces Mobile (non disponible dans la CRM Web)

• 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

La version est cumulative. Elle contient donc toutes les corrections des différentes versions en plus des modifications apportées par la version 5.5.

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

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

• Environnement Master Divalto weavy V5.5 Winter'21 : masterVersion = 1.5.20211116

• Divalto weavy Control Center à jour (version V 4.5.0 à ce jour)

• Divalto weavy Studio à jour (version V 5.14.2.0 à ce jour)

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.

Divalto Infinity

Selon votre version d'infinity :

Infinity 7.5e

• Infinity 7.5e

• Le connecteur mobile est intégré en standard depuis la version 7.5c

• Derniers hotfix

Infinity X.3

• Infinity X.3

• Le connecteur mobile est intégré en standard dans la version X.3

• Derniers hotfix

Infinity X.4

• Infinity X.4

• Le connecteur mobile est intégré en standard dans la version X.4

• Derniers hotfix

Infinity X.5

• Infinity X.5

• Le connecteur mobile est intégré en standard dans la version X.5

• Derniers hotfix

Infinity X.6

• Infinity X.6

• Le connecteur mobile est intégré en standard dans la version X.6

• Derniers hotfix

Infinity X.7

• Infinity X.7

• Le connecteur mobile est intégré en standard dans la version X.7

• Derniers hotfix

Contrainte : Dossier

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

Control Center

Version de control center

La version 5.5.0.0 du kit nécessite les dernières versions du Control Center, à ce jour la 4.5.0.

Flux nouveaux et modifiés

Nouveautés V5

• INFINITY – Prix

  • Les différentes tables liées aux tarifs de Divalto infinity (Flux : InfinityXXX).

Nouveautés V5.2

• INFINITY – Données Article

  • Détail de stock (Flux : productstockdetail)

• Document file list generation

  • Logo société (Flux : 1. Companyinfo File List)

• INFINITY – CRM

  • Types de rendez-vous (Flux : Task type)

Nouveautés V5.3

• INFINITY – Données de base

  • Types d'activités (Flux : 20. Base Info - Time Type Activity)

  • Unités de poids (Flux : 20. Base Info – WeightUnit)

• INFINITY - Données Utilisateurs / clients

  • Collaborateur (baseuser) : Utilisation d'une nouvelle constante (%DECODING_NAME%) pour décoder le nom et le prénom du collaborateur :

    • Si valeur = PrenomNom (par défaut) alors MUSER.NOM ou VRP.NOM sont décodés par :

      • Prénom (jusqu'au 1er espace) -> firstName 

      • Nom pour le reste -> lastName 

      • Si pas d'espace on considère qu'on a que le nom

    • Si valeur = NomPrenom alors MUSER.NOM ou VRP.NOM sont décodés par :

      • Nom (jusqu'au 1er espace) -> lastName 

      • Prénom pour le reste -> firstName 

      • Si pas d'espace on considère qu'on a que le nom

    • Sinon MUSER.NOM ou VRP.NOM -> lastName (comme avant)

• INFINITY - Affaires X.2

  • Deal Element Activity : le type générique DEAL_DEALACTIVITY n'est plus utilisé car remplacé par la table des types d'activités sw_data_timetypeactivity.

• INFINITY – DIM

  • Genres d'équipements (Flux : 92. Equipment - 1. Equipment Kind)

  • Types d'équipements (Flux : 92. Equipment - 2. Equipment Type)

  • Equipements (Flux : 92. Equipment - 3. Equipment)

  • Adresses des équipements (Flux : 92. Equipment - 3.1. Equipment Address)

  • Types de garanties (Flux : 92. Equipment - 4. Equipment Warranty Type)

  • Types d'interventions (Flux : 93. Intervention - 1. Intervention Type)

• Document file list generation

  • 1. Customer File List : nouvelle constante %PATHPRODOCUMENT% pour les chemins des fichiers prospects afin de différencier les chemins client/prospect

  • 1. Deal Document File List : nouvelle constante %PATHPROJECTDOCUMENT% pour les chemins des fichiers projets afin de différencier les chemins affaire/projet

• INFINITY - Rubriques implicites définition

  • Définition Rubriques Equipement

• INFINITY - Rubriques implicites données

  • Données Rubriques Equipements (Flux : 92. Equipment - 3.2. Equipment – DynamicFields)

• INFINITY – Contrat

  • Contrat : le type générique CONTRACT_TYPE n'est plus utilisé car remplacé par la table des types de contrat sw_data_contracttype

Nouveautés V5.4

• INFINITY – Données de base

  • URLs externes (Flux : 20. Base Info - ExternalUrl)

• INFINITY - Données Utilisateurs / clients

  • Collaborateur scindé en « baseuser » et « baseuser vX.6 » suite à l'utilisation du champ « PRENOM » pour améliorer la compatibilité selon la version de Divalto infinity.

• INFINITY – IM

  • Le module « INFINITY – DIM » a été renommé en « INFINITY – IM » (Installation & Maintenance)

  • Agences (Flux : 1. Branchoffice)

• INFINITY - Rubriques implicites définition

  • Nous n'exportons pas les définitions de rubriques 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 : _)

• INFINITY - Rubriques implicites données

  • Nous n'exportons pas les données des rubriques 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 : _)

• INFINITY – Contrat

  • Contrat scindé en « Contrat » et « Contrat vX.5 » rétroactivement pour améliorer la compatibilité selon la version de Divalto infinity

  • Facturation contrat scindé en « Contrat Facturation » et « Contrat Facturation vX.5 » rétroactivement pour améliorer la compatibilité selon la version de Divalto infinity

• INFINITY - Affaires X.2 - Convertit AffaireTemps pour le DataHub

  • 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

Nouveautés V5.5

• Mise en place de l'horodatage sur les fichiers exportés en mode différentiel sous la forme "file-[DATETIME].csv"

  • baseuser

  • baseuser vX.6

  • IDMapping

  • customer - sw_data_customer

  • customergroup

  • customeraddress

  • customercontact

  • customeruser

  • HistoHeader - sw_data_histoheader

  • HistoDetail - sw_data_histodetail

  • productfamily

  • productdeclination

  • product

  • productdepo

  • productstock

  • productstockdetail

  • Price Category

  • InfinitySOC

  • InfinityT001

  • InfinityT002

  • InfinityT005

  • InfinityT035

  • InfinityT072

  • InfinityT008

  • InfinityT009

  • InfinityT010

  • Sales Conditions

  • InfinityT034

  • InfinityTAR

  • InfinityTARPROMO

  • InfinityTRE

  • InfinityTREPROMO

  • sw_data_statistic

  • Event type

  • Event - sw_data_event

  • Task type

  • Task - sw_data_task

  • Deal Element Structure

  • Deal Element

  • Deal Element Activity

  • Deal Element Activity User

  • equipment

• INFINITY – Données de base

  • Etat des affaires V2 (Flux : 20. Base Info - Deal StatusV2)

  • Etat des opportunités (Flux : 20. Base Info - Opportunity Status)

• INFINITY - Données Utilisateurs / clients

  • Versioning de rattrapage de l'entête des historiques « HistoHeader - sw_data_histoheader vX.2 » suite à l'utilisation des préfixes des documents dans Divalto infinity

  • Versioning de rattrapage du détail des historiques « HistoDetail - sw_data_histodetail vX.2 » suite à l'utilisation des préfixes des documents dans Divalto infinity

• INFINITY – Données articles

  • Versioning des dépôts « producdepo vX.7 » suite à l'utilisation des nouveaux champs « Dépôt véhicule » et « Réception automatique » dans Divalto infinity

  • Versioning des codes opérations « Product Stock Movement Type vX.7 » suite à l'utilisation du nouveau champ « Famille d'opération à exporter » dans Divalto infinity. Utilisation des champs « Transfert de dépôt » et « Portée »

• INFINITY – CRM

  • « Deal vX.1 » a été modifié pour tenir compte des nouveaux statuts des affaires/opportunités

  • « Deal Step Type » a été modifié pour tenir compte des nouveaux statuts des affaires/opportunités

• INFINITY – Statistiques

  • Versioning de rattrapage des statistiques « sw_data_statistic vX.2 » suite à l'utilisation des préfixes des documents dans Divalto infinity

• INFINITY – IM

  • Versioning des types d'interventions « interventiontype vX.7 » suite à la refonte des tables dans Divalto infinity

• INFINITY – SAV

  • Tous les modules obsolètes « SAV - … » ont été supprimés

Backend

Nouveautés V5.0

Renommage de flux afin de changer l'ordre de traitements :

L'ordre des flux des backends dans le planning « [Infinity] – Import » a été modifié en conséquence.

Nouveautés V5.2

Renommage de flux afin de changer l'ordre de traitements :

L'ordre des flux des backends dans le planning « [Infinity] – Import » a été modifié en conséquence.
Nouveaux flux :

• 0. Company - Product picture binary upload

• 25. 92.IDMapping Contrat

• 30. Product - 4.1. Stock Detail

• 35. 2.Customer – 4.1. Customer Group/Customer

• 60. CRM – 5. Task Type

Nouveautés V5.3

Renommage de flux afin de changer l'ordre de traitements :

L'ordre des flux des backends dans le planning « [Infinity] – Import » a été modifié en conséquence.
Nouveaux flux :

• 25. 93.IDMapping Customer Address

• 92. Equipment - 1. Equipment Kind

• 92. Equipment - 2. Equipment Type

• 92. Equipment - 3. Equipment

• 92. Equipment - 3.1. Equipment Address

• 92. Equipment - 3.2. Equipment – DynamicFields

• 92. Equipment - 4. Equipment Warranty Type

• 92. Equipment - 5. Equipment Warranty (non exploité pour l'instant)

• 93. Intervention - 1. Intervention Type

Modification concernant le flux des contrats :

• 91. Contract - 2. Contract : le type générique CONTRACT_TYPE n'est plus utilisé car remplacé par la table des types de contrat sw_data_contracttype. Utilisation du champ « contracttype_ID ».

Modification concernant le flux des activités par élément d'affaire :

• 90. Deal X.2 - 4. Deal Element Activity : le type générique DEAL_DEALACTIVITY n'est plus utilisé car remplacé par la table des types d'activités sw_data_timetypeactivity. Utilisation du champ « timetypeactivity_ID ».

Nouveautés V5.4

Nouveaux flux :

• 0. Company – Variable : permet de mettre à jour la variable "ExternalCompanyCode.Value" utilisée dans l'export LinkToWeavy.txt

• 1. Branchoffice

• 20. Base Info - ExternalUrl

Nouveautés V5.5

Gestion horodatage sur les flux déjà existants :

• 10. Base User

• 25. 1.IDMapping Contact

• 25. 2.IDMapping Prospect

• 25. 3.IDMapping Prospect Contact

• 25. 4.IDMapping Event

• 25. 5.IDMapping Task

• 25. 6.IDMapping Deal

• 25. 8.IDMapping InterventionType

• 25. 9.IDMapping Equipment Type

• 25. 91.IDMapping Equipment

• 25. 92.IDMapping Contrat

• 25. 93.IDMapping Customer Address

• 26. Customer - Recode From Prospect

• 80. Customer - Order ERP Number

• 35. 2.Customer - 2. Customer

• 35. 2.Customer - 4.1. Customer Group/Customer

• 35. 2.Customer - 4. Customer Group

• 50. Customer - 2. Address

• 50. Customer - 3. Contact

• 50. Customer - 4. Customer User

• 50. Customer - 5. Histo header

• 50. Customer - 6. Histo detail

• 30. Product - 0. Family

• 30. Product - 0.d.2 Product declination

• 30. Product - 1. Product

• 30. Product - 3. Product depot

• 30. Product - 4. Stock

• 30. Product - 4.1. Stock Detail

• 35. 1.Price - 0. Category

• 35. 1.Price - 40. infinity SOC

• 35. 1.Price - 41. infinity T001

• 35. 1.Price - 42. infinity T002

• 35. 1.Price - 42..1 infinity T005

• 35. 1.Price - 43. infinity T035

• 35. 1.Price - 44. infinity T072

• 35. 1.Price - 45. infinity T008

• 35. 1.Price - 46. infinity T009

• 35. 1.Price - 47. infinity T010

• 40. Price - 1. SalesConditions

• 40. Price - 48. infinity T034

• 40. Price - 50. infinity TAR

• 40. Price - 51. infinity TARPROMO

• 40. Price - 52. infinity TRE

• 40. Price - 53. infinity TREPROMO

• 50. Customer - 7. Statistics

• 60. CRM - 1. Event Type

• 60. CRM - 4. Event

• 60. CRM - 5. Task Type

• 60. CRM - 6. Task

• 90. Deal X.2 - 1. Deal Element Structure

• 90. Deal X.2 - 2. Deal Element Structure Parent Update

• 90. Deal X.2 - 3. Deal Element

• 90. Deal X.2 - 4. Deal Element Activity

• 90. Deal X.2 - 5. Deal Element Activity User

• 92. Equipment - 3. Equipment

Nouveaux flux :

• 20. Base Info - Deal StatusV2

• 20. Base Info - Opportunity Status

• 30. Product - 4. Stock - Adjust Quantity : mise à jour des quantités réelles pour les stocks non véhicules

• 30. Product - 4.1. Stock Detail - Adjust Quantity : mise à jour des quantités réelles pour les stocks non véhicules

Event

Nouveautés V5.0

Nouveaux Events :
[Infinity] Export Equipment and type

• Export Type d'équipements

• Export type d'interventions

• Export des équipements

[Infinity] Export LinkToWeavy

• Export des URLs et webhooks

Nouveautés V5.2

[Infinity] Export Documents
Une modification dans la gestion des pièces commerciales fait que l'export des devis sur les prospects sera pris compte directement sans validation externe.

Nouveautés V5.3

Nouveaux Events :
[Infinity] Export Deals Intervention Times

• DealInterventionTemps

[Infinity] Export Intervention

• BatchSerialNo

Modifications Events :
[Infinity] Export Intervention
Modification du nom du fichier en sortie suite à l'ajout de nouveaux champs.

• EntLivraison -> EntLivraisonV3.txt

• DetLivraison Pièces / DetLivraison Temps -> DetLivraisonV3.txt

• DetLivraisonInfinity Pièces / DetLivraisonInfinity Temps -> DetLivraisonInfinityV3.txt

[Infinity] Export Equipment and type
Modification du nom du fichier en sortie suite à l'ajout de nouveaux champs.

• Equipement -> equipementV2.txt

Nouveautés V5.4

Modifications Events :
[Infinity] Export Intervention
Modification du nom du fichier en sortie suite à l'ajout de nouveaux champs.

• DetLivraison Pièces / DetLivraison Temps -> DetLivraisonV4.txt

[Infinity] Export Equipment and type
Modification du nom du fichier en sortie suite à l'ajout de nouveaux champs.

• Equipement -> equipementV3.txt

[Infinity] Export LinkToWeavy
Utilisation de variables pour une meilleure portabilité.
Nous utilisons dorénavant des variables pour ne plus avoir à modifier l'event directement suite à l'installation. Les URLs weavy sont mises à jour au provisioning selon la typologie du projet et le code dossier vient de la variable ExternalCompanyCode.Value récupérée en automatique suite à un import infinity.

[Infinity] Export Deals
DelStep.txt n'est plus généré par défaut car non géré dans l'import Divalto infinity.

Nouveautés V5.5

Nouvelles planifications :
[Infinity] Export stock
Permet d'exporter les mouvements de stock technicien indépendamment des autres exports. Par défaut aucune fréquence n'est définie.

Nouveaux Events :
[Infinity] Export Stock Movement : export des mouvements de stock technicien

• Mouvement

• MouvementDetail

Modifications Events :
[Infinity] Export Intervention
Modification du nom du fichier en sortie suite à l'ajout de nouveaux champs.

• EntLivraison -> EntLivraisonV5.txt

• DetLivraison Pièces / DetLivraison Temps -> DetLivraisonV5.txt

• DetLivraisonInfinity Pièces / DetLivraisonInfinity Temps -> DetLivraisonInfinityV5.txt

[Infinity] Export Documents

• Changement dans l'ordre d'export des fichiers et amélioration de la gestion du flag « srvExport ».

• On exporte pas les documents encore en brouillon BO (draftBO = 1)

[Infinity] Export Delivery
Changement dans l'ordre d'export des fichiers et amélioration de la gestion du flag « srvExport ».

[Infinity] Export Deals Intervention Times
Modification du nom du fichier en sortie suite à l'ajout de nouveaux champs. Ce fichier ne sera désormais plus converti au format Datahub (.dhub) dans Divalto weavy mais traité directement par le scrutateur mobile de Divalto infinity. Ceci facilite les possibilités de surcharge.

• DealInterventionTemps -> AffaireInterventionTempsV2.txt

Mise à jour

Principes généraux

A ce jour, il n'existe pas de mécanismes standard de mise à jour automatisée tenant compte des spécifiques qui ont pu être réalisés. La mise à jour est donc manuelle et basée sur la comparaison entre votre existant et les modifications effectuées dans les nouvelles releases des kits de connexion.
Les exports de Backends et Events sont disponibles dans le dossier OldVersion du kit, afin de pouvoir faire des comparaisons avec vos versions.

Serveur : Backend/Event

Si vous avez modifié vos Events et/ou vos BackEnds, il faut exporter leur définition dans des fichiers, et opérer une comparaison de ces fichiers avec ceux fournis dans le kit. Cf. point ci-après « Principes d'import et de comparaison ».

Control Center 

Option 1 : comparaison avec WinMerge
Le kit de connexion, à partir de v2, fournit l'outil « RSWConverter » qui permet de convertir les fichiers de configuration RSW du ControlCenter en fichier XML, ceci afin de permettre des comparaisons entre votre configuration et la configuration fournie dans le kit.
Les étapes :

1. Convertir votre configuration actuelle en XML

C:\SwingMobility\Tools\RSWConverter\RSWConverter.exe RSW2XML -s -i"c:\SwingMobility\ControlCenter\ConfigMain" -o"c:\SwingMobility\ControlCenter\ ConfigMain.src"
Le dossier ConfigMain.src sera créé automatiquement.

2. Effectuer la comparaison avec un outil de type WinMerge entre votre dossier ConfigMain.src et le dossier du kit \CC-Configuration\ConfigMain.src.

Option 2 : utiliser un outil de gestion de version, comme git par exemple.

1. Convertir votre configuration actuelle en XML

C:\SwingMobility\Tools\RSWConverter\RSWConverter.exe RSW2XML -s -i"c:\SwingMobility\ControlCenter\ConfigMain" -o"c:\SwingMobility\ControlCenter\ ConfigMain.src"
Le dossier ConfigMain.src sera créé automatiquement.

2. Créer un dépôt git dans ce dossier, et faire le commit initial en committant tous les fichiers.

3. Copier le contenu du dossier du kit \CC-Configuration\ConfigMain.src dans votre dossier.

4. Les fichiers vont être détectés en modifications. En utilisant, les outils de diff intégré (par exemple TortoiseGit → Diff), il est aisé de visualiser les modifications à la fois issues de vos spécifiques et ceux issues de l'évolution du kit.

5. Reporter les modifications détectées directement dans le ControlCenter via l'interface graphique.

Une évolution de l'outil RSWConverter est prévue afin de permettre la conversion inverse, de XML vers RSW, afin de pouvoir réaliser l'ensemble des opérations à partir d'un outil de merge et de gérer ses configurations ControlCenter avec un outil de gestion de version.

Ai-je modifié ma configuration par rapport au kit standard ?

Dans le kit sont fournis les versions précédentes des configurations du ControlCenter en version XML dans l'objectif que vous puissiez comparer ces configurations à celles installées. Elles sont disponibles dans \CC-Configuration\PreviousVersion.src.
Pour se faire,
Convertir votre configuration avec l'outil RSWConverter :
C:\SwingMobility\Tools\RSWConverter\RSWConverter.exe RSW2XML -s -i"c:\SwingMobility\ControlCenter\ConfigMain" -o"c:\SwingMobility\ControlCenter\ ConfigMain.src"
Effectuer une comparaison des fichiers entre le dossier ConfigMain.src et le dossier \CC-Configuration\PreviousVersion.src\X.Y du kit.

Principes d'import et de comparaison

Depuis la version 4.1 du kit de connexion, les backends et les events s'importent dans le projet via l'import de configuration du Studio.
Ce mécanisme détecte les différences entre vos versions et la version importée, et vous demande de régler les conflits.
Afin de faciliter la résolution des conflits, il est possible d'exporter vos interfaces dans des fichiers JSON, en utilisant le Studio (Configuration -> Exporter les interfaces).
Ceci va enregistrer la définition des backends et events dans des fichiers.

1. Comparaison avec la version de ce kit

Utiliser un outil de comparaison/fusion, tel que Winmerge afin de détecter et fusionner vos modifications avec les nouvelles versions des interfaces. Une fois fait, vous pourrez réimporter vos versions modifiées via le Studio (Configuration -> Importer la configuration).
Ouvrir les 2 fichiers, celui du kit à gauche et le vôtre à droite,

L'outil va détecter les différences entre les 2 fichiers.
Certaines de ces différences s'expliquent aisément, et ne nécessitent pas d'être répercutées.

Dans l'exemple, ci-dessus il est logique qu'il y ait des différences sur la date/heure, qui correspond à la date/heure de l'export du fichier. Il est en de même pour la source (le code projet), le user ainsi que les ID, du fait que nous comparons des exports issus de projets différents.
Alt + flèche vers le bas, permet de passer à la modification suivante.
La partie intéressante concerne la partie SQL, donc après le SELECT :

La partie basse permet de comparer facilement les lignes des 2 fichiers :

Si la modification proposée par le kit n'impacte pas vos spécifiques, vous pouvez fusionner la modification avec votre fichier. Ceci peut être fait en faisant Alt + flèche gauche. Une fois les modifications passées en revue, et selon les cas, répercutées dans votre event spécifique, enregistrer votre fichier, puis le réimporter avec le studio.