BEL, 15/11/2024 : ceci est un extrait de la page au-dessus pour permettre son actualisation, demandée ce jour
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 :
Nom de la balise ‘ping’ | Description de la balise, et valeurs possibles |
---|---|
TypeAction | Indique le type d'action à effectuer. Les autres balises à renseigner dépendent du type d’action (voir plus bas) Les valeurs sont possibles :
|
CheminDico | Chemin où se trouvent les dictionnaires actuels, typiquement /divalto/« nom de base sql »/ |
CheminNouveauDico | Chemin où se trouvent les nouveaux dictionnaires. Exemple : /divalto/tmp/erpdivalto/versionx12/ |
RequiertValidation | Permet de visualiser ou non la liste des différences repérées entre les deux versions des dictionnaires. Les valeurs possibles :
|
ModeAudit | Permet de faire un audit des requêtes SQL. 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. Les valeurs possibles :
|
ActualiserFHSQL | Permet de mettre à jour le fichier FHSQL.dhfi de la base Valeurs possibles : 0=non ou 1=oui (valeur par défaut 0) |
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 le sqlversion.txt fourni pour les valeurs possibles |
SupprimerTableSauvegarde | Option pour supprimer les tables OldColumn post synchronisation Valeurs possibles : 0=non ou 1=oui (valeur par défaut 0) |
GenererRegleMigration | Permet de générer un fichier avec des règles de migration. A utiliser avec la balise suivante de chemin CheminReglesMigration Va fabrique un fichier dont le nom est Update_ddd.txt ou ddd est le nom du dictionnaire. Exemple d’un fichier règles de migration : Valeurs possibles : 0=non ou 1=oui (valeur par défaut 0) |
CheminReglesMigration | Chemin Harmony du fichier des règles de migration sans le nom du fichier (ne sert que si GenererRegleMigration=1) ( Exemple : /Specifs/fichiers ) |
VersionERPDepart | Version de départ pour remplir la balise <from> du fichier des règles de migration. A utiliser avec la balise suivante de chemin CheminReglesMigration |
VersionERPArrive | Version d’arrivée pour remplir la balise <to> du fichier des règles de migration. A utiliser avec la balise suivante de chemin CheminReglesMigration |
CheminFichierScript | Nom complet du fichier au format Harmony du fichier de script avec le nom du fichier (présent sur le serveur Exemple : /Specifs/fichiers/script.txt ) |
DecVarCourant | Champ de 10 octets contenant les 10 valeurs des décimales variables courantes ( Exemple : “2232252222” ) |
DecVarNouveau | Champ de 10 octets contenant les 10 valeurs des décimales variables Nouvelles ( Exemple : “0342242222” ) |
Selon le type d’action, les autres paramètres deviennent obligatoire. Voici la liste des paramètres selon le type d’action
Nom de la balise et sa valeur | SYNCHRO | SCRIPT | MAJDECVAR | MAJTRIGGER | MAJTRIGGERDATEETDH | MAJINDEXCONDITIONNEL | MAJCOMPATIBILITESQL |
---|---|---|---|---|---|---|---|
CheminDico | X | X | X | X | X | X | X |
CheminNouveauDico | X | ||||||
RequiertValidation | X | X | X | X | X | X | |
ModeAudit | X | X | X | X | X | ||
ActualiserFHSQL | X | X | X | ||||
CheminNouveauFHSQL | X | ||||||
NomServeur | X | X | X | X | X | X | X |
NomBase | X | X | X | X | X | X | X |
VersionCompatibiliteCibleERP | X | ||||||
SupprimerTableSauvegarde | X | ||||||
GenererRegleMigration | X | X | |||||
CheminReglesMigration | X | ||||||
VersionERPDepart | X | ||||||
VersionERPArrive | X | ||||||
CheminFichierScript | X | ||||||
DecVarCourant | |||||||
DecVarNouveau |
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.