Exécution de la synchronisation par programme

Pour exécuter une synchronisation, le programme xpsqlsynchro.dhop peut être appelé en-dehors de l'utilitaire xpsql.dhop. Il faut simplement lui envoyer par "ping" les paramètres suivants :

• « TypeAction » : indique le type d'action à effectuer. Trois valeurs sont possibles :

• • « SYNCHRO » : Pour une synchronisation du Schéma SQL.

  • « SCRIPT » : Pour l'exécution d'un script SQL

  • <MAJDECVAR> Pour prendre en compte le paramètres des décimales variables.

  • <MAJTRIGGER> Pour Mettre a a jour les TRIGGER ( Indexes Multi-tables )

  • <MAJTRIGGERDATEETDH> Pour mettre a jour les colonnes date et dateDh en nullable

  • « MAJINDEXCONDITIONNEL» : Pour lancer la migration des index conditionnels au nouveau format. Pour une exécution de script : Cf. livre Exécution de scripts.

  • <MAJCOMPATIBILITESQL> : Pour changer le niveau de comparabilité

• « CheminDico » : chemin où se trouvent les dictionnaires actuels, typiquement /divalto/« nom de base sql »/.

• « CheminNouveauDico » : chemin où se trouvent les nouveaux dictionnaires. Exemple : /divalto/erp63/.

• « RequiertValidation » : permet de visualiser ou non la liste des différences repérées entre les deux versions des dictionnaires : 1 pour les visualiser, 0 pour une exécution directe. Il est conseillé de mettre cette valeur à 1.

• « ModeAudit » : permet de faire un audit des requêtes SQL (0 ou 1). 1 demande de générer toutes les requêtes SQL mais sans les exécuter. Elles sont journalisées dans le fichier DhOdbcConfigSql.log, qui se trouve dans /divalto/DivaltoLog/. Sinon, les requêtes ne sont pas journalisées mais sont exécutées.

• « ActualiserFHSQL » : permet de mettre à jour le fichier FHSQL.dhfi de la base (0 ou 1).

• « CheminNouveauFHSQL » : permet de définir quel sera le fichier FHSQL qui servira de modèle pour la mise à jour de celui de la base. Par défaut, c'est le fichier fhsqldivalto.dhfi du répertoire divalto/sys qui est utilisé.

• « NomServeur » : Nom du serveur où se situe la base de données.

• « NomBase » : Nom de la base de données à synchroniser.

• <VersionCompatibiliteCibleERP> : Version cible de la compatibilité SQL, si le serveur SQL le permet. sous la forme d’un numérique ( exemple 130 pour SQL Server 2016), voir fichier sqlversion.txt

• <GenererRegleMigration> : Permet de générer un fichier avec des règles de migration

• <CheminReglesMigration> : chemin Harmony du fichier des règles de migration si GenererRegleMigration=1.

  • Fabrique un fichier dont le nom est Update_ddd.txt ou ddd est le nom du dicotionnaire

  • Exemple d’un fichier règles de migration :

• <VersionERPDepart> : Version de départ pour remplir balise <from> du fichier des règles de migration

• <VersionERPArrive> Version d’arrivée pour remplir la balise <to> du fichier des règles de migration

• <SupprimerTableSauvegarde> option pour supprimer les Tables OldColumn post synchronisation

Les paramètres a renseigné sont

• « SYNCHRO »

  • NomServeur

    NomBase

    ModeAudit

    CheminDico

    CheminNouveauDico

    RequiertValidation

    GenererRegleMigration

    ActualiserFHSQL

    CheminNouveauFHSQL

    CheminReglesMigration

    VersionERPDepart

    VersionERPArrive

• « SCRIPT »

  • RequiertValidation

    NomServeur

    NomBase

    CheminDico

    CheminFichierScript

    SupprimerTableSauvegarde

    ActualiserFHSQL

• <MAJDECVAR>

  • NomServeur

    NomBase

    DecVarCourant

    DecVarNouveau

    CheminDico

    ModeAudit

    RequiertValidation

    GenererRegleMigration

    ActualiserFHSQL

• <MAJTRIGGER>

  • NomServeur

    NomBase

    CheminDico

    ModeAudit

    RequiertValidation

• <MAJTRIGGERDATEETDH>

  • NomServeur

    NomBase

    CheminDico

    ModeAudit

    RequiertValidation

• « MAJINDEXCONDITIONNEL»

  • NomServeur

    NomBase

    CheminDico

    ModeAudit

    RequiertValidation

• <MAJCOMPATIBILITESQL>

  • CheminDico

    NomBase

    VersionCompatibiliteCibleERP

A la fin de l'exécution de l'utilitaire xpsqlsynchro.dhop, deux variables sont renvoyées par "pong" :

• « CodeRetour » : compte-rendu. Les valeurs rendues sont :

  • 0 : pas d'erreur ;

  • 1 : erreur quelconque. Voir le fichier ferror.log pour les détails ;

  • 2 : l'utilisateur a quitté, via F9 ou via le bouton « Abandonner » ;

  • 3 : erreur SQL ;

  • 4 : erreur déjà signalée par MessageBox.

• « FichiersSupprimes » : chaîne au format hmp regroupant les fichiers supprimés.

• Utilisée pour la mise à jour du fichier FHSQL.dhfi. Chaîne de la forme : <fichier>nom<fichier>nom.