Import-export de données techniques
Principe de fonctionnement
L’export et l’import de données techniques se fait en deux temps :
Dans un premier temps, l’utilisateur devra exporter manuellement les entités Diapason qui comprennent :
La nomenclature générique,
Les vari-articles,
Toutes les VBA et VBP utilisées dans le paramétrage,
Les articles standard si besoin,
Les requêtes spécifiques utilisées lors de la génération de la nomenclature (recherche dynamique de profilés par exemple).
Dans un second temps, il devra exporter les règles de configuration :
Correspondance lien de nomenclature / Contexte scénario commercial,
Correspondance VBA données techniques / VBA scénario commercial,
Existence des liens de nomenclature,
Initialisation des VBA d’un lien de nomenclature,
Informations techniques d’un lien de nomenclature,
Formules, matrices, arbres utilisés dans les différentes TV exportées.
Procédure d’export des données techniques
Export des Entités DIAPASON
Les entités diapason représentent la structure de la nomenclature.
Ils s’exportent à l’aide d’une session d’export, qui permet de lister les objets à exporter. Les objets seront mis dans une session d’export quand le traitement d’export sera lancé. Il est possible d’alimenter la session en avance, même si on modifie un des objets après l’avoir mis dans la session, Diapason prendra l’objet au moment de la création de l’export.
On peut créer une session d’export dédiée à chaque nomenclature, qui ne sera pas purgée entre deux exports et qui sera complétée avec les ajouts effectués entre deux exports.
On peut aussi prendre une session existante, qui sera purgée et alimentée à nouveau à chaque export.
Les éléments à exporter figurent dans le menu Import-Export du navigateur (sous-menu Entités Diapason Cfg Technique).
 | Accès : Navigateur DIAPASON ➡️ Configuration ➡️ Import-Export ➡️ Entités Diapason Cfg Technique |
Dans un premier temps, il faut choisir :
Soit la session dédiée à la nomenclature, dans ce cas, la session sera alimentée au fur et à mesure sans purge entre deux exports,
Soit une session d’exportation autre et la purger.
Pour purger une session, aller sur une des entités Diapason et faire clic-droit ➡️ Exportation ➡️ Session courante :
Puis se positionner sur la session à purger et faire clic-droit > Purge session
Pour vérifier qu’on est positionné sur la bonne session, aller dans les sessions courantes. La ligne en surbrillance indique la session sélectionnée. Si on veut utiliser une autre session, cliquer dessus pour la mettre en surbrillance, puis faire clic-droit > Sélection session, ou F1, ou validation.
À l’intérieur de la session, l’utilisateur mettra :
Les vari-articles,
La nomenclature générique,
Les VBA,
Les VBP,
Les articles standard si besoin,
Les requêtes et paramétrages spécifiques (recherche dynamique de profilés, REB utilisées dans les formules sur REB par exemple).
Il est possible d’exporter vari-articles et nomenclature générique en même temps si on utilise l’action exportation avec liens depuis les vari-articles, et qu’on sélectionne uniquement les objets VAD et NOG.
Pour cela, aller dans le menu « Nomenclatures génériques » sous « Entités Diapason Cfg Technique », et se positionner sur le lien de plus haut niveau de la nomenclature dans la liste des liens de nomenclature générique. Si besoin, il est possible de retrouver la référence de ce lien depuis l’article standard utilisé pour lancer la nomenclature depuis les lignes de commande, dans le champ Nomenclature de l’onglet Destination de la fiche article .
Depuis ce lien, faire clic-droit ➡️ Exportation ➡️ Exportation avec liens :
Sur l’écran de sélection des objets liés à exporter, se positionner à la jonction entre entêtes de lignes et entête de colonnes, et faire clic-droit > Annuler les sélections.
Autre méthode, une fois arrivé sur l’écran de sélection des objets liés à exporter, faire Ctrl+Z pour annuler les sélections, puis passer à l’étape suivante.
Enfin, sélectionner les objets de Type NOG et VAD, et uniquement ceux-ci, en les mettant en surbrillance, puis valider.
Diapason alimentera la session d’export avec les liens de nomenclature générique et les vari-articles de la totalité de l’arborescence nomenclature.
Tous les éléments à exporter sont accessibles depuis le menu Import-Export du navigateur.
ATTENTION : Pour que le fichier d’export soit créé sans données superflues, les éléments doivent être exportés avec l'action "exportation directe", et non avec l’action "exportation avec liens, à l’exception de la nomenclature générique.
Une fois la session d’exportation complète, le fichier d’export doit être généré. Pour cela, il faut revenir sur la session courante, et aller sur le contenu de la session contenant les données à exporter.
Dans un premier temps, il faut impérativement vérifier si la session d’export ne contient pas de données superflues. Certains éléments de la session d’export doivent être enlevés de la session. Ceux ayant pour type d’objet :
TVA,
DI_ST,
DI_CO,
REQ (à part les requêtes RCT de liste d’aide et les requêtes spécifiques utilisées par la nomenclature),
Ces éléments peuvent provenir d’un export avec lien non maîtrisé. L’export d’éléments de ce type aura des conséquences fâcheuses sur l’environnement de destination.
Ensuite, faire clic-droit "exportation totale" pour créer la session.
On accèdera successivement à deux formulaires qui devront être saisis en suivant les modèles ci-dessous (le nom de fichier est libre) :
Export des règles de configuration
Les fichiers d’export des entités Diapason étant générés, il faut maintenant créer les fichiers d’export des règles de configuration des données techniques :
 | Accès Navigateur DIAPASON ➡️ Configuration ➡️ Import-Export ➡️ Règles de configuration ➡️ Import-Export règles de configuration |
Dans un premier temps, il faut générer les sessions d’export (clic droit ➡️ génération ➡️ toutes les sessions ; puis choisir « GEN-REQ : (B) »).
Il existe plusieurs sessions d’export de paramétrage. Elles sont détaillées dans le chapitre « Sessions d’export-import du paramétrage» de ce document. Selon le besoin on utilisera une ou plusieurs sessions.
Pour un export total du paramétrage nomenclature, choisir la session "IMoteurDT".
Le nom des fichiers d’export à générer (.act et .dat) peut être piloté en modifiant directement la session d’export (voir encadré rouge).
Pour déterminer quelle sera la nomenclature à exporter, faire clic-droit puis choisir « Exportation tables locales ».
On accèdera à une nouvelle fenêtre qui mentionnera le nom de la session d’export choisie (modifiable directement via l’aide).
En cliquant sur le bouton « critères », on accèdera à une nouvelle fenêtre qui permet de déterminer quelle nomenclature sera exportée ainsi que les différents éléments de paramétrage qu’on exportera. Cette étape est à répéter autant de fois qu’il y a de nomenclatures à exporter, en changeant à chaque fois le nom du fichier d’export.
Une fois les critères renseignés, valider l’écran de saisie des critères, puis l’écran de sélection de la session d’exportation.
Il restera à valider le mode de génération de la session ainsi que la date et l’heure de lancement du traitement de génération de l’export, appelé EXP-LOC.
Le mode (B) permet de lancer la génération en arrière-plan. Ce mode est vivement recommandé pour la génération des sessions, car la session utilisateur ne sera pas bloquée le temps du traitement.
Le mode (I) permet de lancer la génération en interactif. Ce mode bloquera la session utilisateur le temps du traitement. Il sera obligé d’attendre que le traitement soit terminé pour pouvoir travailler à nouveau sur Diapason. Le temps de traitement sera plus ou moins important selon le volume de données à exporter.
Procédure d’import de la nomenclature
Après avoir transféré tous les fichiers .act et .dat générés dans le fichier /tmp du serveur concerné, on peut lancer l’import.
On importera dans un premier temps les entités Diapason, via l’action « Importation de données » disponible depuis la liste des scénarios de configuration par exemple.
Penser lors de l’import entité :
A renseigner dans « Fichier » le nom du fichier généré, en respectant la casse (s’il y a des majuscules et des minuscules dans le nom, il faudra l’écrire ici strictement à l’identique). Une liste d’aide est disponible pour la saisie de ce champ.
A vider le champ « Cde Système » si non vide
À consulter le bouton « Contrôle » afin de vérifier si vous n’avez pas de requêtes ou de tables (TV, DI_ST, DI_CO) malencontreusement ajoutées dans le paquet d’import. Les tables éventuellement présentes dans le paquet sont consultables dans « Structures sur bases ».
Ensuite, on importera les règles de configuration, depuis le menu « Sessions import-export tables locales », (choisir « importation tables locales »).
La procédure d’import est la même pour les deux sessions : Il suffit de saisir le nom donné au fichier d’export dans la zone prévue à cet effet, en respectant la casse (s’il y a des majuscules et des minuscules dans le nom, il faudra l’écrire ici strictement à l’identique). Attention, il n’y a pas de liste d’aide pour ce champ.
Il faudra ensuite supprimer les instructions figurant dans la zone « commande système » (zone en bleu sur la copie d’écran ci-dessous).
Après validation, il vous faudra choisir si l’import doit être fait en Batch ou en interactif (Il est conseillé de lancer les imports en Batch).
Fiche récapitulative de la procédure d’export de données techniques
Exportation des entités Diapason
Sélectionner une session et la purger
Mettre dans la session (1-2) :
La nomenclature générique
Les Vari-Articles
Les VBA et VBP
Les articles standard si besoin
Les requêtes spécifiques.
Vérifier le contenu de la session : Elle ne doit pas contenir d’éléments de type TVA, DI_ST, DI_CO ou REQ.
Générer les fichiers d’export.
Exportation des règles de configuration
Depuis le menu « Import-Export du navigateur > session IMoteurDT > Exportation table locale » saisir la référence de la nomenclature à exporter et choisir les éléments à exporter parmi les différents critères proposés.
Générer les fichiers d’export. Répéter les étapes précédentes autant de fois qu’il y a de nomenclatures à exporter.
Transfert des .act et .dat générés dans le dossier /tmp correspondant à l’environnement Diapason de destination si nécessaire.
Importation des entités Diapason.
Importation des règles de configuration (3).
(1) : Sélectionner uniquement les éléments modifiés depuis le dernier export
(2) : Utiliser l’action exportation directe (et non pas l’action exportation avec liens), sauf pour les vari-articles
(3) : L’importation des règles de configuration doit IMPERATIVEMENT être réalisé avant l’importation des entités Diapason.