Les composants XSL

Planning mensuel

Graphe associé à un tableau X3, permettant de visualiser et de modifier un planning présenté mois par mois.

Le composant présente :

• x groupes de n mois à partir d'un tableau de données.
• Une palette permettant de faire défiler les groupes de mois.
• Un pavé légende comprenant une liste d'activités associées à une couleur sélectionnable. Elle permet d'affecter une activité à une periode.

Les possibilités liées à ce planning mensuel :

• Découpage de l'ensemble des journées en 1 à 4 plages
• Gestion de 12 mois maximum, éventuellement à cheval sur deux années.
• Affichage de 1 à 12 mois simultanément. Selon ce paramétrage, on pourra avoir un ascenseur vertical.
• Sélection de plages, dans la limite d'un mois, pour l'affectation d'une activité.
• Trois types de jour obligatoirement (menu local 9836) : ouvré, week-end, férié
• Une activité ne peut s'affecter que sur les jours ouvrés.
• Interdire la saisie d'activité sur une période, en affectant par la valeur -1, sur les plages à interdire.
• Réduire le nombre de plage, avant l'affichage du planning, en blanchissant le libellé de l'entête d'une ou de plusieurs colonnes typées PLAGn.  
• Personnalisation des activités et leur association aux couleurs par menus locaux.

Utilisation du composant

Click droit sur une période :

appel du menu contextuel de ligne de tableau correspondant à la période.

Click sur période ou sélection période :

Avec un type d'activité selectionné, la période passe dans la nouvelle couleur.

Le tableau X3 associé

Le tableau X3 comprend une ligne par jour, et représente au maximum 12 mois éventuellement à cheval sur deux années.
Le composant XSL planning a besoin pour fonctionner d’identifier les colonnes du tableau X3; celles-ci doivent donc être typées par la rubrique "Paramétrage" sur l'onglet champ.

Typage des colonnes :

Le type indique au processeur XSL le mode d'utilisation de la colonne. Le tableau doit donc contenir les champs typés suivants :

Si l’on souhaite fonctionner avec le programme d’interaction standard AMAJPLAN, les noms de champs suivants sont imposés car ils sont en dur dans le programme. Il est possible d’appeler les champs autrement en définissant un autre programme d’interaction.

Les options du composant XSL

Le composant XSL planning mensuel APLANM propose les options suivantes : 

• NBMONT : Nombre de mois affichés simultanément (valeur de 1 à 12).
• MENACT : Menu local type d’activité (par défaut, 9837 avec 5 valeurs en standard ). Les éléments de ce menu local sont modifiables. Ce paramètre, donne la possibilité de faire appel à un autre menu local. 25 activités sont autorisées si on ne personnalise leur couleur par le paramètre MENCOL.
• MENCOL : Menu local couleur d’activité. facultatif. Ce menu local doit être en concordance avec le menu local des types d'activité. 
• SDATA : Remise à jour du graphique suite au retour d’interaction. Valeur 1 ou 2. Laisser la valeur par défaut Non (1), car ce XSL prend en charge la mise à jour du graphe.
• PINTER : Programme d’interaction. Par défaut, on appelle le programme AMAJPLAN, cependant, il est possible d’en appeler un autre, ce qui permet de nommer les champs autrement et d’intervenir sur les règles d’acceptation, d’interaction ou de cumul.

Le traitement d'interaction

Ces trois menus locaux sont livrés en standard, et associés à un code dans le paramétrage de l'XSL :

• 9001 : MONTH - Libellé des mois
• 9833 : DAY - Libellé des jours
• 9834 : ABRDAY - Libellé abrégé des jours

On a éventuellement la possibilité d'affecter d'autres menus locaux à ces codes qui eux sont fixes.

Interactions

Elles sont définies et modélisées via un sous-programme standard MAJPLAN From AMAJPLAN auquel on passe en paramètre :

Le composant attend 365 ou 366 lignes dans le tableau, représentant 12 mois successifs qui peuvent s’étendre sur 2 années.

Planning annuel

Graphe associé à un tableau X3, permettant de visualiser et de modifier un planning en présentation annuel. Le contexte est identique au planning mensuel.

Le tableau X3 associé

idem planning mensuel.

Les options du composant XSL

Le composant XSL planning annuel APLANY propose les options suivantes : 

• MENACT : Menu local type d’activité (par défaut, 9837 avec 5 valeurs en standard ). Les éléments de ce menu local sont modifiables. Ce paramètre, donne la possibilité de faire appel à un autre menu local. 25 activités sont autorisées si on ne personnalise leur couleur par le paramètre MENCOL.
• MENCOL : Menu local couleur d’activité. facultatif. Ce menu local doit être en concordance avec le menu local des types d'activité. 
• SDATA : Remise à jour du graphique suite au retour d’interaction. Valeur 1 ou 2. Laisser la valeur par défaut Non (1), car ce XSL prend en charge la mise à jour du graphe.
• PINTER : Programme d’interaction. Par défaut, on appelle le programme AMAJPLAN, cependant, il est possible d’en appeler un autre, ce qui permet de nommer les champs autrement et d’intervenir sur les règles d’acceptation, d’interaction ou de cumul.

Le traitement d'interaction

idem planning mensuel

Radar

Visualisation d'un tableau avec une représentation graphique sous forme de radar sur lequel :

• chaque couleur représente une ligne du tableau.
• chaque axe représente une colonne de valeur du tableau.

Les possibilités liées à ce radar :

• Graphe en visualisation uniquement
• Bouton possible sur variable de bas de tableau accessible, sur le graphe, par click droit sur chaque couleur
• Possibilité d'afficher un repère de valeur maximum
• Possibilité d'afficher une échelle
• Plusieurs éléments visualisables (ligne tableau). se limiter à un nombre raisonable, pour la clarté du graphe. 
• Plusieurs axes visualisables (colonne tableau). 3 minimum et se limiter à un nombre raisonnable,  pour la clarté du graphe. 

Utilisation du composant

Survol d'une zone:

• Augmente l'opacité de la zone
• Info bulle libellé

Click sur zone:

• Demande de positionnement au serveur (ligne de tableau correspondante)

Click-droit sur zone :

• Demande de positionnement (ligne de tableau correspondante)
• Bouton du Menu contextuel (ligne de tableau correspondante)

Click sur couleur légende:

• Passe au premier plan la zone correspondante
• Augmente l'opacité

Click sur "oeil" légende:

• Masque la zone correspondante

Le composant XSL radar besoin pour fonctionner d’identifier les informations suivantes, qui sont portées par le tableau associé et par le paramétrage de l’XSL.

Le tableau X3 associé

Le composant XSL planning a besoin pour fonctionner d'un tableau X3. Chaque ligne de tableau permet de calculer une "surface".

Définition des colonnes :

• La première colonne visible du tableau doit être un identifiant.
• La seconde colonne visible du tableau doit être le libellé ; celui-ci sera accessible dans la palette.
• Toutes les autres colonnes sont considérées comme autant d'axes d'analyses. Elles doivent être numériques (entier/décimal), et avoir un titre. Le tableau doit comporté au moins 3 axes.

Lorsqu'on ne renseigne pas le titre d'une colonne numérique, cela permet de faire disparaitre l'axe correspondant.

Ces colonnes doivent donc être typées par la rubrique "Paramétrage" sur l'onglet champ.

Typage des colonnes :

Le type indique au processeur XSL le mode d'utilisation de la colonne. Le tableau doit donc contenir les champs typés suivants :

Type	Description
	Obligatoire. Variable bas de tableau
Clé	Obligatoire. doit contenir un identifiant unique.
Libellé	Obligatoire. doit contenir l'intitulé de l'identifiant.
Valeur	Un champ par axe d'analyse dont le titre est précisé dans l'intitulé. Ces champs doivent être de type entier ou décimal.

Les options du composant XSL

Le composant XSL planning radar ARADAR propose 3 options :

• SCALE : permet de fixer une échelle de représentation (par défaut 0). Si cette échelle est à 0, le composant adapte son échelle à la plus grande valeur à représenter trouvée, sinon les valeurs sont rapportées à l’échelle.
• MENSCA : Menu échelle. Il permet de définir une légende pour les différentes valeurs de l’échelle. Cette information doit être un numéro de menu local. Si la valeur est à 0 (défaut), il n’y a pas d’échelle affichée.
• SDATA : Remise à jour du graphique suite au retour d’interaction depuis le graphe. Valeur 1 ou 2. Aucune incidence, puisque ce graphe est en lecture uniquement.

Nomenclature horizontale

Visualisation d'un tableau avec une représentation graphique sous forme d'organigramme sur lequel :

• chaque élément représente une ligne du tableau.

Les possibilités liées à la nomenclature horizontale :

• possibilité de déplacer un élément et tout ce qui lui est rattaché (soumis à paramétrage)
• possibilité d'afficher une image ou différentes lignes de texte dans les cadres (soumis à paramétrage)
• possibilité d'affecter un style pour mise en page des textes  (soumis à paramétrage)
• possibilité d'avoir un menu contextuel pour chaque élément (suppression élément par action bouton)  
• Possibilité d'exécuter un traitement associé au double-clic (soumis à paramétrage)

Utilisation du composant

Survol d'une zone:

• Info bulle libellé long

Click sur zone:

• Demande de positionnement au serveur (ligne de tableau correspondante)

Click-droit sur zone :

• Demande de positionnement (ligne de tableau correspondante)
• Demande menu contextuel au serveur (ligne de tableau correspondante)

Le tableau X3 associé

Champs du tableau

Le tableau X3 doit être constitué d' une ligne par élément de la nomenclature.

Le composant XSL nomenclature a besoin pour fonctionner d’identifier les colonnes du tableau X3; celles-ci doivent donc être typées par la rubrique "Paramétrage" sur l'onglet champ.

Typage des colonnes :

Le type indique au processeur XSL le mode d'utilisation de la colonne. Le tableau doit donc contenir les champs typés suivants :

Si l’on souhaite fonctionner avec le programme d’interaction standard AMAJHIER, les noms de champs suivants sont imposés car ils sont en dur dans le programme. Il est possible d’appeler les champs autrement en définissant un autre programme d’interaction.

Les options du composant XSL

Le composant XSL nomenclature horizontale ANOMH propose 5 options : 

• MODHIE : Autoriser le déplacement d'un élément et tout ce qui lui est rattaché. Valeur : 1 non / 2 oui. Par défaut Oui(2).
• SIZEB: Taille du cadre de chaque élément en pixels exprimée en hauteur,largeur de la boite, hauteur du texte dans cette boite. (taille par défaut : 100,100). Si la taille texte n'est pas précisée, 20px sont réservés.
• SDATA : Remise à jour du graphique suite au retour d’interaction. Valeur : 1 non / 2 oui. Par défaut OUI (2). Le graphique est recalculé, chaque fois que des données sont modifiées quelque soit l'origine (tableau ou graphe). Positionné à NON, le graphe n'est pas recalculé, suite à une interaction de l'utilisateur sur le graphe lui-même (par contre, recalculé suite à une mise à jour du tableau).   
• PINTER : Programme d’interaction. Par défaut on appelle le programme AMAJHIER, il est possible d’en appeler un autre, ce qui permet d’appeler les champs autrement et d’intervenir sur les règles d’acceptation d’interaction.
• EXECFL : Autoriser l'appel d'un sous-programme sur double-click sur élément de dernier niveau.

Le paramétrage XSL

Interactions

Elles sont définies et modélisées via un sous-programme standard MAJHIER From AMAJHIER auquel on passe en paramètre :

Pour supprimer un élément, on utilisera une action bouton sur la variable de bas de tableau, et on écrira :

Local Char MESSAGE(100)
Local Integer CODRET
Call MAJHIER("D",nolign,"",0,MESSAGE,CODRET) From AMAJHIER
If CODRET<>1
   Call ERREUR(MESSAGE) From GESECRAN
Endif

Nomenclature verticale

Visualisation d'un tableau avec une représentation graphique sous forme d'organigramme sur lequel :

• chaque élément représente une ligne du tableau.

Les possibilités liées à la nomenclature horizontale :

• plier - déplier un élément (clic)
• déplacer un élément et tout ce qui lui est rattaché (soumis à paramétrage)
• supprimer un élément et tout ce qui lui est rattaché (clic droit)
• exécuter un traitement sur double clic sur dernier élément (soumis à paramétrage)

Utilisation du composant

Survol d'une zone:

• Info bulle libellé court
• Modification de la couleur et soulignement du texte survolé

Click sur zone:

• Demande de positionnement au serveur (ligne de tableau correspondante)
• Inverse vidéo sur texte

Click-droit sur zone :

• Demande de positionnement (ligne de tableau correspondante)
• Demande menu contextuel au serveur (ligne de tableau correspondante)
• Inverse vidéo sur texte

Le tableau X3 associé

Le tableau X3 doit être constitué d' une ligne par élément de la nomenclature.

Le composant XSL nomenclature verticale a besoin pour fonctionner d’identifier les colonnes du tableau X3; celles-ci doivent donc être typées par la rubrique "Paramétrage" sur l'onglet champ.

Typage des colonnes :

Le type indique au processeur XSL le mode d'utilisation de la colonne. Le tableau doit donc contenir les champs typés suivants :

Le type indique au processeur XSL le mode d'utilisation de la colonne. Le tableau doit donc contenir les champs typés suivants :

Champ	Type	Description
NBCMP		Variable bas de tableau. Obligatoire.
PARENT	Clé du père	clé du père de l'enregistrement courant. Vide, s'il s'agit de la tête de nomenclature, sinon obligatoire.
KEYC	Clé	clé de l'enregistrement courant. Obligatoire.
LIBL1	Libellé long	Libellé de l'élément. Obligatoire.
INF	Information	Plusieurs champs peuvent être de ce type. Ces informations sont affichées à la suite du libellé long, dans l'ordre de déclaration des champs dans le tableau.
LIBSHORT	Libellé court	Affiché en info bulle. Facultatif.
ICO	Icône	Icône affiché en début de ligne. L'icône doit être localisée dans le répertoire des ressources  standard (/X3_PUB/X3_PUB/RESSTD/IMG). Facultatif.
EXP	plié/déplié	flag permettant de forcer le dépliage d'une branche. (menu local 1)

Si l’on souhaite fonctionner avec le programme d’interaction standard AMAJHIER, les noms de champs suivants sont imposés car ils sont en dur dans le programme. Il est possible d’appeler les champs autrement en définissant un autre programme d’interaction.

Les options du composant XSL

Le composant XSL nomenclature verticale ANOMV propose 5 options : 

• MODHIE : Autoriser le déplacement d'un élément et tout ce qui lui est rattaché. Valeur : 1 non / 2 oui. Par défaut Oui(2).
• SDATA : Remise à jour du graphique suite au retour d’interaction. Valeur : 1 non / 2 oui. Par défaut OUI (2). Le graphique est recalculé, chaque fois que des données sont modifiées quelque soit l'origine (tableau ou graphe). Positionné à NON, le graphe n'est pas recalculé, suite à une interaction de l'utilisateur sur le graphe lui-même (par contre, recalculé suite à une mise à jour du tableau).   
• PINTER : Programme d’interaction. Par défaut on appelle le programme AMAJHIER, il est possible d’en appeler un autre, ce qui permet d’appeler les champs autrement et d’intervenir sur les règles d’acceptation d’interaction.
• EXECFL : Autoriser l'appel d'un sous-programme sur double-click sur élément de dernier niveau.
• TYPPRE : Type de présentatation. Valeur :
• 1 non colonné,
• 2 non colonné nouveau design,
• 3 une colonne pour le libellé, une autre pour les informations complémentaires
• 4 une colonne pour le libellé, une colonne pour chaque information

Le paramétrage XSL

Idem nomenclature horizontale

Les icônes disponibles

On trouvera ci-dessous la liste des icônes disponibles dans le répertoire standard qui peuvent donc être utilisées par ce composant.