View
311
Download
44
Category
Preview:
Citation preview
www.absyscyborg.com
SUPERVISEUR
SAGE X3 ENTREPRISE V140
Plan général du cours
1- Généralités
1.1 Définition du superviseur 1.2 Rappels sur l’architecture
technique 1.3 Organisation des fonctions 1.4 Paramétrage et développement 1.5 Sociétés et sites
2- Paramétrages de base
2.1 Introduction aux formules Adonix 2.2 Paramètres de base 2.3 Workflow 2.4 Paramétrages des fonctions
3- Exploitation
3.1 Imports et exports 3.2 Gestion des états 3.3 Destinations d’impression 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 développement
5.1 Pérennisation et codes activités 5.2 Tables et index 5.3 Types de données : menus
locaux, tables diverses
5.4 Ecrans et fenêtres 5.5 Nouveaux paramètres 5.6 Fonctionnement de base d’un
objet
1. Généralités
1- Généralités
1.1 Définition du superviseur 1.2 Rappels sur l’architecture
technique 1.3 Organisation des fonctions 1.4 Paramétrage et développement 1.5 Sociétés et sites
2- Paramétrages de base
2.1 Introduction aux formules Adonix 2.2 Paramètres de base 2.3 Workflow 2.4 Paramétrages des fonctions
3- Exploitation
3.1 Imports et exports 3.2 Gestion des états 3.3 Destinations d’impression 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 développement
5.1 Pérennisation et codes activités 5.2 Tables et index 5.3 Types de données : menus
locaux, tables diverses
5.4 Ecrans et fenêtres 5.5 Nouveaux paramètres 5.6 Fonctionnement de base d’un
objet
Code applicatif (modulaire)
Moteur adonix (machine virtuelle)
1.1 Définition du superviseur
Un développement en couchesUn développement en couches
Système d’exploitation
Base de données
Services de base (superviseur)
1.1 Définition du superviseur
Un ensemble de services générauxUn ensemble de services généraux
Services de base (superviseur)Gestion de la base de données et de la configuration
Gestion des utilisateurs et des habilitations
Gestion des restitutions (statistiques, états, interrogations…)
Gestion des paramètres
Gestion des travaux batch
Gestion des mises à jour du logiciel
Outil de développement pour spécifiques
1.2 Rappels sur l’architecture technique
Client Windows
TCP/IP
Serveur X3
• Windows NT/2000/2003• Unix (AIX, HP-UX)• Linux (Red Hat sous Intel)
Windows NT/2000/XP
TCP / IP
TCP
/ IP
Serveur Web
• Windows ou Linux• IIS, ou Apache
Client Web• Windows • IE >= 5.5
Une architecture client/serveur / WebUne architecture client/serveur / Web
Une architecture évolutive en multi-tiersUne architecture évolutive en multi-tiers
LAN / WAN
TCP / IP
Serveurs web
Réseau local
Serveurd’application
Serveurde données
TCP
/ IP
Client Windows
Client Web
Base de données• SQL Server v7/8• Oracle v8/8i/9i
Serveursde traitement
1.2 Rappels sur l’architecture technique
1.2 Rappels sur l’architecture technique
On se connecte sur un dossier ADONIX X3 :
qui utilise un ensemble de modules
qui intègre un référentiel (paramétrage, développement spécifiques) commun
qui gère des données (statiques, mouvements)
On s’identifie comme un utilisateur, ce qui définit, dossier par dossier :
les habilitations
des valeurs par défaut
La langue de connexion peut varier d’un utilisateur à l’autre
Langue de connexionLangue de connexion
Utilisateur dans le Utilisateur dans le dossierdossier
DossierDossier
Des connexions secondaires sont possibles :
à partir d’une session ouverte
sur le même dossier, le même utilisateur, dans la même langue
Deux méthodes :
par Fichier / Session secondaire
par l’appel d’une touche de fonction (Shift F5 à Shift F12) paramétrable par utilisateur
1.2 Rappels sur l’architecture technique
ADONIX X3 est organisé en modules hiérarchiques :
…Chaque module intègre un ensemble de fonctions
Ventes Achats GPAO
Stocks Développement
Tiers
Comptabilité générale
Action commerciale
Superviseur
Tronc commun
Support client
Modulesspécifiques
1.3 Organisation des fonctions
ADONIX X3 est organisé en fonctions appelées :
depuis une ligne de menu
depuis une page HTML (portail, assistants) par le biais d’un lien
depuis une autre fonction (appel en “tunnel” ou en “zoom”)
Les fonctions sont à la base :
de l’habilitation (définition des accès par utilisateur et fonction)
de l’organisation des menus
Une fonction :
est identifiée par un nom [ GFONCTION depuis la calculette ]
peut être vue par une info-bulle depuis le menu
est (le plus souvent) rattachée à un modèle permettant des paramétrages
1.3 Organisation des fonctions
Permettent de rendre génériques :
les paramétrages
l’ergonomie
De 3 types principaux
objets [ GFONCTION = GESXXX ]
consultations [ GFONCTION = CONSXXX ]
traitements [ GFONCTION quelconque ]
1.3 Organisation des fonctions
Le modèle objet
Liste(s)Liste(s) de gauchede gauche
OngletsOnglets
En-tête En-tête
1.3 Organisation des fonctions
Correspond à :
la gestion “standard” (création, modification, consultation, suppression)
d’une table ou d’un ensemble de tables de la base
avec des listes gauches (sélection, picking, liaisons), des possibilités de filtrage, de sélection avancée…
Peut intégrer des variantes :
elles sont nommées des transactions.
elles se caractérisent par des écrans différents (on peut ainsi ne pas tout faire apparaître) et parfois par des règles de gestion différentes
L’objet peut se paramétrer à différents niveaux :
listes gauches (de façon générique)
contenu des onglets (transactions fonctionnelles)
passage à d’autres fonctions (liaisons, navigations, opérations du menu Fichier)
Le modèle objet
1.3 Organisation des fonctions
Onglets de consultationOnglets de consultation
Critères en tête Critères en tête
Fenêtre de critères Fenêtre de critères complémentairescomplémentaires
Le modèle consultation
1.3 Organisation des fonctions
Correspond à :
l’interrogation de données
d’une table ou d’un ensemble de tables de la base
sans mise à jour
avec des critères de sélection en tête d’écran et dans une fenêtre avancée, possibilité de mémorisation…
avec en général des zooms vers le détail
Peut intégrer des variantes :
elles sont nommées des écrans de consultation.
Peut se paramétrer de façon générique :
par le paramétrage des écrans de consultation
Le modèle consultation
1.3 Organisation des fonctions
Exécution du traitement Exécution du traitement
Saisie des critèresSaisie des critères
Affichage de traceAffichage de trace
Le modèle traitement
1.3 Organisation des fonctions
Correspond à :
des traitements de masse
dont l’exécution peut être longue
précédés par une saisie de paramètres mémorisables
lancés en direct ou en batch
Au niveau du paramétrage :
correspond normalement à une tâche standard du serveur batch
Le modèle traitement
1.3 Organisation des fonctions
Beaucoup plus rares
de type “composite” (plan de travail)
complètement atypiques (éditeur de traitement…)
Peu de possibilités de paramétrage sauf des paramétrages génériques de toute fonction :
tables de contrôle, code d’accès, styles conditionnels, changement de vocabulaire
paramètres généraux de configuration associés
l’habilitation par fonction, sous-fonction, filtres sur sites et sociétés…
D’autres modèles…
1.3 Organisation des fonctions
Le paramétrage est pérenne
conservé en changement de version
non modifié par une mise à jour de patches
Le spécifique doit être protégé pour être pérenne
chaque élément modifié doit être marqué par un code activité spécifique.
un patch standard ne modifiera alors pas le spécifique
un patch spécifique peut le modifier
Certaines fonctions résultent d’une combinaison de paramétrage et de développement
Une partie est alors du développement, une autre de la personnalisation
1.4 Paramétrage et développement
Une action de gestion (un « mouvement ») ne peut être effectuée dans X3 sans être rattachée à un site ou à une société, informations structurantes du dossier :
Paramétrage / Structure générale / …
DOSSIERDOSSIER
SOCIÉTÉ C2SOCIÉTÉ C2SOCIÉTÉ C1SOCIÉTÉ C1
SITE FINANCIER F1SITE FINANCIER F1 SITE FINANCIER F2SITE FINANCIER F2 SITE FINANCIER F4SITE FINANCIER F4SITE FINANCIER F3SITE FINANCIER F3
SOCIÉTÉ NON JURIDIQUE NJ1SOCIÉTÉ NON JURIDIQUE NJ1
SITE S2SITE S2 SITE S3SITE S3 SITE S5SITE S5SITE S1SITE S1 SITE S4SITE S4
1.5 Sociétés et sites
Paramétrage / Structure générale / …
Tiers,produits,
etc…
Commandesd’achat
Mouvementsde stock
Piècescomptables
Les sociétés et sites interviennent essentiellement :
dans la définition des paramètres
dans les habilitations et le filtrage des données
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 défaut par module (qui dépendent du profil de l’utilisateur)
Paramétrage / Structure générale / …
Paramétrage / Structure générale / …
1.5 Sociétés et sites
2. Paramétrages de base
1- Généralités
1.1 Définition du superviseur 1.2 Rappels sur l’architecture
technique 1.3 Organisation des fonctions 1.4 Paramétrage et développement 1.5 Sociétés et sites
2- Paramétrages de base
2.1 Introduction aux formules Adonix 2.2 Paramètres de base 2.3 Workflow 2.4 Paramétrages des fonctions
3- Exploitation
3.1 Imports et exports 3.2 Gestion des états 3.3 Destinations d’impression 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 développement
5.1 Pérennisation et codes activités 5.2 Tables et index 5.3 Types de données : menus
locaux, tables diverses
5.4 Ecrans et fenêtres 5.5 Nouveaux paramètres 5.6 Fonctionnement de base d’un
objet
Une formule est une expression calculée pouvant être évaluée, faisant appel à des constantes, des variables, des fonctions Adonix et des opérateurs.
À tout moment dans X3, la calculette peut être lancée pour évaluer une formule se rapportant au contexte.
Les formules sont utilisées dans de nombreux cas de paramétrage
2.1 Introduction aux formules ADONIX
Constantes
Valeur numérique signée ou non
3.1415926
-273
Chaîne de caractères
"Aujourd’hui"
‘Vous avez dit : "Bizarre" …’
Date
[29/05/1959]
Condition
Toute valeur numérique non nulle est considérée comme vraie
(le résultat d’une comparaison renvoie 1 si la comparaison est vraie)
Toute valeur numérique nulle est considérée comme fausse
Formules simples
2.1 Introduction aux formules ADONIX
Opérateurs
numériques
+ - * / ^
Date
Date – date
Date + nombre
Date - nombre
Caractères
Chaine + Chaine
Chaine - Chaine
Niveau de parenthésage illimité
Formules simples
2.1 Introduction aux formules ADONIX
Dépendent d’un contexte d’exécution
Liées à une « classe » définie entre crochets
TYPE DE VARIABLE SYNTAXE A UTILISER EXEMPLES
Valeur d’un champ dans l’enregistrement courant d’une table en
ligne
[F:abv]nom
abv=abréviation de la tablenom=nom du champ
[F:BPC]BPCNUM
Valeur d’un champ d’écran (situé dans un onglet visible ou non)
[M:abv]nom
abv=abréviation de l’écrannom=nom du champ
[M:BPC0]BPCNUM
Variable globale [V]nom
la classe peut être omisele nom commence par G
GNBGAUCHEGUSER
GFONCTIONGOLDETAT
Variables système [S]nom
la classe peut être omisele nom est en minuscules
(mot-clé)
datesystnomapindcum
Variables
2.1 Introduction aux formules ADONIX
Appelable chaque fois qu’une formule de calcul peut être saisie
Permet de retrouver les champs des écrans et des tables
Est normalement lié au contexte
L’éditeur de formules
2.1 Introduction aux formules ADONIX
Certains écrans X3 contiennent des tableaux. Les champs sont alors Certains écrans X3 contiennent des tableaux. Les champs sont alors indicés (ex : factures de vente).indicés (ex : factures de vente).
Note : les indices commencent à 0 (les lignes à 1)Note : les indices commencent à 0 (les lignes à 1)
[M:SIH3]QTY(0)[M:SIH3]QTY(1)
[M:SIH3]QTY(2)
[M:SIH3]QTY(3)
Les tableaux de variables
2.1 Introduction aux formules ADONIX
De nombreuses fonctions sont disponibles pour exprimer des formules
numériques
pi abs(N) mod(N,M) arr(N,N) ar2(N) log(N) exp(N) sin(N) …
val (C) day(D) month(D) year(D) ascii(C) instr(N,C,C) …
dates
date$ addmonth(D,N) eomonth(D) gdat$(N,M,P) …
caractères
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) …
Fonctions
2.1 Introduction aux formules ADONIX
Autres fonctions disponibles pour exprimer des formules
agrégatives
find(X,X…) sum(N…) min(X…) max(X…) avg(N…) prd(N…) uni(X…) …
diverses
sigma(N,N,N) evalue(C) parse(C) filpath(C,C,C,C) …
Fonctions génériques définies par le programmeur
func TRAITEMENT.NOM(X…)
Fonctions “standard” définies dans des traitements standard Adonix X3
func AFNC.ACTIV("CODE") valeur d’un code activité
func AFNC.PARAM("PARAMETRE","SITE") valeur paramètre (sous forme alphanumérique)
func AFNC.PARAMUTIL("PARAMETRE","USER","SITE") valeur paramètre utilisateur (idem)
func AFNC.CONSULT("ACCES") vrai si droit de consultation sur le code accès
func AFNC.MODIF("ACCES") vrai si droit de modification sur le code accès
func AFNC.EXEC("ACCES") vrai si droit d’exécution sur le code accès
func AFNC.TEXTE(NUM) donne le texte en fonction du numéro (dans la langue courante)
func AFNC.TEXTRA("TABLE","CHAMP","CLE1","CLE2") texte traduisible dans une table
Fonctions
2.1 Introduction aux formules ADONIX
Ce sont des paramètres génériques, potentiellement utilisés dans tous les types de fonctions :
Paramètres généraux
Base de paramètres influant sur le comportement de l’environnement ou de fonctions du progiciel
Menus locaux
Tables de choix utilisées dans les « combo-boxes » et les boutons radio
Tables diverses
Tables de codes génériques, associés à une liste de valeur, un intitulé traduisible, et une liste limitée de valeurs associées
Compteurs
Définition de règles de numérotation des documents (mouvements notamment)
2.2 Paramètres de base
Les paramètres généraux sont des valeurs de paramétrage:
Définies dans le dictionnaire des données (Développement)
Organisées en chapitres
Activant ou désactivant une fonctionnalité…
ou conditionnant une décision de traitement dans X3…
ou influant sur le fonctionnement de l’interface
Définies à différents niveaux d’organisation
Visibles (dans certains cas) comme des variables globales
Paramètres généraux
Paramétrage / Paramètres généraux / Valeurs paramètres
2.2 Paramètres de base
Il existe au maximum 4 niveaux de définition :
Chaque paramètre est caractérisé par le niveau de détail le plus fin
La valeur de niveau le plus bas est toujours retenue
Paramétrage / Paramètres généraux / Valeurs paramètres
U
UUtilisateur
Site
Société
Dossier
C
C
S
S
D
D
U S U
U U
S
U
U
Niveau de définition des paramètres
2.2 Paramètres de base
Groupe ADX
DIRPCE1 et DIRPCE2 : répertoire des pièces jointes
Groupe TC (valeurs par défaut)
CHGTYP : type de cours, DEFCUR : devise par défaut…
Groupe SUP
Environnement : TYPMES, SERMES, SERIMP, VIRTDIR
Base de données : ROLLBACK, TIMLCK
Sécurité : PASSWD, PASLNG, NBRCON, CHGPASS
Contrôle des connexions : USR1, USR2…
Paramétrage / Paramètres généraux / Valeurs paramètresParamètres du superviseur
2.2 Paramètres de base
Paramétrage / Paramètres généraux / Valeurs paramètres
Choix du chapitre et du niveau de définition :
• global
• société
• site
Possibilité de reprendrela valeur
« au-dessus »
Saisie des VP
2.2 Paramètres de base
Les menus locaux (messages) sont :
des listes de valeurs ou de libellés traduisibles
groupées par chapitre (numéro de 1 à 9999)
utilisées pour les listes déroulantes, les boutons radio, les cases à cocher
Physiquement, un champ de type menu local stocke le numéro du texte (0-255) plutôt que le texte lui-même.
Paramétrage / Paramètres généraux / Menus locauxLes menus locaux (messages)
2.2 Paramètres de base
Il existe des règles de modification des menus locaux :
Tous ne sont pas modifiables (cela dépend du développeur)
Attention aux insertions ! (les valeurs sont stockées sous forme de rang)
Parfois, un nombre minimum et/ou maximum de choix est autorisé
Une validation est demandée 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)
Paramétrage / Paramètres généraux / Menus locauxLes menus locaux (messages)
2.2 Paramètres de base
Les tables diverses sont :
des petites tables logiques contenant des valeurs diverses comme les codes de taxe, les incoterms, les familles et sous-familles article, client, fournisseur …
identifiées par un numéro (de 1 à 999)
stockées dans une seule table de la base (ATABDIV)
associées à un champ dans une fiche pour permettre d’en contrôler la valeur
Les codes stockés dans la table ont une longueur maximale dépendant du numéro de la table (3 par défaut)
Paramétrage / Paramètres généraux / Tables diverses
Les tables diverses
2.2 Paramètres de base
Chaque enregistrement d’une table diverse est caractérisé par :
un code alphanumérique (caractères majuscules) sur N positions maximum
le code d’une autre table dont l’enregistrement peut dépendre
deux intitulés (long, court) stockés en fonction de la langue (intitulés « traduisibles »)
Jusqu’à 2 champs alphabétiques (ou date) et jusqu’à 2 champs numériques complémentaires, dont le format dépend de la table
Paramétrage / Paramètres généraux / Tables diverses
Les tables diverses
2.2 Paramètres de base
Paramétrage / Paramètres généraux / Tables diverses
Les tables diverses
2.2 Paramètres de base
Cette fonction permet de les règles de dépendance Familles / Sous-familles, les intitulés de la table et la longueur des codes s’ils sont modifiables
Paramétrage / Paramètres généraux / Perso tables diverses
! Le fait que la longueur soit modifiable est « spécifique »Le fait que la longueur soit modifiable est « spécifique »
Il faut protéger par un code activité « spécifique » pour Il faut protéger par un code activité « spécifique » pour pérenniserpérenniser
Par contre, est considéré comme paramétrage (pérenne) la longueur Par contre, est considéré comme paramétrage (pérenne) la longueur du code, la présence de champs supplémentaires, la table de du code, la présence de champs supplémentaires, la table de dépendance.dépendance.
Personnalisation des tables diverses
2.2 Paramètres de base
Les compteurs sont :
des codes associés aux documents du progiciel (factures, commandes, écritures…) ou à des fiches que l’on souhaite numéroter
qui définissent des règles d’attribution d’identifiants (un numéro de facture par exemple)
Caractéristiques des identifiants délivrés par un compteur :
Ils ne sont pas forcément entièrement numériques
Ils sont structurés de façon particulière (en intégrant des segments particuliers dépendant du contexte : l’année, le site…)
Ils intègrent obligatoirement un numéro séquentiel qui peut revenir à zéro de façon périodique, et peut dépendre de la société, du site, ou d’une autre information (complément)
Paramétrage / Paramètres généraux / Compteurs
Les compteurs
2.2 Paramètres de base
Un compteur peut être global, défini au niveau du site ou de la société.
(nombre de séquences gérées)
Fréquence de Remise-A-Zéro : La séquence peut repartir à 1 de façon périodique.
Attention : il faut que l’élément identifiant la période soit présent dans un autre segment, sinon on va créer
des doublons dans les identifiants.
Le tableau des composants
La longueur totale est la somme des longueurs de composants, elle est
limitée à 15 ou 20 caractères)
Case à cocher permettant de vérifier qu’un document daté après un autre
a toujours un numéro de séquence supérieur
Compteur remis à zéro en cas de remise à zéro du dossier ?
Paramétrage / Paramètres généraux / Compteurs
Les compteurs
2.2 Paramètres de base
Compléments et formules
Les compléments définissent segments dépendant du contexte ayant chacun leur numérotation propre :
Les formules permettent d’évaluer une constante sans que la numérotation en dépende
Contexte de numérotation Valeur du complément
Ecriture comptable Journal
Lot article Code article
Règlement Code transaction de règlement
Lot de saisie de règlement Code utilisateur
Quittance factor Code factor
Fiches tarif Code tarif
Paramétrage / Paramètres généraux / Compteurs
Les compteurs
2.2 Paramètres de base
Elle se fait par module et par type de document dans la majorité des cas
Dans certains cas, un numéro manuel est possible
Certaines affectations sont plus complexes
Paramétrage / Paramètres généraux / Affectation des compteurs
Affectation des compteurs
2.2 Paramètres de base
C’est une fonction de maintenance située dans le développement !
Elle permet de modifier le prochain numéro de séquence utilisé
Elle est utile en cas de reprise (après import d’un système antérieur, pour numéroter les pièces suivantes en séquence)
Développement / Utilitaires / Divers / Valeurs des compteurs
!
Valeurs initiales des compteurs
2.2 Paramètres de base
Principes de base
Evénements déclenchants
Ce qui peut être déclenché
Retour de Workflow
Création détaillée d’une règle de Workflow
2.3 Workflow
Paramétrage / Workflow / Règles workflow
Le moteur de Workflow d’ADONIX X3 permet :
à partir d’événements déclenchants divers :
Entrée dans une fonction Action réalisée dans une fonction “objet” Fin de tâche batch Edition Evénements divers
de déclencher un ou plusieurs actions :
Exécution d’un traitement par le biais d’une action Envoi de messages (mails) Enregistrements d’événements dans une table de log
Lorsqu’un mail est envoyé, il est possible de définir l’appel d’une action en retour (par double-clic sur une icône jointe dans le mail)
Principes de base du workflow
Paramétrage / Workflow / Règles workflow
2.3 Workflow
Fonctionnement du moteur de Workflow
Paramétrage / Workflow / Règles workflow
Utilisateur etcontextes courants
Contexte X3
Conditionssupplémentaires
Actions déclenchantes(opérations, boutons)
Code événement
Contexte déclenchant
Type d’événement
1122
Valeurs de retour (si nécessaire)
Action et paramètres de l’action
Condition de déclenchement
Exécution d’une action (traitement)
Définition de l’icône de retour
Liste des destinataires
Options d’envoi
Texte du ou des messagesDéfinition des pièces jointes
Envoi d’un message (e-mail)
Définition des informations àstocker (nature, information)
Stockage d’informations de « log »Table de log
33
TraitementX3
2.3 Workflow
Evénements génériques :
Gestion d’objet
Entrée dans une fonction
Fin ou arrêt de tâche batch
Lancement d’une édition
Evénements divers (connexion, déconnexion, time-out, arrêt processus)
Le contexte peut être précisé :
En donnant le code “en dur” (objet, fonction, tâche batch, état)
En spécifiant des conditions complémentaires (expressions calculées)
En gestion objet, le contexte peut être plus riche :
Opération en cours (Création, Modification, Suppression, Changement de code, Impression, Bouton Workflow)
Exécution d’un bouton associée à la fenêtre (si l’objet est donné en dur)
Evénements déclenchants possibles
Paramétrage / Workflow / Règles workflow
2.3 Workflow
Caractéristiques du traitement :
Normalisé comme une action
défini dans le dictionnaire des actions avec la case Workflow cochée
Sans aucune interaction avec l’écran
puisqu’il peut être déclenché en batch mais avec la possibilité de disposer de variables en retour
Actions disponibles à ce jour :
gestion des liaisons (explorateur de liaison)
actions spécifiques à créer
Déclenchement d’un traitement X3
Paramétrage / Workflow / Règles workflow
2.3 Workflow
Client Windows
Serveur X3
Serveur Web
Client Web
Principes de base du mail via Workflow
Serveur de messagerie
Interface SMTP POP3
Interface MAPI
2.3 Workflow
Les caractéristiques paramétrables du mail sont :
Destinataires
soit connus comme des utilisateurs (adresse e-mail sur la fiche) soit définis comme des tiers avec le type d’interlocuteur si un @ se trouve dans l’adresse, on envoie tel quel Destinataires principaux et/ou en copie
Texte défini sous la forme de lignes avec des expressions
Pièces jointes
chemin fixe sur le serveur d’application défini par une expression pièces jointes à un objet (avec des filtres type/catégorie) fichier trace lié (si tâche batch)
Informations complémentaires :
Présence d’une icône de retour (retour au menu ou fin directe) Accusé de réception
Envoi d’un mail par le Workflow
Paramétrage / Workflow / Règles workflow
2.3 Workflow
Eléments stockés dans la table de log (AWRKLOG) :
Date, heure, utilisateur.
5 éléments (couples) du type Nature / Information (table diverse 50).
Évènement, type d'opération, code objet, clé…
Flag Message pour indiquer si un e-mail a été envoyé ou non.
Visualisation par le Workflow monitor ( Exploitation / Moniteur Workflow )
Mise à jour d’une table de log Paramétrage / Workflow / Règles workflow
2.3 Workflow
Paramétrage détaillé Paramétrage / Workflow / Règles workflowOnglet Général
Code catégorie, rattaché à la table diverse 51 (informatif)
Type d’événement:• Entrée fonction• Objet• Edition Etat• Fin tâche batch• Arrêt tâche batch• Divers
Code événement(s’il est vide, il s’agit d’un événement générique)
Conditions liées au contexte
Opérations déclenchantes
et / ou Boutons déclenchants
(dans un contexte Objet )
Evénements déclenchés et Options
2.3 Workflow
Paramétrage détaillé : assistant de formuleParamétrage / Workflow / Règles workflow
On dispose d’un contexte en ligne si l’événement est spécifié :
En contexte objet Table (valeurs avant modification) Ecrans (valeurs après modification)
En contexte état : les paramètres de lancement
En contexte tâche batch : l’écran saisie
des paramètres
Dans tous les cas : la table des utilisateurs
AUTILIS
2.3 Workflow
Paramétrage détaillé Paramétrage / Workflow / Règles workflow
Onglet Actions
Code action à déclencher(Pas d’action à lancer si vide)C’est ici une action spécifique
Tableau des paramètres :Ici, on a
deux paramètres en entréedeux paramètres en sortie
Informations sur le retour par mail :Possible Icône de retour cochée
Retour au menu ou fin après exécution
Fonction de retour(fonction appelante par défaut)et clé de lien(si la fonction est de type objet)
2.3 Workflow
Paramétrage détaillé Paramétrage / Workflow / Règles workflowOnglet Message
Tableau des destinataires, sous la forme -d’une adresse « en dur » avec @
- d’un couple (code tiers, fonction)- d’un code interne utilisateur
Au moins un des destinataires doit avoir Non dans la colonne
Texte évalué du message
2.3 Workflow
Paramétrage détaillé Paramétrage / Workflow / Règles workflowOnglets Pièces jointes et Traçabilité
Pièce jointe(chemin d’accès évalué)
Indicateur Fichier trace lié(pour tâches batch)
Définition des pièces jointes à envoyer(dans un contexte objet uniquement)
Tableau des informations du moniteur Workflow :Nature = Table diverse numéro 50
2.3 Workflow
Les modèles de fonctions induisent des paramétrages particuliers :
Modèle ObjetPropriétés
Personnalisation
Liaisons automatiques
Navigation
Transactions
Modèle consultationParamétrage des écrans
Tout modèle utilisant des écransTables de contrôle
Affectation de codes d’accès (pour rappel)
2.4 Paramétrage des fonctions
En gestion d’objet, Fichier / Propriétés permet d’accéder :
A des informations liées à la valeur courante de la fichePar défaut, on trouve les informations suivantes
(si elles existent) :
Paramétrage des objets : PropriétésParamétrage / Paramètres généraux / Propriétés objets sous menu Fichier
Ces informations calculées étant Ces informations calculées étant paramétrables, en intégrant :paramétrables, en intégrant : des fonctions des constantes des champs de la table principale Des champs de tables liées déclarées
dans un tableau
Cette information est aussi disponible par F11 sur toute zone de clé liée à Cette information est aussi disponible par F11 sur toute zone de clé liée à un objetun objet
2.4 Paramétrage des fonctions
Il est possible de paramétrer un ensemble de caractéristiques de l’objet :
Paramétrage des objets : Personnalisation
Paramétrage / Paramètres généraux / Personnalisation objet
Les caractéristiques de la liste gauche :Index de tri (le premier de la table par défaut)
Sens (ascendant ou descendant)Gestion en liste hiérarchisée
(si plusieurs composantes dans la clé)
Les colonnes présentes dans la liste gaucheTable (principale ou liée)
Champ ou expression (type et variable associée)Intitulé de la colonne
Etats appelés par :Fichier / Impression
Fichier / Liste
Accès direct par zoom aux statistiques( Appel par Fichier / Statistiques)
Affichage de la liste des derniers lus
2.4 Paramétrage des fonctions
Sur le second onglet, on paramètre les autres listes de gauche standard
Paramétrage des objets : Personnalisation
Paramétrage / Paramètres généraux / Personnalisation objet
Présence de l’explorateur de liaisons
Intitulé des liensvers l’objet paramétré
Présence de l’ongletDerniers lus
Paramétrage des liaisons automatiques :Objet à partir duquel le lien part
Expression permettant de connaître sa cléCode liaison
Tableau si liens multiples(l’expression de lien dépend alors de indice)
2.4 Paramétrage des fonctions
Gestion des objets : Navigation
Développement / Dictionnaire traitements / Navigation
C’est une fonction située dans le développementC’est une fonction située dans le développement
Des navigations standard sont fournies (essentiellement pour la Des navigations standard sont fournies (essentiellement pour la CRM)CRM)
Toute modification et toute création de nouvelle navigation doit Toute modification et toute création de nouvelle navigation doit être signée par un code activité spécifique (commençant par X, être signée par un code activité spécifique (commençant par X, Y, ou Z)Y, ou Z)
Elle suppose une bonne connaissance du contexte d’exécutionElle suppose une bonne connaissance du contexte d’exécution
Elle peut produire des dysfonctionnements dans l’objet modifié Elle peut produire des dysfonctionnements dans l’objet modifié si la définition est mal faitesi la définition est mal faite
Néanmoins :Néanmoins :
Elle a la facilité de mise en oeuvre d’un paramétrageElle a la facilité de mise en oeuvre d’un paramétrage
!
2.4 Paramétrage des fonctions
Navigation : principes de base
Développement / Dictionnaire traitements / Navigation
Une fonction X3 dispose Une fonction X3 dispose dede
possibilités de possibilités de navigationnavigation
vers d’autres fonctions vers d’autres fonctions
Via Via l’explorateur l’explorateur de liaisonsde liaisons
Via des menus Via des menus dans la barre dans la barre
d’outilsd’outils
Par tunnelPar tunnel
Via des Via des boutonsboutons
Quand la fonction arrivanteQuand la fonction arrivante
est un objet, on peut vouloirest un objet, on peut vouloir
tenir compte du contextetenir compte du contexte
appelant pour :appelant pour :
Proposer des valeurs Proposer des valeurs par défaut en créationpar défaut en création
Imposer des filtres de Imposer des filtres de sélectionsélection
2.4 Paramétrage des fonctions
Sur le premier onglet, on paramètre les filtres sur l’objet
Navigation : définition détaillée
Paramétrage / Paramètres généraux / Personnalisation objet
Code identifiantla navigation
Contexte :Fonction de départ
Objet d’arrivée
Filtres sur la liste gauche :Condition d’activation
Filtre
2.4 Paramétrage des fonctions
Sur le second onglet, on paramètre les valeurs par défaut
Navigation : définition détaillée
Paramétrage / Paramètres généraux / Personnalisation objet
Champs des écrans
Formules des valeurs par défaut
2.4 Paramétrage des fonctions
Gestion des objets : Navigation
Développement / Dictionnaire traitements / Navigation
Un cas particulier important Un cas particulier important
ssi le code fonction de départ correspond à l’objet d’arrivée :i le code fonction de départ correspond à l’objet d’arrivée :
c’est-à-dire c’est-à-dire GESXXX GESXXX XXX XXX
par convention, on est dans le cas où on part d’un menupar convention, on est dans le cas où on part d’un menu
Il est donc possible par ce biais, sur des objets appelés directementIl est donc possible par ce biais, sur des objets appelés directement
de créer des filtres complémentaires génériques ou contextuelsde créer des filtres complémentaires génériques ou contextuels
de proposer des valeurs par défaut contextuellesde proposer des valeurs par défaut contextuelles
Interface utilisateur :Interface utilisateur :
Un code de navigation actif est indiqué par l’icône en bas Un code de navigation actif est indiqué par l’icône en bas de l’écrande l’écran
Un double clic sur l’icône affiche le code de navigation actif Un double clic sur l’icône affiche le code de navigation actif
2.4 Paramétrage des fonctions
Gestion des objets : Transactions
Paramétrage /??? / Transactions
Sur le plan technique, un objet se compose :Sur le plan technique, un objet se compose :
de listes de gauchede listes de gauche
d’un ensemble d’onglets (appelé fenêtre)d’un ensemble d’onglets (appelé fenêtre)
En temps normal, un objet est associé à une seule fenêtreEn temps normal, un objet est associé à une seule fenêtre
règle de nommage : fonction règle de nommage : fonction GESXXXGESXXX, objet , objet XXXXXX, fenêtre , fenêtre OXXXOXXX
l’entrée dans l’objet provoque l’ouverture de la fenêtrel’entrée dans l’objet provoque l’ouverture de la fenêtre
Il est possible de créer plusieurs fenêtres pour un seul objet : Il est possible de créer plusieurs fenêtres pour un seul objet :
chaque fenêtre correspond à une “variante” de l’objetchaque fenêtre correspond à une “variante” de l’objet
chaque variante peut être protégée par un code d’accèschaque variante peut être protégée par un code d’accès
à l’appel de la fonction, un choix de transaction est demandé parmi à l’appel de la fonction, un choix de transaction est demandé parmi les transactions autoriséesles transactions autorisées
il est aussi possible d’imposer la transaction (paramètre dans le il est aussi possible d’imposer la transaction (paramètre dans le profil menu).profil menu).
2.4 Paramétrage des fonctions
Gestion des objets : Transactions
Paramétrage / ??? / Transactions
Créer de nouvelles fenêtres est un acte de programmation, mais :Créer de nouvelles fenêtres est un acte de programmation, mais :
dans la plupart des modules, des fonctions de création dans la plupart des modules, des fonctions de création automatique de fenêtres associées à un objet existentautomatique de fenêtres associées à un objet existent
elles partent d’une fenêtre “de base” intégrant tous les champs elles partent d’une fenêtre “de base” intégrant tous les champs possiblespossibles
elles permettent par paramétrage de choisir les champs que l’on elles permettent par paramétrage de choisir les champs que l’on ne veut pas voir, ceux que l’on veut pouvoir modifier, et ceux ne veut pas voir, ceux que l’on veut pouvoir modifier, et ceux que l’on ne veut que visualiserque l’on ne veut que visualiser
dans certains cas, elles permettent de définir des valeurs par dans certains cas, elles permettent de définir des valeurs par défaut, des filtrages, ou des contrôles complémentairesdéfaut, des filtrages, ou des contrôles complémentaires
Ces fonctions, dépendant de chaque module, sont les Ces fonctions, dépendant de chaque module, sont les paramétrages de transaction.paramétrages de transaction.
2.4 Paramétrage des fonctions
Les consultations sont caractérisées par un code sur 3 caractères :
Règle de nommage :
fonction CONSXXX, consultation XXX
Un écran “par défaut” est fourni :
nommé STD
incluant tous les champs
Le paramétrage général crée des écrans :
Protégés par code d’accès
Avec une pagination paramétrable
En donnant un rang à chaque champ
Rang 0 champ non affiché
à l’appel de la fonction, un choixest demandé parmi les écrans autorisés
il est aussi possible d’imposer l’écran(paramètre dans le profil menu).
Paramétrage des consultations : EcransParamétrage / Paramètres généraux / Ecrans de consultation
2.4 Paramétrage des fonctions
Paramétrage générique lié aux écrans
Paramétrage / Paramétrages généraux / Tables de contrôle
Toute fonction utilisant des écrans peut utiliser des tables de contrôleToute fonction utilisant des écrans peut utiliser des tables de contrôle
Une table de contrôle définit des contrôlesUne table de contrôle définit des contrôlessupplémentaires sous la forme :supplémentaires sous la forme :• de liste de valeurs obligatoiresde liste de valeurs obligatoires• de liste de valeurs interditesde liste de valeurs interdites• de bornes de valeurs numériquesde bornes de valeurs numériques• d’existence dans une tabled’existence dans une table• d’une expression logiqued’une expression logique
Trois contrôles successifs peuventTrois contrôles successifs peuventêtre saisis, avec des messagesêtre saisis, avec des messagesd’erreur dédiésd’erreur dédiés
2.4 Paramétrage des fonctions
Affectation des contrôles aux écrans
Paramétrage / Paramétrages généraux / Affectation contrôle
La fonction d’affectation permet de saisir l’écran concerné, et La fonction d’affectation permet de saisir l’écran concerné, et d’affecter une table aux champs concernés.d’affecter une table aux champs concernés.
Les écrans sont automatiquement revalidés.Les écrans sont automatiquement revalidés.
2.4 Paramétrage des fonctions
Paramétrage générique lié aux écrans
Paramétrage / Paramétrages généraux / Affectation codes d’accès
Rappel : toute fonction utilisant des écrans peut utiliser des codes Rappel : toute fonction utilisant des écrans peut utiliser des codes d’accès pour définir des restrictions d’accèsd’accès pour définir des restrictions d’accès
2.4 Paramétrage des fonctions
3. Exploitation
1- Généralités
1.1 Définition du superviseur 1.2 Rappels sur l’architecture
technique 1.3 Organisation des fonctions 1.4 Paramétrage et développement 1.5 Sociétés et sites
2- Paramétrages de base
2.1 Introduction aux formules Adonix 2.2 Paramètres de base 2.3 Workflow 2.4 Paramétrages des fonctions
3- Exploitation
3.1 Imports et exports 3.2 Gestion des états 3.3 Destinations d’impression 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 développement
5.1 Pérennisation et codes activités 5.2 Tables et index 5.3 Types de données : menus
locaux, tables diverses
5.4 Ecrans et fenêtres 5.5 Nouveaux paramètres 5.6 Fonctionnement de base d’un
objet
Définition générale
Modèles
Tables de transcodage
Paramètres généraux
Imports et exports chronologiques
Enchaînements
3.1 Import / Export
Imports et exports
Exploitation / Import/export / Import ----- Exploitation / Import/export / Export
La fonction d'import/export permet de transférer des données de la La fonction d'import/export permet de transférer des données de la BDD vers des fichiers textes et vice-versa, en se basant sur les BDD vers des fichiers textes et vice-versa, en se basant sur les objets X3 et sur un dictionnaire objets X3 et sur un dictionnaire ::
• Un dictionnaire de modèles d'import/export définit le format Un dictionnaire de modèles d'import/export définit le format des fichiers texte et les liens vers les objets X3 à exporter ou des fichiers texte et les liens vers les objets X3 à exporter ou à importer.à importer.
• Le processus d'import est basé sur la gestion d'objet X3,Le processus d'import est basé sur la gestion d'objet X3, c'est à dire qu'il simule une saisie manuelle des données.c'est à dire qu'il simule une saisie manuelle des données. En En conséquence, les contrôles qui sont effectués lors de la saisie conséquence, les contrôles qui sont effectués lors de la saisie manuelle le sont également lors d'un import.manuelle le sont également lors d'un import.
• Un certain nombre d'objets ne peut pas être importé en Un certain nombre d'objets ne peut pas être importé en utilisant la gestion d'objetutilisant la gestion d'objet. . Dans ce cas un traitement Dans ce cas un traitement d'import spécifique est utilisé et écrit les données d'import spécifique est utilisé et écrit les données directement dans lesdirectement dans les tables tables X3, sans passer par une X3, sans passer par une simulation de saisiesimulation de saisie..
3.1 Import / Export
Définition d’un modèle d’import/export
Paramétrage / Exploitation / Modèles d’import/export
Types de fichiers et structure des données Types de fichiers et structure des données ::
ASCII 1ASCII 1
CHAMPCHAMP1 1 sepsep CHAMPCHAMP22 sepsep … … CHAMPCHAMPN N sepsep// Enr. suivantEnr. suivant
ASCII 2ASCII 2
CHAMPCHAMP1 1 sep1 sep1 CHAMPCHAMP22 sep1 sep1 … … sep1 sep1 CHAMPCHAMPNN sep2 sep2// Enr. Enr. suivantsuivant
DélimitéDélimité
CHAMPCHAMP11 sep1 del sep1 delCHAMPCHAMP22del sep1 del sep1 … … CHAMPCHAMPN N sep2sep2// Enr. Enr. suivantsuivant
FixeFixe
CHAMPCHAMP11llllllllllllllllllllllCHAMPCHAMP22lllllll lllllll … … CHAMPCHAMPNNlllllllllll/lllllllllll/ Enr. suivantEnr. suivant
• Identificateurs : Plusieurs niveaux en-tête/détails peuvent être définis :
• Niveau définit la hiérarchie entre les différentes tables.• Code est l'identifiant du niveau dans le fichier texte.• La Clé est celle utilisée pour lire la table (cf. dictionnaire).• Lien : les champs de la table dont les valeurs seront utilisées
pour la lecture de la table du niveau supérieur(dépendent de la clé de la table supérieure).
3.1 Import / Export
Définition d’un modèle d’import/export
Paramétrage / Exploitation / Modèles d’import/export
L'onglet L'onglet ChampsChamps contient la définition de contient la définition de l'ordre des champs exportés ou importés l'ordre des champs exportés ou importés dans le fichier textedans le fichier texte..
Lorsque des Lorsque des identificateursidentificateurs existent, ils existent, ils doivent être placés en tant que premier doivent être placés en tant que premier champ pour chaque tablechamp pour chaque table. . Un identifiant est Un identifiant est indiqué par le caractèreindiqué par le caractère '/'. '/'.
Critère permet la saisie de critères de début/fin lors de l'export
Le champ peut être:• Un champ de la table• Une constante ("XXX" ou 'XXX') (ignorée en import)• =Expression (ignorée en import)• *1, *2 etc. pour référence à la variable GIMP(i) (import)
Le bouton Export sert à définir les paramètres par défaut (critères et formules de sélection), qui seront préchargés lors de l'exécution manuelle d'un export ou utilisés directement lors de l'exécution d'un enchaînement.
Le chemin d'accès peut inclure le caractère '#' pour numérotation séquentielle du fichier.
Numéro de table utilisée pour un transcodage de données
3.1 Import / Export
Tables de transcodage d’imports/exports
Paramétrage / Exploitation / Transcodage Import/Export
Cette fonction permet de définir des tables de correspondance :Cette fonction permet de définir des tables de correspondance :• Entre codes locaux et codes externesEntre codes locaux et codes externes• Associables à un modèle d’import/exportAssociables à un modèle d’import/export• Fonctionnant à la fois en import et en exportFonctionnant à la fois en import et en export• Avec des valeurs par défaut possibles (*)Avec des valeurs par défaut possibles (*)
Dans l’exemple ci-contre :
En export :• CHQ est transcodé en CHEQUE• TRT est transcodé en TRAITE
(1er choix de la liste)• DIV n’est pas transcodé (*)• Tout autre choix est transcodé en AUTRES
En import :• CHEQUE est transcodé en CHQ• TRAITE et EFFET sont transcodés en TRT• Tout autre choix est transcodé en DIV• AUTRES n’est pas transcodé
3.1 Import / Export
Paramètres d’imports /export
Paramétrage / Exploitation /
Utilisés pour définir les emplacements par défaut des fichiers Utilisés pour définir les emplacements par défaut des fichiers utilisés pour l'import/export sur le client ou sur le serveur.utilisés pour l'import/export sur le client ou sur le serveur. Ceci Ceci n'est pas obligatoire mais ajoute de la cohérence à la gestion n'est pas obligatoire mais ajoute de la cohérence à la gestion des imports/exports.des imports/exports.
Les répertoires par défaut sont symbolisés par le caractère '%' dans les modèles d'import/export (champ Fichier de données).
AA
22
33
44
11
33
22
44
Déplacement en début
d’import
Transfert des lignes
importées
Copie des ligneserronées
BB
AA
BB
11
Transfert en fin d’export
3.1 Import / Export
Imports et exports chronologiques
Exploitation / Import/export / Export
Un export chronologique se déclenche en activant la case à cocher Un export chronologique se déclenche en activant la case à cocher Gestion Gestion ChronoChrono : :
L’export est alors basé sur un numéro de chrono géré comme un time-L’export est alors basé sur un numéro de chrono géré comme un time-stamp, pour effectuer des extractions différentiellesstamp, pour effectuer des extractions différentielles
Seuls les enregistrements modifiés depuis le dernier export sont Seuls les enregistrements modifiés depuis le dernier export sont exportésexportés
La variable La variable [C]EXPORT[C]EXPORT contient le numéro chronologique courant et est contient le numéro chronologique courant et est incrémentée à la fin de chaque export, quel que soit le modèle utilisé.incrémentée à la fin de chaque export, quel que soit le modèle utilisé.
La valeur courante du numéro chronologique est stockée dans le champLa valeur courante du numéro chronologique est stockée dans le champ EXPNUMEXPNUM d'un enregistrement lorsqu'il est modifié ou créé, et dans le d'un enregistrement lorsqu'il est modifié ou créé, et dans le champ champ EXPORTEXPORT du modèle à la fin de chaque export. du modèle à la fin de chaque export.
Un export avec gestion de chrono ne touche que les enregistrements Un export avec gestion de chrono ne touche que les enregistrements dontdont EXPNUMEXPNUM est plus grand que le champest plus grand que le champ EXPORTEXPORT du modèle.du modèle.
3.1 Import / Export
Imports et exports chronologiques
Exploitation / Import/export / Export
Exemple de séquence d’export chronologique :Exemple de séquence d’export chronologique :
EXPORT = 5
Modèle exportSOH
Commande 34EXPNUM = 2
Commande 35EXPNUM = 1
Commande 36EXPNUM = 4
EXPORT = 3
Modèle exportSOH
[C]EXPORT = 5Commande 34EXPNUM = 2
Commande 35EXPNUM = 1
Commande 36EXPNUM = 4
11
EXPORT CHRONOLOGIQUE . DES COMMANDES AVEC LE MODELE SOH22
Commande 34EXPNUM = 9MODIFICATION DE LA COMMANDE 3433
[C]EXPORT = 6
La commande 36est exportée
44 EXPORT CHRONOLOGIQUE . DES COMMANDES AVEC LE MODELE SOH
Commande 34EXPNUM = 2
Commande 35EXPNUM = 1
Commande 36EXPNUM = 6
EXPORT = 9
Modèle exportSOH
[C]EXPORT = 10
La commande 34est exportée
[C]EXPORT = 9
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 Il est conseillé de mettre un # dans le fichier utilisé pour les exports chronologiques :chronologiques :
Le # est remplacé par le numéro de chrono formaté sur 8 caractères Le # est remplacé par le numéro de chrono formaté sur 8 caractères avec des zérosavec des zéros
En import :En import :
Si un # est détecté dans le nom du fichier, on importe tous les fichiers Si un # est détecté dans le nom du fichier, on importe tous les fichiers correspondant à cette règle de nommage, dans l’ordre croissant des correspondant à cette règle de nommage, dans l’ordre croissant des numéros.numéros.
Ainsi, deux fichiers exportés successivement seront importés dans Ainsi, deux fichiers exportés successivement seront importés dans l’ordre chronologique d’extractionl’ordre chronologique d’extraction
3.1 Import / Export
Enchaînements d’import /exports
Paramétrage / Exploitation / Enchaînements
Exploitation / Imports/Exports / Imports enchaînés -- Exports enchaînés
Un enchaînement est une série d'imports ou d'exports enchaînés à Un enchaînement est une série d'imports ou d'exports enchaînés à l’exécution :l’exécution :
• Ceci est utile notamment lorsqu'un processus d'import ou d'export Ceci est utile notamment lorsqu'un processus d'import ou d'export doit se servir de plusieurs fichiersdoit se servir de plusieurs fichiers..
• L'exécution d'un enchaînement est gérée par le serveur batch.L'exécution d'un enchaînement est gérée par le serveur batch.• Lorsqu'on exécute un enchaînement d'exports avec gestion Lorsqu'on exécute un enchaînement d'exports avec gestion
chronologique, le numéro de séquence est incrémenté une seule chronologique, le numéro de séquence est incrémenté une seule foisfois.. L'enchaînement utilise un seul numéro de séquence, ce qui L'enchaînement utilise un seul numéro de séquence, ce qui garantit la cohérence de l’ensemble.garantit la cohérence de l’ensemble.
3.1 Import / Export
Principes de base
Le dictionnaire des états
Lancement des états
Affectation des codes internes
Valeurs par défaut des paramètres
3.2 Gestion des états
Gestion des états : principes de base
Développement / Traitements / Etats / Dictionnaire des états
Les états sont :Les états sont :• Définis à l’aide du générateur d’états Définis à l’aide du générateur d’états Crystal ReportsCrystal ReportsTMTM (fichiers (fichiers
d’extensiond’extension .rpt.rpt ))• Répertoriés dans un dictionnaire d’états qui pointe sur un état Répertoriés dans un dictionnaire d’états qui pointe sur un état
et référence en outre leurs paramètreset référence en outre leurs paramètres
Les états sont téléchargés depuis le serveur, puis exécutés :Les états sont téléchargés depuis le serveur, puis exécutés :• Directement sur le poste client via une librairie (DLL) Directement sur le poste client via une librairie (DLL) Crystal Crystal
ReportsReports• Sur un serveur d’impression quand l’état est lancé depuis un Sur un serveur d’impression quand l’état est lancé depuis un
poste Webposte Web• Sur un serveur d’impression quand l’état est lancé depuis une Sur un serveur d’impression quand l’état est lancé depuis une
tâche batchtâche batch
Un serveur d’impression est un serveur Windows sur lequel sont Un serveur d’impression est un serveur Windows sur lequel sont installés, outre des composants ADONIX, les librairies installés, outre des composants ADONIX, les librairies Crystal Crystal ReportsReports idoines. idoines.
3.2 Gestion des états
Le dictionnaire des états
Développement / Traitements / Etats / Dictionnaire des états
C’est une fonction située dans le développementC’est une fonction située dans le développement
Il est donc nécessaire, lorsqu’on crée de nouveaux états :Il est donc nécessaire, lorsqu’on crée de nouveaux états :• De respecter des règles de nommage (noms commençant par De respecter des règles de nommage (noms commençant par
X, Y, ou Z)X, Y, ou Z)• De marquer ces états par un code activité spécifiqueDe marquer ces états par un code activité spécifique
De même, il faut, si on modifie des états standards : De même, il faut, si on modifie des états standards : • Renommer les fichiers d’extension Renommer les fichiers d’extension .rpt.rpt• Modifier la fiche de l’état pour le faire pointer sur l’état modifiéModifier la fiche de l’état pour le faire pointer sur l’état modifié
Certains champ du dictionnaire des états sont considérés comme Certains champ du dictionnaire des états sont considérés comme du paramétragedu paramétrage
• Leur modification est sauvegardéeLeur modification est sauvegardée• Il ne faut donc pas utiliser de code activité si seules ces champs Il ne faut donc pas utiliser de code activité si seules ces champs
sont modifiéssont modifiés
!
3.2 Gestion des états
Le dictionnaire des états : Premier onglet
Développement / Traitements / Etats / Dictionnaire des états
Les zones encadrées Les zones encadrées sontsont
des paramètres des paramètres (pérennes)(pérennes)Groupe d’états
Menu local 97 (personnalisable)Permet de gérer des habilitations
Association aux fichiers .rpt
1 à 5 états peuvent être enchaînés
(paramètres identiques obligatoires)
Traitements préliminaires
Exécutés avant l’état
Permet d’alimenter un fichier temporaire que l’on imprime
Règles d’affectation des sorties
Gestion des langues
Chaque fichier .rpt est stocké dans un répertoire dépendant de la langue
Règles d’accès et de lancement
Non exécutable signifie pas en direct depuis la fonction d’impression
3.2 Gestion des états
Le dictionnaire des états : Deuxième onglet
Développement / Traitements / Etats / Dictionnaire des états
On définit les paramètres et leurs caractéristiques (type de On définit les paramètres et leurs caractéristiques (type de données, valeursdonnées, valeurs
par défaut, contrôles). par défaut, contrôles).
3.2 Gestion des états
Lancement d’un état : écranImpressions / Impressions
On saisit :On saisit :• les paramètres de lancementles paramètres de lancement
• le format si on crée un fichierle format si on crée un fichier
• La destination si elle est La destination si elle est répertoriée dans la table des répertoriée dans la table des destinationsdestinations• sinon, on saisit la destinationsinon, on saisit la destinationet le chemin de l’imprimante :et le chemin de l’imprimante :
• des éléments complémentairesdes éléments complémentaires
3.2 Gestion des états
Lancement des états : cinématique
Impressions / ImpressionsFichier / Impression ou Fichier / Liste depuis la gestion d’objet
Langue de connexion
FRAFRA
Code état
Code interne état
Fichier / ImpressionFichier / Impression
Fichier / ListeFichier / Liste
Règle d’association d’un code interne à un ou plusieurscodes états : si plusieurs, on donne le choix à l’exécution
Si aucune indirection, code état = code interne
Développement/Dictionnaire traitements/Etats/Codes impression
Définition contextuelle par des formules de valeurs pardéfaut pour les paramètres de l’état
Développement/Dictionnaire traitements/Etats/Valeurs par défaut
Objet X3
Impressions / Impression/groupe Impressions / Impression/groupe
Impressions / Impressions Impressions / Impressions
Lancement de l’état Crystal Reports™
Impression automatique Impression automatique
Fonction X3
3.2 Gestion des états
Affectation des codes internes à des états Développement/Dictionnaire traitements/Etats/Codes impression
Affectation multiple :Affectation multiple :• Choix à l’impressionChoix à l’impression
Affectation simple :Affectation simple :• IndirectionIndirection
Pas de ligne présente :Pas de ligne présente :• Le code de l’état estLe code de l’état est
utilisé utilisé
3.2 Gestion des états
Valeurs par défaut des paramètres d’étatsDéveloppement/Dictionnaire traitements/Etats/Valeurs par défaut
C’est une fonction située dans le développement qui permet :C’est une fonction située dans le développement qui permet :• De donner des valeurs par défaut contextuelles quand un état De donner des valeurs par défaut contextuelles quand un état
donné est appelé depuis une fonction donnéedonné est appelé depuis une fonction donnée• En l’absence de telle règle, les valeurs par défaut données dans En l’absence de telle règle, les valeurs par défaut données dans
le dictionnaire des états s’appliquent.le dictionnaire des états s’appliquent.
!
3.2 Gestion des états
La table des destinations permet de définir des destinations de sortie d’états:
supposées partageables entre les utilisateurs (chemin réseau accessible)
avec un type discriminant vis à vis des états
utilisables comme valeur pardéfaut
Elle n’empêche pas l’utilisation,
au lancement de l’état,
d’une imprimante non répertoriée
par le choix classique d’une
imprimante sous Windows TM
Paramétrage / Destinations / Destinations
Serveur
Si on passe par un serveur d’impression
Type d’imprimante
Menu local 22 (intitulés modifiables)Le premier type est un type par défaut
Code d’accès
S’il est renseigné, l’utilisateur doit avoir les droits d’exécution pour utiliser l’imprimante
3.3 Gestion des destinations d’états
Les serveurs d’éditions correspondent à des serveurs :
accessibles par le réseau
sur lequel un run-time adonix et Crystal Reports a été installé
Les serveurs d’éditions sont définis par le biais de la console de
configuration.
Serveurs d’édition
3.3 Gestion des destinations d’états
Fiche utilisateur
Imprimantes utilisateur
(le code utilisateurpar défaut)Destinations par utilisateur
(Etat, Complément) Destination
Affectation des destinationsParamétrage / Imprimantes / Imprimantes par utilisateur
22
11
33
Définition de l’état
(code, destination par défaut,
formule complément)
3.3 Gestion des destinations d’états
Portail utilisateurParamétrage / Portail / Pages du portail
Un portail correspond au contenu de l’écran ADONIX X3 présenté à Un portail correspond au contenu de l’écran ADONIX X3 présenté à
l’utilisateur :l’utilisateur :
• Lors de sa connexion en client-serveurLors de sa connexion en client-serveur
• En cliquant sur l’onglet Portail en mode WebEn cliquant sur l’onglet Portail en mode Web
Caractéristiques principalesCaractéristiques principales
• Permet de présenter des pages HTML, des données mises en forme Permet de présenter des pages HTML, des données mises en forme
par des composants standard (graphes flash, tableaux de par des composants standard (graphes flash, tableaux de
présentation, calendriers…)présentation, calendriers…)
• De façon personnaliséeDe façon personnalisée
• Par utilisateur ou groupe d’utilisateurPar utilisateur ou groupe d’utilisateur
• En tenant compte du contexte de connexionEn tenant compte du contexte de connexion
• En réutilisant des fonctions d’extractions standard du progicielEn réutilisant des fonctions d’extractions standard du progiciel
• Avec des zooms sur les fiches liées aux données présentéesAvec des zooms sur les fiches liées aux données présentées
3.4 Portail utilisateur
Portail utilisateurParamétrage / Portail / Pages du portail
Issu d’un paramétrage de pages portail :Issu d’un paramétrage de pages portail :
• Identifiées par un codeIdentifiées par un code
• Associées à l’utilisateur par le paramètreAssociées à l’utilisateur par le paramètre
PTLPAGEPTLPAGE
Chaque page définit :Chaque page définit :
• Une organisation (en 1, 2, 3 ou 4 cadres)Une organisation (en 1, 2, 3 ou 4 cadres)
• Chaque cadre contient :Chaque cadre contient :
• Soit une page WebSoit une page Web
• Soit une “vue de portail” qui associe :Soit une “vue de portail” qui associe :
• une une source de donnéessource de données
(logique d’extraction des données)(logique d’extraction des données)
• un un composant visuelcomposant visuel
(mode de présentation)(mode de présentation)
3.4 Portail utilisateur
Vue du Portail : sources de donnéesParamétrage / Portail / Vues du portail
• Une source de données identifie la façon dont les données sont Une source de données identifie la façon dont les données sont
extraitesextraites
• Elle est définie par des codes normalisés (table diverse 90)Elle est définie par des codes normalisés (table diverse 90)
• Certains codes correspondent à des fonctions d’exploitation Certains codes correspondent à des fonctions d’exploitation
accessibles par ailleurs :accessibles par ailleurs :
• REQ : Requête (paramétrée par le requêteur ou le requêteur REQ : Requête (paramétrée par le requêteur ou le requêteur
SQL)SQL)
• STA : Statistique (paramétrage des statistiques)STA : Statistique (paramétrage des statistiques)
• D’autres sont plus particulièresD’autres sont plus particulières
• AGD : Agenda du CRMAGD : Agenda du CRM
• MLT : multi-liste (ensemble de listes de gauche d’objets)MLT : multi-liste (ensemble de listes de gauche d’objets)
• TRT : traitement normalisé d’extraction (identifié par un code TRT : traitement normalisé d’extraction (identifié par un code
action)action)
• WEB : page http dont l’adresse est évaluée au moment de WEB : page http dont l’adresse est évaluée au moment de
l’exécutionl’exécution
3.4 Portail utilisateur
Vue du Portail : sources de donnéesParamétrage / Portail / Vues du portail
Outre le code identifiant la source, on a des paramètres Outre le code identifiant la source, on a des paramètres
complémentaires :complémentaires :
• dépendant du type de source de donnéesdépendant du type de source de données
• saisis dans un tableau sous forme de formule (dépendant du saisis dans un tableau sous forme de formule (dépendant du
contexte)contexte)
Les paramètres « source » sont les suivants :Les paramètres « source » sont les suivants :
• Source REQ :Source REQ :
• Fréquence de mise à jour (horaire, journalière, à l’utilisation)Fréquence de mise à jour (horaire, journalière, à l’utilisation)
• Niveau de rupture pour la présentation des données (1 à N)Niveau de rupture pour la présentation des données (1 à N)
• Source TRT :Source TRT :
• 4 paramètres de type chaîne de caractères banalisés (P1 à 4 paramètres de type chaîne de caractères banalisés (P1 à
P4)P4)
• Source WEBSource WEB
• Adresse (paramètre URL)Adresse (paramètre URL)
3.4 Portail utilisateur
Vue du Portail : sources de donnéesParamétrage / Portail / Vues du portail
Paramètres « source » (suite) :Paramètres « source » (suite) :
• Source STA :Source STA :
• Codes société et site pour filtre Codes société et site pour filtre
• Dates de début et de fin (période 1 et Dates de début et de fin (période 1 et
2)2)
• Critères fixés (CRIT1 à CRIT8). Le Critères fixés (CRIT1 à CRIT8). Le
premier critère égal à la chaine vide premier critère égal à la chaine vide
détermine le niveau de zoom de la détermine le niveau de zoom de la
statistiquestatistique
• Source MLT :Source MLT :
• Pas de paramètre complémentaire Pas de paramètre complémentaire
(on saisit le code de la multi-liste)(on saisit le code de la multi-liste)
• Source AGD :Source AGD :
• Nombre de mois avant et après la Nombre de mois avant et après la
date courantedate courante
3.4 Portail utilisateur
Vue du Portail : Composants visuelsParamétrage / Portail / Vues du portail
Les composants visuels :Les composants visuels :
• sont définis par un code dans la sont définis par un code dans la
table diverse 91table diverse 91
• correspondent à des composants à correspondent à des composants à
mêmes de présenter l’informationmêmes de présenter l’information
• ne sont pas compatibles avec toutes ne sont pas compatibles avec toutes
les sources de donnéesles sources de données
• peuvent nécessiter des paramètres peuvent nécessiter des paramètres
complémentairescomplémentaires
3.4 Portail utilisateur
Portail utilisateur et habilitationsParamétrage / Portail / Pages du portail
Le portail, lorsqu’il s’exécute, utilise la fonction APTLREQ :Le portail, lorsqu’il s’exécute, utilise la fonction APTLREQ :
• Cette fonction doit donc être autorisée pour le profil de l’utilisateurCette fonction doit donc être autorisée pour le profil de l’utilisateur
• … … faute de quoi un message d’erreur s’affichera, et le portail ne faute de quoi un message d’erreur s’affichera, et le portail ne
sera pas visible.sera pas visible.
Les zooms vers les objets, lorsqu’ils s’exécutent, utilisent la fonction Les zooms vers les objets, lorsqu’ils s’exécutent, utilisent la fonction
APTLOBJ :APTLOBJ :
• Cette fonction doit donc être autorisée pour le profil de l’utilisateurCette fonction doit donc être autorisée pour le profil de l’utilisateur
• … … faute de quoi un message d’erreur s’affichera, et les zooms ne faute de quoi un message d’erreur s’affichera, et les zooms ne
seront pas activés.seront pas activés.
3.4 Portail utilisateur
Styles de présentation Paramètres / Paramètres généraux / Styles / Styles de présentation
Permet de définir des mises en valeurs particulières dans les écransPermet de définir des mises en valeurs particulières dans les écrans
• Polices particulièresPolices particulières
• Couleur et couleur de fondCouleur et couleur de fond
• Tailles de caractèresTailles de caractères
• Effets (gras, italique, souligné, barré…)Effets (gras, italique, souligné, barré…)
De façon fixe, contextuelle, ou génériqueDe façon fixe, contextuelle, ou générique
Les styles utilisés sont Les styles utilisés sont
• Identifiés par un code Identifiés par un code
• Sont modifiables par paramétrage par groupes d’utilisateursSont modifiables par paramétrage par groupes d’utilisateurs
• Affectés par paramétrage ou développement aux éléments à mettre en Affectés par paramétrage ou développement aux éléments à mettre en
valeurvaleur
3.5 Gestion des styles
Définition d’un style de présentationParamètres / Paramètres généraux / Styles / Styles de présentation
Un style de présentation se définit parUn style de présentation se définit par
• Un code et des intitulésUn code et des intitulés
• La définition en elle-mêmeLa définition en elle-même
• La saisie peut se faire par un assistantLa saisie peut se faire par un assistant
3.5 Gestion des styles
Utilisation d’un style de présentationParamètres / Paramètres généraux / Styles / Styles de présentation
Utilisation des styles :Utilisation des styles :
• Pour les titres (via le dictionnaire)Pour les titres (via le dictionnaire)
• des champsdes champs
• des blocs dans les écransdes blocs dans les écrans
• Pour les valeurs de champs dans les écrans :Pour les valeurs de champs dans les écrans :
• De façon statiqueDe façon statique
• De façon dynamique par la fonction de mise en valeurDe façon dynamique par la fonction de mise en valeur
• Dans certains écrans (tableaux de bord comptables)Dans certains écrans (tableaux de bord comptables)
• De façon générique pour mettre en évidence certaines caractéristiques De façon générique pour mettre en évidence certaines caractéristiques
(en permettant de marquer les titres, les valeurs, et en distinguant les (en permettant de marquer les titres, les valeurs, et en distinguant les
champs en liste et les champs en tableaux) :champs en liste et les champs en tableaux) :
• Champ obligatoireChamp obligatoire
• Présence d’une fenêtre de sélectionPrésence d’une fenêtre de sélection
• Présence d’un tunnelPrésence d’un tunnel
• Saisie d’une formule de calculSaisie d’une formule de calcul
3.5 Gestion des styles
Définition d’un style personnaliséParamètres / Paramètres généraux / Styles / Styles personnalisés
Un style personnalisé permet d’associer des effets particuliers :Un style personnalisé permet d’associer des effets particuliers :
• pour les styles de présentation précédemment définispour les styles de présentation précédemment définis
• pour un code de personnalisation donnépour un code de personnalisation donné
On peut associer aux utilisateurs un code de personnalisation donné :On peut associer aux utilisateurs un code de personnalisation donné :
• par le biais du paramètre utilisateur STYLEpar le biais du paramètre utilisateur STYLE
• par défaut (paramètre non renseigné), on utilise les effets associés au par défaut (paramètre non renseigné), on utilise les effets associés au
style de présentation standardstyle de présentation standard
3.5 Gestion des styles
Styles conditionnels Paramètres / Paramètres généraux / Styles / Styles conditionnels
Permet de définir des styles sur la valeur du champ uniquement :Permet de définir des styles sur la valeur du champ uniquement :
• Par une listePar une liste
• De conditionsDe conditions
• De styles associésDe styles associés
• La première condition remplie détermine le style utilisé.La première condition remplie détermine le style utilisé.
• Si la dernière ligne n’a pas de condition, elle est utilisée si les Si la dernière ligne n’a pas de condition, elle est utilisée si les
autres conditions ne sont pas remplies.autres conditions ne sont pas remplies.
3.5 Gestion des styles
Affectation de styles conditionnelsParamètres / Paramètres généraux / Styles / Personnalisation écrans
Se fait par affectation d’un style conditionnel à un écran :Se fait par affectation d’un style conditionnel à un écran :
• De façon pérenne (respecté en cas de mise à jour)De façon pérenne (respecté en cas de mise à jour)
• Par simple rappel de l’écran dans la fonction dédiéePar simple rappel de l’écran dans la fonction dédiée
3.5 Gestion des styles
Gestion du vocabulaire lié au dictionnaireParamètres / Paramètres généraux / Personnalisation vocabulaire
Le dictionnaire utilise des textes traduisibles stockés Le dictionnaire utilise des textes traduisibles stockés
dans :dans :
• la table APLSTD (menus locaux)la table APLSTD (menus locaux)
• la table ATEXTE (textes écrans)la table ATEXTE (textes écrans)
Ils sont :Ils sont :
• fournis en standard fournis en standard
• remis à jour à chaque installation de version remis à jour à chaque installation de version
(sauf menus locaux modifiables par l’utilisateur)(sauf menus locaux modifiables par l’utilisateur)
• Ecrits « en dur » dans la description des écrans Ecrits « en dur » dans la description des écrans
et fenêtres lors de leur validation.et fenêtres lors de leur validation.
La gestion du vocabulaire stocke dans une table La gestion du vocabulaire stocke dans une table
dédiée :dédiée :
• Des valeurs de menus locauxDes valeurs de menus locaux
• Des textes Des textes
Ces textes remplacent leCes textes remplacent le
contenu d’APLSTD et ATEXTE contenu d’APLSTD et ATEXTE
Textestraduisibles(ATEXTE)
Menus locaux(APLSTD)
DOSSIER DE REFERENCE
DOSSIER D’EXPLOITATION
Textestraduisibles(ATEXTE)
Menus locaux(APLSTD)
Copie des menus locaux non modifiables
PROCESSUS DEVALIDATION
Vocabulaire(AVOCAB)
Copiedes textes
Copie du vocabulaire personnalisé
Générationde l’interface
3.6 Personnalisation du vocabulaire
On saisit dans l’écran :
Le type (message ou texte) et la clé (chapitre/numéro ou numéro)
Le texte modifié
Gestion du vocabulaire lié au dictionnaireParamètres / Paramètres généraux / Personnalisation vocabulaire
On dispose de deux outils de recherche de textes :On dispose de deux outils de recherche de textes :
Par clic droit sur la ligne, pour recharger un ensemble de textesPar clic droit sur la ligne, pour recharger un ensemble de textes
Par clic doit sur le champ (choix d’un texte)Par clic doit sur le champ (choix d’un texte)
La recherche est indépendante de la casse (majuscule/minuscule/accents)La recherche est indépendante de la casse (majuscule/minuscule/accents)
3.6 Personnalisation du vocabulaire
Caractéristiques du serveur batch :
C’est un processus fonctionnant en arrière-plan sur le serveur de traitement, qui gère le lancement de tâches batch correspondant à des traitements X3 ou à des commandes OS.
Il est géré par une dossier spécial dédié, appelé SERVX3.
Les tâches soumises au serveur batch s'appellent des requêtes. Elles sont lancées par le serveur sous forme de processus Adonix en arrière-plan.
Mise en service du serveur : au lancement du système : au lancement du système : adonix -a -l adonix -a -l lang lang SERVX3 SERVX3 à partir d'X3 : à partir d'X3 : Exploitation / Serveur batch / Activation serveur
automatiquement à la connexion d'un utilisateur (paramètre DEMSRV).automatiquement à la connexion d'un utilisateur (paramètre DEMSRV).
Arrêt du serveur : à partir d'X3 : à partir d'X3 : Exploitation / Serveur batch / Désactivation serveur
en créant un fichier en créant un fichier stopstop dans le répertoire dans le répertoire FILFIL du dossier du dossier SERVX3SERVX3 en arrêtant la base (pour une sauvegarde par exemple)en arrêtant la base (pour une sauvegarde par exemple)
Exploitation / Serveur batch / …
3.7 Le serveur batch
Le serveur batch fonctionne par "polling" :
Interrogation périodique de la table des requêtes soumises. Lorsque l'heure de démarrage d'une requête est arrivée ou dépassée,
la requête est lancée (sauf si elle est trop en retard, ou si le nombre maximum de tâches simultanément en cours est dépassé).
Lorsque le temps maximum (time-out) d’exécution alloué à une tâche est dépassé, la tâche est interrompue.
Principes de fonctionnement
Exploitation / Serveur batch / …
DOSSIER SERVX3
Serveur Batch(processus SERVX3)
Serveur Batch(processus SERVX3)
Table desrequêtes
(ABATRQT)
Polling périodique ??
Processus batch
Processus batch
DOSSIER D’EXPLOITATION
Lancement
Interruption (time-out, demande d’arrêt)
Sessionutilisateur
Sessionutilisateur
Soumission
Soumission pardépose de fichier
AbonnementsTrace duprocessus
Trace duserveur
3.7 Le serveur batch
Une requête est une demande d’exécution d’une ou plusieurs tâches
soumises au serveur :
Par la fonction de soumission des requêtesExploitation / Serveur batch / Soumission des requêtes.
Directement depuis la fonction de surveillance des requêtes par clic droit sur le tableau des requêtesExploitation / Serveur batch / Gestion des requêtes.
Par dépose d’un fichier dans un répertoire du serveur de traitement Peut être piloté par un automate externe
Par le biais d'un abonnement, c'est à dire une requête à lancer périodiquementExploitation / Serveur batch / Gestion des abonnements.
Mensuel, Hebdomadaire, en fréquence
Principes de fonctionnement
Exploitation / Serveur batch / …
3.7 Le serveur batch
Une tâche est définie en spécifiant 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 normalisées selon le modèle traitement peuvent être lancées.
Définition d’une tâche
Exploitation /serveur batch/ Gestion des tâches
Si la tâche est active au-delà de cette durée, elle est arrêtée.
Si la tâche n’a pas pu être lancée au delà de ce délai, elle ne sera pas lancée.
Niveau minimal que doit avoir l'utilisateur pour lancer la tâche (paramétrage utilisateur)
Paramètre transmis au système d’exploitation
Numéro de service (le service adonix par défaut)
Table définissant les horaires admissibles
Ce flag signifie que la tâche peut être lancée dans un dossier sur les données d’un autre (ceci suppose qu’elle ait été écrite pour le permettre)
La tâche ne pourra être lancée que si aucun autre utilisateur n’est connecté sur le dossier
3.7 Le serveur batch
C’est une suite de tâches exécutées en séquence
En cas d’erreur grave dans une tâche, les suivantes ne sont pas lancées
Chaque tâche crée sa propre trace
A la saisie d’une requête sur le groupe, tous les paramètres des tâches liées sont saisis
Niveau minimal que doit avoir l'utilisateur pour lancer le groupe de
tâches (paramètre utilisateur)
Table définissant les horaires admissibles
Liste des tâches à enchaîner
Définition d’un groupe de tâches
Exploitation / Serveur batch / Groupe de tâches
3.7 Le serveur batch
Définit les horaires admissibles pour lancer une tâche batch
Associé à une tâche ou à un groupe de tâches
Deux types de jours : ouvrés, et non ouvrés / fériés, chacun avec des plages horaires possibles
Contraintes horaires
Paramétrage / Exploitation / Contraintes horaires
Paramétrage / Exploitation / Calendrier d’exclusion
3.7 Le serveur batch
C’est une tâche ou un groupe de tâches exécutés de façon régulière :
Avec une périodicité variable(hebdomadaire, mensuelle)
A heures fixes ou en fréquencedans une plage horaire
A la création d’un abonnement,les paramètres doivent être saisis.
Définition d’un abonnement
Exploitation / Serveur batch / Gestion des abonnements
Définition du contexte d’exécution :
Dossier, utilisateur, groupe ou tâche à lancer
Base mensuelle :
1 à 5 Quantièmes de déclenchement
Flag Fin de mois
Base hebdomadaire :
Liste des jours de déclenchement
Horaires de lancement :
Soit 1 à 3 heures
Soit une fréquence entre deux horaires
Base périodique de lancement
Calendrier d’exécution
Flag exécution forcée
La tâche est exécutée au moins une fois par jour, même si l’horaire est dépassé
3.7 Le serveur batch
La soumission d’une requête se fait par saisie : du dossier où elle doit être exécutée du code utilisateur de la tâche ou du groupe de l’heure demandée d’exécution
La fenêtre de saisie des paramètres s’ouvre alors
Soumission d’une requête
Exploitation / Serveur batch / Soumission des requêtes
3.7 Le serveur batch
La gestion des tâches permet de surveiller et de modifier les requêtes en attente et les tâches en cours d'exécution ou terminées.
Il est possible d'en visualiser les différents fichiers traces, de soumettre une nouvelle requête, de supprimer une requête en attente ou d'en modifier les paramètres etc.
Surveillance des tâches
Exploitation / Serveur batch / Gestion des requêtes
3.7 Le serveur batch
requete.kil
Soumission de tâche par fichier
Exploitation / Serveur batch / …
requete.run
requete.sta
requete.kil
Prise en comptepar le serveur batch
requete.job
requete.req
requete.oldLancement de la tâche
Fin de tâche
Demande d’interruption
Soumission de tâcherequete.mod
Gestion des tâchesserveur batch
requete.job
requete.req
requete.run
Permet le déclenchement de tâches par des processus externes
Soumis à autorisation : Globale (Paramétrage / Exploitation / Paramètres du serveur batch) Par utilisateur (paramètre EXTBATCH)
3.7 Le serveur batch
Soumission de tâche par fichier
Exploitation / Serveur batch / …
No statut No requête Début
5 chiffres 8 chiffres date/heure
Dossier
10 car
Utilisateur
5 car
Tâche
10 car
Message final
80 caractèresdate/heure
Fin
Le fichier de statut (requete.sta) est normalisé pour faciliter l’exploitation :
Une ligne de longueur fixe, codage ascii 7 bits, séparateur entre deux champs (le « : »), Fin de ligne : CR/LF ou LF selon le système
Statut normalisé sur 5 chiffres FSXXX, avec : F=0 : fin normale, SXXX=nombre d’avertissements F=1 : fin sur erreur de traitement, S=sous-cas, XXX=détails F=2 : traitement non lancé, S=sous-cas, XXX=détails F=3 : traitement interrompu, S=sous-cas
Le fichier de trace du serveur utilise la même présentation La trace détaillée est dans un fichier nommé RQTnnnnnnnn.tra
(nnnnnnnn=no requête sur 8 caractères)
date/heureNote : correspond à AAAAMMJJhhmmss
3.7 Le serveur batch
Temps entre deux scrutations Définit le temps entre deux lectures
successives de la table des requêtes. Influe sur le délai de prise en compte d'une
requête, et inversement sur la charge du système.
Influe sur le temps d'entrée dans la fonction de surveillance des tâches.
Temps pour scrutation time-out Influe sur le temps d'arrêt d'une tâche trop
longue. La scrutation time-out est consommatrice de
ressources.
Retard maxi pour lancer une requête Evite un lancement tardif si la requête n’a pas
pu être lancée à temps (trop de tâches en cours, serveur arrêté)
Nombre maximum de requêtes en cours Le maximum dépend de la licence
Paramètres du serveur batch
Paramétrage / Exploitation / Paramètres serveur batch
3.7 Le serveur batch
Les fichiers stratégiques du serveur
Exploitation / Serveur batch / …
Ils sont situés sur le serveur d’application : Dans le répertoire SERVX3/FIL :
la présence d’un fichier .run indique normalement que le serveur est en fonctionnement (sauf arrêt intempestif)
la présence d’un fichier .stop indique qu’une demande d’arrêt a été transmise au serveur (mais que les tâches lancées par le serveur ne doivent pas être interrompues)
la présence d’un fichier .kill indique qu’une demande d’arrêt a été transmise au serveur (avec demande d’interruption des tâches lancées)
Dans le répertoire SERVX3/TRA : le fichier serveur.tra contient la trace du serveur les fichiers RQTnnnnnnnn.tra contiennent la trace des tâches
3.7 Le serveur batch
Trace détaillée d’une requête
Exploitation / Serveur batch / …
Chaque requête génère un fichier de trace détaillé : Nommé RQTnnnnnnnn.tra (nnnnnnnn = no requête sur 8
caractères) Codé en UTF8, avec un en-tête normalisé Contenant des lignes de texte sous l’un des formats suivants :
<NNNN> Texte Texte
Le préfixe <NNNN> permet une mise en évidence en lecture de trace :
NNNN<0 avertissement NNNN>0 erreur
3.7 Le serveur batch
La tâche batch comptable
Exploitation / Serveur batch / Tâche comptabilité
La tâche comptable est un cas particulier de tâche batch :
elle a pour code ACCBATCH
elle doit être lancée en permanence dans chaque dossier d'exploitation
elle met à jour les écritures comptablescréées depuis les autres modules(ventes, achats, stocks, gestion de production, immobilisations,comptabilité tiers, comptabilité générale)
On ne peut lancer qu'une seule tâchecomptable par dossier.
Elle possède une fonction de surveillanceparticulière
3.7 Le serveur batch
Fonctionnement de la tâche comptable
Exploitation / Serveur batch / Tâche comptabilité
Tâche batch comptable
Tâche batch comptable
Pièces temporaires (en attente)Pièces temporaires (en attente) Pièces finalesPièces finales
Interface comptable
Échéances(GACCDUDATE)
Lignesanalytiques
(GACCTMPA)
Lignesd’écriture
(GACCENTRYD)
En-tête depièces
(GACCENTRY)
Balances(BALANCE,BALANA)
Lettragesen attente
(MTCBATCH)
Lignesanalytiques
(GACCTMPA)
Lignesd’écriture
(GACCTMPD)
En-tête depièces
(GACCTMP)
Facture
Avoir
Mvt. de
stock
Abonnement
compta
3.7 Le serveur batch
4. Administration
1- Généralités
1.1 Définition du superviseur 1.2 Rappels sur l’architecture
technique 1.3 Organisation des fonctions 1.4 Paramétrage et développement 1.5 Sociétés et sites
2- Paramétrages de base
2.1 Introduction aux formules Adonix 2.2 Paramètres de base 2.3 Workflow 2.4 Paramétrages des fonctions
3- Exploitation
3.1 Imports et exports 3.2 Gestion des états 3.3 Destinations d’impression 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 développement
5.1 Pérennisation et codes activités 5.2 Tables et index 5.3 Types de données : menus
locaux, tables diverses
5.4 Ecrans et fenêtres 5.5 Nouveaux paramètres 5.6 Fonctionnement de base d’un
objet
Définition d’un dossier
4.1 Gestion des dossiers
Paramétrage / Paramètres généraux / Dossiers
DOSSIERDOSSIER
Règles Règles ParamètresParamètres
DonnéeDonnéess
Dev. spécifiquesDev. spécifiquesDictionnairesDictionnaires
Habilitations, signatures, législation comptable…
Tables, écrans, objets, états…Traitements, écrans spécifiques…Clients, comptes généraux, fournisseurs…
Structures de sociétés, paramètres généraux, dimensions…
Un dossier ADONIX X3 :
stocke un référentiel (paramétrage, développement spécifiques)
gère des données (statiques, mouvements)
MouvemenMouvementsts
Factures, Commandes, Ecritures
Définition d’un dossier
Paramétrage / Paramètres généraux / Dossiers
Au niveau technique, un dossier est composé :
d’un user au niveau base de données,auquel sont rattachés : des tables stockant les paramètres et les données d’index, de séquences…
d’un répertoire situé sur le serveur d’applicationcontenant, dans des sous-répertoires : des descriptions d’écrans et de fenêtres la description externe des tables de la base du code exécutable par le moteur des états Crystal Reports
DEMO
BPARTNER
tableAdonix.DEMO.BPARTNE
RUtilisateur
final
Authentification X3:Code User X3 = "JEANDUPONT"
Authentification SQL:Code user = "DEMO"
4.1 Gestion des dossiers
Paramétrage / Paramètres généraux / Dossiers
TESTTESTDossier
test/prototype
HéritageHéritage
FINALFINALDossier
d'exploitation
HéritageHéritage
Un dossier est créé en référence à un autre dossier qui : Existe sur le même serveur Contient tous les modules désirés Devient le dossier de référence pour le dossier créé Peut être X3 (par défaut)
X3X3
ARCHITECTURE ARCHITECTURE À 2 NIVEAUXÀ 2 NIVEAUX X3X3
ARCHITECTURE À TROIS NIVEAUXARCHITECTURE À TROIS NIVEAUX
FINALFINALDossier
d'exploitation
Hérita
gH
érita
gee
TESTTESTDossier
test/prototype
Hérita
gH
érita
gee
Outils de copie - PatchesOutils de copie - Patches
4.1 Gestion des dossiers
Dossier et héritage
Concrètement, l'héritage consiste en deux points Concrètement, l'héritage consiste en deux points ::
Lorsqu'un dossier est créé à partir d'un dossier mère, il hérite de certaines de ses données :
Les dictionnaires, qui décrivent la structure des tables, des écrans et d'autres objets d'X3.
Certaines données techniques (Menus locaux par exemple).
Dans certains cas, lorsqu'un dossier ne trouve pas un élément dans ses propres répertoires, il les recherchera dans les répertoires de son dossier mère, et ainsi de suite.
Ceci est vrai notamment pour les traitements standard, pour les états (fichiers Crystal Report™) et pour certaines tables que l'on trouve uniquement dans le dossier X3 (tables du serveur batch, par exemple).
Ceci permet à tous les dossiers d'un environnement d'exhiber le même comportement standard, tout en ayant des modifications spécifiques appartenant à chacun d'entre eux individuellement.
Il est par ailleurs possible, à la création d’un dossier, de reprendre des données issues d’un dossier de copie qui n’est pas son dossier mère.
X3X3
X3X3
TESTESTT
FINAFINALL
TESTESTT
FINAFINALL
4.1 Gestion des dossiers
Les dossiers standards
Paramétrage / Paramètres généraux / Dossiers
A l’installation, 3 dossiers sont livrés :
X3 est le dossier de référence qui contient : la description de toutes les tables standard une partie seulement des tables (les tables stockant des
paramètres) tout le code standard livré (programmes, écrans, fenêtres) un jeu de paramètres de référence relatif à une législation donnée certaines tables communes (notamment la table des dossiers)
DEMO est un dossier de démonstration complet
SERVX3 est un dossier technique qui gère le serveur batch
4.1 Gestion des dossiers
La fiche dossier
Paramétrage / Paramètres généraux / Dossiers
Un dossier est d’abord décrit par une fiche dossier stockée dans le dossier X3 :
Elle permet de définir les paramètres de base du dossier
Sa validation va provoquer la création du dossier, c’est-à-dire : Créer les répertoires du dossier sur le serveur. Créer un user dans la base de données. Ajouter une ligne dans le fichier de configuration des dossiers (x3appli.ini). Transférer et valider le dictionnaire des objets à partir du dossier de référence. Copier certaines données de base à partir du dossier de copie.
Sa revalidation va permettre de : Mettre à jour le dictionnaire des objets à partir du dossier de référence (en
protégeant les éléments spécifiques). 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 Général
Paramétrage / Paramètres généraux / Dossiers
Caractéristiques générales :
Base de données utilisée
Taille de la base
Codage (UNICODE)
Caractéristiques propres à chaque base
Dossier de référence
Dossier utilisé pour les copies de données
Dossier historisé (pour info)
Date de début 1er exercice
Modules utilisés
Indicateurs Test et Spécifique
Longueur des codes des tables diverses
4.1 Gestion des dossiers
La fiche dossier et les codes activité
Paramétrage / Paramètres généraux / Dossiers
Les codes activité sont des codes sur trois caractères, affectés à des éléments des dictionnaires X3 pour les activer, les désactiver ou les dimensionner.
Les codes activité peuvent être de 4 types : Options classiques : Activation/Désactivation d'un élément du dictionnaire selon que le code
soit actif ou inactif. Localisations : Même utilisation que les options, mais ces options sont spécifiques à une
législation donnée. Ils commencent généralement par la lettre K. Dimensionnement : Ces codes possèdent une dimension et sont affectés à des champs ou à
des tableaux (écrans dimensionnés) pour en définir les dimensions maximales. Spécifiques: Codes activité affectés aux éléments spécifiques pour les protéger. Ils doivent
impérativement commencer par X, Y ou Z.
Les codes activité d'un dossier donné sont stockés dans la table ADOSACT dans le dossier X3, et dans la table ACTIV dans le dossier même. À partir d'X3 : Dossiers / Dossiers. À partir du dossier fille : Développement / Dictionnaire données / Codes activité
On retrouve, dans différents onglets de la fiche Dossier, des valeurs de code activité à renseigner.
4.1 Gestion des dossiers
La fiche dossier onglets Options
Paramétrage / Paramètres généraux / Dossiers
Il permet d’activer ou de
désactiver des codes
activité qui définissent des
champs et fonctions
optionnelles du progiciel :
D’une part les options
D’autre part les localisations.
4.1 Gestion des dossiers
La fiche dossier onglet Ecrans
Paramétrage / Paramètres généraux / Dossiers
Il permet d’activer ou de
désactiver des codes
activité qui définissent les
dimensionnements d’écrans
du progiciel :
La plupart sont un nombre maximum de lignes dans un document
Certaines structurent la base de données (nombre d’axes analytiques, de montants statistiques…)
4.1 Gestion des dossiers
La fiche dossier onglet Tables
Paramétrage / Paramètres généraux / Dossiers
Les paramètres de dimensionnement permettent à X3 de calculer la taille Les paramètres de dimensionnement permettent à X3 de calculer la taille de chaque table de la base de données et la taille physique globale.de chaque table de la base de données et la taille physique globale. Les tailles individuelles des tables peuvent être modifiées à tout
moment. La taille physique totale est définie à la création du dossier
uniquement.
Les paramètres de dimensionnement saisis dans la fiche dossier sont Les paramètres de dimensionnement saisis dans la fiche dossier sont utilisés dans des utilisés dans des formules de dimensionnementformules de dimensionnement. Les paramètres et les . Les paramètres et les formules sont modifiables dans le dictionnaire de données (en formules sont modifiables dans le dictionnaire de données (en développement).développement).
VOUCHER = 1000VOUCHER = 1000
Nombre d'écritures comptables à conserver
Taille de la table des entêtes de pièces comptables:On considère qu'il y a en moyenne :
• 2,5 lignes d'écritures par entête
• 1,5 lignes de détail analytique par ligne d’écriture.
Taille de GACCENTRY:
arr(VOUCHER/2.5, 100) = 400 fiches.
Table GACCENTRY[en-tête de pièces]
Table GACCENTRYD[lignes d’écritures]
Taille de GACCENTRYD:
VOUCHER
= 1000 fiches.
Table GACCENTRYA[détail analytique]
Taille de GACCENTRYA:
arr(VOUCHER*1.5,100)
= 1500 fiches.
4.1 Gestion des dossiers
La fiche dossier onglet Tables
Paramétrage / Paramètres généraux / Dossiers
On saisit dans cet onglet la valeur des variables (telles VOUCHER) :
Ces variables sont utilisées 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
Paramétrage / Paramètres généraux / Dossiers
Cet onglet permet de paramétrer :
Un transfert de données d’un dossier de copie vers le dossier à la première validation (ou au rajout d’un module dont dépendent les données copiées)
Les langues dans lesquelles le dossier va être accessible en connexion
La devise de reporting, commune à toutes les sociétés du dossier
Des valeurs par défaut (langue, pays)
Un forçage des validations de transaction
4.1 Gestion des dossiers
La fiche dossier onglet Connexion
Paramétrage / Paramètres généraux / Dossiers
Ces informations correspondent à la boîte de connexion du client X3. À
la validation (ou revalidation) du dossier,
elles sont reportées dans le fichier x3appli.ini afin d'être éventuellement téléchargées sur les
différents postes clients.
4.1 Gestion des dossiers
La fiche dossier onglet Spécifiques
Paramétrage / Paramètres généraux / Dossiers
On définit ici les activations de paramètres spécifiques :
• Actif (Oui/Non)
• ou en dimension selon les cas
L’indicateur Vertical signifie que le spécifique est défini dans un dossier intermédiaire et est remis à jour à chaque revalidation de dossier à partir du dossier de référence
4.1 Gestion des dossiers
La fiche dossier onglet Divers
Paramétrage / Paramètres généraux / Dossiers
On définit ici des paramètres techniques dont les valeurs (sauf exception) ne doivent pas être modifiées :
• elles sont stockées 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
Paramétrage / Paramètres généraux / Dossiers
La revalidation d’un dossier permet de :
• Mettre à jour une version (les modifications du standard vont être appliquées, des traitements complémentaires de mise à jour automatiquement appliqués si nécessaire)
• Tranférer les développements verticaux d’un dossier de développement vers un dossier qui en dépend
Il est important de tours vérifier la trace de dernière validation !
Dans une architecture à 3 niveaux, pour appliquer des évolutions standard :
• On revalide toujours le dossier intermédiaire d’abord
• Puis on remet à jour le dossier de plus bas niveauL’import d’un dossier permet de :
• Créer la fiche d’un dossier à partir d’une arborescence existante
• Normalement, ceci est fait après la restauration d’un dossier dans un environnement ouù il n’existait pas
4.1 Gestion des dossiers
Exploitation / Historisation/Epuration
Les fonctions d'épuration ou d’historisation traitent les données :
De type mouvement uniquement (on n’épure ou on n’archive pas les clients ou les articles, mais les factures, les commandes, les écritures)
Définies sous la forme de groupes de tables liées.
Satisfaisant certaines conditions de cohérence (formules d'épuration) fournies en standard mais modifiables en spécifique.
Ayant atteint ou dépassé une période de conservation prédéfinie (paramètres d'épuration et d’archivage).
Les fonctions d’historisation :
Supposent la création d’un dossier dans lequel les données archivées vont être stockées.
Se définissent par groupe de tables.
4.2 Epuration et historisation
Création d’un dossier d’historisation
Développement / Utilitaires / Dossier / Création dossier historisé
Un dossier historisé est un dossier particulier, associé au dossier d’exploitation, qui se définit par :
Un nom (HDOSSIER par défaut).
Des paramètres de taille globale.
Des paramètres base de données.
Un coefficient exprimant la tailledes tables historisées par rapportaux tailles des tables d’origine.
Un profil menu, donnant accès àdes fonctions de consultation, quisera le profil par défaut quand onentrera dans ce dossier.
4.2 Epuration et historisation
Principes de base
Exploitation / Historisation/Epuration
L’historisation transfère définitivement les données archivables (ie. répondant aux critères) datées de plus de N1 jours ou mois dans le dossier archive
L’épuration épure définitivement les données non archivables datées de plus de N’1 jours ou mois, et les données archivées datées de plus de N2 jours ou mois
Groupe de tables archivable
Groupe de tables non archivable
archivage
DOSSIER D’EXPLOITATION
DOSSIER D’ARCHIVAGE
épuration
4.2 Epuration et historisation
Définition des règles
Développement / Dictionnaire de données / Historisation/épuration
Ces règles sont fournies en standard dans le progiciel, leur modification relève de développement spécifique.
On associe à un code :
Un groupe de tables liées
Des formules qui doivent être vérifiées pour que l’épuration soit possible
Des informationssociété/site,et date de référence
Un traitement decontrôle standard,personnalisable parun traitement spécifiquecomplémentaire
!
4.2 Epuration et historisation
Paramètres d’épuration / historisation
Paramétrage / Exploitation / Paramètres épurations
On définit, pour chaque groupe de données :
Si on épure et/ou si on historise
La durée minimale (en jours)de conservation des données
La fréquence de lancementpour le groupe(ie. le nombre minimum dejours à attendre depuis ladernière épuration ouhistorisation)
La date de lancement de ladernière opération est affichée
4.2 Epuration et historisation
Lancement de l’historisation/épuration
Exploitation /Historisation / épuration
Cette fonction peut être lancée en direct et en batch (tâche AHISTO)
Les paramètres à saisir sont :
Le groupe de tables concerné
L’opération désirée(historisation, épuration, ou les deux)
Une sélection société
Un flag simulation (seule unetrace de ce qui serait traitéest alors créée)
Un flag détail (s’il est actif,la liste détaillé des clés des lignes purgées est écrite dans la trace)
4.2 Epuration et historisation
Visualisation des données historisées
[ Connexion au dossier d’historisation ]
La visualisation se fait en se connectant sur le dossier historisé
Les données accessibles sont :
Les données historisées sur les tables historisées (les données non historisées ne sont pas visibles)
Les données présentes dans le dossier d’exploitation sur toutes les tables non historisées (par héritage)
DOSSIER D’EXPLOITATION DOSSIER D’ARCHIVAGEConnexion au dossier archive
accès direct
accès direct
héritage
héritage
4.2 Epuration et historisation
Gestion des versions
4.3 Gestion de patches et de version
Les versions sont numérotés sur 3 chiffres X.Y.Z :
X = génération 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 : première version officielle, 06/1999
120 : première version distribuée, 04/2000 (120 à 126)
130 : première version Web, 06/2001 (130 à 138)
140 : dernière version majeure, 09/2004
Passage d’une version à une autre
Passage de version X.Y1 à X.Y2 : utilisation d’un support (CD)
Mise à jour des clients (si nécessaire)
Mise à jour du serveur X3 et des serveurs Web (si nécessaire)
Revalidation de dossier obligatoire
Pas de passage en réel sans test et validation préliminaire
Passage de version X.Y.Z1 à X.Y.Z2
Soit par installation de CD et revalidation (comme ci-dessus)
Soit par installation de patches consécutifs
4.3 Gestion de patches et de version
Passage de patches
Un patch est un fichier d’archives :
Numéroté à partir du début d’une version majeure (X.Y) de 1 à N
Contenant une correction ou mise à jour « consistante » : code applicatif, description de structure de données, données, voire demande d’exécution d’un utilitaire…
Installable par une fonction très simple d’administration
Pour plus de facilité, les patches sont organisées en listes
Numérotées à partir du début d’une version majeure (X.Y) de 1 à M
Une version mineure correspond à une liste de patches donnée
Ces dépendances sont visibles dans un fichier nommé X3PATCHXY0, livré avec toute liste de patches
Développement / Utilitaires / Patch / …
4.3 Gestion de patches et de version
Exemple de la version 130
Contenu du fichier X3PATCHV130.htm
Développement / Utilitaires / Patch / …
4.3 Gestion de patches et de version
Les limites du passage de patches
Les patches ne permettent pas de remettre à jour :
Les données de paramétrage situées dans le dossier de référence X3
Le moteur installé sur le poste client (une procédure n’installant que une nouvelle version de moteur existe)
Le moteur du serveur (même remarque)
Le moteur du serveur Web (même remarque)
L’aide en ligne (elle peut être installée indépendamment du reste)
Les patches doivent être installés séquentiellement :
Un patch suppose que les précédents aient été installés
Mais il est possible d’installer une version intermédiaire quand on est très en amont du numéro de patch en cours
Développement / Utilitaires / Patch / Intégration de patch
4.3 Gestion de patches et de version
Les précautions à prendre
Il est bon de lire attentivement le fichier X3PATCHVxxx
Il précise les points particuliers (changement de structure pouvant nécessiter de la place disque, par exemple)
Il est hautement recommandé d’être le seul connecté sur le dossier à patcher :
C’est obligatoire si une table change de structure
C’est préférable dans les autres cas (pour éviter une persistance de code en mémoire)
Dans certains cas, on doit quitter la session avant de passer une autre liste de patches
Si des spécifiques ont été réalisés, il est conseillé :
D’utiliser le testeur de patches pour vérifier d’éventuels conflits
De tester les spécifiques sur lesquels des conflits potentiels ont été détecter
Développement / Utilitaires / Patch / Intégration de patch
4.3 Gestion de patches et de version
Le testeur de patches
Il permet de vérifier les conflits potentiels lors de l’installation de patches :
Traitement standard ou état standard dupliqué dans un dossier patché et présent dans le patch
Présence de spécifique sur un deséléments patchés (le programmesignale ce qui a été protégé parun code activité spécifique)
Il peut être utilisé pour l’installationd’une nouvelle version mineure :
des fichiers List_nn.dat présentssur le répertoire X3Patch du CDd’une version permettent deréaliser le test sur les listes depatch équivalant au passage de version
Développement / Utilitaires / Patch /Test de patch
4.3 Gestion de patches et de version
Quels dossiers patcher ?
Un patch s’installe dossier par dossier :
Lorsqu’on veut tester un patch, on peut l’installer sur un dossier de test dédié ( paramètre Dossier de test égal à Oui )
Lorsque l’installation est définitive, il doit être installé à la fois sur le dossier X3 et les dossiers d’exploitation
On peut choisir d’intégrer unfichier unique ou l’ensembledes fichiers contenus dans unrépertoire (c’est le cas d’une liste)
En ne cochant pas la caseIntégration de patch, on lit lecontenu des fichiers de patch
Liste des dossiers à patcher
Développement / Utilitaires / Patch / Intégration de patch
4.3 Gestion de patches et de version
Consultation de patches
Cette fonction permet de voir les patches déjà passés sur un dossier donné :
Développement / Utilitaires / Patch / Consultation de patch
Clé (numérotation automatique)
Nom complet du fichier
Le préfixe PX est caractéristique des patches standards sur X3
Numéro de maintenance
Utilisé, à préfixe égal, pour le contrôle de séquentialité
Numéro de liste de patch
4.3 Gestion de patches et de version
Définition d’une session X3
Une connexion à ADONIX X3 provoque l’ouverture d’une session :
identifiée de façon unique pour un serveur d’application donné
d’un type donné
Les types de connexion sont les suivants : Session primaire (connexion classique d’un utilisateur,
depuis un poste en client-serveur ou en Web) Session secondaire ouverte à partir d’une session primaire :
Par Fichier / Nouvelle session Par un raccourci clavier (Shift F5 à Shift F12,
paramétrable par utilisateur) Session batch (déclenchée par le serveur batch)
Session ADAPI (appel à une API ADONIX)
4.4 Gestion des sessions
Contrôle des sessions X3
La licence définit le nombremaximum de sessions possiblespar type :
La licence est définie parle fichier serial_adonixinstallé dans le répertoire.serialisation sur le serveurd’application
Elle définit aussi des limitesfonctionnelles liées à lalicence (cadre de droite)
Développement / Utilitaires / Divers / Visu licence
4.4 Gestion des sessions
Contrôle des sessions autorisées
Il est possible de contrôler le nombre de sessions ouvertes :
Pour un utilisateur donné, par les paramètres utilisateur MAXSES1 (nombre maxi de sessions primaires) et MAXSES2 (nombre maxi de sessions secondaires)
Globalement, en passant un dossier en mode mono-utilisateur (personne d’autre ne peut alors se connecter)
Pour un type de profil menu donné dans un dossier donné (paramètres USR1, USR2, USR3)
Il est possible de provoquer une déconnexion automatique d’un utilisateur :
En cas d’inactivité clavier/souris au bout de TIMEHGUP1 ou TIMHEHGUP3 secondes (valeur de paramètres utilisateurs pour sessions primaires / secondaires)
Avec un avertissement et un délai de grâce de TIMEHGUP2 secondes (idem)
Si ces paramètres sont nuls, il n’y a pas de déconnexion automatique
4.4 Gestion des sessions
Visualisation des sessions en cours
Cette fonction permet de :
Visualiser les connexions en cours (tableau supérieur) sur un serveur d’application et un service donné (machine:service)
Visualiser les processus correspondants et les interrompre si on est habilité
Développement / Utilitaires / Divers / Surveillance utilisateurs
4.4 Gestion des sessions
Des utilitaires divers sont fournis :
Ils font pour la plupart partie du développement
Ils peuvent avoir des incidences sur la cohérence de la base ou du dossier
Ils sont donc à manipuler avec précaution :
Maintenance (mode fiche, maintenance en colonne, transactions système)
Vérifications (Infos version, Vérif cohérence, Symboles et traitements verrouillés)
Utilitaires dictionnaire (copies, génération et validations, comparaisons)
Remise à zéro dossier
Gestion mono/multi, déverrouillage
Recherches
Extraction / Intégration
Optimisations de la base (Etat des tables, Recherche index, Analyse mémos, Optimisation base de données)
Développement / Utilitaires / …
!
4.5 Utilitaires
Maintenance :
Ces outils permettent d'accéder aux données contenues dans la base X3 :
sans aucune forme de contrôle
Maintenance en lignes : Accès aux enregistrements d'une table un par un. Maintenance en colonnes : Accès aux enregistrements sous forme de
tableaux. Transaction système : Mise à jour massive des données d’une table
ces fonctions sont des outils dangereux qui ne doivent être réservés qu'à l'installateur du logiciel !
Développement / Utilitaires / …
4.5 Utilitaires
Les écrans de maintenance
Développement / Utilitaires / Maintenance
4.5 Utilitaires
Les écrans de maintenance en colonnes
Développement / Utilitaires / Maintenance en colonnes
4.5 Utilitaires
Développement / Dictionnaire traitements / Transactions système
Transactions système : définition
Table principale mise à jour
Tables liées et clé de lien
Paramètres à saisir au lancement :
-Intitulé
-Type de données
-Valeur par défaut
-Table de contrôle
Formules de sélection
Pouvant faire appel aux valeurs de paramètres (V1,V2,V3…)
Description des mises à jour
(Création, mise à jour de champs, suppression)
Les transactions système sont utilisées pour effectuer des mises à jour en masse de la base de données (création, modification ou suppression de lignes), à partir d'une transaction définie dans le dictionnaire des traitements.
4.5 Utilitaires
Développement / Utilitaires / Divers / Transactions système
Transactions système : utilisation
Code transaction à exécuter
Valeurs de paramètres à utiliser
En mode test, on peut définir le nombre de transactions à simuler
4.5 Utilitaires
Infos version :
Cette fonction donne les numéros de version :
du moteur sur le serveur
du superviseur
de l’applicatif
La version du client est obtenue à partir
du menu principal du poste client :
Développement / Utilitaires / Vérification …
4.5 Utilitaires
Verification de cohérence :
Cet utilitaire parcourt toutes les tables du dictionnaire
et vérifie l'intégrité référentielle des liens (existence
des enregistrements liés pour chaque ligne de la table).
La description de la base est parfois imparfaite, cequi peut provoquer de fausses erreurs.
L'exécution de cet utilitaire peut être très longue : il est conseillé d'utiliser les bornes de tables et/ou de limiter par module.
Développement / Utilitaires / Vérifications / Vérif cohérence
4.5 Utilitaires
Symboles et traitements verrouillés :
X3 utilise des verrous applicatifs :
Pour des opérations longues hors transaction
Utilisés par les objets est en modification defiche (temps de saisie important)
Erreur et symbole de verrouillage :
Stockés dans la table APLLCK
A ne pas confondre avec le verrouillage induit par des transactions, géré par la base de données (row level locking), durée limitée par le temps de la transaction (aucun temps d’attente utilisateur)
X3 utilise des verrous fichiers (TRAITEMENT.LCKsrc):
Pour verrouiller des fichiers en coursd’édition (développement)
Erreur et symbole de verrouillage :
Développement / Utilitaires / …
4.5 Utilitaires
Symboles verrouillés :
Un zoom est possible de cette fonction vers la gestion des sessions
Développement / Utilitaires / Vérifications / Symboles verrouillés
Traitements verrouillés : Une suppression du verrou est possible (par clic droit)
Développement / Utilitaires / Vérifications / Traitements verrouillés
4.5 Utilitaires
Utilitaires dictionnaire :
Ces outils permettent de réaliserles opérations suivantes :
Validation d'objets
Développement / Utilitaires / Dictionnaire / Validation
Développement / Utilitaires / Dictionnaire / Copie dictionnaire
Copie d'éléments d'un dossier vers un autre
4.5 Utilitaires
Utilitaires dictionnaire (suite) :
Développement / Utilitaires / Dictionnaire / Différence d’objets
Ces outils permettent de réaliser
les opérations suivantes :
Comparaison d’objets générant une trace plus ou moins détaillée
4.5 Utilitaires
Utilitaires dictionnaire (suite) :
Développement / Utilitaires / Dictionnaire / Génération de transactions
Développement / Utilitaires / Dictionnaire / Copie de transactions
Ces outils permettent de réaliserles opérations suivantes :
Génération du code associé aux transactions applicatives paramétrables
Copie de transactions applicatives paramétrables vers un autre dossier
4.5 Utilitaires
Utilitaires dictionnaire (suite) :
Développement / Utilitaires / Dictionnaire / Validation des fonctions
Développement / Utilitaires / Dictionnaire / MAJ menus locaux
Développement / Utilitaires / Dictionnaire / Copie de traitements
Ces outils permettent de réaliser les opérations suivantes :
Validation des fonctions : permet de mettre à jour la table croisée d'habilitation sites / fonctions / profils.
Mise à jour des menus locaux : Permet d'exporter lesfichiers de menus locaux dans les répertoires de publication (client/serveur et web).
Copie de traitement : transfère un traitement (et sa description dans le dictionnaire des traitements)d’un dossier à l’autre
4.5 Utilitaires
Utilitaires dossiers :
Changement de dossier : permet une reconnexion sur un autre dossier
Remise à zéro dossier
Cet utilitaire remet à zéro les mouvements dansla base de données, sans remettre à zéro lesdonnées permanentes.
Attention, utilitaire irréversible ! Les mouvements sont identifiés dans le dictionnaire :
Une table marquée Raz est vidée Un champ marqué Raz reçoit une valeur nulle Les compteurs marqués Raz sont remis à zéro
Utile en cas de démarrage réel après un démarrage test, par exemple
Développement / Utilitaires / Dossiers / Changement de dossier
Développement / Utilitaires / Dossiers / Remise à zéro dossier
4.5 Utilitaires
Utilitaires dossiers (suite) :
Déverrou dossier : supprime le verrou empêchant laconnexion à un dossier lors de sa revalidation dedossier (ce verrou peut rester en place en casd’arrêt brutal lors d’une revalidation)
Import dossier : crée la fiche Dossier à partir d’un fichier se trouvant dans le répertoire du dossier (utile en cas de transport d’un dossier d’un serveur à un autre, correspond à l’item 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 forcément le profil fonction de l’administrateur
Passage en mode multi : sortie du mode mono-utilisateur
Développement / Utilitaires / Dossiers / Déverrou dossier
Développement / Utilitaires / Dossiers / Import dossier
Développement / Utilitaires / Dossiers / Mode mono
Développement / Utilitaires / Dossiers / Mode multi
4.5 Utilitaires
Utilitaires de recherche :
Ces utilitaires permettent de rechercher des éléments de développement dans les dictionnaires d’ADONIX X3 :
Codes activité (dans les tables, écrans, fenêtres, objets… qui composent un dossier)
Types de données (dans les écrans, tables…)
Codes d’accès (dans les écrans et les autres tables)
Messages (dans la base de données des messages traduisibles)
Textes (Références croisées de l’utilisation des textes dans les éléments du dictionnaire)
Développement / Utilitaires / Recherche
4.5 Utilitaires
Utilitaires de sauvegarde :
Ces utilitaires permettent d’extraire ou d’intégrer des données :
A partir ou vers des fichiers (4 à 6 par table) ayant un format « à plat »
Sous un format indépendant de la base de données
Sous un format indépendant du système d’exploitation
Transportables par simple copie
Ce ne sont pas des outils normaux d’exploitation :
Ils font des extractions table par table sans garantir de cohérence globale si des modifications ont été faites entre temps, la base devant rester active
Ils n’ont pas les performances des procédures de sauvegarde fournies avec les bases de données
Ils sont par contre utilisables en maintenance :
Notamment pour transférer des donnée d’une base à une autre
Mais aussi pour transmettre des données à la hot-line ADONIX
Développement / Utilitaires / Sauvegarde / …
4.5 Utilitaires
Utilitaires de sauvegarde :
Chaque table est extraite ou intégrée à partir de 4 à 6 fichiers :
TABLE.srf : description ascii de la structure de la table
TABLE.fde : description « compilée » de la structure de la table
TABLE.dat : données de la table rangées « à plat »
TABLE.seq : valeur de séquence rattachée à la table
TABLE.blb : données de type blobs ou clobs (images, textes) stockés dans la table (s’il y en a)
TABLE.cfg : configuration de la table dans la base de données si elle existe
L’extraction ou l’intégration se fait dans ou depuis un répertoire :
du serveur d’application
qui doit forcément être sur le même volume que le répertoire du dossier
qui est par défaut le répertoire SVG
4.5 Utilitaires
Développement / Utilitaires / Extraction / Intégration
Utilitaire d’extraction de données :
Paramètres d’extraction :
Dossier, table(s) à exporter (sous la forme de modèle de nom), et répertoire de sauvegarde
Indicateurs :
Copie du fichier .cfg (Oui/Non)
Taille réelle dans srf
Ce dernier indicateur permet :
de stocker dans les fichiers .fde et .srfla taille réelle de la table au momentde l’extraction (pas sa taille prévue)
de remonter les données dans unenvironnement dimensionné au plusjuste
4.5 Utilitaires
Développement / Utilitaires / Extraction / Intégration
Utilitaire d’intégration de données :
Paramètres d’extraction :
Dossier, table(s) à exporter (sous la forme de modèle de nom), et répertoire de sauvegarde, et deux indicateurs
Indicateur Fichiers de config d’origine
Permet d’ignorer le fichier .cfg présentdans le répertoire de sauvegarde
Utile par exemple pour remonter dans unenvironnement d’exploitation correctementdimensionné des données issues d’unenvironnement de test et de reprise
Indicateur Taille d’origine
Permet d’ignorer la taille présente dansle fichier .srf au profit de celle de la tabled’origine (si elle existait avant intégration)
Développement / Utilitaires / Extraction / Intégration
4.5 Utilitaires
Utilitaires d’optimisation de base :
ADONIX X3 crée automatiquement la base de données en :
Dimensionnant les tables à partir d’une taille prévue à l’origine
Tenant compte de fichiers de configuration
Créant les index nécessaires à un fonctionnement normal
Mais, dans le temps, les performances peuvent être affectées :
Par une évolution de la volumétrie différente de ce qui était prévu
Par l’utilisation de sélections mémorisées sur des tables importantes
Par la mise en place de filtres rôle sur des tables importantes
Par des incidents d’exploitation (non création d’un index standard)
Des outils de diagnostic et de paramétrage vont permettre d’y remédier
4.5 Utilitaires
Etat des tables :
Cet outil permet de vérifier les caractéristiques de chaque table de la base
Permet de constater si des tables ont été mal dimensionnées
Développement / Utilitaires / Vérifications / Etat des tables
4.5 Utilitaires
Recherche des index :
Le dictionnaire des tables décrit des index dont ADONIX X3 se sert fréquemment :
Ils définissent des ordres de recherche et des critères de sélection privilégiés
Ils sont utilisés par les programmes standard
A l’exécution des requêtes :
La base reçoit les critères de sélection et de tri
Elle se sert des index s’ils existent réellement
Mais est tout de même capable de répondre à la requête si les index n’existent pas… au détriment de la charge machine et des temps de réponse…
Il arrive que des index soient déclarés, mais non créés :
Si une revalidation de la table n’a pas été faite
Si un incident (pas assez de place sur un tablespace) empêche leur création
Cet utilitaire permet de vérifier si les index sont bien présents
Développement / Utilitaires / Vérifications / Recherche index
4.5 Utilitaires
Analyse des mémos :
En gestion d’objet, il est possible de créer des sélections mémorisées :
Sur des tables importantes
Portant sur des champs non indexés
Parfois partagée par un ensemble d’utilisateurs
A l’exécution les requêtes liées sont :
Lourdes (pas d’index, table importante)
Fréquente (à chaque affichage ou rafraîchissementde liste gauche, d’autant plus fréquente si le mémoest partagé et/ou standard)
L’outil d’analyse de mémos va donner une liste des problèmes rencontrés
On peut agir en amont :
Le paramètre SELWARN définit un nombre de lignes limite dans une table.
Au dessus de ce nombre de lignes, l’enregistrement d’une sélection non performante est refusé ou provoque un avertissement selon la valeur du paramètre AUZMEMO
Développement / Utilitaires / Vérifications / Analyse mémos
4.5 Utilitaires
Optimisation base de données :
Des filtrages de données peuvent être définis par paramétrage sur des tables importantes :
Par des sélections mémorisées
Par des filtres
Par l’utilisation de codes d’accès
Les requêtes liées peuvent être d’autant plus lourdes :
Qu’elles sont fréquemment lancées
Qu’aucun index standard n’est adapté pour leur optimisation
On peut alors créer des index supplémentaires dans la base :
Activables ou désactivables à la demande
Sur des champs indicés (ce qui est impossible dans le standard)
Paramétrage / Exploitation / Optimisation base de données
4.5 Utilitaires
Optimisation base de données :
Des index d’optimisationstandard sont livrés :
Liés aux filtres par rôles
Sur certaines consultations (en fonctions des axes analytiques souvent utilisés)
Pour optimiser certaines opérations (suppressions, épurations…)
Règle de nommage : SPE_*
On peut en créer autant que nécessaire
Paramétrage / Exploitation / Optimisation base de données
4.5 Utilitaires
5. Introduction au développement
1- Généralités
1.1 Définition du superviseur 1.2 Rappels sur l’architecture
technique 1.3 Organisation des fonctions 1.4 Paramétrage et développement 1.5 Sociétés et sites
2- Paramétrages de base
2.1 Introduction aux formules Adonix 2.2 Paramètres de base 2.3 Workflow 2.4 Paramétrages des fonctions
3- Exploitation
3.1 Imports et exports 3.2 Gestion des états 3.3 Destinations d’impression 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 développement
5.1 Pérennisation et codes activités 5.2 Tables et index 5.3 Types de données : menus
locaux, tables diverses
5.4 Ecrans et fenêtres 5.5 Nouveaux paramètres 5.6 Fonctionnement de base d’un
objet
Codes activité : rappels
5.1 Pérennisation et codes activité
Un code activité est un code sur 3 caractères :
Défini dans un dictionnaire
Permettant de rendre optionnel des éléments du logiciel
Permettant de signer un spécifique, s’il commence par X,Y,ou Z.
Tout développement spécifique doit être marqué par un code activité :
Sinon, il sera perdu lors d’une revalidation de dossier
Mais il doit être marqué au niveau le plus fin possible Champ dans un écran plutôt que Bloc ou Ecran lui-même Champ ou Index dans une table plutôt que Table elle-même
Certains cas particuliers ne nécessitent pas de code activité :
Action SPE ou SPX dans un écran standard
Code action commençant par X, Y ou Z
Développement / Dictionnaire données / Codes activité
Le dictionnaire des tables
5.2 Tables et index
Il décrit la structure de la table :
Sur 3 onglets
Sa validation crée la table dans la base de données
Sa revalidation change la structure de la table
Champs de la table contenant les intitulés des fiches de la table, utilisés notamment pour les liens.
Permet à X3 de dimensionner la table dans la base de données. Si ce chiffre est différent de ce qui a été calculé
suite au dimensionnement dans les paramètres du dossier, la valeur la plus élevée sera prise en compte.
Indicateur signalant les tables de mouvement remises à zéro en Raz dossier.
Copie de données possible du Dossier de copie vers le dossier cible en création de dossier (si optionnelle, on précise le groupe de copie).
Développement / Dictionnaire données / Tables
Le dictionnaire des tables
L’onglet champ définit les champs et leurs caractéristiques
Les champs CREDAT, CRETIM,CREUSR, UPDDAT, UPDTIM,UPDUSR sont automatiquement mis à jour par l’objet de gestion associé
Développement / Dictionnaire données / Tables
5.2 Tables et index
Le dictionnaire des tables
L’onglet index :
définit les index de la table (un au moins doit exister)
permet de saisir des directives de configuration
Développement / Dictionnaire données / Tables
5.2 Tables et index
Le dictionnaire des types de données
Un type de données caractérise les champs présents
dans les écrans dans les tables dans les paramètres des états…
Il existe des types génériques :
A (alpha), C (entier court), D (date), L (entier long), M (menu local), DCB (décimal)
On leur associe une longueur (A), un numéro de menu (M), un nombre de chiffres et de décimales sous la forme N.M DCB)
Les autres types sont définis :
par référence à un type interne
en pouvant être associés à un objet (sélection, tunnel)
en nécessitant parfois des paramètres
La variable GLONXXX permet de connaître la longueur du champ de type XXX
Développement / Dictionnaire données / Types de données
5.3 Types de données
Les menus locaux et les tables diverses Les menus locaux correspondent au type M (suivi d’un numéro) :
Ils sont stockés sur un octet dans une table (valeur 0 à 255) Ils sont traduits en fonction de la langue de dialogue Ils sont téléchargés sur le poste client ou présents dans la description XML des écrans Web Leur valeur est stockée dans la table APLSTD Ils peuvent être définis avec un nombre de choix fixe ou variable (entre deux bornes),
modifiables ou non en paramétrage Il existe des bornes de numérotation pour les spécifiques (1000 à 2000)
Les tables diverses correspondent au type ADI :
Complété par un numéro de table (défini dans l’expression de lien)
De longueur maximale définie dans le paramétrage des tables diverses
Avec des intitulés traduisibles
Avec des champs complémentaires et des possibilités de dépendance
Les numéros spécifiques sont compris entre 1000 et 2000
Développement / Dictionnaire données / Paramétrage tables diverses
Développement / Dictionnaire données / Menus locaux
5.3 Types de données
Le dictionnaire des écrans
Un écran X3 est une partie d’une fenêtre du progiciel qui correspond :
à un onglet
au contenu d’une boîte de dialogue
ou à l’en-tête d’un objet
Il est organisé en blocs placés
comme les cases d’un damier
Chaque bloc contient des champs : en liste en tableau déroulant en boîte de texte
Développement / Dictionnaire traitements / Ecrans
5.4 Ecrans et fenêtres
Le dictionnaire des écrans
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 données etinformations rattachées(no de menu, longueur,objet graphique, tunnelet zone lien…)
Un code activité
Des actions définiesdans les tableauxci-dessous
Développement / Dictionnaire traitements / Ecrans
5.4 Ecrans et fenêtres
Le dictionnaire des fenêtres Une fenêtre est la réunion d’un ensemble :
d’écrans de boutons et de menus de listes gauches
Développement / Dictionnaire traitements / Fenêtres
5.4 Ecrans et fenêtres
Le dictionnaire des paramètres
Ce dictionnaire permet de définir des paramètres :
En les créant dans un chapitre (table diverse numéro 901)
En définissant leur niveaude paramétrage le plus fin :Dossier, Société, Site, Utilisateur
En leur associant unevariable globale qui seraautomatiquement crééeet renseignée (si le niveauest Dossier ou Utilisateur).
L’utilisation des variablesglobales est alors possibledans toute formule de calcul.
Développement / Dictionnaire données / Définition paramètres
5.5 Définition de nouveaux paramètres
Le dictionnaire des objets
5.6 Fonctionnement de base d’un objet
Un objet est la description d’une fonction de base à même de gérer :
Une table principale (et des tables liées)
Par le biais d’au moins unefenêtre (s’il en a plusieurs,un choix sera proposé :c’est ainsi qu’est réalisée lagestion de transactions)
C’est le modèle de base le plus
présent dans ADONIX X3.
Développement / Dictionnaire traitements / Objets
Le dictionnaire des objets On retrouve dans la définition d’un objet :
Des filtres génériques utilisables lors des appels par tunnel
La définition des champsde la liste gauche
Des informationscomplémentairespour l’importnotamment(onglet Environnement)
Développement / Dictionnaire traitements / Objets
5.6 Fonctionnement de base d’un objet
Merci
Recommended