You are on page 1of 209

www.absyscyborg.

com

SUPERVISEUR

SAGE X3 ENTREPRISE V140

Plan gnral du cours

1- Gnralits

1.1 Dfinition du superviseur


1.2 Rappels sur larchitecture
technique
1.3 Organisation des fonctions
1.4 Paramtrage et dveloppement
1.5 Socits et sites

2- Paramtrages de base

2.1 Introduction aux formules Adonix


2.2 Paramtres de base
2.3 Workflow
2.4 Paramtrages des fonctions

3- Exploitation

3.1 Imports et exports


3.2 Gestion des tats
3.3 Destinations dimpression
3.4 Portail utilisateur
3.5 Gestion des styles
3.6 Personnalisation du vocabulaire
3.7 Le serveur batch

4- Administration

4.1 Gestion des dossiers


4.2 Epuration et historisation
4.3 Gestion de patches et de version
4.4 Gestion des sessions
4.5 Utilitaires

5- Introduction au dveloppement
5.1 Prennisation et codes activits
5.2 Tables et index
5.3 Types de donnes : menus
locaux,
tables diverses
5.4 Ecrans et fentres
5.5 Nouveaux paramtres
5.6 Fonctionnement de base dun
objet

1. Gnralits

1- Gnralits

1.1 Dfinition du superviseur


1.2 Rappels sur larchitecture
technique
1.3 Organisation des fonctions
1.4 Paramtrage et dveloppement
1.5 Socits et sites

2- Paramtrages de base

2.1 Introduction aux formules Adonix


2.2 Paramtres de base
2.3 Workflow
2.4 Paramtrages des fonctions

3- Exploitation

3.1 Imports et exports


3.2 Gestion des tats
3.3 Destinations dimpression
3.4 Portail utilisateur
3.5 Gestion des styles
3.6 Personnalisation du vocabulaire
3.7 Le serveur batch

4- Administration

4.1 Gestion des dossiers


4.2 Epuration et historisation
4.3 Gestion de patches et de version
4.4 Gestion des sessions
4.5 Utilitaires

5- Introduction au dveloppement
5.1 Prennisation et codes activits
5.2 Tables et index
5.3 Types de donnes : menus
locaux,
tables diverses
5.4 Ecrans et fentres
5.5 Nouveaux paramtres
5.6 Fonctionnement de base dun
objet

1.1 Dfinition du superviseur


Un dveloppement en couches

Code applicatif (modulaire)


Services de base (superviseur)
Moteur adonix (machine virtuelle)

Base de donnes
Systme dexploitation

1.1 Dfinition du superviseur


Un ensemble de services gnraux

Services de base (superviseur)


Gestion de la base de donnes et de la configuration
Gestion des utilisateurs et des habilitations
Gestion des restitutions (statistiques, tats, interrogations)
Gestion des paramtres
Gestion des travaux batch
Gestion des mises jour du logiciel
Outil de dveloppement pour spcifiques

1.2 Rappels sur larchitecture technique


Une architecture client/serveur / Web

Client Windows
Windows NT/2000/XP

Serveur X3

Client Web
Windows
IE >= 5.5

Serveur Web

Windows NT/2000/2003
Unix (AIX, HP-UX)
Linux (Red Hat sous Intel)

Windows ou Linux
IIS, ou Apache

1.2 Rappels sur larchitecture technique


Une architecture volutive en multi-tiers

Client Windows

Client Web

Serveur
dapplication

Serveurs
de traitement
Serveur
de donnes
Base de donnes
SQL Server v7/8
Oracle v8/8i/9i

Serveurs web

1.2 Rappels sur larchitecture technique


On se connecte sur un dossier ADONIX X3 :

qui utilise un ensemble de modules

qui intgre un rfrentiel (paramtrage, dveloppement spcifiques)


commun

qui gre des donnes (statiques, mouvements)

On sidentifie comme un utilisateur, ce qui dfinit, dossier par dossier :

les habilitations

des valeurs par dfaut

La langue de connexion peut varier dun utilisateur lautre


Langue de connexion
Utilisateur dans le dossier
Dossier

1.2 Rappels sur larchitecture technique


Des connexions secondaires sont possibles :

partir dune session ouverte

sur le mme dossier, le mme utilisateur, dans la mme langue

Deux mthodes :

par Fichier / Session secondaire

par lappel dune touche de fonction (Shift F5 Shift F12)


paramtrable par utilisateur

1.3 Organisation des fonctions


ADONIX X3 est organis en modules hirarchiques :

Superviseur
Tronc commun

Ventes

Action commerciale

Stocks

Dveloppement

Comptabilit gnrale

Achats

GPAO

Tiers

Support client

Modules
spcifiques

1.3 Organisation des fonctions


ADONIX X3 est organis en fonctions appeles :

depuis une ligne de menu

depuis une page HTML (portail, assistants) par le biais dun lien

depuis une autre fonction (appel en tunnel ou en zoom)

Les fonctions sont la base :

de lhabilitation (dfinition des accs par utilisateur et fonction)

de lorganisation des menus

Une fonction :

est identifie par un nom [ GFONCTION depuis la calculette ]

peut tre vue par une info-bulle depuis le menu

est (le plus souvent) rattache un modle permettant des paramtrages

1.3 Organisation des fonctions


Permettent de rendre gnriques :

les paramtrages

lergonomie

De 3 types principaux

objets [ GFONCTION = GESXXX ]

consultations [ GFONCTION = CONSXXX ]

traitements [ GFONCTION quelconque ]

1.3 Organisation des fonctions


Le modle objet

Liste(s)
de gauche

Onglets

En-tte

1.3 Organisation des fonctions


Le modle objet
Correspond :

la gestion standard (cration, modification, consultation, suppression)

dune table ou dun ensemble de tables de la base

avec des listes gauches (slection, picking, liaisons), des possibilits de filtrage, de
slection avance

Peut intgrer des variantes :

elles sont nommes des transactions.

elles se caractrisent par des crans diffrents (on peut ainsi ne pas tout faire apparatre)
et parfois par des rgles de gestion diffrentes

Lobjet peut se paramtrer diffrents niveaux :

listes gauches (de faon gnrique)

contenu des onglets (transactions fonctionnelles)

passage dautres fonctions (liaisons, navigations, oprations du menu Fichier)

1.3 Organisation des fonctions


Le modle consultation

Onglets de consultation

Fentre de critres
complmentaires

Critres en tte

1.3 Organisation des fonctions


Le modle consultation
Correspond :

linterrogation de donnes

dune table ou dun ensemble de tables de la base

sans mise jour

avec des critres de slection en tte dcran et dans une fentre avance,
possibilit de mmorisation

avec en gnral des zooms vers le dtail

Peut intgrer des variantes :

elles sont nommes des crans de consultation.

Peut se paramtrer de faon gnrique :

par le paramtrage des crans de consultation

1.3 Organisation des fonctions


Le modle traitement
Saisie des critres

Excution du traitement

Affichage de trace

1.3 Organisation des fonctions


Le modle traitement
Correspond :

des traitements de masse

dont lexcution peut tre longue

prcds par une saisie de paramtres mmorisables

lancs en direct ou en batch

Au niveau du paramtrage :

correspond normalement une tche standard du serveur


batch

1.3 Organisation des fonctions


Dautres modles
Beaucoup plus rares

de type composite (plan de travail)

compltement atypiques (diteur de traitement)

Peu de possibilits de paramtrage sauf des paramtrages


gnriques de toute fonction :

tables de contrle, code daccs, styles conditionnels,


changement de vocabulaire

paramtres gnraux de configuration associs

lhabilitation par fonction, sous-fonction, filtres sur sites et


socits

1.4 Paramtrage et dveloppement


Le paramtrage est prenne

conserv en changement de version

non modifi par une mise jour de patches

Le spcifique doit tre protg pour tre prenne

chaque lment modifi doit tre marqu par un code activit spcifique.

un patch standard ne modifiera alors pas le spcifique

un patch spcifique peut le modifier

Certaines fonctions rsultent dune combinaison de paramtrage et de


dveloppement

Une partie est alors du dveloppement, une autre de la personnalisation

1.5 Socits et sites


Paramtrage / Structure gnrale /

Paramtrage / Structure gnrale /

Une action de gestion (un mouvement ) ne peut tre effectue dans X3


sans tre rattache un site ou une socit, informations
structurantes du dossier :

DOSSIER
SOCIT C1

Tiers,
produits,
etc

SOCIT C2

Pices
comptables
SITE FINANCIER F1

SITE S1

SITE S2

SITE FINANCIER F2

SITE S3

SITE FINANCIER F3

Commandes
dachat

SITE FINANCIER F4

SITE S4

SOCIT NON JURIDIQUE NJ1

SITE S5

Mouvements
de stock

1.5 Socits et sites


Paramtrage / Structure gnrale /

Paramtrage / Structure gnrale /

Les socits et sites interviennent essentiellement :

dans la dfinition des paramtres

dans les habilitations et le filtrage des donnes

Il est noter que :

on ne se connecte pas sur un site (le site est saisi dans les
documents o il intervient)

mais on a des sites par dfaut par module (qui dpendent du


profil de lutilisateur)

2. Paramtrages de base

1- Gnralits

1.1 Dfinition du superviseur


1.2 Rappels sur larchitecture
technique
1.3 Organisation des fonctions
1.4 Paramtrage et dveloppement
1.5 Socits et sites

2- Paramtrages de base

2.1 Introduction aux formules Adonix


2.2 Paramtres de base
2.3 Workflow
2.4 Paramtrages des fonctions

3- Exploitation

3.1 Imports et exports


3.2 Gestion des tats
3.3 Destinations dimpression
3.4 Portail utilisateur
3.5 Gestion des styles
3.6 Personnalisation du vocabulaire
3.7 Le serveur batch

4- Administration

4.1 Gestion des dossiers


4.2 Epuration et historisation
4.3 Gestion de patches et de version
4.4 Gestion des sessions
4.5 Utilitaires

5- Introduction au dveloppement
5.1 Prennisation et codes activits
5.2 Tables et index
5.3 Types de donnes : menus
locaux,
tables diverses
5.4 Ecrans et fentres
5.5 Nouveaux paramtres
5.6 Fonctionnement de base dun
objet

2.1 Introduction aux formules ADONIX

Une formule est une expression calcule pouvant tre value, faisant
appel des constantes, des variables, des fonctions Adonix et des
oprateurs.

tout moment dans X3, la calculette


une formule se rapportant au contexte.

Les formules sont utilises dans de nombreux cas de paramtrage

peut tre lance pour valuer

2.1 Introduction aux formules ADONIX


Formules simples
Constantes
Valeur numrique signe ou non
3.1415926
-273

Chane de caractres
"Aujourdhui"
Vous avez dit : "Bizarre"

Date
[29/05/1959]

Condition
Toute valeur numrique non nulle est considre comme vraie
(le rsultat dune comparaison renvoie 1 si la comparaison est vraie)
Toute valeur numrique nulle est considre comme fausse

2.1 Introduction aux formules ADONIX


Formules simples
Oprateurs
numriques
+ - * / ^

Date
Date date
Date + nombre
Date - nombre

Caractres
Chaine + Chaine
Chaine - Chaine

Niveau de parenthsage illimit

2.1 Introduction aux formules ADONIX


Variables
Dpendent dun contexte dexcution
Lies une classe dfinie entre crochets
TYPE DE VARIABLE

SYNTAXE A UTILISER

EXEMPLES

Valeur dun champ dans


lenregistrement
courant dune table en
ligne

[F:abv]nom

[F:BPC]BPCNUM

Valeur dun champ


dcran (situ dans un
onglet visible ou non)
Variable globale

abv=abrviation de la table
nom=nom du champ
[M:abv]nom
abv=abrviation de lcran
nom=nom du champ
[V]nom
la classe peut tre omise
le nom commence par G

Variables systme

[M:BPC0]BPCNUM

[S]nom
la classe peut tre omise
le nom est en minuscules
(mot-cl)

GNBGAUCHE
GUSER
GFONCTION
GOLDETAT
datesyst
nomap
indcum

2.1 Introduction aux formules ADONIX


Lditeur de formules
Appelable chaque fois quune formule de calcul peut tre saisie
Permet de retrouver les champs des crans et des tables
Est normalement li au contexte

2.1 Introduction aux formules ADONIX


Les tableaux de variables
Certains crans X3 contiennent des tableaux. Les champs sont alors indics (ex :
factures de vente).

[M:SIH3]QTY(0)
[M:SIH3]QTY(1)
[M:SIH3]QTY(2)
[M:SIH3]QTY(3)

Note : les indices commencent 0 (les lignes 1)

2.1 Introduction aux formules ADONIX


Fonctions
De nombreuses fonctions sont disponibles pour exprimer des
formules
numriques
pi abs(N) mod(N,M) arr(N,N) ar2(N) log(N) exp(N)
val (C) day(D) month(D) year(D) ascii(C) instr(N,C,C)

sin(N)

dates
date$

addmonth(D,N)

eomonth(D)

gdat$(N,M,P)

caractres
string$(N,C) num$(N) chr$(N) left$(C,N) right$(C,N) seg$(C,N,M)
mid$(C,N,M)
format$(C,X) space$(N) vireblc(C,N) ctrans(C) ctrans(C,C,C)

2.1 Introduction aux formules ADONIX


Fonctions
Autres fonctions disponibles pour exprimer des formules

agrgatives
find(X,X)

min(X)

max(X)

avg(N)

prd(N)

uni(X)

diverses
sigma(N,N,N)

sum(N)

evalue(C)

parse(C)

filpath(C,C,C,C)

Fonctions gnriques dfinies par le programmeur


func TRAITEMENT.NOM(X)

Fonctions standard dfinies dans des traitements standard Adonix X3


func AFNC.ACTIV("CODE") valeur dun code activit
func AFNC.PARAM("PARAMETRE","SITE") valeur paramtre (sous forme alphanumrique)
func AFNC.PARAMUTIL("PARAMETRE","USER","SITE") valeur paramtre utilisateur (idem)
func AFNC.CONSULT("ACCES") vrai si droit de consultation sur le code accs
func AFNC.MODIF("ACCES") vrai si droit de modification sur le code accs
func AFNC.EXEC("ACCES") vrai si droit dexcution sur le code accs
func AFNC.TEXTE(NUM) donne le texte en fonction du numro (dans la langue courante)
func AFNC.TEXTRA("TABLE","CHAMP","CLE1","CLE2") texte traduisible dans une table

2.2 Paramtres de base


Ce sont des paramtres gnriques, potentiellement utiliss dans
tous les types de fonctions :
Paramtres gnraux
Base de paramtres influant sur le comportement de lenvironnement ou de
fonctions du progiciel

Menus locaux
Tables de choix utilises dans les combo-boxes et les boutons radio

Tables diverses
Tables de codes gnriques, associs une liste de valeur, un intitul traduisible,
et une liste limite de valeurs associes

Compteurs
Dfinition de rgles de numrotation des documents (mouvements notamment)

2.2 Paramtres de base


Paramtres gnraux

Paramtrage / Paramtres gnraux / Valeurs paramtres

Les paramtres gnraux sont des valeurs de paramtrage:


Dfinies dans le dictionnaire des donnes (Dveloppement)
Organises en chapitres
Activant ou dsactivant une fonctionnalit
ou conditionnant une dcision de traitement dans X3
ou influant sur le fonctionnement de linterface

Dfinies diffrents niveaux dorganisation


Visibles (dans certains cas) comme des variables globales

2.2 Paramtres de base


Paramtrage / Paramtres gnraux / Valeurs paramtres

Niveau de dfinition des paramtres


Il existe au maximum 4 niveaux de dfinition :

Dossier

Socit

Site

Utilisateur
C

S
U

U
D

U
S

Chaque paramtre est caractris par le niveau de dtail le plus fin


La valeur de niveau le plus bas est toujours retenue

2.2 Paramtres de base


Paramtres du superviseur Paramtrage / Paramtres gnraux / Valeurs paramtres
Groupe ADX
DIRPCE1 et DIRPCE2 : rpertoire des pices jointes
Groupe TC (valeurs par dfaut)
CHGTYP : type de cours, DEFCUR : devise par dfaut
Groupe SUP
Environnement : TYPMES, SERMES, SERIMP, VIRTDIR
Base de donnes : ROLLBACK, TIMLCK
Scurit : PASSWD, PASLNG, NBRCON, CHGPASS
Contrle des connexions : USR1, USR2

2.2 Paramtres de base


Saisie des VP

Paramtrage / Paramtres gnraux / Valeurs paramtres

Choix du chapitre
et du niveau de
dfinition :
global
socit
site

Possibilit de
reprendre
la valeur
au-dessus

2.2 Paramtres de base


Paramtrage / Paramtres gnraux / Menus locaux

Les menus locaux (messages)


Les menus locaux (messages) sont :

des listes de valeurs ou de libells traduisibles

groupes par chapitre (numro de 1 9999)

utilises pour les listes droulantes, les boutons radio, les cases cocher

Physiquement, un champ de type menu local stocke le numro du texte (0-255)


plutt que le texte lui-mme.

2.2 Paramtres de base


Paramtrage / Paramtres gnraux / Menus locaux

Les menus locaux (messages)


Il existe des rgles de modification des
menus locaux :

Tous ne sont pas modifiables (cela


dpend du dveloppeur)

Attention aux insertions ! (les


valeurs sont stockes sous forme
de rang)

Parfois, un nombre minimum et/ou


maximum de choix est autoris

Une validation est demande en fin


de mise jour de menus

Une modification peut imposer des


actions techniques (revalidation
des crans si le menu local est
utilis comme bouton radio)

2.2 Paramtres de base


Paramtrage / Paramtres gnraux / Tables diverses

Les tables diverses


Les tables diverses sont :

des petites tables logiques contenant des valeurs diverses


comme les codes de taxe, les incoterms, les familles et sousfamilles article, client, fournisseur

identifies par un numro (de 1 999)

stockes dans une seule table de la base (ATABDIV)

associes un champ dans une fiche pour permettre den


contrler la valeur

Les codes stocks dans la table ont une longueur maximale


dpendant du numro de la table (3 par dfaut)

2.2 Paramtres de base


Paramtrage / Paramtres gnraux / Tables diverses

Les tables diverses


Chaque enregistrement dune table diverse est caractris par :
un code alphanumrique (caractres majuscules) sur N
positions maximum
le code dune autre table dont lenregistrement peut dpendre

deux intituls (long, court) stocks en fonction de la langue


(intituls traduisibles )
Jusqu 2 champs alphabtiques (ou date) et jusqu 2
champs numriques complmentaires, dont le format dpend
de la table

2.2 Paramtres de base


Paramtrage / Paramtres gnraux / Tables diverses

Les tables diverses

2.2 Paramtres de base


Paramtrage / Paramtres gnraux / Perso tables diverses

Personnalisation des tables diverses


Cette fonction permet de les rgles de dpendance Familles / Sousfamilles, les intituls de la table et la longueur des codes sils sont
modifiables
Le fait que la longueur soit modifiable est spcifique
!

Il faut protger par un code activit spcifique pour prenniser

Par contre, est considr comme paramtrage (prenne) la longueur du code, la


prsence de champs supplmentaires, la table de dpendance.

2.2 Paramtres de base


Paramtrage / Paramtres gnraux / Compteurs

Les compteurs
Les compteurs sont :

des codes associs aux documents du progiciel (factures, commandes,


critures) ou des fiches que lon souhaite numroter

qui dfinissent des rgles dattribution didentifiants (un numro de


facture par exemple)

Caractristiques des identifiants dlivrs par un compteur :

Ils ne sont pas forcment entirement numriques

Ils sont structurs de faon particulire (en intgrant des segments


particuliers dpendant du contexte : lanne, le site)

Ils intgrent obligatoirement un numro squentiel qui peut revenir zro


de faon priodique, et peut dpendre de la socit, du site, ou dune autre
information (complment)

2.2 Paramtres de base


Paramtrage / Paramtres gnraux / Compteurs

Les compteurs
Un compteur peut tre global, dfini
au niveau du site ou de la socit.
(nombre de squences gres)

Le tableau des composants


La longueur totale est la somme des
longueurs de composants, elle est
limite 15 ou 20 caractres)

Case cocher permettant de vrifier


quun document dat aprs un autre
a toujours un numro de squence
suprieur

Compteur remis zro en cas de


remise zro du dossier ?

Frquence de Remise-A-Zro :
La squence peut repartir 1 de faon priodique.
Attention : il faut que llment identifiant la priode
soit prsent dans un autre segment, sinon on va crer
des doublons dans les identifiants.

2.2 Paramtres de base


Paramtrage / Paramtres gnraux / Compteurs

Les compteurs
Complments et formules

Les complments dfinissent segments dpendant du contexte ayant


chacun leur numrotation propre :
Contexte de numrotation

Valeur du complment

Ecriture comptable

Journal

Lot article

Code article

Rglement

Code transaction de rglement

Lot de saisie de rglement

Code utilisateur

Quittance factor

Code factor

Fiches tarif

Code tarif

Les formules permettent dvaluer une constante sans que la


numrotation en dpende

2.2 Paramtres de base


Paramtrage / Paramtres gnraux / Affectation des compteurs

Affectation des compteurs

Elle se fait par module et par type de document dans la majorit des cas

Dans certains cas, un numro manuel est possible

Certaines affectations sont plus complexes

2.2 Paramtres de base


Dveloppement / Utilitaires / Divers / Valeurs des compteurs

Valeurs initiales des compteurs


!

Cest une fonction de maintenance situe dans le dveloppement !

Elle permet de modifier le prochain numro de squence utilis

Elle est utile en cas de reprise (aprs import dun systme antrieur,
pour numroter les pices suivantes en squence)

2.3 Workflow
Paramtrage / Workflow / Rgles workflow

Principes de base
Evnements dclenchants
Ce qui peut tre dclench

Retour de Workflow
Cration dtaille dune rgle de Workflow

2.3 Workflow
Principes de base du workflow

Paramtrage / Workflow / Rgles workflow

Le moteur de Workflow dADONIX X3 permet :

partir dvnements dclenchants divers :

Entre dans une fonction


Action ralise dans une fonction objet
Fin de tche batch
Edition
Evnements divers

de dclencher un ou plusieurs actions :


Excution dun traitement par le biais dune action
Envoi de messages (mails)
Enregistrements dvnements dans une table de log

Lorsquun mail est envoy, il est possible de dfinir lappel dune


action en retour (par double-clic sur une icne jointe dans le mail)

2.3 Workflow
Paramtrage / Workflow / Rgles workflow

Fonctionnement du moteur de Workflow


Excution dune action (traitement)

Contexte dclenchant

Condition de dclenchement

Traitement
X3

Utilisateur et
Action et paramtres de laction
contextes courants
Valeurs de retour (si ncessaire)
Type dvnement

Envoi dun message (e-mail)

Texte du ou des messages


Dfinition des pices jointes

Code vnement

Actions dclenchantes
(oprations, boutons)

Options denvoi

Conditions
supplmentaires

Liste des destinataires

1
Contexte X3

2
3

Dfinition de licne de retour


Stockage dinformations de log

Dfinition des informations


stocker (nature, information)

Table de log

2.3 Workflow
Paramtrage / Workflow / Rgles workflow

Evnements dclenchants possibles


Evnements gnriques :

Gestion dobjet

Entre dans une fonction

Fin ou arrt de tche batch

Lancement dune dition

Evnements divers (connexion, dconnexion, time-out, arrt processus)

Le contexte peut tre prcis :

En donnant le code en dur (objet, fonction, tche batch, tat)

En spcifiant des conditions complmentaires (expressions calcules)

En gestion objet, le contexte peut tre plus riche :

Opration en cours (Cration, Modification, Suppression, Changement de


code, Impression, Bouton Workflow)

Excution dun bouton associe la fentre (si lobjet est donn en dur)

2.3 Workflow
Paramtrage / Workflow / Rgles workflow

Dclenchement dun traitement X3


Caractristiques du traitement :
Normalis comme une action
dfini dans le dictionnaire des actions
avec la case Workflow coche

Sans aucune interaction avec lcran


puisquil peut tre dclench en batch
mais avec la possibilit de disposer de variables en retour

Actions disponibles ce jour :


gestion des liaisons (explorateur de liaison)
actions spcifiques crer

2.3 Workflow
Principes de base du mail via Workflow
Interface MAPI

Serveur de messagerie

Client Windows
Client Web

Serveur X3
Interface SMTP POP3
Serveur Web

2.3 Workflow
Envoi dun mail par le Workflow

Paramtrage / Workflow / Rgles workflow

Les caractristiques paramtrables du mail sont :

Destinataires

soit connus comme des utilisateurs (adresse e-mail sur la fiche)


soit dfinis comme des tiers avec le type dinterlocuteur
si un @ se trouve dans ladresse, on envoie tel quel
Destinataires principaux et/ou en copie

Texte dfini sous la forme de lignes avec des expressions

Pices jointes
chemin fixe sur le serveur dapplication dfini par une expression
pices jointes un objet (avec des filtres type/catgorie)
fichier trace li (si tche batch)

Informations complmentaires :
Prsence dune icne de retour (retour au menu ou fin directe)
Accus de rception

2.3 Workflow
Mise jour dune table de log

Paramtrage / Workflow / Rgles workflow

Elments stocks dans la table de log (AWRKLOG) :

Date, heure, utilisateur.

5 lments (couples) du type Nature / Information (table diverse 50).

vnement, type d'opration, code objet, cl

Flag Message pour indiquer si un e-mail a t envoy ou non.

Visualisation par le Workflow monitor ( Exploitation / Moniteur Workflow )

2.3 Workflow
Paramtrage dtaill
Code catgorie, rattach la
table diverse 51 (informatif)

Type dvnement:
Entre fonction
Objet
Edition Etat
Fin tche batch
Arrt tche batch
Divers
Code vnement
(sil est vide, il sagit dun vnement
gnrique)

Conditions lies au contexte

Evnements dclenchs et Options

Paramtrage / Workflow / Rgles workflow


Onglet Gnral
Oprations dclenchantes
et / ou Boutons dclenchants
(dans un contexte Objet )

2.3 Workflow
Paramtrage / Workflow / Rgles workflow

Paramtrage dtaill : assistant de formule


On dispose dun contexte en ligne si lvnement est spcifi :

En contexte objet

En contexte tat :

les paramtres de lancement

En contexte tche batch :

Table (valeurs avant modification)


Ecrans (valeurs aprs modification)

lcran saisie
des paramtres

Dans tous les cas :

la table des utilisateurs


AUTILIS

2.3 Workflow
Paramtrage dtaill
Informations sur le retour par mail :
Possible Icne de retour coche
Retour au menu ou fin aprs excution

Fonction de retour
(fonction appelante par dfaut)
et cl de lien
(si la fonction est de type objet)
Code action dclencher
(Pas daction lancer si vide)
Cest ici une action spcifique
Tableau des paramtres :
Ici, on a
deux paramtres en entre
deux paramtres en sortie

Paramtrage / Workflow / Rgles workflow


Onglet Actions

2.3 Workflow
Paramtrage dtaill
Tableau des destinataires, sous la forme
-dune adresse en dur avec @
- dun couple (code tiers, fonction)
- dun code interne utilisateur

Au moins un des destinataires


doit avoir Non dans la colonne

Texte valu du message

Paramtrage / Workflow / Rgles workflow


Onglet Message

2.3 Workflow
Paramtrage dtaill

Paramtrage / Workflow / Rgles workflow


Onglets Pices jointes et Traabilit

Pice jointe
(chemin daccs valu)

Indicateur Fichier trace li


(pour tches batch)

Dfinition des pices jointes envoyer


(dans un contexte objet uniquement)

Tableau des informations du moniteur Workflow :


Nature = Table diverse numro 50

2.4 Paramtrage des fonctions


Les modles de fonctions induisent des
paramtrages particuliers :

Modle Objet
Proprits
Personnalisation
Liaisons automatiques
Navigation
Transactions

Modle consultation
Paramtrage des crans

Tout modle utilisant des crans


Tables de contrle
Affectation de codes daccs (pour rappel)

2.4 Paramtrage des fonctions


Paramtrage / Paramtres gnraux / Proprits objets sous menu Fichier

Paramtrage des objets : Proprits


En gestion dobjet, Fichier / Proprits permet daccder :

A des informations lies la valeur courante de la fiche


Par dfaut, on trouve les informations suivantes
(si elles existent) :

Ces informations calcules tant


paramtrables, en intgrant :

des fonctions
des constantes
des champs de la table principale
Des champs de tables lies dclares dans
un tableau

Cette information est aussi disponible par F11 sur toute zone de cl lie un objet

2.4 Paramtrage des fonctions


Paramtrage / Paramtres gnraux / Personnalisation objet

Paramtrage des objets : Personnalisation


Il est possible de paramtrer un ensemble de caractristiques de
lobjet :
Les caractristiques de la liste gauche :
Index de tri (le premier de la table par dfaut)
Sens (ascendant ou descendant)
Gestion en liste hirarchise
(si plusieurs composantes dans la cl)
Affichage de la liste des derniers lus

Les colonnes prsentes dans la liste gauche


Table (principale ou lie)
Champ ou expression (type et variable associe)
Intitul de la colonne
Accs direct par zoom aux statistiques
( Appel par Fichier / Statistiques)
Etats appels par :
Fichier / Impression
Fichier / Liste

2.4 Paramtrage des fonctions


Paramtrage / Paramtres gnraux / Personnalisation objet

Paramtrage des objets : Personnalisation


Sur le second onglet, on paramtre les autres listes de gauche standard

Prsence de
lexplorateur de liaisons

Intitul des liens


vers lobjet paramtr

Paramtrage des liaisons automatiques :


Objet partir duquel le lien part
Expression permettant de connatre sa cl
Code liaison
Tableau si liens multiples
(lexpression de lien dpend alors de indice)

Prsence de longlet
Derniers lus

2.4 Paramtrage des fonctions


Dveloppement / Dictionnaire traitements / Navigation

Gestion des objets : Navigation


!

Cest une fonction situe dans le dveloppement

Des navigations standard sont fournies (essentiellement pour la CRM)

Toute modification et toute cration de nouvelle navigation doit tre


signe par un code activit spcifique (commenant par X, Y, ou Z)

Elle suppose une bonne connaissance du contexte dexcution

Elle peut produire des dysfonctionnements dans lobjet modifi si la


dfinition est mal faite

Nanmoins :

Elle a la facilit de mise en oeuvre dun paramtrage

2.4 Paramtrage des fonctions


Dveloppement / Dictionnaire traitements / Navigation

Navigation : principes de base


Une fonction X3 dispose de

possibilits de navigation
vers dautres fonctions
Quand la fonction arrivante
est un objet, on peut vouloir
tenir compte du contexte
appelant pour :

Proposer des valeurs par


dfaut en cration

Imposer des filtres de


slection

Via lexplorateur
de liaisons
Via des menus
dans la barre
doutils
Par tunnel
Via des boutons

2.4 Paramtrage des fonctions


Paramtrage / Paramtres gnraux / Personnalisation objet

Navigation : dfinition dtaille

Sur le premier onglet, on paramtre les filtres sur lobjet

Code identifiant
la navigation

Contexte :
Fonction de dpart
Objet darrive

Filtres sur la liste gauche :


Condition dactivation
Filtre

2.4 Paramtrage des fonctions


Paramtrage / Paramtres gnraux / Personnalisation objet

Navigation : dfinition dtaille

Sur le second onglet, on paramtre les valeurs par dfaut

Champs des crans

Formules des
valeurs par dfaut

2.4 Paramtrage des fonctions


Dveloppement / Dictionnaire traitements / Navigation

Gestion des objets : Navigation


Un cas particulier important

si le code fonction de dpart correspond lobjet darrive :

cest--dire GESXXX XXX

par convention, on est dans le cas o on part dun menu

Il est donc possible par ce biais, sur des objets appels directement

de crer des filtres complmentaires gnriques ou contextuels

de proposer des valeurs par dfaut contextuelles

Interface utilisateur :

Un code de navigation actif est indiqu par licne

en bas de lcran

Un double clic sur licne affiche le code de navigation actif

2.4 Paramtrage des fonctions

Gestion des objets : Transactions

Paramtrage /??? / Transactions

Sur le plan technique, un objet se compose :

de listes de gauche

dun ensemble donglets (appel fentre)

En temps normal, un objet est associ une seule fentre

rgle de nommage : fonction GESXXX, objet XXX, fentre OXXX

lentre dans lobjet provoque louverture de la fentre

Il est possible de crer plusieurs fentres pour un seul objet :

chaque fentre correspond une variante de lobjet

chaque variante peut tre protge par un code daccs

lappel de la fonction, un choix de transaction est demand parmi les


transactions autorises

il est aussi possible dimposer la transaction (paramtre dans le profil menu).

2.4 Paramtrage des fonctions

Gestion des objets : Transactions

Paramtrage / ??? / Transactions

Crer de nouvelles fentres est un acte de programmation, mais :

dans la plupart des modules, des fonctions de cration automatique de


fentres associes un objet existent

elles partent dune fentre de base intgrant tous les champs possibles

elles permettent par paramtrage de choisir les champs que lon ne veut
pas voir, ceux que lon veut pouvoir modifier, et ceux que lon ne veut que
visualiser

dans certains cas, elles permettent de dfinir des valeurs par dfaut, des
filtrages, ou des contrles complmentaires

Ces fonctions, dpendant de chaque module, sont les paramtrages de


transaction.

2.4 Paramtrage des fonctions


Paramtrage / Paramtres gnraux / Ecrans de consultation

Paramtrage des consultations : Ecrans


Les consultations sont caractrises par un code sur 3 caractres :
Rgle de nommage :

fonction CONSXXX, consultation XXX

Un cran par dfaut est fourni :

nomm STD

incluant tous les champs

Le paramtrage gnral cre des crans :

Protgs par code daccs

Avec une pagination paramtrable

En donnant un rang chaque champ

Rang 0 champ non affich

lappel de la fonction, un choix


est demand parmi les crans autoriss

il est aussi possible dimposer lcran


(paramtre dans le profil menu).

2.4 Paramtrage des fonctions


Paramtrage / Paramtrages gnraux / Tables de contrle

Paramtrage gnrique li aux crans

Toute fonction utilisant des crans peut utiliser des tables de contrle

Une table de contrle dfinit des contrles


supplmentaires sous la forme :
de liste de valeurs obligatoires
de liste de valeurs interdites
de bornes de valeurs numriques
dexistence dans une table
dune expression logique

Trois contrles successifs peuvent


tre saisis, avec des messages
derreur ddis

2.4 Paramtrage des fonctions


Paramtrage / Paramtrages gnraux / Affectation contrle

Affectation des contrles aux crans

La fonction daffectation permet de saisir lcran concern, et daffecter une table


aux champs concerns.
Les crans sont automatiquement revalids.

2.4 Paramtrage des fonctions


Paramtrage / Paramtrages gnraux / Affectation codes daccs

Paramtrage gnrique li aux crans

Rappel : toute fonction utilisant des crans peut utiliser des codes daccs pour
dfinir des restrictions daccs

3. Exploitation

1- Gnralits

1.1 Dfinition du superviseur


1.2 Rappels sur larchitecture
technique
1.3 Organisation des fonctions
1.4 Paramtrage et dveloppement
1.5 Socits et sites

2- Paramtrages de base

2.1 Introduction aux formules Adonix


2.2 Paramtres de base
2.3 Workflow
2.4 Paramtrages des fonctions

3- Exploitation

3.1 Imports et exports


3.2 Gestion des tats
3.3 Destinations dimpression
3.4 Portail utilisateur
3.5 Gestion des styles
3.6 Personnalisation du vocabulaire
3.7 Le serveur batch

4- Administration

4.1 Gestion des dossiers


4.2 Epuration et historisation
4.3 Gestion de patches et de version
4.4 Gestion des sessions
4.5 Utilitaires

5- Introduction au dveloppement
5.1 Prennisation et codes activits
5.2 Tables et index
5.3 Types de donnes : menus
locaux,
tables diverses
5.4 Ecrans et fentres
5.5 Nouveaux paramtres
5.6 Fonctionnement de base dun
objet

3.1 Import / Export


Dfinition gnrale
Modles
Tables de transcodage
Paramtres gnraux

Imports et exports chronologiques


Enchanements

3.1 Import / Export

Imports et exports

Exploitation / Import/export / Import

----- Exploitation / Import/export / Export

La fonction d'import/export permet de transfrer des donnes de la BDD vers


des fichiers textes et vice-versa, en se basant sur les objets X3 et sur un
dictionnaire :
Un dictionnaire de modles d'import/export dfinit le format des
fichiers texte et les liens vers les objets X3 exporter ou importer.
Le processus d'import est bas sur la gestion d'objet X3, c'est dire
qu'il simule une saisie manuelle des donnes. En consquence, les
contrles qui sont effectus lors de la saisie manuelle le sont
galement lors d'un import.

Un certain nombre d'objets ne peut pas tre import en utilisant la


gestion d'objet. Dans ce cas un traitement d'import spcifique est
utilis et crit les donnes directement dans les tables X3, sans
passer par une simulation de saisie.

3.1 Import / Export


Paramtrage / Exploitation / Modles dimport/export

Dfinition dun modle dimport/export

Types de fichiers et structure des donnes :

ASCII 1
CHAMP1 sep CHAMP2 sep CHAMPN sep/ Enr. suivant
ASCII 2
CHAMP1 sep1 CHAMP2 sep1 sep1 CHAMPN sep2/ Enr. suivant
Dlimit
CHAMP1 sep1 delCHAMP2del sep1 CHAMPN sep2/ Enr. suivant
Fixe
CHAMP1lllllllllllCHAMP2lllllll CHAMPNlllllllllll/ Enr. suivant

Identificateurs : Plusieurs niveaux en-tte/dtails


peuvent tre dfinis :

Niveau dfinit la hirarchie entre les diffrentes tables.


Code est l'identifiant du niveau dans le fichier texte.
La Cl est celle utilise pour lire la table (cf. dictionnaire).
Lien : les champs de la table dont les valeurs seront utilises
pour la lecture de la table du niveau suprieur
(dpendent de la cl de la table suprieure).

3.1 Import / Export


Paramtrage / Exploitation / Modles dimport/export

Dfinition dun modle dimport/export

L'onglet Champs contient la dfinition de l'ordre


des champs exports ou imports dans le fichier
texte.

Lorsque des identificateurs existent, ils doivent


tre placs en tant que premier champ pour
chaque table. Un identifiant est indiqu par le
caractre '/'.
Critre permet la saisie de critres de dbut/fin lors de l'export
Le champ peut tre:
Un champ de la table
Une constante ("XXX" ou 'XXX') (ignore en import)
=Expression (ignore en import)
*1, *2 etc. pour rfrence la variable GIMP(i) (import)

Numro de table utilise pour un transcodage de donnes

Le chemin d'accs peut inclure le caractre '#' pour numrotation squentielle du fichier.
Le bouton Export sert dfinir les paramtres par dfaut (critres et
formules de slection), qui seront prchargs lors de l'excution manuelle
d'un export ou utiliss directement lors de l'excution d'un enchanement.

3.1 Import / Export


Paramtrage / Exploitation / Transcodage Import/Export

Tables de transcodage dimports/exports


Cette fonction permet de dfinir des tables de correspondance :
Entre codes locaux et codes externes
Associables un modle dimport/export
Fonctionnant la fois en import et en export
Avec des valeurs par dfaut possibles (*)
Dans lexemple ci-contre :
En export :

CHQ est transcod en CHEQUE

TRT est transcod en TRAITE


(1er choix de la liste)

DIV nest pas transcod (*)

Tout autre choix est transcod en AUTRES


En

import :
CHEQUE est transcod en CHQ
TRAITE et EFFET sont transcods en TRT
Tout autre choix est transcod en DIV
AUTRES nest pas transcod

3.1 Import / Export


Paramtrage / Exploitation /

Paramtres dimports /export

Utiliss pour dfinir les emplacements par dfaut des fichiers utiliss pour
l'import/export sur le client ou sur le serveur. Ceci n'est pas obligatoire
mais ajoute de la cohrence la gestion des imports/exports.
Les rpertoires par dfaut sont symboliss par le
caractre '%' dans les modles d'import/export
(champ Fichier de donnes).

Transfert en
fin dexport

Dplacement
en dbut
dimport

1
2

Transfert
des lignes
importes

3
4

Copie des lignes


errones
4

3.1 Import / Export

Imports et exports chronologiques

Exploitation / Import/export / Export

Un export chronologique se dclenche en activant la case cocher Gestion Chrono :

Lexport est alors bas sur un numro de chrono gr comme un time-stamp, pour
effectuer des extractions diffrentielles

Seuls les enregistrements modifis depuis le dernier export sont exports

La variable [C]EXPORT contient le numro chronologique courant et est


incrmente la fin de chaque export, quel que soit le modle utilis.

La valeur courante du numro chronologique est stocke dans le champ EXPNUM


d'un enregistrement lorsqu'il est modifi ou cr, et dans le champ EXPORT du
modle la fin de chaque export.

Un export avec gestion de chrono ne touche que les enregistrements dont EXPNUM
est plus grand que le champ EXPORT du modle.

3.1 Import / Export

Imports et exports chronologiques

Exploitation / Import/export / Export

Exemple de squence dexport chronologique :

1
2
3
4

Commande 34

EXPNUM = 2

Commande 35

EXPNUM = 1

Modle export
SOH

Commande 36

EXPNUM = 4

EXPORT = 3

EXPORT CHRONOLOGIQUE . DES


COMMANDES AVEC LE MODELE SOH

MODIFICATION DE LA COMMANDE 34

EXPORT CHRONOLOGIQUE . DES


COMMANDES AVEC LE MODELE SOH

[C]EXPORT = 5

Commande 34

EXPNUM = 2

Commande 35

EXPNUM = 1

Modle export
SOH

Commande 36

EXPNUM = 4

EXPORT = 5

Commande 34

EXPNUM = 9

La commande 36
est exporte
[C]EXPORT = 6

[C]EXPORT = 9

Commande 34

EXPNUM = 2

Commande 35

EXPNUM = 1

Modle export
SOH

Commande 36

EXPNUM = 6

EXPORT = 9

La commande 34
est exporte
[C]EXPORT = 10

3.1 Import / Export

Imports et exports chronologiques

Exploitation / Import/export / Export

Il est conseill de mettre un # dans le fichier utilis pour les exports chronologiques :

Le # est remplac par le numro de chrono format sur 8 caractres avec des
zros

En import :

Si un # est dtect dans le nom du fichier, on importe tous les fichiers


correspondant cette rgle de nommage, dans lordre croissant des numros.

Ainsi, deux fichiers exports successivement seront imports dans lordre


chronologique dextraction

3.1 Import / Export


Paramtrage / Exploitation / Enchanements
Exploitation / Imports/Exports / Imports enchans -- Exports enchans

Enchanements dimport /exports

Un enchanement est une srie d'imports ou d'exports enchans lexcution :


Ceci est utile notamment lorsqu'un processus d'import ou d'export doit se
servir de plusieurs fichiers.
L'excution d'un enchanement est gre par le serveur batch.
Lorsqu'on excute un enchanement d'exports avec gestion chronologique, le
numro de squence est incrment une seule fois. L'enchanement utilise
un seul numro de squence, ce qui garantit la cohrence de lensemble.

3.2 Gestion des tats


Principes de base

Le dictionnaire des tats

Lancement des tats

Affectation des codes internes

Valeurs par dfaut des paramtres

3.2 Gestion des tats


Dveloppement / Traitements / Etats / Dictionnaire des tats

Gestion des tats : principes de base


Les tats sont :
Dfinis laide du gnrateur dtats Crystal ReportsTM (fichiers
dextension .rpt )
Rpertoris dans un dictionnaire dtats qui pointe sur un tat et
rfrence en outre leurs paramtres

Les tats sont tlchargs depuis le serveur, puis excuts :


Directement sur le poste client via une librairie (DLL) Crystal Reports
Sur un serveur dimpression quand ltat est lanc depuis un poste Web
Sur un serveur dimpression quand ltat est lanc depuis une tche
batch
Un serveur dimpression est un serveur Windows sur lequel sont installs,
outre des composants ADONIX, les librairies Crystal Reports idoines.

3.2 Gestion des tats


Dveloppement / Traitements / Etats / Dictionnaire des tats

Le dictionnaire des tats


Cest une fonction situe dans le dveloppement

!
Il est donc ncessaire, lorsquon cre de nouveaux tats :
De respecter des rgles de nommage (noms commenant par X, Y, ou Z)
De marquer ces tats par un code activit spcifique
De mme, il faut, si on modifie des tats standards :
Renommer les fichiers dextension .rpt
Modifier la fiche de ltat pour le faire pointer sur ltat modifi
Certains champ du dictionnaire des tats sont considrs comme du
paramtrage
Leur modification est sauvegarde
Il ne faut donc pas utiliser de code activit si seules ces champs sont
modifis

3.2 Gestion des tats


Dveloppement / Traitements / Etats / Dictionnaire des tats

Le dictionnaire des tats : Premier onglet


Les zones encadres sont
des paramtres (prennes)
Groupe dtats
Menu local 97 (personnalisable)
Permet de grer des habilitations
Gestion des langues
Chaque fichier .rpt est stock dans un
rpertoire dpendant de la langue
Rgles daffectation des sorties

Traitements prliminaires
Excuts avant ltat
Permet dalimenter un fichier
temporaire que lon imprime
Association aux fichiers .rpt
1 5 tats peuvent tre enchans
(paramtres identiques obligatoires)
Rgles daccs et de lancement
Non excutable signifie pas en direct
depuis la fonction dimpression

3.2 Gestion des tats


Dveloppement / Traitements / Etats / Dictionnaire des tats

Le dictionnaire des tats : Deuxime onglet


On dfinit les paramtres et leurs caractristiques (type de donnes, valeurs
par dfaut, contrles).

3.2 Gestion des tats

Lancement dun tat : cran


On saisit :
les paramtres de lancement

La destination si elle est rpertorie


dans la table des destinations
sinon, on saisit la destination
et le chemin de limprimante :

le format si on cre un fichier


des lments complmentaires

Impressions / Impressions

3.2 Gestion des tats


Impressions / Impressions
Fichier / Impression ou Fichier / Liste depuis la gestion dobjet

Lancement des tats : cinmatique


Impression automatique
Impressions / Impressions
Fonction X3

Fichier / Impression
Code interne tat

Impressions /
Impression/groupe

Fichier / Liste
Objet X3
Langue de
connexion
FRA

Dveloppement/Dictionnaire traitements/Etats/Codes impression


Rgle dassociation dun code interne un ou plusieurs
codes tats : si plusieurs, on donne le choix lexcution
Si aucune indirection, code tat = code interne

Code tat

Dveloppement/Dictionnaire traitements/Etats/Valeurs par dfaut


Dfinition contextuelle par des formules de valeurs par
dfaut pour les paramtres de ltat

Lancement de
ltat Crystal
Reports

3.2 Gestion des tats


Dveloppement/Dictionnaire traitements/Etats/Codes impression

Affectation des codes internes des tats


Affectation multiple :
Choix limpression

Affectation simple :
Indirection
Pas de ligne prsente :

Le code de ltat est


utilis

3.2 Gestion des tats


Dveloppement/Dictionnaire traitements/Etats/Valeurs par dfaut

Valeurs par dfaut des paramtres dtats


!

Cest une fonction situe dans le dveloppement qui permet :


De donner des valeurs par dfaut contextuelles quand un tat donn est
appel depuis une fonction donne
En labsence de telle rgle, les valeurs par dfaut donnes dans le
dictionnaire des tats sappliquent.

3.3 Gestion des destinations dtats


Paramtrage / Destinations / Destinations

La table des destinations permet de dfinir des destinations de sortie dtats:

supposes partageables entre les utilisateurs (chemin rseau accessible)

avec un type discriminant vis vis des tats

utilisables comme valeur par


dfaut

Elle nempche pas lutilisation,

au lancement de ltat,
dune imprimante non rpertorie
par le choix classique dune
imprimante sous Windows TM
Code daccs
Sil est renseign, lutilisateur doit avoir les droits
dexcution pour utiliser limprimante
Serveur
Si on passe par un serveur dimpression
Type dimprimante
Menu local 22 (intituls modifiables)
Le premier type est un type par dfaut

3.3 Gestion des destinations dtats


Serveurs ddition
Les serveurs dditions correspondent des serveurs :

accessibles par le rseau


sur lequel un run-time adonix et Crystal Reports a t install

Les serveurs dditions sont dfinis par le biais de la console de


configuration.

3.3 Gestion des destinations dtats


Paramtrage / Imprimantes / Imprimantes par utilisateur

Affectation des destinations


2

Dfinition de ltat
(code, destination par dfaut,
formule complment)

Destinations par utilisateur


(Etat, Complment) Destination

Fiche utilisateur
Imprimantes utilisateur
(le code utilisateur
par dfaut)

3
1

3.4 Portail utilisateur


Paramtrage / Portail / Pages du portail

Portail utilisateur
Un portail correspond au contenu de lcran ADONIX X3 prsent lutilisateur :

Lors de sa connexion en client-serveur

En cliquant sur longlet Portail en mode Web

Caractristiques principales

Permet de prsenter des pages HTML, des donnes mises en forme par des
composants standard (graphes flash, tableaux de prsentation, calendriers)

De faon personnalise
Par utilisateur ou groupe dutilisateur
En tenant compte du contexte de connexion
En rutilisant des fonctions dextractions standard du progiciel

Avec des zooms sur les fiches lies aux donnes prsentes

3.4 Portail utilisateur


Paramtrage / Portail / Pages du portail

Portail utilisateur
Issu dun paramtrage de pages portail :

Identifies par un code

Associes lutilisateur par le paramtre

PTLPAGE
Chaque page dfinit :

Une organisation (en 1, 2, 3 ou 4 cadres)

Chaque cadre contient :


Soit une page Web

Soit une vue de portail qui associe :


une source de donnes
(logique dextraction des donnes)
un composant visuel
(mode de prsentation)

3.4 Portail utilisateur


Paramtrage / Portail / Vues du portail

Vue du Portail : sources de donnes

Une source de donnes identifie la faon dont les donnes sont extraites

Elle est dfinie par des codes normaliss (table diverse 90)

Certains codes correspondent des fonctions dexploitation accessibles


par ailleurs :
REQ : Requte (paramtre par le requteur ou le requteur SQL)
STA : Statistique (paramtrage des statistiques)

Dautres sont plus particulires


AGD : Agenda du CRM
MLT : multi-liste (ensemble de listes de gauche dobjets)
TRT : traitement normalis dextraction (identifi par un code action)
WEB : page http dont ladresse est value au moment de lexcution

3.4 Portail utilisateur


Paramtrage / Portail / Vues du portail

Vue du Portail : sources de donnes


Outre le code identifiant la source, on a des paramtres complmentaires :

dpendant du type de source de donnes

saisis dans un tableau sous forme de formule (dpendant du contexte)

Les paramtres source sont les suivants :

Source REQ :
Frquence de mise jour (horaire, journalire, lutilisation)
Niveau de rupture pour la prsentation des donnes (1 N)

Source TRT :
4 paramtres de type chane de caractres banaliss (P1 P4)

Source WEB
Adresse (paramtre URL)

3.4 Portail utilisateur


Paramtrage / Portail / Vues du portail

Vue du Portail : sources de donnes


Paramtres source (suite) :

Source STA :
Codes socit et site pour filtre
Dates de dbut et de fin (priode 1 et 2)
Critres fixs (CRIT1 CRIT8). Le premier
critre gal la chaine vide dtermine le
niveau de zoom de la statistique

Source MLT :
Pas de paramtre complmentaire (on
saisit le code de la multi-liste)

Source AGD :
Nombre de mois avant et aprs la date
courante

3.4 Portail utilisateur


Paramtrage / Portail / Vues du portail

Vue du Portail : Composants visuels


Les composants visuels :

sont dfinis par un code dans la table


diverse 91

correspondent des composants


mmes de prsenter linformation

ne sont pas compatibles avec toutes les


sources de donnes

peuvent ncessiter des paramtres


complmentaires

3.4 Portail utilisateur


Paramtrage / Portail / Pages du portail

Portail utilisateur et habilitations


Le portail, lorsquil sexcute, utilise la fonction APTLREQ :

Cette fonction doit donc tre autorise pour le profil de lutilisateur

faute de quoi un message derreur saffichera, et le portail ne sera pas


visible.

Les zooms vers les objets, lorsquils sexcutent, utilisent la fonction APTLOBJ :

Cette fonction doit donc tre autorise pour le profil de lutilisateur

faute de quoi un message derreur saffichera, et les zooms ne seront pas


activs.

3.5 Gestion des styles

Styles de prsentation

Paramtres / Paramtres gnraux / Styles / Styles de prsentation

Permet de dfinir des mises en valeurs particulires dans les crans

Polices particulires

Couleur et couleur de fond

Tailles de caractres

Effets (gras, italique, soulign, barr)

De faon fixe, contextuelle, ou gnrique


Les styles utiliss sont

Identifis par un code

Sont modifiables par paramtrage par groupes dutilisateurs

Affects par paramtrage ou dveloppement aux lments mettre en valeur

3.5 Gestion des styles


Paramtres / Paramtres gnraux / Styles / Styles de prsentation

Dfinition dun style de prsentation


Un style de prsentation se dfinit par

Un code et des intituls

La dfinition en elle-mme

La saisie peut se faire par un assistant

3.5 Gestion des styles


Paramtres / Paramtres gnraux / Styles / Styles de prsentation

Utilisation dun style de prsentation


Utilisation des styles :

Pour les titres (via le dictionnaire)

des champs

des blocs dans les crans

Pour les valeurs de champs dans les crans :

De faon statique

De faon dynamique par la fonction de mise en valeur

Dans certains crans (tableaux de bord comptables)

De faon gnrique pour mettre en vidence certaines caractristiques (en


permettant de marquer les titres, les valeurs, et en distinguant les champs en liste et
les champs en tableaux) :

Champ obligatoire

Prsence dune fentre de slection

Prsence dun tunnel

Saisie dune formule de calcul

3.5 Gestion des styles


Paramtres / Paramtres gnraux / Styles / Styles personnaliss

Dfinition dun style personnalis


Un style personnalis permet dassocier des effets particuliers :

pour les styles de prsentation prcdemment dfinis

pour un code de personnalisation donn

On peut associer aux utilisateurs un code de personnalisation donn :

par le biais du paramtre utilisateur STYLE

par dfaut (paramtre non renseign), on utilise les effets associs au style de
prsentation standard

3.5 Gestion des styles

Styles conditionnels

Paramtres / Paramtres gnraux / Styles / Styles conditionnels

Permet de dfinir des styles sur la valeur du champ uniquement :

Par une liste


De conditions
De styles associs

La premire condition remplie dtermine le style utilis.

Si la dernire ligne na pas de condition, elle est utilise si les autres


conditions ne sont pas remplies.

3.5 Gestion des styles


Paramtres / Paramtres gnraux / Styles / Personnalisation crans

Affectation de styles conditionnels


Se fait par affectation dun style conditionnel un cran :

De faon prenne (respect en cas de mise jour)

Par simple rappel de lcran dans la fonction ddie

3.6 Personnalisation du vocabulaire


Paramtres / Paramtres gnraux / Personnalisation vocabulaire

Gestion du vocabulaire li au dictionnaire


Le dictionnaire utilise des textes traduisibles stocks dans :

la table APLSTD (menus locaux)

la table ATEXTE (textes crans)

DOSSIER DE REFERENCE

Ils sont :

Menus locaux
(APLSTD)

fournis en standard

remis jour chaque installation de version (sauf


menus locaux modifiables par lutilisateur)

Textes
traduisibles
(ATEXTE)

PROCESSUS DE
VALIDATION

Ecrits en dur dans la description des crans et


Copie
Copie des menus
des textes
fentres lors de leur validation.
locaux non modifiables
DOSSIER DEXPLOITATION
La gestion du vocabulaire stocke dans une table ddie :

Des valeurs de menus locaux

Des textes

Ces textes remplacent le


contenu dAPLSTD et ATEXTE

Vocabulaire
(AVOCAB)

Copie du
vocabulaire
personnalis

Menus locaux
(APLSTD)

Textes
traduisibles
(ATEXTE)

Gnration
de linterface

3.6 Personnalisation du vocabulaire


Paramtres / Paramtres gnraux / Personnalisation vocabulaire

Gestion du vocabulaire li au dictionnaire


On saisit dans lcran :

Le type (message ou texte) et la cl (chapitre/numro ou numro)

Le texte modifi

On dispose de deux outils de recherche de textes :

Par clic droit sur la ligne, pour recharger un ensemble de textes

Par clic doit sur le champ (choix dun texte)

La recherche est indpendante de la casse (majuscule/minuscule/accents)

3.7 Le serveur batch


Exploitation / Serveur batch /

Caractristiques du serveur batch :

Cest un processus fonctionnant en arrire-plan sur le serveur de


traitement, qui gre le lancement de tches batch correspondant
des traitements X3 ou des commandes OS.

Il est gr par une dossier spcial ddi, appel SERVX3.

Les tches soumises au serveur batch s'appellent des requtes. Elles


sont lances par le serveur sous forme de processus Adonix en
arrire-plan.

Mise en service du serveur :


au lancement du systme :
adonix -a -l lang SERVX3
partir d'X3 : Exploitation / Serveur batch / Activation serveur
automatiquement la connexion d'un utilisateur (paramtre DEMSRV).

Arrt du serveur :
partir d'X3 : Exploitation / Serveur batch / Dsactivation serveur
en crant un fichier stop dans le rpertoire FIL du dossier SERVX3
en arrtant la base (pour une sauvegarde par exemple)

3.7 Le serveur batch


Exploitation / Serveur batch /

Principes de fonctionnement
Le serveur batch fonctionne par "polling" :

Interrogation priodique de la table des requtes soumises.


Lorsque l'heure de dmarrage d'une requte est arrive ou dpasse,
la requte est lance (sauf si elle est trop en retard, ou si le nombre
maximum de tches simultanment en cours est dpass).
Lorsque le temps maximum (time-out) dexcution allou une tche
est dpass, la tche est interrompue.
Trace du
serveur
DOSSIER DEXPLOITATION
DOSSIER SERVX3
Processus
batch

Lancement

Interruption (time-out,
demande darrt)

Trace du
processus

Serveur Batch
(processus SERVX3)
Abonnements
Polling priodique

?
Soumission

Session
utilisateur

Soumission par
dpose de fichier

Table des
requtes
(ABATRQT)

3.7 Le serveur batch


Principes de fonctionnement

Exploitation / Serveur batch /

Une requte est une demande dexcution dune ou plusieurs tches


soumises au serveur :

Par la fonction de soumission des requtes


Exploitation / Serveur batch / Soumission des requtes.

Directement depuis la fonction de surveillance des requtes par clic


droit sur le tableau des requtes
Exploitation / Serveur batch / Gestion des requtes.

Par dpose dun fichier dans un rpertoire du serveur de traitement


Peut tre pilot par un automate externe

Par le biais d'un abonnement, c'est dire une requte lancer


priodiquement
Exploitation / Serveur batch / Gestion des abonnements.

Mensuel, Hebdomadaire, en frquence

3.7 Le serveur batch


Dfinition dune tche

Exploitation /serveur batch/ Gestion des tches


Si la tche est active au-del de cette dure, elle est
arrte.

Si la tche na pas pu tre lance au del de ce dlai,


elle ne sera pas lance.
Niveau minimal que doit avoir l'utilisateur pour
lancer la tche (paramtrage utilisateur)
Paramtre transmis au systme dexploitation

Numro de service (le service adonix par dfaut)


Table dfinissant les horaires admissibles
Ce flag signifie que la tche peut tre lance dans un
dossier sur les donnes dun autre (ceci suppose quelle
ait t crite pour le permettre)
La tche ne pourra tre lance que si aucun autre
utilisateur nest connect sur le dossier

Une tche est dfinie en spcifiant une fonction ou un traitement X3, ou un script
(shellscript sous UNIX, script Windows).

Pour une impression d'tat en batch, le traitement est BATCHIMP.

Les fonctions normalises selon le modle traitement peuvent tre lances.

3.7 Le serveur batch


Exploitation / Serveur batch / Groupe de tches

Dfinition dun groupe de tches

Cest une suite de tches excutes en squence

En cas derreur grave dans une tche, les suivantes ne sont pas lances

Chaque tche cre sa propre trace

A la saisie dune requte sur le groupe, tous les paramtres des tches
lies sont saisis

Niveau minimal que doit avoir


l'utilisateur pour lancer le groupe de
tches (paramtre utilisateur)

Table dfinissant les horaires


admissibles

Liste des tches enchaner

3.7 Le serveur batch

Contraintes horaires

Paramtrage / Exploitation / Contraintes horaires


Paramtrage / Exploitation / Calendrier dexclusion

Dfinit les horaires admissibles pour lancer une tche batch

Associ une tche ou un groupe de tches

Deux types de jours : ouvrs, et non ouvrs / fris, chacun avec des
plages horaires possibles

3.7 Le serveur batch

Dfinition dun abonnement

Exploitation / Serveur batch / Gestion des abonnements

Cest une tche ou un groupe de tches excuts de faon rgulire :

Avec une priodicit variable


(hebdomadaire, mensuelle)

A heures fixes ou en frquence


dans une plage horaire

A la cration dun abonnement,


les paramtres doivent tre saisis.
Dfinition du contexte dexcution :
Dossier, utilisateur, groupe ou tche lancer
Base priodique de lancement
Calendrier dexcution
Base hebdomadaire :
Liste des jours de dclenchement

Base mensuelle :
1 5 Quantimes de dclenchement
Flag Fin de mois

Horaires de lancement :
Soit 1 3 heures
Soit une frquence entre deux horaires
Flag excution force
La tche est excute au moins une fois par jour, mme si lhoraire est dpass

3.7 Le serveur batch


Soumission dune requte

Exploitation / Serveur batch / Soumission des requtes

La soumission dune requte se fait par saisie :

du dossier o elle doit tre excute


du code utilisateur
de la tche ou du groupe
de lheure demande dexcution

La fentre de saisie des paramtres souvre alors

3.7 Le serveur batch


Surveillance des tches

Exploitation / Serveur batch / Gestion des requtes

La gestion des tches permet de surveiller et de modifier les


requtes en attente et les tches en cours d'excution ou
termines.
Il est possible d'en visualiser les diffrents fichiers traces, de
soumettre une nouvelle requte, de supprimer une requte en
attente ou d'en modifier les paramtres etc.

3.7 Le serveur batch


Exploitation / Serveur batch /

Soumission de tche par fichier

Permet le dclenchement de tches par des processus externes

Soumis autorisation :
Globale (Paramtrage / Exploitation / Paramtres du serveur batch)
Par utilisateur (paramtre EXTBATCH)

requete.mod

Gestion des tches

serveur batch
Soumission de tche

requete.job
requete.req
requete.old

Prise en compte
par le serveur batch
Lancement de la tche

requete.run
requete.sta
requete.kil

Fin de tche
Demande dinterruption

3.7 Le serveur batch


Exploitation / Serveur batch /

Soumission de tche par fichier


Le fichier de statut (requete.sta) est normalis pour faciliter
lexploitation :
Une ligne de longueur fixe, codage ascii 7 bits, sparateur entre deux
champs (le : ), Fin de ligne : CR/LF ou LF selon le systme
Statut normalis sur 5 chiffres FSXXX, avec :

F=0 : fin normale, SXXX=nombre davertissements


F=1 : fin sur erreur de traitement, S=sous-cas, XXX=dtails
F=2 : traitement non lanc, S=sous-cas, XXX=dtails
F=3 : traitement interrompu, S=sous-cas

5 chiffres

8 chiffres

date/heure

date/heure

10 car

5 car

10 car

80 caractres

No statut

No requte

Dbut

Fin

Dossier

Utilisateur

Tche

Message final

Le fichier de trace du serveur utilise la mme prsentation


La trace dtaille est dans un fichier nomm RQTnnnnnnnn.tra
(nnnnnnnn=no requte sur 8 caractres)

Note :

date/heure

correspond AAAAMMJJhhmmss

3.7 Le serveur batch


Paramtrage / Exploitation / Paramtres serveur batch

Paramtres du serveur batch

Temps entre deux scrutations

Temps pour scrutation time-out

Influe sur le temps d'arrt d'une tche trop


longue.
La scrutation time-out est consommatrice de
ressources.

Retard maxi pour lancer une requte

Dfinit le temps entre deux lectures


successives de la table des requtes.
Influe sur le dlai de prise en compte d'une
requte, et inversement sur la charge du
systme.
Influe sur le temps d'entre dans la fonction de
surveillance des tches.

Evite un lancement tardif si la requte na pas


pu tre lance temps (trop de tches en
cours, serveur arrt)

Nombre maximum de requtes en cours

Le maximum dpend de la licence

3.7 Le serveur batch


Exploitation / Serveur batch /

Les fichiers stratgiques du serveur


Ils sont situs sur le serveur dapplication :
Dans le rpertoire SERVX3/FIL :
la prsence dun fichier .run indique normalement que le serveur est
en fonctionnement (sauf arrt intempestif)
la prsence dun fichier .stop indique quune demande darrt a t
transmise au serveur (mais que les tches lances par le serveur ne
doivent pas tre interrompues)
la prsence dun fichier .kill indique quune demande darrt a t
transmise au serveur (avec demande dinterruption des tches
lances)

Dans le rpertoire SERVX3/TRA :


le fichier serveur.tra contient la trace du serveur
les fichiers RQTnnnnnnnn.tra contiennent la trace des tches

3.7 Le serveur batch


Trace dtaille dune requte

Exploitation / Serveur batch /

Chaque requte gnre un fichier de trace dtaill :


Nomm RQTnnnnnnnn.tra (nnnnnnnn = no requte sur 8
caractres)
Cod en UTF8, avec un en-tte normalis
Contenant des lignes de texte sous lun des formats suivants :
<NNNN> Texte
Texte

Le prfixe <NNNN> permet une mise en vidence en lecture de


trace :
NNNN<0 avertissement
NNNN>0 erreur

3.7 Le serveur batch


Exploitation / Serveur batch / Tche comptabilit

La tche batch comptable


La tche comptable est un cas particulier de tche batch :

elle a pour code ACCBATCH

elle doit tre lance en permanence dans chaque dossier d'exploitation

elle met jour les critures comptables


cres depuis les autres modules
(ventes, achats, stocks,
gestion de production, immobilisations,
comptabilit tiers, comptabilit gnrale)

On ne peut lancer qu'une seule tche


comptable par dossier.
Elle possde une fonction de surveillance
particulire

3.7 Le serveur batch


Exploitation / Serveur batch / Tche comptabilit

Fonctionnement de la tche comptable


Pices temporaires (en attente)

Mvt. de
stock

Facture

Abonnement

compta

Interface comptable

Avoir

Pices finales

En-tte de
pices
(GACCTMP)

En-tte de
pices
(GACCENTRY)

Lignes
dcriture
(GACCTMPD)

Lignes
dcriture
(GACCENTRYD)

Tche batch
comptable

Lignes
analytiques
(GACCTMPA)
Lettrages
en attente
(MTCBATCH)

Balances
(BALANCE,
BALANA)

Lignes
analytiques
(GACCTMPA)
chances
(GACCDUDATE)

4. Administration

1- Gnralits

1.1 Dfinition du superviseur


1.2 Rappels sur larchitecture
technique
1.3 Organisation des fonctions
1.4 Paramtrage et dveloppement
1.5 Socits et sites

2- Paramtrages de base

2.1 Introduction aux formules Adonix


2.2 Paramtres de base
2.3 Workflow
2.4 Paramtrages des fonctions

3- Exploitation

3.1 Imports et exports


3.2 Gestion des tats
3.3 Destinations dimpression
3.4 Portail utilisateur
3.5 Gestion des styles
3.6 Personnalisation du vocabulaire
3.7 Le serveur batch

4- Administration

4.1 Gestion des dossiers


4.2 Epuration et historisation
4.3 Gestion de patches et de version
4.4 Gestion des sessions
4.5 Utilitaires

5- Introduction au dveloppement
5.1 Prennisation et codes activits
5.2 Tables et index
5.3 Types de donnes : menus
locaux,
tables diverses
5.4 Ecrans et fentres
5.5 Nouveaux paramtres
5.6 Fonctionnement de base dun
objet

4.1 Gestion des dossiers


Dfinition dun dossier

Paramtrage / Paramtres gnraux / Dossiers

Un dossier ADONIX X3 :

stocke un rfrentiel (paramtrage, dveloppement


spcifiques)

gre des donnes (statiques, mouvements)


DOSSIER
Rgles
Paramtres
Dictionnaires
Dev. spcifiques
Donnes
Mouvements

Habilitations, signatures, lgislation comptable


Structures de socits, paramtres gnraux, dimensions
Tables, crans, objets, tats
Traitements, crans spcifiques
Clients, comptes gnraux, fournisseurs
Factures, Commandes, Ecritures

4.1 Gestion des dossiers


Dfinition dun dossier
Au niveau technique, un dossier est compos :

dun user au niveau base de donnes,


auquel sont rattachs :

des tables stockant les paramtres et les donnes


dindex, de squences

dun rpertoire situ sur le serveur dapplication


contenant, dans des sous-rpertoires :

des descriptions dcrans et de fentres


la description externe des tables de la base
du code excutable par le moteur
des tats Crystal Reports

DEMO
BPARTNER

table
Adonix.DEMO.BPARTNER

Utilisateur
final
Authentification X3:
Code User X3 = "JEANDUPONT"

Authentification SQL:
Code user = "DEMO"

Paramtrage / Paramtres gnraux / Dossiers

4.1 Gestion des dossiers


Paramtrage / Paramtres gnraux / Dossiers

Un dossier est cr en rfrence un autre dossier qui :

Existe sur le mme serveur


Contient tous les modules dsirs
Devient le dossier de rfrence pour le dossier cr
Peut tre X3 (par dfaut)

ARCHITECTURE TROIS NIVEAUX

X3

Hritage

Hritage

Hritage

X3

ARCHITECTURE 2 NIVEAUX

TEST
FINAL

Dossier
test/prototype

Dossier
d'exploitation

FINAL
Outils de copie - Patches

Dossier
d'exploitation

Hritage

TEST

Dossier
test/prototype

4.1 Gestion des dossiers


Dossier et hritage
X3

Concrtement, l'hritage consiste en deux points :


Lorsqu'un dossier est cr partir d'un dossier mre, il hrite de
certaines de ses donnes :
TEST
Les dictionnaires, qui dcrivent la structure des tables, des
crans et d'autres objets d'X3.
Certaines donnes techniques (Menus locaux par exemple).
FINAL
Dans certains cas, lorsqu'un dossier ne trouve pas un lment dans
ses propres rpertoires, il les recherchera dans les rpertoires de
son dossier mre, et ainsi de suite.
X3
Ceci est vrai notamment pour les traitements standard, pour
les tats (fichiers Crystal Report) et pour certaines tables
TEST
que l'on trouve uniquement dans le dossier X3 (tables du
serveur batch, par exemple).
FINAL Ceci permet tous les dossiers d'un environnement d'exhiber le
mme comportement standard, tout en ayant des modifications
spcifiques appartenant chacun d'entre eux individuellement.
Il est par ailleurs possible, la cration dun dossier, de reprendre des
donnes issues dun dossier de copie qui nest pas son dossier mre.

4.1 Gestion des dossiers


Paramtrage / Paramtres gnraux / Dossiers

Les dossiers standards


A linstallation, 3 dossiers sont livrs :
X3 est le dossier de rfrence qui contient :
la description de toutes les tables standard
une partie seulement des tables (les tables stockant des
paramtres)
tout le code standard livr (programmes, crans, fentres)
un jeu de paramtres de rfrence relatif une lgislation donne
certaines tables communes (notamment la table des dossiers)

DEMO est un dossier de dmonstration complet


SERVX3 est un dossier technique qui gre le serveur
batch

4.1 Gestion des dossiers


Paramtrage / Paramtres gnraux / Dossiers

La fiche dossier
Un dossier est dabord dcrit par une fiche dossier stocke dans le dossier
X3 :

Elle permet de dfinir les paramtres de base du dossier

Sa validation va provoquer la cration du dossier, cest--dire :

Crer les rpertoires du dossier sur le serveur.


Crer un user dans la base de donnes.
Ajouter une ligne dans le fichier de configuration des dossiers (x3appli.ini).
Transfrer et valider le dictionnaire des objets partir du dossier de rfrence.
Copier certaines donnes de base partir du dossier de copie.

Sa revalidation va permettre de :
Mettre jour le dictionnaire des objets partir du dossier de rfrence (en
protgeant les lments spcifiques).
Revalider les dictionnaires (tables, crans, objets)

Un changement de version passe par une revalidation des dossiers.

4.1 Gestion des dossiers


La fiche dossier onglet Gnral

Paramtrage / Paramtres gnraux / Dossiers

Caractristiques gnrales :

Base de donnes utilise

Taille de la base

Codage (UNICODE)

Caractristiques propres
chaque base

Dossier de rfrence

Dossier utilis pour les copies


de donnes

Dossier historis (pour info)

Date de dbut 1er exercice

Modules utiliss

Indicateurs Test et Spcifique

Longueur des codes des tables


diverses

4.1 Gestion des dossiers


Paramtrage / Paramtres gnraux / Dossiers

La fiche dossier et les codes activit

Les codes activit sont des codes sur trois caractres, affects des lments
des dictionnaires X3 pour les activer, les dsactiver ou les dimensionner.

Les codes activit peuvent tre de 4 types :

Les codes activit d'un dossier donn sont stocks dans la table ADOSACT dans
le dossier X3, et dans la table ACTIV dans le dossier mme.

Options classiques : Activation/Dsactivation d'un lment du dictionnaire selon que le code


soit actif ou inactif.
Localisations : Mme utilisation que les options, mais ces options sont spcifiques une
lgislation donne. Ils commencent gnralement par la lettre K.
Dimensionnement : Ces codes possdent une dimension et sont affects des champs ou
des tableaux (crans dimensionns) pour en dfinir les dimensions maximales.
Spcifiques: Codes activit affects aux lments spcifiques pour les protger. Ils doivent
imprativement commencer par X, Y ou Z.

partir d'X3 : Dossiers / Dossiers.


partir du dossier fille : Dveloppement / Dictionnaire donnes / Codes activit

On retrouve, dans diffrents onglets de la fiche Dossier, des valeurs de code


activit renseigner.

4.1 Gestion des dossiers


Paramtrage / Paramtres gnraux / Dossiers

La fiche dossier onglets Options


Il permet dactiver ou de
dsactiver des codes
activit qui dfinissent des
champs et fonctions
optionnelles du progiciel :

Dune part les options

Dautre part les


localisations.

4.1 Gestion des dossiers


Paramtrage / Paramtres gnraux / Dossiers

La fiche dossier onglet Ecrans


Il permet dactiver ou de
dsactiver des codes
activit qui dfinissent les
dimensionnements dcrans
du progiciel :

La plupart sont un
nombre maximum de
lignes dans un document

Certaines structurent la
base de donnes (nombre
daxes analytiques, de
montants statistiques)

4.1 Gestion des dossiers


Paramtrage / Paramtres gnraux / Dossiers

La fiche dossier onglet Tables

Les paramtres de dimensionnement permettent X3 de calculer la taille de chaque


table de la base de donnes et la taille physique globale.
Les tailles individuelles des tables peuvent tre modifies tout moment.
La taille physique totale est dfinie la cration du dossier uniquement.

Les paramtres de dimensionnement saisis dans la fiche dossier sont utiliss dans des
formules de dimensionnement. Les paramtres et les formules sont modifiables
dans le dictionnaire de donnes (en dveloppement).

Taille de GACCENTRYA:

Taille de la table des enttes de pices comptables:


On considre qu'il y a en moyenne :
2,5 lignes d'critures par entte
1,5 lignes de dtail analytique par ligne dcriture.

Table GACCENTRYA
[dtail analytique]

arr(VOUCHER*1.5,100)
= 1500 fiches.
Taille de GACCENTRYD:

Table GACCENTRYD
[lignes dcritures]

VOUCHER
= 1000 fiches.

VOUCHER = 1000
Nombre d'critures comptables conserver

Table GACCENTRY
[en-tte de pices]

Taille de GACCENTRY:
arr(VOUCHER/2.5, 100)
= 400 fiches.

4.1 Gestion des dossiers


La fiche dossier onglet Tables

Paramtrage / Paramtres gnraux / Dossiers

On saisit dans cet onglet la valeur des variables (telles VOUCHER) :

Ces variables sont utilises pour dimensionner chaque table

La fonction Options / Taille calcule alors la taille globale de la base

4.1 Gestion des dossiers


La fiche dossier onglet Init

Paramtrage / Paramtres gnraux / Dossiers

Cet onglet permet de paramtrer :

Un transfert de donnes dun


dossier de copie vers le dossier
la premire validation (ou au
rajout
dun
module
dont
dpendent les donnes copies)

Les langues dans lesquelles le


dossier va tre accessible en
connexion

La
devise
de
reporting,
commune toutes les socits
du dossier

Des valeurs par dfaut (langue,


pays)

Un forage des validations de


transaction

4.1 Gestion des dossiers


Paramtrage / Paramtres gnraux / Dossiers

La fiche dossier onglet Connexion

Ces informations
correspondent la bote de
connexion du client X3. la
validation (ou revalidation) du
dossier, elles sont reportes
dans le fichier x3appli.ini afin
d'tre ventuellement
tlcharges sur les diffrents
postes clients.

4.1 Gestion des dossiers


Paramtrage / Paramtres gnraux / Dossiers

La fiche dossier onglet Spcifiques


On dfinit ici les activations de paramtres spcifiques :
Actif (Oui/Non)
ou en dimension selon les cas

Lindicateur Vertical signifie que le spcifique est dfini dans un dossier


intermdiaire et est remis jour chaque revalidation de dossier partir du
dossier de rfrence

4.1 Gestion des dossiers


La fiche dossier onglet Divers

Paramtrage / Paramtres gnraux / Dossiers

On dfinit ici des paramtres techniques dont les valeurs (sauf exception) ne
doivent pas tre modifies :

elles sont stockes dans le fichier apl.ini qui initialise certaines


variables X3.

la validation (ou revalidation) du dossier, le fichier apl.ini est mis


jour avec ces valeurs.

4.1 Gestion des dossiers


Gestion des dossiers

Paramtrage / Paramtres gnraux / Dossiers

La revalidation dun dossier permet de :

Mettre jour une version (les modifications du standard vont tre


appliques, des traitements complmentaires de mise jour
automatiquement appliqus si ncessaire)

Tranfrer les dveloppements verticaux dun dossier de


dveloppement vers un dossier qui en dpend

Il est important de tours vrifier la trace de dernire validation !


Dans une architecture 3 niveaux, pour appliquer des volutions standard :

On revalide toujours le dossier intermdiaire dabord

Puis on remet jour le dossier de plus bas niveau

Limport dun dossier permet de :

Crer la fiche dun dossier partir dune arborescence existante

Normalement, ceci est fait aprs la restauration dun dossier dans un


environnement ou il nexistait pas

4.2 Epuration et historisation


Exploitation / Historisation/Epuration

Les fonctions d'puration ou dhistorisation traitent les donnes :

De type mouvement uniquement (on npure ou on narchive pas


les clients ou les articles, mais les factures, les commandes, les
critures)

Dfinies sous la forme de groupes de tables lies.


Satisfaisant certaines conditions de cohrence (formules
d'puration) fournies en standard mais modifiables en spcifique.

Ayant atteint ou dpass une priode de conservation prdfinie


(paramtres d'puration et darchivage).
Les fonctions dhistorisation :
Supposent la cration dun dossier dans lequel les donnes
archives vont tre stockes.
Se dfinissent par groupe de tables.

4.2 Epuration et historisation


Dveloppement / Utilitaires / Dossier / Cration dossier historis

Cration dun dossier dhistorisation

Un dossier historis est un dossier particulier, associ au dossier


dexploitation, qui se dfinit par :

Un nom (HDOSSIER par dfaut).

Des paramtres de taille globale.

Des paramtres base de donnes.

Un coefficient exprimant la taille


des tables historises par rapport
aux tailles des tables dorigine.

Un profil menu, donnant accs


des fonctions de consultation, qui
sera le profil par dfaut quand on
entrera dans ce dossier.

4.2 Epuration et historisation


Principes de base

Exploitation / Historisation/Epuration

Lhistorisation transfre dfinitivement les donnes archivables (ie. rpondant aux


critres) dates de plus de N1 jours ou mois dans le dossier archive

Lpuration pure dfinitivement les donnes non archivables dates de plus de N1


jours ou mois, et les donnes archives dates de plus de N2 jours ou mois
DOSSIER
DEXPLOITATION

DOSSIER
DARCHIVAGE

Groupe de tables
archivable
archivage

Groupe de tables
non archivable

puration

4.2 Epuration et historisation


Dfinition des rgles

Dveloppement / Dictionnaire de donnes / Historisation/puration

Ces rgles sont fournies en standard dans le progiciel, leur modification


relve de dveloppement spcifique.

On associe un code :

Un groupe de tables lies

Des formules qui doivent tre vrifies pour que lpuration soit
possible

Des informations
socit/site,
et date de rfrence

Un traitement de
contrle standard,
personnalisable par
un traitement spcifique
complmentaire

4.2 Epuration et historisation


Paramtrage / Exploitation / Paramtres purations

Paramtres dpuration / historisation


On dfinit, pour chaque groupe de donnes :

Si on pure et/ou si on historise

La dure minimale (en jours)


de conservation des donnes

La frquence de lancement
pour le groupe
(ie. le nombre minimum de
jours attendre depuis la
dernire puration ou
historisation)

La date de lancement de la
dernire opration est affiche

4.2 Epuration et historisation


Exploitation /Historisation / puration

Lancement de lhistorisation/puration

Cette fonction peut tre lance en direct et en batch (tche AHISTO)


Les paramtres saisir sont :

Le groupe de tables concern

Lopration dsire
(historisation, puration,
ou les deux)

Une slection socit

Un flag simulation (seule une


trace de ce qui serait trait
est alors cre)

Un flag dtail (sil est actif,


la liste dtaill des cls des lignes purges est crite dans la trace)

4.2 Epuration et historisation


[ Connexion au dossier dhistorisation ]

Visualisation des donnes historises

La visualisation se fait en se connectant sur le dossier historis

Les donnes accessibles sont :

Les donnes historises sur les tables historises (les donnes non
historises ne sont pas visibles)

Les donnes prsentes dans le dossier dexploitation sur toutes les


tables non historises (par hritage)

DOSSIER DEXPLOITATION

DOSSIER DARCHIVAGE

Connexion au dossier archive

accs direct
accs direct
hritage
hritage

4.3 Gestion de patches et de version

Gestion des versions


Les versions sont numrots sur 3 chiffres X.Y.Z :

X = gnration majeure (1 pour le moment)

Y = version majeure (0,1,2,3,4)

Z = sous-version

Historique des versions ce jour :

100 : version alpha, 12/1998

110 : premire version officielle, 06/1999

120 : premire version distribue, 04/2000 (120 126)

130 : premire version Web, 06/2001 (130 138)

140 : dernire version majeure, 09/2004

4.3 Gestion de patches et de version

Passage dune version une autre


Passage de version X.Y1 X.Y2 : utilisation dun support (CD)
Mise jour des clients (si ncessaire)
Mise jour du serveur X3 et des serveurs Web (si ncessaire)
Revalidation de dossier obligatoire
Pas de passage en rel sans test et validation prliminaire

Passage de version X.Y.Z1 X.Y.Z2


Soit par installation de CD et revalidation (comme ci-dessus)
Soit par installation de patches conscutifs

4.3 Gestion de patches et de version


Dveloppement / Utilitaires / Patch /

Passage de patches
Un patch est un fichier darchives :

Numrot partir du dbut dune version majeure (X.Y) de 1 N

Contenant une correction ou mise jour consistante : code


applicatif, description de structure de donnes, donnes, voire demande
dexcution dun utilitaire

Installable par une fonction trs simple dadministration

Pour plus de facilit, les patches sont organises en listes

Numrotes partir du dbut dune version majeure (X.Y) de 1 M

Une version mineure correspond une liste de patches donne

Ces dpendances sont visibles dans un fichier nomm X3PATCHXY0,


livr avec toute liste de patches

4.3 Gestion de patches et de version


Dveloppement / Utilitaires / Patch /

Exemple de la version 130


Contenu du fichier X3PATCHV130.htm

4.3 Gestion de patches et de version


Dveloppement / Utilitaires / Patch / Intgration de patch

Les limites du passage de patches


Les patches ne permettent pas de remettre jour :

Les donnes de paramtrage situes dans le dossier de rfrence X3

Le moteur install sur le poste client (une procdure ninstallant que une
nouvelle version de moteur existe)

Le moteur du serveur (mme remarque)

Le moteur du serveur Web (mme remarque)

Laide en ligne (elle peut tre installe indpendamment du reste)

Les patches doivent tre installs squentiellement :

Un patch suppose que les prcdents aient t installs

Mais il est possible dinstaller une version intermdiaire quand on est


trs en amont du numro de patch en cours

4.3 Gestion de patches et de version


Dveloppement / Utilitaires / Patch / Intgration de patch

Les prcautions prendre


Il est bon de lire attentivement le fichier X3PATCHVxxx

Il prcise les points particuliers (changement de structure pouvant ncessiter de


la place disque, par exemple)

Il est hautement recommand dtre le seul connect sur le dossier patcher :

Cest obligatoire si une table change de structure

Cest prfrable dans les autres cas (pour viter une persistance de code en
mmoire)

Dans certains cas, on doit quitter la session avant de passer une autre liste de
patches

Si des spcifiques ont t raliss, il est conseill :

Dutiliser le testeur de patches pour vrifier dventuels conflits

De tester les spcifiques sur lesquels des conflits potentiels ont t dtecter

4.3 Gestion de patches et de version


Le testeur de patches

Dveloppement / Utilitaires / Patch /Test de patch

Il permet de vrifier les conflits potentiels lors de linstallation de patches :

Traitement standard ou tat standard dupliqu dans un dossier patch et


prsent dans le patch

Prsence de spcifique sur un des


lments patchs (le programme
signale ce qui a t protg par
un code activit spcifique)

Il peut tre utilis pour linstallation


dune nouvelle version mineure :

des fichiers List_nn.dat prsents


sur le rpertoire X3Patch du CD
dune version permettent de
raliser le test sur les listes de
patch quivalant au passage de version

4.3 Gestion de patches et de version


Quels dossiers patcher ?

Dveloppement / Utilitaires / Patch / Intgration de patch

Un patch sinstalle dossier par dossier :

Lorsquon veut tester un patch, on peut linstaller sur un dossier de test ddi
( paramtre Dossier de test gal Oui )

Lorsque linstallation est dfinitive, il doit tre install la fois sur le dossier
X3 et les dossiers dexploitation

On peut choisir dintgrer un


fichier unique ou lensemble
des fichiers contenus dans un
rpertoire (cest le cas dune liste)

En ne cochant pas la case


Intgration de patch, on lit le
contenu des fichiers de patch

Liste des dossiers patcher

4.3 Gestion de patches et de version


Consultation de patches

Dveloppement / Utilitaires / Patch / Consultation de patch

Cette fonction permet de voir les patches dj passs sur un dossier donn :
Cl (numrotation automatique)

Nom complet du fichier


Le prfixe PX est caractristique
des patches standards sur X3

Numro de maintenance
Utilis, prfixe gal, pour le
contrle de squentialit

Numro de liste de patch

4.4 Gestion des sessions


Dfinition dune session X3
Une connexion ADONIX X3 provoque louverture dune session :

identifie de faon unique pour un serveur dapplication donn

dun type donn

Les types de connexion sont les suivants :

Session primaire (connexion classique dun utilisateur,


depuis un poste en client-serveur ou en Web)

Session secondaire ouverte partir dune session primaire :


Par Fichier / Nouvelle session
Par un raccourci clavier (Shift F5 Shift F12,
paramtrable par utilisateur)

Session batch (dclenche par le serveur batch)

Session ADAPI (appel une API ADONIX)

4.4 Gestion des sessions


Dveloppement / Utilitaires / Divers / Visu licence

Contrle des sessions X3


La licence dfinit le nombre
maximum de sessions possibles
par type :

La licence est dfinie par


le fichier serial_adonix
install dans le rpertoire
.serialisation sur le serveur
dapplication

Elle dfinit aussi des limites


fonctionnelles lies la
licence (cadre de droite)

4.4 Gestion des sessions


Contrle des sessions autorises
Il est possible de contrler le nombre de sessions ouvertes :

Pour un utilisateur donn, par les paramtres utilisateur MAXSES1 (nombre maxi de sessions
primaires) et MAXSES2 (nombre maxi de sessions secondaires)

Globalement, en passant un dossier en mode mono-utilisateur (personne dautre ne peut


alors se connecter)

Pour un type de profil menu donn dans un dossier donn (paramtres USR1, USR2, USR3)

Il est possible de provoquer une dconnexion automatique dun utilisateur :

En cas dinactivit clavier/souris au bout de TIMEHGUP1 ou TIMHEHGUP3 secondes (valeur


de paramtres utilisateurs pour sessions primaires / secondaires)

Avec un avertissement et un dlai de grce de TIMEHGUP2 secondes (idem)

Si ces paramtres sont nuls, il ny a pas de dconnexion automatique

4.4 Gestion des sessions


Dveloppement / Utilitaires / Divers / Surveillance utilisateurs

Visualisation des sessions en cours

Cette fonction permet de :

Visualiser les connexions en cours (tableau suprieur) sur un serveur


dapplication et un service donn (machine:service)

Visualiser les processus correspondants et les interrompre si on est


habilit

4.5 Utilitaires
Dveloppement / Utilitaires /

Des utilitaires divers sont fournis :


!

Ils font pour la plupart partie du dveloppement


Ils peuvent avoir des incidences sur la cohrence de la base ou du dossier
Ils sont donc manipuler avec prcaution :

Maintenance (mode fiche, maintenance en colonne, transactions systme)

Vrifications (Infos version, Vrif cohrence, Symboles et traitements verrouills)

Utilitaires dictionnaire (copies, gnration et validations, comparaisons)

Remise zro dossier

Gestion mono/multi, dverrouillage

Recherches

Extraction / Intgration

Optimisations de la base (Etat des tables, Recherche index, Analyse mmos,


Optimisation base de donnes)

4.5 Utilitaires
Dveloppement / Utilitaires /

Maintenance :
Ces outils permettent d'accder aux donnes contenues dans la
base X3 :
sans aucune forme de contrle
Maintenance en lignes : Accs aux enregistrements d'une table un par un.
Maintenance en colonnes : Accs aux enregistrements sous forme de
tableaux.
Transaction systme : Mise jour massive des donnes dune table

ces fonctions sont des outils dangereux qui ne doivent tre


rservs qu' l'installateur du logiciel !

4.5 Utilitaires
Dveloppement / Utilitaires / Maintenance

Les crans de maintenance

4.5 Utilitaires
Dveloppement / Utilitaires / Maintenance en colonnes

Les crans de maintenance en colonnes

4.5 Utilitaires
Dveloppement / Dictionnaire traitements / Transactions systme

Transactions systme : dfinition


Les transactions systme sont utilises pour
effectuer des mises jour en masse de la base de
donnes (cration, modification ou suppression de
lignes), partir d'une transaction dfinie dans le
dictionnaire des traitements.
Paramtres saisir au lancement :
-Intitul
-Type de donnes
-Valeur par dfaut
-Table de contrle

Tables lies et cl de lien


Table principale mise jour
Formules de slection
Pouvant faire appel aux valeurs de paramtres (V1,V2,V3)
Description des mises jour
(Cration, mise jour de champs, suppression)

4.5 Utilitaires
Dveloppement / Utilitaires / Divers / Transactions systme

Transactions systme : utilisation

Code transaction excuter

En mode test, on peut dfinir le nombre


de transactions simuler

Valeurs de paramtres utiliser

4.5 Utilitaires
Dveloppement / Utilitaires / Vrification

Infos version :
Cette fonction donne les numros de version :

du moteur sur le serveur

du superviseur

de lapplicatif

La version du client est obtenue partir


du menu principal du poste client :

4.5 Utilitaires
Dveloppement / Utilitaires / Vrifications / Vrif cohrence

Verification de cohrence :
Cet utilitaire parcourt toutes les tables du dictionnaire
et vrifie l'intgrit rfrentielle des liens (existence
des enregistrements lis pour chaque ligne de la table).

La description de la base est parfois imparfaite, ce


qui peut provoquer de fausses erreurs.

L'excution de cet utilitaire peut tre trs longue : il est conseill


d'utiliser les bornes de tables et/ou de limiter par module.

4.5 Utilitaires
Dveloppement / Utilitaires /

Symboles et traitements verrouills :


X3 utilise des verrous applicatifs :

Pour des oprations longues hors transaction

Utiliss par les objets est en modification de


fiche (temps de saisie important)

Erreur et symbole de verrouillage :

Stocks dans la table APLLCK

A ne pas confondre avec le verrouillage induit par des


transactions, gr par la base de donnes (row level locking),
dure limite par le temps de la transaction (aucun temps
dattente utilisateur)

X3 utilise des verrous fichiers (TRAITEMENT.LCKsrc):

Pour verrouiller des fichiers en cours


ddition (dveloppement)

Erreur et symbole de verrouillage :

4.5 Utilitaires
Dveloppement / Utilitaires / Vrifications / Symboles verrouills

Symboles verrouills :

Dveloppement / Utilitaires / Vrifications / Traitements verrouills

Un zoom est possible de cette fonction vers la gestion des sessions

Traitements verrouills :

Une suppression du verrou est possible (par clic droit)

4.5 Utilitaires
Utilitaires dictionnaire :

Dveloppement / Utilitaires / Dictionnaire / Validation


Dveloppement / Utilitaires / Dictionnaire / Copie dictionnaire

Ces outils permettent de raliser


les oprations suivantes :

Validation d'objets

Copie d'lments d'un dossier vers un


autre

4.5 Utilitaires
Dveloppement / Utilitaires / Dictionnaire / Diffrence dobjets

Utilitaires dictionnaire (suite) :


Ces outils permettent de
raliser
les oprations suivantes :

Comparaison dobjets
gnrant une trace plus ou
moins dtaille

4.5 Utilitaires
Dveloppement / Utilitaires / Dictionnaire / Gnration de transactions
Dveloppement / Utilitaires / Dictionnaire / Copie de transactions

Utilitaires dictionnaire (suite) :


Ces outils permettent de raliser
les oprations suivantes :

Gnration du code associ aux


transactions applicatives paramtrables

Copie de transactions applicatives


paramtrables vers un autre dossier

4.5 Utilitaires
Dveloppement / Utilitaires / Dictionnaire / Validation des fonctions
Dveloppement / Utilitaires / Dictionnaire / MAJ menus locaux
Dveloppement / Utilitaires / Dictionnaire / Copie de traitements

Utilitaires dictionnaire (suite) :


Ces outils permettent de raliser les oprations suivantes :

Validation des fonctions : permet de mettre jour la


table croise d'habilitation sites / fonctions / profils.

Mise jour des menus locaux : Permet d'exporter les


fichiers de menus locaux dans les rpertoires de
publication (client/serveur et web).

Copie de traitement : transfre un traitement (et sa


description dans le dictionnaire des traitements)
dun dossier lautre

4.5 Utilitaires

Utilitaires dossiers :

Dveloppement / Utilitaires / Dossiers / Changement de dossier


Dveloppement / Utilitaires / Dossiers / Remise zro dossier

Changement de dossier : permet une reconnexion sur un autre


dossier

Remise zro dossier


Cet utilitaire remet zro les mouvements dans
la base de donnes, sans remettre zro les
donnes permanentes.
Attention, utilitaire irrversible !
Les mouvements sont identifis dans le dictionnaire :
Une table marque Raz est vide
Un champ marqu Raz reoit une valeur nulle
Les compteurs marqus Raz sont remis zro

Utile en cas de dmarrage rel aprs un dmarrage test, par exemple

4.5 Utilitaires

Utilitaires dossiers (suite) :

Dveloppement / Utilitaires / Dossiers / Dverrou dossier


Dveloppement / Utilitaires / Dossiers / Import dossier
Dveloppement / Utilitaires / Dossiers / Mode mono
Dveloppement / Utilitaires / Dossiers / Mode multi

Dverrou dossier : supprime le verrou empchant la


connexion un dossier lors de sa revalidation de
dossier (ce verrou peut rester en place en cas
darrt brutal lors dune revalidation)

Import dossier : cre la fiche Dossier partir dun


fichier se trouvant dans le rpertoire du dossier (utile
en cas de transport dun dossier dun serveur un
autre, correspond litem de menu Option / Importer
en gestion de dossier)

Passage en mode mono : Cet utilitaire met le dossier


dans un mode o :

Un seul utilisateur peut tre connect la fois


Cet utilisateur a forcment le profil fonction de ladministrateur

Passage en mode multi : sortie du mode monoutilisateur

4.5 Utilitaires
Dveloppement / Utilitaires / Recherche

Utilitaires de recherche :
Ces utilitaires permettent de rechercher des lments de
dveloppement dans les dictionnaires dADONIX X3 :
Codes activit (dans les tables, crans, fentres, objets qui
composent un dossier)

Types de donnes (dans les crans, tables)


Codes daccs (dans les crans et les autres tables)
Messages (dans la base de donnes des messages traduisibles)

Textes (Rfrences croises de lutilisation des textes dans les


lments du dictionnaire)

4.5 Utilitaires
Dveloppement / Utilitaires / Sauvegarde /

Utilitaires de sauvegarde :
Ces utilitaires permettent dextraire ou dintgrer des donnes :

A partir ou vers des fichiers (4 6 par table) ayant un format plat

Sous un format indpendant de la base de donnes

Sous un format indpendant du systme dexploitation

Transportables par simple copie

Ce ne sont pas des outils normaux dexploitation :

Ils font des extractions table par table sans garantir de cohrence globale si des
modifications ont t faites entre temps, la base devant rester active

Ils nont pas les performances des procdures de sauvegarde fournies avec les
bases de donnes

Ils sont par contre utilisables en maintenance :

Notamment pour transfrer des donne dune base une autre

Mais aussi pour transmettre des donnes la hot-line ADONIX

4.5 Utilitaires
Dveloppement / Utilitaires / Extraction / Intgration

Utilitaires de sauvegarde :
Chaque table est extraite ou intgre partir de 4 6 fichiers :

TABLE.srf : description ascii de la structure de la table

TABLE.fde : description compile de la structure de la table

TABLE.dat : donnes de la table ranges plat

TABLE.seq : valeur de squence rattache la table

TABLE.blb : donnes de type blobs ou clobs (images, textes) stocks dans la


table (sil y en a)

TABLE.cfg : configuration de la table dans la base de donnes si elle existe

Lextraction ou lintgration se fait dans ou depuis un rpertoire :

du serveur dapplication

qui doit forcment tre sur le mme volume que le rpertoire du dossier

qui est par dfaut le rpertoire SVG

4.5 Utilitaires
Dveloppement / Utilitaires / Extraction / Intgration

Utilitaire dextraction de donnes :


Paramtres dextraction :

Dossier, table(s) exporter (sous la forme de modle de nom), et rpertoire de


sauvegarde

Indicateurs :

Copie du fichier .cfg (Oui/Non)

Taille relle dans srf

Ce dernier indicateur permet :

de stocker dans les fichiers .fde et .srf


la taille relle de la table au moment
de lextraction (pas sa taille prvue)

de remonter les donnes dans un


environnement dimensionn au plus
juste

4.5 Utilitaires
Dveloppement / Utilitaires / Extraction / Intgration

Utilitaire dintgration de donnes :


Paramtres dextraction :

Dossier, table(s) exporter (sous la forme de modle de nom), et rpertoire de


sauvegarde, et deux indicateurs

Indicateur Fichiers de config dorigine

Permet dignorer le fichier .cfg prsent


dans le rpertoire de sauvegarde

Utile par exemple pour remonter dans un


environnement dexploitation correctement
dimensionn des donnes issues dun
environnement de test et de reprise

Indicateur Taille dorigine

Permet dignorer la taille prsente dans


le fichier .srf au profit de celle de la table
dorigine (si elle existait avant intgration)

4.5 Utilitaires
Utilitaires doptimisation de base :
ADONIX X3 cre automatiquement la base de donnes en :

Dimensionnant les tables partir dune taille prvue lorigine

Tenant compte de fichiers de configuration

Crant les index ncessaires un fonctionnement normal

Mais, dans le temps, les performances peuvent tre affectes :

Par une volution de la volumtrie diffrente de ce qui tait prvu

Par lutilisation de slections mmorises sur des tables importantes

Par la mise en place de filtres rle sur des tables importantes

Par des incidents dexploitation (non cration dun index standard)

Des outils de diagnostic et de paramtrage vont permettre dy remdier

4.5 Utilitaires
Dveloppement / Utilitaires / Vrifications / Etat des tables

Etat des tables :


Cet outil permet de vrifier les caractristiques de chaque table de la base

Permet de constater si des tables ont t mal dimensionnes

4.5 Utilitaires
Recherche des index :

Dveloppement / Utilitaires / Vrifications / Recherche index

Le dictionnaire des tables dcrit des index dont ADONIX X3 se sert frquemment :

Ils dfinissent des ordres de recherche et des critres de slection privilgis

Ils sont utiliss par les programmes standard

A lexcution des requtes :

La base reoit les critres de slection et de tri

Elle se sert des index sils existent rellement

Mais est tout de mme capable de rpondre la requte si les index nexistent pas au
dtriment de la charge machine et des temps de rponse

Il arrive que des index soient dclars, mais non crs :

Si une revalidation de la table na pas t faite

Si un incident (pas assez de place sur un tablespace) empche leur cration

Cet utilitaire permet de vrifier si les index sont bien prsents

4.5 Utilitaires
Dveloppement / Utilitaires / Vrifications / Analyse mmos

Analyse des mmos :


En gestion dobjet, il est possible de crer des slections mmorises :

Sur des tables importantes

Portant sur des champs non indexs

Parfois partage par un ensemble dutilisateurs

A lexcution les requtes lies sont :

Lourdes (pas dindex, table importante)

Frquente ( chaque affichage ou rafrachissement


de liste gauche, dautant plus frquente si le mmo
est partag et/ou standard)

Loutil danalyse de mmos va donner une liste des problmes rencontrs


On peut agir en amont :

Le paramtre SELWARN dfinit un nombre de lignes limite dans une table.

Au dessus de ce nombre de lignes, lenregistrement dune slection non performante est


refus ou provoque un avertissement selon la valeur du paramtre AUZMEMO

4.5 Utilitaires
Paramtrage / Exploitation / Optimisation base de donnes

Optimisation base de donnes :


Des filtrages de donnes peuvent tre dfinis par paramtrage sur des tables
importantes :

Par des slections mmorises

Par des filtres

Par lutilisation de codes daccs

Les requtes lies peuvent tre dautant plus lourdes :

Quelles sont frquemment lances

Quaucun index standard nest adapt pour leur optimisation

On peut alors crer des index supplmentaires dans la base :

Activables ou dsactivables la demande

Sur des champs indics (ce qui est impossible dans le standard)

4.5 Utilitaires
Paramtrage / Exploitation / Optimisation base de donnes

Optimisation base de donnes :


Des index doptimisation
standard sont livrs :

Lis aux filtres par rles

Sur certaines consultations


(en fonctions des axes
analytiques souvent utiliss)

Pour optimiser certaines


oprations (suppressions,
purations)

Rgle de nommage : SPE_*

On peut en crer autant que


ncessaire

5. Introduction au dveloppement

1- Gnralits

1.1 Dfinition du superviseur


1.2 Rappels sur larchitecture
technique
1.3 Organisation des fonctions
1.4 Paramtrage et dveloppement
1.5 Socits et sites

2- Paramtrages de base

2.1 Introduction aux formules Adonix


2.2 Paramtres de base
2.3 Workflow
2.4 Paramtrages des fonctions

3- Exploitation

3.1 Imports et exports


3.2 Gestion des tats
3.3 Destinations dimpression
3.4 Portail utilisateur
3.5 Gestion des styles
3.6 Personnalisation du vocabulaire
3.7 Le serveur batch

4- Administration

4.1 Gestion des dossiers


4.2 Epuration et historisation
4.3 Gestion de patches et de version
4.4 Gestion des sessions
4.5 Utilitaires

5- Introduction au dveloppement
5.1 Prennisation et codes activits
5.2 Tables et index
5.3 Types de donnes : menus
locaux,
tables diverses
5.4 Ecrans et fentres
5.5 Nouveaux paramtres
5.6 Fonctionnement de base dun
objet

5.1 Prennisation et codes activit


Dveloppement / Dictionnaire donnes / Codes activit

Codes activit : rappels


Un code activit est un code sur 3 caractres :

Dfini dans un dictionnaire

Permettant de rendre optionnel des lments du logiciel

Permettant de signer un spcifique, sil commence par X,Y,ou Z.

Tout dveloppement spcifique doit tre marqu par un code activit :

Sinon, il sera perdu lors dune revalidation de dossier

Mais il doit tre marqu au niveau le plus fin possible


Champ dans un cran plutt que Bloc ou Ecran lui-mme
Champ ou Index dans une table plutt que Table elle-mme

Certains cas particuliers ne ncessitent pas de code activit :

Action SPE ou SPX dans un cran standard

Code action commenant par X, Y ou Z

5.2 Tables et index


Le dictionnaire des tables
Il dcrit la structure de la table :

Sur 3 onglets

Sa validation cre la table dans la


base de donnes

Sa revalidation change la structure


de la table
Champs de la table contenant les intituls des fiches de
la table, utiliss notamment pour les liens.

Permet X3 de dimensionner la table dans la base de


donnes. Si ce chiffre est diffrent de ce qui a t
calcul suite au dimensionnement dans les paramtres
du dossier, la valeur la plus leve sera prise en compte.
Indicateur signalant les tables de mouvement remises zro
en Raz dossier.
Copie de donnes possible du Dossier de copie vers le dossier
cible en cration de dossier (si optionnelle, on prcise le
groupe de copie).

Dveloppement / Dictionnaire donnes / Tables

5.2 Tables et index


Le dictionnaire des tables

Dveloppement / Dictionnaire donnes / Tables

Longlet champ dfinit les champs et leurs caractristiques

Les champs CREDAT, CRETIM,CREUSR, UPDDAT, UPDTIM,UPDUSR


sont automatiquement mis jour par lobjet de gestion associ

5.2 Tables et index


Le dictionnaire des tables

Dveloppement / Dictionnaire donnes / Tables

Longlet index :
dfinit les index de la table (un au moins doit exister)
permet de saisir des directives de configuration

5.3 Types de donnes


Dveloppement / Dictionnaire donnes / Types de donnes

Le dictionnaire des types de donnes


Un type de donnes caractrise les champs prsents

dans les crans

dans les tables

dans les paramtres des tats

Il existe des types gnriques :

A (alpha), C (entier court), D (date), L (entier long), M (menu local), DCB (dcimal)

On leur associe une longueur (A), un numro de menu (M), un nombre de chiffres
et de dcimales sous la forme N.M DCB)

Les autres types sont dfinis :

par rfrence un type interne

en pouvant tre associs un objet (slection, tunnel)

en ncessitant parfois des paramtres

La variable GLONXXX permet de connatre la longueur du champ de type XXX

5.3 Types de donnes


Dveloppement / Dictionnaire donnes / Menus locaux
Dveloppement / Dictionnaire donnes / Paramtrage tables diverses

Les menus locaux et les tables diverses


Les menus locaux correspondent au type M (suivi dun numro) :

Ils sont stocks sur un octet dans une table (valeur 0 255)

Ils sont traduits en fonction de la langue de dialogue

Ils sont tlchargs sur le poste client ou prsents dans la description XML des crans Web

Leur valeur est stocke dans la table APLSTD

Ils peuvent tre dfinis avec un nombre de choix fixe ou variable (entre deux bornes),
modifiables ou non en paramtrage

Il existe des bornes de numrotation pour les spcifiques (1000 2000)

Les tables diverses correspondent au type ADI :

Complt par un numro de table (dfini dans lexpression de lien)

De longueur maximale dfinie dans le paramtrage des tables diverses

Avec des intituls traduisibles

Avec des champs complmentaires et des possibilits de dpendance

Les numros spcifiques sont compris entre 1000 et 2000

5.4 Ecrans et fentres


Le dictionnaire des crans

Dveloppement / Dictionnaire traitements / Ecrans

Un cran X3 est une partie dune fentre du progiciel qui correspond :

un onglet

au contenu dune bote de dialogue

ou len-tte dun objet

Il est organis en blocs placs


comme les cases dun damier

Chaque bloc contient des champs :

en liste

en tableau droulant

en bote de texte

5.4 Ecrans et fentres


Le dictionnaire des crans

Dveloppement / Dictionnaire traitements / Ecrans

Chaque bloc contient une liste de champs ayant des attributs :

Rang dans le bloc (sous forme 1, 2, 3 mais aussi 1.1, 1.2, 1.3)

Intitul

Type de donnes et
informations rattaches
(no de menu, longueur,
objet graphique, tunnel
et zone lien)

Un code activit

Des actions dfinies


dans les tableaux
ci-dessous

5.4 Ecrans et fentres


Le dictionnaire des fentres
Une fentre est la runion dun ensemble :

dcrans

de boutons et de menus

de listes gauches

Dveloppement / Dictionnaire traitements / Fentres

5.5 Dfinition de nouveaux paramtres


Dveloppement / Dictionnaire donnes / Dfinition paramtres

Le dictionnaire des paramtres


Ce dictionnaire permet de dfinir des paramtres :

En les crant dans un chapitre (table diverse numro 901)

En dfinissant leur niveau


de paramtrage le plus fin :
Dossier, Socit, Site, Utilisateur

En leur associant une


variable globale qui sera
automatiquement cre
et renseigne (si le niveau
est Dossier ou Utilisateur).

Lutilisation des variables


globales est alors possible
dans toute formule de calcul.

5.6 Fonctionnement de base dun objet


Dveloppement / Dictionnaire traitements / Objets

Le dictionnaire des objets


Un objet est la description dune fonction de base mme de grer :

Une table principale (et des tables lies)

Par le biais dau moins une


fentre (sil en a plusieurs,
un choix sera propos :
cest ainsi quest ralise la
gestion de transactions)

Cest le modle de base le plus


prsent dans ADONIX X3.

5.6 Fonctionnement de base dun objet


Dveloppement / Dictionnaire traitements / Objets

Le dictionnaire des objets


On retrouve dans la dfinition dun objet :

Des filtres gnriques utilisables lors des appels par tunnel

La dfinition des champs


de la liste gauche

Des informations
complmentaires
pour limport
notamment
(onglet Environnement)

Merci

You might also like