wiki:v15:migration_13_15

Différences

Ci-dessous, les différences entre deux révisions de la page.


Révision précédente
wiki:v15:migration_13_15 [2024/03/21 11:30] (Version actuelle) – [Migration de Gestan 13 à Gestan 15] eneuville
Ligne 1: Ligne 1:
 +====== Migration de Gestan 13 à Gestan 15 ======
 +
 +<WRAP round todo>
 +
 +Gestan 15 est la suite de Gestan 13, à compter du 01/01/2018. Vous retrouverez dans la version 15 tous les fondamentaux de la version 13, en y ajoutant de [[http://forum.gestan.fr/categories/nouvelles-versions|nombreuses nouveautés]].
 +
 +Cependant, la base de données de Gestan 15 n'a pas la même structure que celle de Gestan 13, il faut mettre les bases 13 au format 15. Tout un chacun peut effectuer cette mise au format, il suffit de bien suivre les étapes minutieusement décrites dans le tuto ci-dessous.
 +
 +Pour ceux qui toutefois ne seraient pas du tout à l'aise avec l'informatique, nous vous proposons une offre d'[[https://www.gestan.fr/assistance-migration/|assistance à la migration]], qui, si elle n'a pas le mérite de la gratuité, a le mérite de l'efficacité et du confort total !
 +
 +</WRAP>
 +
 +<WRAP round alert >
 +Le programme de migration a été développé en 2018. Cependant, depuis toutes ces années, des modifications importantes ont été apportées à la V15, rendant l'usage du programme de migration lacunaire dans plusieurs cas. Aussi, depuis le 01/01/2023, sauf si vous disposez d'une connaissance avancée de Gestan, il est très vivement recommandée de [[https://www.gestan.fr/assistance-migration-erp-gestan/|faire appel au support pour effectuer la migration 13->15]].
 +</WRAP>
 +
 +
 +
 +
 +
 +===== Pré-requis =====
 +
 +Si vous utilisiez des addons, plugins, ou programmes spécifiques en Gestan 13, et qu'ils vous sont indispensables, assurez vous qu'ils sont disponibles en Gestan 15. En effet, tous les programmes spécifiques ne sont pas encore migrés en V15 !
 +
 +===== Migration d'une base "Classique" =====
 +
 +(Une base "classique" est une base qui n'est pas "client/serveur")
 +
 +==== 1 - Vérifiez la version de vos données Gestan 13 actuelles ====
 +
 +Assurez-vous que vos données V13 sont au format de la toute dernière version de Gestan, c'est à dire la 13.3D/R2 (c'est écrit dans le bandeau titre de la fenêtre Gestan)
 +
 +{{:wiki:v15:version_01.png?nolink|}}
 +
 +Si tel n'est pas le cas, faites la mise à jour de Gestan 13 (ou installez-le si vous ne l'avez plus) pour passer d'abord à la version 13.3D/R2, disponible sur [[https://www.gestan.fr/scripts/website/compteur_download.php?ops=increase|ce lien]].
 +
 +==== 2 - Sauvegardez vos données de production Gestan 13 actuelles ====
 +
 +<WRAP round important>
 +On est jamais trop prudent : Faites un copier-coller complet de votre répertoire de données Gestan (En général, c'est C:\GESTAN\DATABASE, sauf si vous l'aviez installé ailleurs. La localisation des données est indiquée en bas à gauche de l'écran principal de Gestan). Vous pouvez nommez cette copie en DATABASE_V13, par exemple
 +</WRAP>
 +  
 +
 +==== 3 - Utilisez l'utilitaire de migration : gMigr ====
 +
 +Installez l'utilitaire gMigr, disponible sur [[https://www.gestan.fr/downloads/gMigr_install.EXE|ce lien]].
 +
 +gMigr est l'utilitaire qui formate les données V13 au format V15. A l'exécution, il affiche cet écran :
 +
 +{{:wiki:tech:gmigr1.jpg|}}
 +
 +La petite loupe permet de sélectionner le répertoire de la base de données que vous voulez traiter. Par exemple, ici nous allons sélectionner la base 
 +
 +{{:wiki:tech:gmigr2.jpg|}}
 +
 +Une fois la base sélectionnée, cliquez sur le bouton **Migrer**.
 +
 +{{:wiki:tech:gmigr3.jpg|}}
 +
 +Le processus va modifier les fichiers du répertoire sélectionné, et créer un sous-répertoire "sauvegarde_gMigr", dans lequel il va stocker les fichiers originaux. 
 +
 +En cas de problème dans la migration, il suffit de copier les fichiers de "sauvegarde_gMigr" dans le répertoire supérieur, pour retrouver votre base dans son état initial (ou refaire un copier-coller de la base originale).
 +
 +{{:wiki:tech:gmigr4.jpg|}}
 +
 +Pour finir, supprimez les fichiers COMPUTER.FIC et COMPUTER.ndx se trouvant dans le dossier DATABASE. Si vous ne le faites pas, un message d'erreur s'affichera à l'ouverture de Gestan.
 +
 +{{:wiki:v15:migration_computer.png?400|}}
 +
 +
 +Si la migration s'est bien passée, supprimez le répertoire sauvegarde_gMigr, et désinstallez gMigr, qui devient inutile.
 +
 +Supprimez également les fichiers COMPUTER.* dans le répertoire des données.
 +
 +==== 4 - Téléchargez Gestan V15 ====
 +
 +Téléchargez le programme d'installation de Gestan V15 sur [[https://www.gestan.fr/scripts/ADM_compteur_download.php?ops=increase_15|ce lien]].
 +
 +Allez dans C:\Program Files (x86), et renommez le répertoire de programme Gestan (Normalement, c'est C:\Program Files (x86)\GESTAN dans lequel se trouvent les programmes de Gestan V13), en GESTAN_V13 ou GESTAN_OLD, par exemple.
 +
 +Lancez le programme d'installation de Gestan V15.
 +
 +{{:wiki:v15:installv15_1.jpg?nolink|}}
 +
 +Cliquez sur **"Installation Personnalisée"**, et assurez vous que Gestan soit installé dans C:\Program Files (x86)\GESTAN.
 +
 +Au premier lancement, l'assistant va se déclencher :
 +
 +{{:wiki:v15:gmigr12bis.png?nolink|}}
 +
 +Demandez la connexion sur une base déjà existante, indiquez les paramètres nécessaires, dont la localisation de la base que vous venez de traiter avec gMigr.
 +
 +Points à vérifier :
 +  * Vérifiez le paramétrage général (paramétrage SMTP notamment)
 +  * Délais de paiement : repasser ceux nécessaires en "délai net" (s'ils sont indûment en "délai net + quantième")
 +  * Si toast "btn non trouvé" à l'arrivée du menu principal, faites un reset des boutons de l'utilisateur.
 +  * Messages-type : supprimer tous les messages niveau utilisateur (sauf personnalisés), regénérez les messages-type "tous"
 +  * Appliquer le paramétrage comptable standard
 +  * Imprimer une pièce pour vérification
 +
 +Et c'est tout !
 +
 +
 +
 +===== Migration d'un base "client/serveur" =====
 +
 +
 +Tout d'abord, stoppez le serveur HFSQL, via le centre de contrôle HFSQL.
 +
 +Ensuite, ouvrez le répertoire dans lequel sont stockées les bases gérées par le serveur HFSQL. Vous devriez avoir quelque chose comme ci-dessous :
 +
 +{{:wiki:tech:gmigr5.jpg|}}
 +
 +Supposons que votre base s'appelle ICS.
 +
 +Copiez-coller le répertoire ICS dans un autre répertoire, mettons C:\TMP\ICS. Puis supprimez les deux répertoires système, %%__%%internal et %%__%%System, de ce répertoire C:\TMP\ICS.
 +
 +{{:wiki:tech:gmigr6.jpg|}}
 +
 +Effectuez ensuite la modification de format via gMigr comme expliqué ci-dessus à l'étape 3.
 +
 +Revenez enfin dans le gestionnaire HFSQL, et procédez à l'importation de la base C:\TMP\ICS comme vous l'avez fait pour l'importation des bases V13, mais en spécifiant l'analyse de Gestan 15, que vous trouverez dans le répertoire de programme Gestan 15.
 +
 +Et voilà ! 8-)
 +
 +
 +===== Installer Gestan 15 si vous n'utilisiez pas Gestan 13=====
 +
 +Téléchargez simplement le programme d'installation de Gestan V15 sur [[https://www.gestan.fr/scripts/website/compteur_download.php?ops=increase_15|ce lien]] et demandez son exécution.
 +
 +L'assistant d'installation va se déclencher.
 +
 +{{:wiki:tech:gmigr12.png|}}
 +
 +Choisissez l'option "Connexion à une nouvelle base", et c'est parti !
 +
 +===== Vérifications à effectuer après migration =====
 +  * Vérifier le paramétrage comptable : il est souvent incomplet
 +  * Vérifier les délais de paiement : les délais de type "délai net" sont classés à tort en "délai+quantième"
 +  * Vérifier les taux de TVA : vu sur une migration effectuée en 2021, un taux de TVA par défaut à 19.6
 +  * Vérifier le paramétrage général
 +  * Si présent, supprimer LKTMP_TCKMVT.*
 +  * Si présents, supprimer tous les fichiers SALLE*.*
 +  * Supprimer tous les messages-type, et les recréer pour l'utilisateur <tous>
 +
 +===== Point particulier : les acomptes =====
 +<WRAP center box >
 +
 +Dans Gestan V15, si un enregistrement facture porte un montant d'acompte, il est nécessaire qu'une écriture de type acompte soit enregistrée.
 +
 +Donc pendant la migration, Gestan va ajouter une écriture pour toutes les factures qui portent un montant d'acompte mais pour lesquelles il n'y a pas d'écriture de même montant. 
 +
 +Il vous faudra vérifier si ces écritures ne font pas doublon.
 +
 +Pour ce faire, éditez le fichier log de l'opération de création des écritures, que vous trouverez dans le répertoire Mes Documents\gestan_creation_écritures_acomptes_[heure].log.
 +
 +Voici quelques lignes d'exemple que vous trouverez dans ce fichier :
 +<code>
 +Ecriture 14 du 20160722 : Rglt acompte fact 979 (SYS)
 +Ecriture 15 du 20160802 : Rglt acompte fact 992 (SYS)
 +Ecriture 16 du 20160829 : Rglt acompte fact 1006 (SYS)
 +</code>
 +
 +Par la première ligne, Gestan vous signale qu'il a créé un acompte pour la facture 979. Allez sur la facture 979, faites Ctrl+M pour afficher les paiements, et vérifiez que la somme des paiements enregistrée est correcte, sinon modifiez les écritures.
 +
 +Vous pouvez aussi utiliser l'outil de [[http://wiki.gestan.fr/doku.php?id=wiki:v15:admin:auditdonnees|vérification des factures]] avec l'option "Règlement des pièces".
 +
 +
 +
 +
 +</WRAP>
 +
 +===== Point particulier : numérotation des factures =====
 +<WRAP center box >
 +
 +Il était possible dans Gestan V13 d'utiliser, bien que cela soit explicitement déconseillé, une numérotation intégrant le n° d'année. Le millésime de l'année était calculé suivant la date de facture : la numérotation changeait donc si la date de facture était modifiée.
 +
 +Pour pallier ce problème, en Gestan V15, le millésime de ces types de numérotations est basé sur la date de création de facture (et non plus sur la date de la facture).
 +
 +(pour rappel, l'identifiant de facture demeure l'[[wiki:v15:facturation:common:numpiece|ID interne]], affiché en bas de facture quand le n° imprimé ne le contient pas)
 +
 +</WRAP>
 +
 +===== Trucs et astuces =====
 +<WRAP center box >
 +
 +IDEA La licence de Gestan 13 est valable pour Gestan 15. La rentrer à nouveau si nécessaire. Elle était anciennement stockée dans C:\Users\[user]\AppData\Roaming\GESTAN, et maintenant elle est dans C:\ProgramData\GESTAN15, ce qui fait qu'elle reste valide même si un autre user se connecte à la même machine.
 +
 +IDEA Les fichiers de connexion CNX et WIDGET sont stockés dans C:\Users\[user]\AppData\Roaming\GESTAN_15. Le fichier CNX décrit les connexions aux bases, le fichier WIDGET ce sont les widgets affichés sur le tableau de bord. Ils peuvent être supprimés sans problème si nécessaire
 +
 +IDEA Il y a parfois un problème de droits sur les répertoires gérés par Gestan et cela peut impacter la prise en compte de la licence. 
 +Avant de lancer Gestan 15, veuillez vérifier vos droits d'écriture dans les dossiers correspondants en lisant les informations suivantes : http://wiki.gestan.fr/doku.php?id=wiki:v15:admin:licences#lors_de_l_enregistrement_de_la_licence
 +
 +IDEA Oui, on est passé de Gestan 13 à Gestan 15, nous n'avons pas fait d'erreur de calcul ! Voir [[https://www.gestan.fr/gestan-version-15/|cet article]].
 +</WRAP>
 +
 +===== Problèmes connus =====
 +
 +Il peut arriver que vous rencontriez, au cours du processus de migration, un message d'erreur du type :
 +<code>
 +Erreur à la ligne 111 du traitement Clic sur Migrer / Impossible de renommer le fichier <C:\Gestan\DATABASE\sauvegarde_gMigr\FACTURELIGNE.mmo> en <C:\Gestan\DATABASE\FACTURELIGNE.mmo>
 +</code>
 +
 +Il s'agit d'une incohérence dans les règles d'aliasage des fichiers, un problème que nous avons signalé à PCSoft depuis des années, sans réaction.
 +
 +La solution qui fonctionne est d'importer proprement la base dans un serveur HFSQL, selon la méthodologie expliquée [[wiki:v15:tech:mode_cs#resynchronisation_de_la_base|ici]], et de recommencer la migration.