Introduction

L'outil d'import/export de sources permet d'exporter les sources d'un objet Adélia sous la forme d'une arborescence de fichiers texte.

Le but principal de l'outil est de créer une arborescence de fichiers susceptibles d'être intégrés dans un logiciel de gestion de version de type Git, Subversion ou équivalent.

L'outil gère les types d'objet suivant :

• Etat (Adélia ou Crystal reports).
• Modèle RAD.
• Type de dialogue Adélia.
• Objet graphique personnalisé.
• Règle de gestion.
• Programme (tous types).
• Classe.

L'arborescence de sources générée respecte la structure du référentiel Adélia. Le sous-répertoire "src" contient un sous-répertoire par domaine Adélia, contenant les sources des objets privés du domaine, le répertoire _Commons représentant le référentiel (sources des objets publics).

L'arborescence contient un sous-répertoire "src" contenant un répertoire pour chaque domaine Adélia (le répertoire _Commons contenant les sources des objets publics du référentiel Adélia).

Chaque répertoire d'un domaine contient un sous-répertoire correspondant au type de l'objet (tel qu'il est référencé dans le référentiel Adélia ; les abréviations sont donc en français), contenant lui-même un sous-répertoire correspondant au nom de l'objet.

BDCADEL

src

_Commons

ETA

GRA

MRA

PGM

AAID_DSPF

AFF_CLI_SQL_01

environment.json

genoptions.json

layout.json

object.json

object.src

resources.json

sync.tag

tech_doc_1.txt

transaction_1.xml

transaction_2.xml

AFF_CLI_SQL_02

RGG

TDI

EXEMPLE_ADELIA

EXEMPLE_MOBILE

...

Les fichiers générés sont  les suivants :

Distribution

Les outils en ligne de commande sont fournis sous la forme d'une archive dans le sous-répertoire "Distrib" de l'installation d'Adélia Studio.

Pour installer l'outil, décompressez le fichier zip présent dans le sous-répertoire "Distrib\AdeliaCommandLineInterface" dans un répertoire dédié.

Le zip contient les répertoires suivants :

Fichiers de commande

Les fichiers de commande suivants sont fournis :

configure.bat

Le fichier de commandes configure.bat est un script de questions/réponses utilisé pour créer les fichiers de configuration pour un environnement Adélia spécifique (URL de connexion JDBC et profil/mot de passe, répertoire de sortie, configuration des pilotes JDBC). Si vous choisissez de stocker le mot de passe de la connexion, celui-ci sera chiffré automatiquement. 

Usage : configure ALIAS_ENVIRONNEMENT

Le fichier de commandes créera un répertoire correspondant à l'alias choisi dans le sous-répertoire /conf de la distribution et y stockera les fichiers de configuration contenant les paramètres de connexion à l'environnement.

Attention : la configuration du schéma (SYSADEL par défaut) ne concerne que les bases de données supportant la notion de schéma. Avec MySQL, le schéma doit être laissé vide et la base de données indiquée dans l'URL de connexion. 

Par exemple, la configuration automatique pour une base de données BDCADEL installée sur DB2 génèrera les fichiers suivants :

• loader.properties (référence des jar additionnels ajoutés au CLASSPATH, ici les pilotes JDBC)

  loader.path=C:/Program Files/IBM/SQLLIB/java/db2jcc_license_cu.jar,C:/Program Files/IBM/SQLLIB/java/db2jcc4.jar,C:/Program Files/IBM/SQLLIB/java/pdq.jar

  
  

  
  

• application.properties (paramètres de l'application Spring Boot).

  #Tue Oct 02 14:01:39 CEST 2018 
  adelia.language=fr 
  adelia.sync_folder=D\:/IDE/TESTIDE 
  spring.datasource.password=ENC(FV2BiEKzy/mh3xbawBbpNZIMxIVgzyCu) 
  spring.datasource.url=jdbc\:db2\://hostname\:50000/TESTIDE\:useRowsetCursor\=true; 
  spring.datasource.username=test 
  spring.jpa.properties.hibernate.default_schema=SYSADEL

↑ Haut de page

check.bat

Le fichier de commandes check.bat permet de vérifier la validité des fichiers de configuration et, de manière optionnelle, de modifier le profil et le mot de passe de connexion.

Usage :  check ALIAS [-u profil] [-p mot_de_passe] [-storepassword]
 
	-u profil	 	profil de connexion. le profil doit correspondre à un concepteur enregistré dans l'environnement.
	-p password  	mot de passe.
	-storepassword	mise à jour du profil et du mot de passe stockés dans les fichiers de configuration (depuis les paramètres -u et -p). 

↑ Haut de page

export.bat

Le fichier de commandes export.bat permet d'exporter sur le disque tout ou partie des objets du référentiel Adélia (programmes, règles de gestion...).

 Usage : export ALIAS [-u profil] [-p mot_de_passe] ([-type:[REP|ETA,RAD|MRA,PT|TDI,GRA,MR|RGG,PGM,CLA]] [-force] [-app_area:DOMAINE] [-resolve:[AUTO|REPOSITORY|FILESYSTEM]]
 [-component:COMPONENT]
  [noms])*

• Le paramètre ALIAS se réfère à un sous-répertoire du répertoire /conf contenant les fichiers de configuration pour la connexion à l'environnement (créés par la commande configure).
• Le paramètre type permet de filtrer par type d'objet. Par défaut tous les objets d'un type supporté seront exportés. Si vous spécifiez "-type:PGM,RGG", seuls les programmes et les règles de gestion seront traités.
• Spécifier l'option -app_area permet de n'exporter que les objets privés au domaine indiqué.
• L'option -force permet de contourner la vérification de l'état de synchronisation et d'exporter un objet même si la version disque est plus récente que la version de l'environnement.
• L'option -resolve permet d'indiquer explicitement comment résoudre les conflits de synchronisation. Si un objet a été modifié aussi bien dans l'environnement que sur le disque, l'option -resolve:REPOSITORY va autoriser l'export, alors que -resolve:AUTO ou -resolve:FILESYSTEM va ignorer l'objet.
• Vous pouvez spécifier une liste de noms ou de masques de noms d'objet à exporter. Par défaut, tous les objets seront traités (masque). Les masques sont au format DOS (correspond à une séquence de caractères, ? à un caractère simple).
• L'option "-component" se comporte comme un filtre permettant de sélectionner les programmes et les classes associés à un composant. Par exemple, s'il existe dans l'environnement un composant de build TEST comportant les programmes TEST1 et TEST2, l'option "-component;TEST" est équivalente à "-type:PGM,CLA TEST1 TEST2".

Veuillez noter que le concepteur Adélia doit avoir accès en lecture aux objets et au gestionnaire d'objet pour les domaines traités ("Gestionnaire d'objet et éditeur L4G (*MOPT)").

↑ Haut de page

import.bat

Le fichier de commandes import.bat permet d'importer depuis le disque tout ou partie des objets du référentiel Adélia (programmes, règles de gestion...).

 Usage : import ALIAS [-u profil] [-p mot_de_passe] ([-type:[REP|ETA,RAD|MRA,PT|TDI,GRA,MR|RGG,PGM,CLA]] [-force] [-app_area:DOMAINE] [-resolve:[AUTO|REPOSITORY|FILESYSTEM]] [-recreate] [-autocorrect] [-no_check]
 [-component:COMPONENT]
  [noms])*

• Le paramètre ALIAS se réfère à un sous-répertoire du répertoire /conf contenant les fichiers de configuration pour la connexion à l'environnement (créés par la commande configure).
• Le paramètre type permet de filtrer par type d'objet. Par défaut, tous les objets d'un type supporté seront exportés. Si vous spécifiez "-type:PGM,RGG", seuls les programmes et les règles de gestion seront traités.
• Spécifier l'option -app_area permet de n'exporter que les objets privés au domaine indiqué.
• L'option -force permet de contourner la vérification de l'état de synchronisation et d'importer un objet même si la version de l'environnement est plus récente que la version disque.
• L'option -recreate va essayer de créer l'objet s'il n'existe pas dans l'environnement cible.
• L'option -autocorrect va automatiquement ajouter l'objet à la correction par défaut si nécessaire (et possible) dans un environnement de correction.
• L'option -resolve permet d'indiquer explicitement comment résoudre les conflits de synchronisation. Si un objet a été modifié aussi bien dans l'environnement que sur le disque, l'option -resolve:FILESYSTEM autorise l'import, alors que -resolve:AUTO ou -resolve:REPOSITORY ignore l'objet.
• Vous pouvez spécifier une liste de noms ou de masques de noms d'objet à exporter. Par défaut tous les objets seront traités (masque). Les masques sont au format DOS (correspond à une séquence de caractères, ? à un caractère simple).
• L'option "-component" se comporte comme un filtre permettant de sélectionner les programmes et les classes associés à un composant. Par exemple, s'il existe dans l'environnement un composant de build TEST comportant les programmes TEST1 et TEST2, l'option "-component;TEST" est équivalente à "-type:PGM,CLA TEST1 TEST2".

Veuillez noter que le concepteur Adélia doit être propriétaire des objets traités ou disposer du droit "Modification de tous les objets (*REM)" sur les domaines traités, et avoir accès en écriture à "Gestionnaire d'objet et éditeur L4G (*MOPT)" sur les domaines traités.

↑ Haut de page