Académique Documents
Professionnel Documents
Culture Documents
Guide utilisateur
DELTA-BANK
Version 10.1
SOMMAIRE
1. PRINCIPE ACTUEL .................................................................................. 3
1.1 CONSULTATION INSTANTANÉE ................................................................... 3
1.2 CONSULTATION A POSTERIORI DE L'ESPACE DE RÉTENTION ....................... 3
2. INCONVENIENTS .................................................................................... 4
9. ANNEXES .............................................................................................. 14
9.1 CRÉATION DES TABLES "EVPRINTDOC" ET "EVPRINTTOKEN" ......................14
9.2 CRÉATION DE LA SÉQUENCE "SEQ_DOCUMENT" .........................................14
9.3 SCRIPT : LPRINT2.SH (CAS DELTA-BANK) ...................................................15
9.4 INSTALLATION DE LA PARTIE APACHE / PHP ..............................................16
9.4.1 SUPPORT FOURNI ...............................................................................16
9.4.2 UTILISATEUR DÉDIÉ ET DROITS .........................................................16
9.4.3 RÉPERTOIRE CONTENANT LES FICHIERS TEMPORAIRES ......................16
9.4.4 RÉPERTOIRE DE RÉTENTION...............................................................16
9.4.5 ASPECT MULTI APPLICATION SOURCE .................................................17
9.4.6 FICHIERS DE CONFIGURATION............................................................18
9.4.7 CRÉATION DU SERVICE.......................................................................19
9.4.8 DÉMARRAGE DU SERVICE ...................................................................19
9.4.9 TESTER LE SERVEUR APACHE..............................................................19
9.5 ASPECT MULTI APPLICATIONS ...................................................................20
9.5.1 EXEMPLE ............................................................................................20
10. SYNTHÈSE SUR LES BINAIRES À INSTALLER ....................................... 21
10.1 ENVIRONNEMENT DELTA-BANK ..............................................................21
10.2 ENVIRONNEMENT DELTA PAIE / DELTA IMMO .........................................21
Version 10.1 CONSULTATION SECURISEE DES EDITIONS AU SEIN D'UN NAVIGATEUR Delta-Bank
Guide utilisateur
1. PRINCIPE ACTUEL
1.1 C ON S U L T A T ION IN S T A N T A N É E
Un utilisateur connecté à l'application Delta–Bank et désireux d'imprimer un report va
choisir une imprimante logique DELTA-BANK. Cette imprimante est en fait un script
(exemple : lprint.sh) qui réalise actuellement les actions suivantes :
Remarque : l’envoi ainsi que la suppression du fichier sur le serveur d’application AIX ne
concerne que les cas où le serveur Apache n’est pas installé sur le serveur AIX.
Remarque : ce script PHP va lister sous forme de liens, les fichiers de l'espace de
rétention et permet de visualiser leur contenu par simple clic sur le lien.
2. INCONVENIENTS
L'URL doit être à usage unique et le document consulté doit être une copie du document
d'origine.
Faiblesse de la sécurité car un user A peut consulter trop aisément les documents d'un
user B.
3. SOLUTION PROPOSEE
3. 1 C ON S U L T A T ION IN S T A N T A N É E
Un utilisateur connecté à l'application Delta-Bank et désireux d'imprimer un report va
choisir une imprimante logique DELTA-BANK. Cette imprimante est en fait un script
(exemple : lprint.sh) qui réalise actuellement les actions suivantes :
Génération d'un fichier sur le serveur d'applications AIX (convention de nommage à
déterminer).
Envoi de ce fichier vers un espace de rétention de l'infrastructure Windows
hébergeant le serveur Apache (solution de transport à valider).
Après envoi, insertion en base d'un record référençant le document concerné et
insertion d'un jeton à usage unique. Cette tâche sera réalisée par le programme
"cbinsdoc".
L'utilisation d'un outil de transport permettant de récupérer un "return code" sur le
transfert est donc préférable.
Invocation sur le poste client d'une URL de consultation (getdoc.php avec comme
paramètre unique le jeton).
Suppression du fichier sur le serveur d'applications AIX.
3. 2 C ON S U L T A T IO N A POS T E R IO R I DE L ' E S PA C E DE
R É T E N T ION
Un utilisateur connecté à l'application Delta-Bank et désireux de re-visualiser un report va
sélectionner dans son menu DELTA-BANK le programme "cbconsdoc".
Ce programme DELTA-BANK développé en Genero permettra l'affichage sous forme d'un
tableau du contenu de la table des documents pour un utilisateur donné.
4. SCHEMA DE PRINCIPE
4.1 C ON S U L T A T ION IN S T A N T A N E E
5. 1 V A R IA B L E D’E N V IR ON N E M E N T DE L T A _ DOC _ U R L
5.1.1 SYNTAXE
Export DELTA_DOC_URL="http://mySite:myPort/myApp/getdoc.php?token="
5.1.2 EXEMPLE
Export DELTA_DOC_URL="http://hsen2ksi:46016/DeltaBank/getdoc.php?token="
Warning
htdocs/DeltaPaie
htdocs/DeltaImmo
htdocs/DeltaBank
6. CONSULTATION INSTANTANEE
Programme Delta-Bank : "cbinsdoc"
Remarque : ce programme ne doit en aucun cas être placé au menu. Il s'agit d’un
programme silencieux appelable par script.
Syntaxe
cbinsdoc.42r <DeltaUserCode>
00000000
<filename>
<subdir>
<orig>
<program>
<pagecode>
{ AUTO | MANUAL }
[ { O | N } ]
6. 1 E X E M PL E
$FGLRUN $BANK/4gi/compta/cbinsdoc.42r BC8656 00000000 DELTA-BC8656-20080807-152234-cbednom.txt jdurand
DELTA cbednom ISO8859-6 AUTO N
6. 2 M ODE DE B U G
Le 9ème paramètre permettra de débugger l’alimentation des deux tables concernées :
"evprintdoc" et "evprinttoken". Ce paramètre est à placer à "N" en production.
# doc_insertDocument (end)
# doc_insertToken (begin)
# doc_insertToken (end)
# doc_execURL (begin)
# T098-DOCUMENTS not filled
>> Echec de l’invocation de l’URL car la clé permettant de spécifier le serveur Apache n’est pas
renseignée
6. 3 FL U X X M L
Le programme "cbinsdoc" permet de lire et d'intégrer un flux XML qui sera produit pour
définir le "catalogue du document" par StreamServe (fichier XML sous format ".cat").
Après le contrôle d’existence du fichier catalogue, le fichier XML est lu et contrôlé.
Les différentes données fournis par StreamServe via le fichier catalogue seront insérées
en base dans une table annexe à la table des documents.
7. CONSULTATION A POSTERIORI
Programme Delta-Bank : "cbconsdoc"
7.1 A S PE C T H A B IL IT A T ION
Un utilisateur (a fortiori un profil) avec comme habilitation "i" seulement ne pourra pas
sélectionner l’utilisateur. C’est donc ses propres documents seulement que pourra voir
l’utilisateur.
En revanche, avec l’habilitation "c" (a fortiori "*" ), l’utilisateur aura accès au champ
"Utilisateur" et pourra consulter les éditions d’un autre utilisateur.
Une fois sélectionné, la validation par la touche ESC ou un clic sur le bouton
"Visualisation" génère un ticket de session (un enregistrement dans evprinttoken) et
invoque l’URL paramétrée.
La case à cocher "Editions du jour seulement ?" permettra de sélectionner les éditions du
jour : c’est en termes de date système et non comptable que le test est effectué.
7.2 A PU R E M E N T S
Il conviendra de prévoir l’apurement de l’espace de rétention sur l’environnement
d’hébergement en parallèle de l’apurement de la table "evprintdoc".
Les critères sont affichés sous forme de fourchette. Il est possible, pour chaque critère,
de faire une recherche. Un contrôle de la valeur saisie ou récupérée sera ensuite effectué.
Pour chaque fourchette, il faut saisir les deux valeurs ou rien. De plus, un contrôle est
effectué afin de savoir si la deuxième est supérieure à la première valeur. Sinon, un
message d’erreur sera généré.
Il faut absolument saisir au moins un critère pour pouvoir avoir les résultats dans le
tableau.
9. ANNEXES
Ces tables et séquences devront être créés sur chaque base : Paie, Immos, et Bank.
9. 3 S C R IPT : L PR I N T 2 . S H ( C A S D E L T A - B A N K)
Note
export
DELTA_DOC_URL="http://hsen2ksi:46016/DeltaBank/getdoc.php?token="
[ $RUNNER ] || { RUNNER=fglrun_1311d_IFX;}
[ $BANK ] || { BANK=/appli/delta/PRODV9/genero_1.31.1d/v9.0.131;}
[ $PROFILE ] || { BANK=/appli/delta/profilev9;}
WHO=$UNIX_USER
[ $WHO ] || { WHO=unknown;}
WHICH="txt"
SOURCE_DIR=/echange/tmp
OUTPUT_FILE=DELTA-$WHO-$WHEN-$WHAT.$WHICH
cat $* > /echange/tmp/$OUTPUT_FILE
9. 4 IN S T A L L A T ION DE L A PA R T IE A PA C H E / PH P
L'installation ci-après tient compte de la customisation de l’installation dans le répertoire :
D:\applis\Delta-Print v1.0 Printing Server
Sur le serveur hsen2ksi avec écoute sur le port 46016.
E:/file
Warning
Afin de supporter plusieurs applications (Paie, Immos, Bank), l’installation de
l’application Apache/PHP sera réalisée sous la forme :
htdocs/DeltaPaie
htdocs/DeltaImmo
htdocs/DeltaBank
Listen 46016
Fichier no 2 : php.ini
sous D:\applis\Delta-Print v1.0 Printing Server\php5
Fichier no 3 : param.php
sous D:\applis\Delta-Print v1.0 Printing
Server\Apache2\htdocs\DeltaBank
// DATABASE PARAMETERS
// Database type : oracle or informix
define ("DATABASE_TYPE",'informix');
// Database host name : must be a DNS name or IP address.
define("DATABASE_HOST",'hsenisrv');
// Database service nome : example ORCL for oracle ou turbo(or 1526) for informix
define("DATABASE_SERVICE",'hsenisrv_net1');
// Database server name : only for informix (ex : ol_xxxxx)
define("DATABASE_SERVER",'ifxagencesrv_tcp');
// Database protocol : only for informix (ex : olsoctcp)
define("DATABASE_PROTOCOL",'onsoctcp');
// Database name : only for informix
define("DATABASE_NAME",'sgbsv9');
// Database connexion name
define("DATABASE_USER",'bo');
// Database connexion password
define("DATABASE_PASSWORD",'bo');
// FILES PARAMETERS
// Files storage directory (must ended with '/')
define("FILEDIR",'E:/file/');
// Temporary files path (must ended with '/')
define("TMPDIR",'D:/applis/Delta-Print v1.0 Printing Server/Apache2/htdocs/temp/');
// Time in seconds before cleaning. Concerne all files except ".txt"
define("LIFETIME",3600);
Note
il y a donc n fichiers param.php à paramétrer pour chacune des bases, donc chacune des applications.
9. 5 A S PE C T M U L T I A PPL IC A T ION S
Par rapport à la première installation, il est important de noter que pour supporter
plusieurs "sources" d’applications, la solution a consisté à dupliquer le contenu de
"htdocs" en n sous répertoires.
Ceci permet de disposer ainsi de n fichiers param.php pour accéder aux n bases.
Attention, chaque environnement (Paie, Immo, Bank) doit positionner dans ce contexte et
de manière dédiée l’URL de connexion (DELTA_DOC_URL).
9.5.1 EXEMPLE
Pour la partie Delta-Bank, la variable d’environnement DELTA_DOC_URL a été
positionnée dans le script qui positionne la majeure partie des variables propres à
l’application (setDeltaEnvironment.sh)
export
DELTA_DOC_URL="http://hsen2ksi:46016/DeltaBank/getdoc.php?token="
C’est pourquoi il sera nécessaire de prévoir une duplication des scripts "lprint2.sh" sur le
même principe.
Alors que les scripts - utilisés par les applications PAIE et IMMOS - devront invoquer
1 0. 1 E N V IR ON N E M E N T DE L T A - B A N K
Programmes : cbconsdoc.42r, cbinsdoc.42r (sous $BANK/4gi/compta)
Librairies : cbconsdoc.42m, cbinsdoc.42m, fct_doc.42m (sous $BANK/4gi/global)
Forme écran : fconsdoc.42f (sous $BANK/form_fr/global)
1 0 . 2 E N V IR ON N E M E N T DE L T A PA IE / DE L T A IM M O
Ces 2 applications se partagent un même répertoire "env".