Www.absyscyborg.com. SUPERVISEUR SAGE X3 ENTREPRISE V140.

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





3- Exploitation


4- Administration







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



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


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


Permettent de rendre génériques :

les paramétrages

l’ergonomie

De 3 types principaux

objets [ GFONCTION = GESXXX ]

consultations [ GFONCTION = CONSXXX ]

traitements [ GFONCTION quelconque ]


Le modèle objet

Liste(s)Liste(s) de gauchede gauche

OngletsOnglets

En-tête En-tête


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


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


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


Exécution du traitement Exécution du traitement

Saisie des critèresSaisie des critères

Affichage de traceAffichage de trace

Le modèle traitement


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


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…


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


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)



1.5 Sociétés et sites

2. Paramétrages de base

1- Généralités





3- Exploitation


4- Administration







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


Opérateurs

numériques

+ - * / ^

Date

Date – date

Date + nombre

Date - nombre

Caractères

Chaine + Chaine

Chaine - Chaine

Niveau de parenthésage illimité

Formules simples


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


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


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


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


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


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étrage / Paramètres généraux / Valeurs paramètres


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


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


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



Choix du chapitre et du niveau de définition :

• global

• société

• site

Possibilité de reprendrela valeur

« au-dessus »

Saisie des VP


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)


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)


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


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


Les tables diverses



Les tables diverses


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


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


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 ?


Les compteurs


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


Les compteurs


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


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


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


2.3 Workflow

Fonctionnement du moteur de 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


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


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


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


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


Sur le second onglet, on paramètre les autres listes de gauche standard

Paramétrage des objets : Personnalisation


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)


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

!


Navigation : principes de base


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


Sur le premier onglet, on paramètre les filtres sur l’objet

Navigation : définition détaillée


Code identifiantla navigation

Contexte :Fonction de départ

Objet d’arrivée

Filtres sur la liste gauche :Condition d’activation

Filtre


Sur le second onglet, on paramètre les valeurs par défaut

Navigation : définition détaillée


Champs des écrans

Formules des valeurs par défaut


Gestion des objets : 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


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


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.


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


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


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.


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


3. Exploitation

1- Généralités





3- Exploitation


4- Administration







objet

Définition générale

Modèles

Tables de transcodage


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


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



Exemple de séquence d’export chronologique :Exemple de séquence d’export chronologique :

EXPORT = 5

Modèle exportSOH

Commande 34EXPNUM = 2



EXPORT = 3

Modèle exportSOH

[C]EXPORT = 5Commande 34EXPNUM = 2



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




EXPORT = 9

Modèle exportSOH

[C]EXPORT = 10

La commande 34est exportée

[C]EXPORT = 9

3.1 Import / 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.


Le 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

!


Le dictionnaire des états : Premier onglet


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


Le dictionnaire des états : Deuxième onglet


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


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


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


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é


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.

!


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


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)


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)


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



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)



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


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


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.


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


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


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


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.


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


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


DOSSIER SERVX3

Serveur Batch(processus SERVX3)

Serveur Batch(processus SERVX3)

Table desrequêtes

(ABATRQT)

Polling périodique ??

Processus batch

Processus batch


Lancement

Interruption (time-out, demande d’arrêt)

Sessionutilisateur

Sessionutilisateur

Soumission

Soumission pardépose de fichier

AbonnementsTrace duprocessus

Trace duserveur


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



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


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


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


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é


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


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


requete.kil

Soumission de tâche par fichier


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)


Soumission de tâche par fichier


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


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


Les fichiers stratégiques du serveur


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


Trace détaillée d’une requête


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


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


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


4. Administration

1- Généralités





3- Exploitation


4- Administration







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


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"



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


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


Les dossiers standards


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


La fiche dossier


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.


La fiche dossier onglet Général


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


La fiche dossier et les codes activité


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.


La fiche dossier onglets Options


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.


La fiche dossier onglet Ecrans


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


La fiche dossier onglet Tables


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.


La fiche dossier onglet Tables


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


La fiche dossier onglet Init


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


La fiche dossier onglet Connexion


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.


La fiche dossier onglet Spécifiques


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


La fiche dossier onglet Divers


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.


Gestion des 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


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.


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’ARCHIVAGE

épuration


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

!


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


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)


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


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


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 / …


Exemple de la version 130

Contenu du fichier X3PATCHV130.htm

Développement / Utilitaires / Patch / …


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


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



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


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



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


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


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


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


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 !


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 :


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


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


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


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)


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





3- Exploitation


4- Administration







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


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é


5.2 Tables et index


L’onglet index :

définit les index de la table (un au moins doit exister)

permet de saisir des directives de configuration


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


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


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

Www.absyscyborg.com. SUPERVISEUR SAGE X3 ENTREPRISE V140.

Documents

Transcript of Www.absyscyborg.com. SUPERVISEUR SAGE X3 ENTREPRISE V140.