Téléchargement des produits


Version anglaise


 


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).

Attention :

Dans le cadre de l'intégration à un gestionnaire de source, veuillez noter que tous les fichiers du répertoire d'un objet sont potentiellement liés entre eux, et donc qu'une version de l'objet se réfère à une version de l'ensemble des fichiers de l'objet.

Restaurer, par exemple, le source d'un programme Visual Adélia sans tenir compte des maquettes de fenêtre peut être dangereux et doit être fait avec précaution.


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 :

Tous les objets

sync.tag

Données de synchronisation.

object.json

Description de l'objet.

comment.txt

Commentaire sur l'objet (optionnel).

user_doc.txt

Documentation utilisateur (optionnel pour les types d'objet gérant la documentation).

tech_doc.txt

Documentation technique (optionnel pour les types d'objet gérant la documentation).



Etat Adélia (ETA)

layout.xml

Fichier de description de l'état.

layout.json

Caractéristiques maquette.

simformats.json

Formats de simulation (optionnel).



Etat Crystal Report (ETA)

report.rpt

Fichier de description de l'état.



Type de dialogue (TDI)

object.src

Source L4G.

transaction_*.xml

Fichiers de description des transactions Adélia.

user_doc_*.txt

Documentation utilisateur des transactions (optionnel).

tech_doc_*.txt

Documentation technique des transactions (optionnel).



Objet graphique personnalisé (GRA)

object.src

Source L4G (optionnel pour les OGP avec source).

bitmap_up.png

Resource image de la palette.

bitmap_dw.png

Resource image de la palette.

properties.json

Liste des propriétés modifiées de l'objet.

property_<id>.<ext>

Valeurs des propriétés binaires.



Modèle RAD (MRA)

object.src

Source L4G.

properties.json

Liste des propriétés du modèle.

property_<id>.<ext>

Valeurs des propriétés binaires.

window_*.xml

Fichiers de description des fenêtres du modèle.



Programme ADELIA (PGM)

object.src

Source L4G.

metadata.json

Métadonnées du programme.

genoptions.json

Options de génération.

environment.json

Description de l'environnement de données.

layout.json

Caractéristiques de la maquette (programme interactif).

transaction_*.xml

Fichiers de description des transactions Adélia (programme interactif).

user_doc_*.txt

Documentation utilisateur des transactions (optionnel).

tech_doc_*.txt

Documentation technique des transactions (optionnel).

reports.json

Rapports affectés au programme (programme batch).



Programme VISUAL(PGM)

object.src

Source L4G.

metadata.json

Métadonnées du programme.

genoptions.json

Options de génération.

window_*.xml

Fichiers de description des fenêtres (programme interactif).

reports.json

Rapports affectés au programme (programme batch).

resources.json

Ressources affectées au programme (optionnel).



Programme WADELIA(PGM)

object.src

Source L4G.

metadata.json

Métadonnées du programme.

genoptions.json

Options de génération.

page_*.xml

Fichiers de description des pages (programme interactif).

resources.json

Ressources affectées au programme (optionnel).

↑ Haut de page


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 :

CmdLineInterface

Contient les fichiers de documentation (README*.txt, INSTALL*.txt, NOTICE.txt).

bin

Contient les fichiers de commande (interface simplifiée en ligne de commandes).

conf

Contient les fichiers de configuration.

lib

Contient les librairies d'exécution.

↑ Haut de page

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])*

-u profil

Profil de connexion. le profil doit correspondre à un concepteur enregistré dans l'environnement.

-p password

Mot de passe.

-type:TYPES

Liste de types d'objet séparés par des virgules. Les valeurs acceptées sont :

  • REP|ETA - rapport.
  • RAD|MRA - modèle RAD.
  • PT|TDI - type de dialogue.
  • GRA - objet graphique personnalisé.
  • MR|RGG - règle de gestion.
  • PGM - programme.
  • CLA - classe.

-app_area:DOMAINE

Domaine (tous les domaines seront traités si le paramètre n'est pas spécifié). Utilisez la valeur "_Commons" pour les objets publics.

-force

Force l'exportation quel que soit l'état de la synchronisation.

-resolve:AUTO

Ignore les objets avec conflits de synchronisation.

-resolve:REPOSITORY

Résout les conflits en utilisant la version de l'environnement.

-resolve:FILESYSTEM

Résout les conflits en utilisant la version du disque.

-component:COMPONENT Exporte les programmes et les classes associés au composant de build spécifié.

noms

Liste de masques de nom d'objets (* par défaut).


  • 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])*

-u profil

Profil de connexion. le profil doit correspondre à un concepteur enregistré dans l'environnement.

-p password

Mot de passe.

-type:TYPES

Liste de types d'objet séparés par des virgules.

Les valeurs acceptées sont :

    • REP|ETA - rapport.
    • RAD|MRA - modèle RAD.
    • PT|TDI  - type de dialogue.
    • GRA     - objet graphique personnalisé.
    • MR|RGG  - règle de gestion.
    • PGM     - programme.
    • CLA     - classe.

-app_area:DOMAINE

Domaine (tous les domaines seront traités si le paramètre n'est pas spécifié).

Utilisez la valeur "_Commons" pour les objets publics.

-force

Force l'importation quel que soit l'état de la synchronisation.

-resolve:AUTO

Ignore les objets avec conflits de synchronisation.

-resolve:REPOSITORY

Résout les conflits en utilisant la version de l'environnement.

-resolve:FILESYSTEM

Résout les conflits en utilisant la version du disque.

-recreate

Crée à nouveau l'objet s'il n'existe pas dans le référentiel Adélia.

-autocorrect

Ajoute automatiquement l'objet à la correction en cours si nécessaire (environnements de correction).

-no_check

Désactive partiellement la vérification de la structure du source (ordre des blocs, source mal placé).

-component:COMPONENT Exporte les programmes et les classes associés au composant de build spécifié.

noms

Liste de masques de nom d'objets (* par défaut).


  • 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

  • Aucune étiquette