Aller directement à la fin des métadonnées
Aller au début des métadonnées

Vous regardez une version antérieure (v. /wiki/spaces/UDW56/pages/10542974282/Kit+Divalto+infinity+-+Documentation+fonctionnelle) de cette page.

afficher les différences afficher l'historique de la page

« Afficher la version précédente Vous regardez la version actuelle de cette page. (v. 12) afficher la version suivante »

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 5.6 pour être en phase avec la version SUMMER’22 de Divalto weavy.

Introduction

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 :

  • infinity 7.5e

  • infinity X.3

  • infinity X.4

  • infinity X.5

  • infinity X.6

  • infinity X.7

  • infinity X.8

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.6 Summer’22 : masterVersion = 1.5.20220517

  • Divalto weavy Control Center à jour : version V 4.5.0 à ce jour

  • Divalto weavy Studio à jour : version V 5.19.1.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.

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

Infinity X.8

  • Infinity X.8

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

  • Derniers hotfix

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 :

  • Fichiers de configuration Divalto weavy Control Center (extraction des données d'Infinity et échanges bidirectionnels avec la plateforme Divalto weavy).

  • Arborescence et outils nécessaires au fonctionnement

  • Dossier contenant la surcharge infinity

  • Dossier contenant les interfaces Backend et Event

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

La version 5 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

Flux Divalto infinity vers Divalto weavy

Données communes

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

  • Information société (SOC)

  • Civilité (T048)

  • Responsabilité des contacts (T069)

  • Services des contacts (T051)

  • Liste des pays (T013)

  • Liste des devises (T007)

  • Familles clients (T029)

  • Libellé des taux de TVA Client (T086)

  • Niveau de rattachement clients / vendeurs (REPR1, REPR2, REPR3)

  • Projet raisons des pertes (T059)

  • Etat des projets/affaires (statique)

  • Type d'affaires (projets/affaires) (statique)

  • Liste des modes de livraisons (T026)

  • Type de document (statique)

  • Type d'événement parent (statique)

  • Liste des modes de règlements (T006)

  • Taux de TVA (T085)

  • Libellé des taux de TVA Article (T085)

  • Liste des provinces (T099)

  • Type de rendez-vous (GRTEVT)

  • Unités de vente (T005)

  • Unités de mesures (T023)

Ajoutées en V5.3 :

  • Unités de poids (T023)

  • Types d'activités (T039)

Ajoutées en V5.4 :

  • URL externes (MABSENT)

Ajoutées en V5.5 :

  • Etat des affaires V2 (statique)

  • Etat des opportunités (statique)

Ajoutées en V5.6 :

  • Motifs de pertes de documents (T059)

  • Versioning Motifs de pertes de projets à partir de Divalto infinity X.3

Utilisateurs/Clients

  • Utilisateurs (MUSER)

  • Clients (CLI)

  • Adresses clients (T1,CLI,SITE)

  • Contacts (T2)

  • Groupes Client (CLI)

  • Liens utilisateurs Clients/Prospects (CLI/PRO)

  • Prospects (PRO)

  • Documents Clients/Prospects (MJOINT)

  • Historique des pièces Facture, Avoir, Devis, Commande, Bon de livraisons (ENT,MOUV)

  • IDMapping (recodification suite intégration ERP) (MMOBITEMP)

Ajoutées en V5.4 :

  • Versioning Utilisateurs à partir à partir de Divalto infinity X.6

Ajoutées en V5.5 :

  • Versioning Historique (entête et détail) des pièces à partir de Divalto infinity X.2

Ajoutées en V5.6 :

  • Versioning Clients à partir de Divalto infinity X.8

  • Versioning Adresses clients à partir de Divalto infinity X.8

  • Versioning Prospects à partir de Divalto infinity X.8

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

  • Familles sur 4 niveaux (T012)

  • Articles (ART)

  • Définition Dimensions articles (Statique)

  • Sous-référence Articles (SART)

  • Kits (DAR)

  • Liste des dépôts (T017)

  • Documents Articles (MJOINT)

  • Images des articles (ART)

  • Stock par dépôt (MVTL)

  • Nature de stock (T025)

  • Codes Opérations (T020)

  • X.3 : Articles complémentaires (PRDTCARTO, PRDTASSOR, ASSORART, MAIV)

  • X.3 : Articles de remplacement (ART, PRDTCARTO, PRDTASSOR, ASSORART, MAIV)

Ajoutées en V5.2 :

  • Détail de stock par dépôt (MVTL)

Ajoutées en V5.5 :

  • Versioning Dépôts à partir de Divalto infinity X.7

  • Versioning Codes opérations à partir de Divalto infinity X.7

Tarifs

  • Catégorie de prix (TAR)

  • Conditions de ventes (TAR)

  • Familles tarification (T008)

  • Classe de remises (T009)

  • Tarifs (TAR)

  • Tarifs promotions (TARPROMO)

  • Remises (TRE)

  • Remises promotions (TREPROMO)

Ajoutées en V5 :

  • Paramétrage tarifs du dossier (SOC)

  • Libellé famille de tarification (T001)

  • Libellé classe remise (T002)

  • Coefficient coût de revient (T010)

  • Marché (T034)

  • Code remise (T035)

  • Libellé des promotions (T072)

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

  • Type d'événements (GRTEVT)

  • Evénements (EVTTIERS)

  • Evénements rattachés aux projets (EVTTIERS,PRJAV)

  • Evénements rattachés aux affaires (EVTTIERS,PRJAP)

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

  • Statut des projets/affaires (statique)

  • Etapes des projets/affaires (statique)

  • Raisons des échecs (T059)

  • Opportunités (PRJAV)

  • Affaires (PRJAP)

  • Activités d'affaires (T039)

  • Eléments d'affaires (GPAELEM)

  • Activités sur éléments d'affaires (GPAACTIVITE)

  • Association ressources-éléments-activités(GPAACTIVRES)

Cette version du kit extrait les affaires d'une X.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 x.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)

  • Questionnaires/Rubriques (MQSTRBQ, MRBQ)

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

  • Type de contrats (T101)

  • Contrats (CEACONTRAT)

Ajoutées en V5.4 :

  • Versioning des Contrats à partir de Divalto infinity X.5

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 :

  • Genres d'équipements (GMGENRE)

  • Types d'équipements (GMTYPE)

  • Equipements (GMMAT)

  • Adresses des équipements (GMTLOC)

  • Types de garanties (T143)

  • Types d'interventions (GMTINTFAM)

Ajoutées en V5.4 :

  • Agences (T145 ou ETS selon paramétrage dossier)

Ajoutées en V5.5 :

  • Versioning Types d'interventions à partir de Divalto infinity X.7

Statistiques

  • Statistiques

Ajoutées en V5.5 :

  • Versioning Statistiques à partir de Divalto infinity X.2

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 :

  • Devis, Commandes

    • EntDocument, DetDocument, DetDocumentInfinity, InfoDocument, DetDocumentExtension

  • Bons de livraisons

    • EntLivraison, DetLivraison, DetLivraisonInfinity, DetLivraisonExtension, BatchSerialNo

  • Evénements de type rendez-vous → Agenda

  • Evénements de type tâches* → ActionV15

  • Client → Client

  • Client Contacts → Contact

  • Prospects → Prospect

  • Prospects contacts → ProspectContact

  • Projets/Affaires → Affaire

  • Temps sur les affaires → Affaire (via DataHub)

  • Fichiers joints (Client, Prospect, Opportunité, Affaire, Evénement)

    • File, FileEntity

  • Interventions (hors contrats) avec rapport en PJ → Bons de livraison

  • Contrats avec documents en PJ → Contrats

  • Adresses de livraisons → Adresses (T1)

  • Fichiers joints liés aux devis/commandes

  • V5 : type d'équipement (uniquement à partir de infinity 10.4*)

  • V5 : type d'intervention (uniquement à partir de infinity 10.4*)

  • V5 : équipements (uniquement à partir de infinity 10.4*)

  • V5 : LinkToWeavy (URL et webhooks) (uniquement à partir de infinity 10.4*)

  • V5.3 : Temps sur les interventions → Affaire (via DataHub)

  • V5.5 : Temps sur les interventions → Affaire (sans DataHub)

  • V5.5 : Mouvements de stock → Bons de livraison interne

Pour plus de détails sur l'interface mobile de Divalto infinity, se reporter aux documentations disponibles dans le connecteur mobile (infinity Mobile V7.x : Mapping et Synchronisation).

* 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 (Control Center + 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'export 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.

  • Aucune étiquette