Vues

• Code vue (champ CODVUE)

Le code de la vue doit être composé de 1 à 10 caractères (lettres ou chiffres mais commençant obligatoirement par une lettre). C'est un identificateur unique pour l'ensemble des vues du dictionnaire des données. Une vue ne peut pas porter le même nom qu'une table du dictionnaire, puisqu'à la validation, le superviseur génère les fichiers *.srf et *.fde. les mots réservés d'adonix sont interdits.

• champ ABRVUE

L'abréviation de la vue doit être composée de 1 à 3 caractères (lettres ou chiffres mais commençant obligatoirement par une lettre). Cet identificateur peut ne pas être unique pour l'ensemble des abréviations des vues du dictionnaire de données. Les mots réservés d'Adonix sont interdits.

• Intitulé (champ INTITSAI)

Destiné notamment à figurer sur les états et les écrans dans lesquels le code de la fiche peut être saisi ou sélectionné. Ce texte permet de donner une description en clair de la fiche concernée.

• Code activité (champ CODACT)

Le Code Activité et le Module permettent de savoir si la vue décrite dans le dictionnaire doit effectivement être créée dans la base de données du dossier. Elle l'est si les deux conditions ci-dessous sont réalisées simultanément :

 le champ code activité est vide, ou bien le code activité (définie dans la vue correspondante) est effectivement activé.

 le module auquel la vue est rattachée a été déclaré actif pour le dossier.

Une vue affectée d'un code activité commençant par X, Y, ou Z, est réputée être spécifique et ne sera en aucun cas affectée par un changement de version (ces codes activités peuvent être mis au niveau des lignes).

• Accès non sécurisé (champ SECURE)

Cette case à cocher permet de restreindre l'accès à la table de données au seul dossier propriétaire de la table et à certains dossiers autorisés. Cette notion est identique pour la vue. Une modification de ce champ nécessite une revalidation de la table, pour être pris en compte dans la base de donnée.

• non sécurisé : tous les dossiers de la solution peuvent accéder à la table pour lire ou écrire des données de cette table. C'est le cas :
• des tables système,
• des tables dictionnaire,
• de certaines tables superviseur,
• sécurisé : l'accès à cette table se fait en fonction des droits du dossier d'appel. Un dossier peut être :
• non habilité,
• habilité en lecture,
• habilité en lecture écriture. C'est le cas des tables fonctionnelles et de la plupart des tables superviseur.

Les dossiers habilités sont :

• le dossier dans lequel la table est définie (les tables système étant dans le dossier de référence de la solution : dans le cas de Sage X3, ce dossier s'appelle X3),
• les dossiers parents du dossier,
• un dossier habilité (via la fonction Gestion des dossiers, onglet "Liens", bloc "Dossiers de la solution").
• les dossiers d'autres solutions ayant un accès par liens (via la même fonction).

La politique de sécurité pour la table étant considérée comme du paramétrage, cette case à cocher n'est pas mise à jour par patch. A la validation de la table, le fait que cette case soit cochée provoque la création d'un fichier de configuration (d'extension ".cfg") avec le code suivant :

$SECURITY
{  "LEVEL0" }
End

Si d'autres directives manuelles existent dans le fichier de configuration, elles sont respectées. Des directives peuvent en effet être ajoutées par mise à jour du bloc "Fichier de configuration" dans l'onglet correspondant de la Gestion des tables).

• Module (champ MODULE)

Le Code Activité et le Module permettent de savoir si la vue décrite dans le dictionnaire doit effectivement être créée dans la base de données du dossier. Elle l'est si les deux conditions ci-dessous sont réalisées simultanément :

 le champ code activité est vide, ou bien le code activité (définie dans la vue correspondante) est effectivement activé.

 le module auquel la vue est rattachée a été déclaré actif pour le dossier.

Une vue affectée d'un code activité commençant par X, Y, ou Z, est réputée être spécifique et ne sera en aucun cas affectée par un changement de version (ces codes activités peuvent être mis au niveau des lignes).

• champ TEX1

• champ TEX2

• Champs (champ FLDVUE)

On définit dans cette colonne le nom de zone de la vue telle qu'elle sera définie dans le progiciel (un champ de nom NOMCHAMP défini dans une vue d'abréviation ABV pourra être accédé par la syntaxe [F:ABV]NOMCHAMP).

Pour les champs créés en spécifique, le nom de zone doit commencer par X_, Y_ ou Z_.

Pour un champ dimensionné (NOMCHAMP_0, NOMCHAMP_1, NOMCHAMP_2…), on ne définit qu'une seule zone NOMCHAMP.

• Typ (champ CODTYP)

Vous devez définir ici le type de la zone. Les principaux types sont :

A : Alphanumérique
C : Entier court
L : Entier long
DCB : Décimal
D : Date
M : Menu local
MM : Menu local avec filtre
ACB : clob
ABB : blob

 D'autres types prédéfinis existent. Ils font généralement référence à une table annexe (devise, section,...). La touche F12 vous permet d'en obtenir la liste.

Il n'est pas possible d'utiliser ici, les types de donnés relatifs aux textes traduits : AX1, AX2, AX3.

• Menu (champ NOLIB)

Définit le numéro de menu local associée au champ défini sur la ligne.

Lorsqu'un champ est de type menu local, il est stocké sous la forme d'une valeur numérique (de 1 à 255) correspondant au rang d'un intitulé dans une table appelée menu local, stockée dans la table des messages APLSTD.

En saisie ou en affichage, on voit, selon les choix faits sur l'interface utilisateur :

• soit un intitulé pouvant être choisi dans une liste déroulante communément appelée combo box
• soit une liste de boutons de choix.

L'intérêt de ce type de saisie est que la liste des choix est présentée dans la langue de connexion de l'utilisateur.

Chaque numéro de menu local caractérise la liste des intitulés possibles. Par exemple, le menu local 1 correspond au choix Non / Oui dans cet ordre. Dans ce cas particulier, l'interface utilisateur peut aussi être la case à cocher.

• Long (champ LNG)

Permet de définir la longueur d'un champ lorsque ce champ utilise un type de données générique dont la longueur n'est pas fixée. C'est le cas notamment pour les types A et DCB.

Pour les blob, comme pour les clob, il faut saisir la longueur qui sera une longueur maximale de stockage. La codification est la suivante :

• Act (champ FLDACT)

Un code activité permet :

• de rendre optionnel un élément du dictionnaire si la valeur associée au code activité est nulle.
• de signer les éléments spécifiques dès lors qu'ils sont marqués par un code commençant par X, Y ou Z.
• de dimensionner un nombre de lignes maximum lorsque le code activité marque des éléments d'un tableau.

Ainsi, si le code activité est non actif, l'élément marqué ne sera pas utilisable, et le code associé (s'il y en a) ne sera pas généré ni activable.

• Dim (champ DIME)

Dimension de la zone dans la vue. La dimension peut également être affectée en fonction du code activité.

• Intitulé (champ FLDINTSAI)

Destiné notamment à figurer sur les états et les écrans dans lesquels le code de la fiche peut être saisi ou sélectionné. Ce texte permet de donner une description en clair de la fiche concernée.

• Options (champ OPTION)

Ces options sont matérialisées par des caractères qui peuvent se concaténer lorsque plusieurs options sont nécessaires. Il est possible de choisir ces options grâce à une fenêtre de sélection. On trouvera une description détaillée de toutes les options possibles.

• No (champ NUMLIG)

• Code clé (champ CODCLE)

Ce champ correspond au nom sous lequel la clé est connu dans l'ordre Order By. Une norme est utilisée dans toutes les vues de l'applicatif : elle consiste à nommer les clés en utilisant l'abréviation de la vue, suivi de 0 pour la première clé , de 1 pour la deuxième clé, etc.…Pour le spécifique, faites commencer ce code par l'une des trois lettres : X,Y ou Z.

• Descripteur clé (champ DESCLE)

On saisit ici la liste des champs composant l'index, séparé par un '+' s'il y a plusieurs champs.
Un champ trié en descendant est précédé du signe "-".
Le premier champ composant un index est sans signe et est forcément ascendant.

• Homonymes (champ KEYDUP)

Ce champ est par défaut initialisé à Oui. Il est possible de le mettre à Non. Dans ce cas, un message d'avertissement prévient qu'il ne doit pas y avoir de clés en double sur l'index de cette vue. Si c'était le cas, il n'y aurait pas d'erreur mais une simple boucle For ne détecterait pas les homonymes.

Il est donc recommandé de le laisser à Oui sauf dans des cas très particuliers où l'option Non permet de supporter les instructions "Read Next/Prev" sur des vues.

• Code activité (champ CLEACT)

Un code activité permet :

• de rendre optionnel un élément du dictionnaire si la valeur associée au code activité est nulle.
• de signer les éléments spécifiques dès lors qu'ils sont marqués par un code commençant par X, Y ou Z.
• de dimensionner un nombre de lignes maximum lorsque le code activité marque des éléments d'un tableau.

Ainsi, si le code activité est non actif, l'élément marqué ne sera pas utilisable, et le code associé (s'il y en a) ne sera pas généré ni activable.

• champ FICCFG

On peut saisir dans ce bloc un texte décrivant la configuration technique de vue dans la base de données. Ce texte est enregistré dans un fichier "nom de vue.cfg" dans le répertoire FIL de l'application. Ce fichier est utilisé par l'instruction "valfil". On consultera l'annexe technique dédiée pour plus d'informations.