Dictionnaire des tables

Le code de la table 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 tables du dictionnaire des données. Les mots réservés d'adonix sont interdits.

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

Le Code Activité et le Module permettent de savoir si la table 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 table correspondante) est effectivement activé.

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

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

Par ailleurs, il existe une dépendance entre les modules :

• Superviseur et Tronc commun : doivent être installés au minimum. Ensuite peuvent être installés les modules Stock, Développement, Comptabilité générale.
• Stock : on peut alors installer les modules Ventes, Achats, GPAO.
• Ventes : on peut alors installer les modules Support client CRM, Action Commerciale.
• Comptabilité générale: on peut alors installer les modules immobilisations, tiers.

Type de base pour laquelle doit être générée la table. Le type de base "Dossier" permet d'indiquer au programme de gestion de dossiers de générer la table dans le type de base retenu dans la fiche dossier pour l'ensemble des fichiers du dossier. Dans certains cas exceptionnels (en particulier s'il s'agit d'une table externe), on peut être amené à mettre un autre paramètre.

Cette case à cocher est à positionner si l'on veut accéder à une table d'un dossier 140 depuis un dossier 130. Dans ce cas, la structure de cette table doit respecter les limites de la version 130 ( pas de clob ni de blob …). Remarque : l'inverse est possible sans rien préciser dans le dictionnaire ( accéder à une table 130 depuis un dossier 140 ).

Si cette case est cochée en V7, les champs de type "datetime",  "uuident" et "updtick" ne sont pas générés pour que la table puisse être utilisée depuis une application V6 ou de version antérieure.

Le champ nombre de fiches permet de définir un dimensionnement de la table dans la base. Ce champ est utilisé pour dimensionner la table à créer ou à modifier. Cette valeur est renseignée à la création du dossier pour chaque table créée, à partir du résultat de l'évaluation de la formule de dimensionnement. Cette formule utilise elle-même  des variables dont les valeurs sont saisies dans les paramètres dossier.

Lors de la revalidation d'un dossier, le nombre de fiches est réévalué, mais le résultat du calcul n'est réécrit dans cette rubrique que s'il est supérieur à la valeur trouvée dans la table ; Ainsi, on peut, en modifiant cette valeur, augmenter la taille de la table, et cette valeur sera reprise en cas de revalidation de dossier. Si par contre on la diminue, elle sera prise en compte immédiatement si on valide manuellement la table à l'aide du bouton correspondant, mais dès qu'une revalidation de dossier sera faite, la valeur calculée, qui est plus grande, sera reprise en lieu et place de la valeur saisie. Ce comportement a été défini pour des raisons de sécurité : pour des raisons de performance et de facilité d'exploitation, il vaut mieux en effet sur-dimensionner une table plutôt que de la sous-dimensionner. Il n'est pas nécessaire de protéger la modification de ce champ par un code activité.

Cette case à cocher permet de définir la méthode utilisée, dans Crystal Report, pour les textes traduits de cette table.

• cochée : méthode issue de la version 140. génération des textes dans les fichiers séquentiels textrafra, textraeng, etc utilisés dans l'état Crystal par la fonction X3TranslatedText.
• non cochée : méthode créée en V5. aucune génération de fichier. L'état Crystal portant sur cette table utilise une vue.

C'est un champ de paramétrage ne nécessitant pas de code activité pour être protégé. Doit être en cohérence avec la technique utilisée dans l'état crystal se rapportant à la table. Pour les nouveaux textes traduits, il est conseillé de cocher cette case, pour utiliser a méthode des vues, et ainsi ne pas surcharger les fichiers séquentiels.   

Cette case à cocher est utilisée par l'utilitaire de remise à zéro des mouvements, qui permet de remettre à zéro les mouvements d'un dossier (ce qui permet de garder les données " fixes " - articles, tiers, comptes, nomenclatures… - issues d'une saisie en effaçant les mouvements - pièces, factures, mouvements de stocks, OF… - liés par exemple à un test de démarrage en réel). Lorsque cette case est cochée, l'utilitaire de remise à zéro efface toutes les lignes de la table. On retrouve un tel indicateur sur chaque champ (lorsque le champ doit être remis à zéro sans que la table ne soit vidée).

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

Ce champ permet de classer les tables suivant une typologie utilisée pour la gestion des dossiers. Il peut prendre les valeurs suivantes :

• Applicatif : ce qui correspond au cas par défaut (tables standard d'un dossier). Ces tables peuvent être ou pas présentes selon la gestion des codes activités et des modules.

• Superviseur  : la table fait alors partie des données du superviseur gérées dans chaque dossier hors dictionnaire (utilisateurs, trace des opérations, pièces jointes…). Elle est toujours présente.

• Système X3 : la table fait partie des données générales non rattachées à un dossier donné (tables liées à la gestion des dossiers, au serveur batch…). Ces tables ne sont présentes que dans le dossier superviseur, ce dossier pouvant prendre des noms divers selon le produit installé : X3, PAYE, GX par exemple. Elles sont donc communes à tous les dossiers. Elles ne sont donc pas concernées par les types et options de copie, puisqu'elles ne sont jamais copiées. L'ajout de champ spécifique est interdit sur ce type de table.

• Dictionnaire : la table, qui est toujours présente, fait partie du dictionnaire de chaque dossier (états, actions, écrans, types de données…). La gestion de dossier tient compte de façon particulière des tables du dictionnaire lors de la gestion des mises à jour (procédure de fusionde dictionnaire).  Là encore, les champs Type de copie et Option de copie ne concernent pas ce type de table. L'ajout de champ spécifique est interdit sur ce type de table.

• Interne : aucune table de ce type n'est livrée, et ce type, qui n'est utilisé que dans le processus de développement du progiciel, ne doit pas être utilisé.

Il détermine si la création de la table implique un transfert de données entre le dossier de référence et le dossier à créer lors de la création du dossier. Ce paramètre peut prendre les valeurs suivantes :

• Pas de copie : la table est créée vierge de toute donnée.

• Copie automatique  : les données de la table sont reprises à partir des données existant dans le dossier de copie (le dossier de référence par défaut).

• Copie conditionnelle : les données de la table sont copiées par groupes logiques. Un groupe est matérialisé par un choix du menu local numéro 26, saisi dans le champ Option de copie. On rattache à chaque groupe une liste de tables. Parmi les groupes, on trouve Utilisateurs et profils, Tables diverses, Compteurs, Paramètres, Plan comptable général… A la création de la table, on répond Oui ou Non en regard de chaque choix pour savoir les tables qui doivent effectivement être copiées.

Dans le cas d'une copie  conditionnelle, l'option de copie est liée au type de copie.

Vous pouvez choisir les données de divers sous-groupes de tables que vous souhaitez copier du dossier source au dossier de destination.

Cette case à cocher permet de définir la méthode de copie dans la validation de dictionnaire:

• cochée : Cela signifie qu'on appliquera un filtre sur le champ législation de cette table ou de la table "maître".
• non cochée : Aucun filtre supplémentaire ne sera appliqué.

Lors de la validation de dossier , on ne récupèrera que les données correspondantes aux législations gérées ou vides, par le dossier validé.

Cette option sera aussi utilisé dans la fonction de copie législation.

Usage interne pour l'industrialisation d'une version. Ce paramètre peut prendre les valeurs suivantes :

• Non livré : ces tables ne sont pas générées dans le dossier X3.
• Pas de données : livraison de la table sans données.
• Données d'indus : livraison de la table avec les données du dossier d'indus (paramètrage: styles , modèles d'import , etc.).
• Données communes : livraison de la table depuis le dossier de référence X3REFFRA.
• Données par pays : livraison de la table depuis le dossier X3REFxxx ( xxx : langue choisie à l'installation chez le client ).

Ces zones permettent de renseigner le nom de deux champs de la table. Elles permettent d'identifier les champs intitulé présents dans la table. Cette information est exploitée pour l'affichage automatique de l'intitulé d'un enregistrement dont on connaît la clé (gestion des écrans, annulations, changements de code, ...)

Indiquez le nom du champ dans la table, en suivant la syntaxe interprétable par le logiciel. Par exemple, le nom de champ FIELDNAME, défini dans la table des abréviations ABV, sera accessible en suivant la syntaxe [F:ABV]FIELDNAME.

Le nom des champs personnalisés commence par X_, Y_ ou Z_.

Dans la base de données, chaque zone correspond à un ou plusieurs champs. (selon que la zone est dimensionnée ou non). Les champs correspondants s'appellent FIELDNAME_0, FIELDNAME_1, FIELDNAME_2.

Pour saisir et afficher le champ correspondant à l'écran, son nom doit être le même dans le dictionnaire des écrans. L'écran et la table seront alors utilisés en simultané dans la gestion des objets.

On définit ici le type de la zone, qui caractérise son format de saisie (numérique, caractères quelconques, date...) et des contrôles de cohérence (référence à une table par exemple).

Les principaux types génériques existants 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

Mais beaucoup d'autres types prédéfinis existent. Ils font souvent référence à une table annexe (devise, pays,...). Un dictionnaire dédié permet de les décrire, et ils peuvent être sélectionnés via la touche F12 qui permet d'en obtenir la liste.

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.

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 :

Un code activité vous permet de :

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

Si le code activité est désactivé :

• l'élément marqué n'est pas utilisable,
• le code associé n'est pas généré ou activé.

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

Intitulé du champ sur trois longueurs : l'intitulé abrégé étant limité à 12 caractères, l'intitulé normal à 20 caractères, et l'intitulé long à 35 caractères.

Ces intitulés étant des textes traduisibles, ils sont stockés dans une table dédiée, la table ATEXTE. Quand un nouveau texte est saisi, après création d'une rubrique, une fenêtre apparaît dont le titre est Texte. On a alors le choix entre les 3 options suivantes :

• considérer que le texte saisi est un nouveau texte et l'intégrer dans la base des textes en lui attribuant un nouveau numéro. Ce numéro est obligatoirement supérieur à 50.000 (c'est un texte spécifique).

• rechercher un texte proche de celui saisi afin de reprendre le même. Une fenêtre de sélection s'ouvre alors pour cela.

• abandonner la saisie du texte.

Lorsqu'on passe en modification d'un texte déjà saisi au préalable, on a en outre un choix supplémentaire qui s'affiche dans la fenêtre, dont le titre est à présent Texte nnn (nnn étant son numéro). En effet, on peut alors modifier le texte dont le numéro est donné, pour le rendre conforme au texte qui vient d'être saisi (cette modification sera faite partout où le texte correspondant est utilisé, dès lors que les écrans correspondants auront été revalidés).

Par ailleurs, il est possible d'appeler, par le clic droit de souris, la fonction Abréviation qui permet de sélectionner une des abréviations normalisées définies lorsqu'un intitulé est trop long (l'usage des abréviations doit être évité tant que possible pour des raisons de lisibilité des écrans).

Intitulé du champ sur trois longueurs : l'intitulé abrégé étant limité à 12 caractères, l'intitulé normal à 20 caractères, et l'intitulé long à 35 caractères.

Ces intitulés étant des textes traduisibles, ils sont stockés dans une table dédiée, la table ATEXTE. Quand un nouveau texte est saisi, après création d'une rubrique, une fenêtre apparaît dont le titre est Texte. On a alors le choix entre les 3 options suivantes :

• considérer que le texte saisi est un nouveau texte et l'intégrer dans la base des textes en lui attribuant un nouveau numéro. Ce numéro est obligatoirement supérieur à 50.000 (c'est un texte spécifique).

• rechercher un texte proche de celui saisi afin de reprendre le même. Une fenêtre de sélection s'ouvre alors pour cela.

• abandonner la saisie du texte.

Lorsqu'on passe en modification d'un texte déjà saisi au préalable, on a en outre un choix supplémentaire qui s'affiche dans la fenêtre, dont le titre est à présent Texte nnn (nnn étant son numéro). En effet, on peut alors modifier le texte dont le numéro est donné, pour le rendre conforme au texte qui vient d'être saisi (cette modification sera faite partout où le texte correspondant est utilisé, dès lors que les écrans correspondants auront été revalidés).

Par ailleurs, il est possible d'appeler, par le clic droit de souris, la fonction Abréviation qui permet de sélectionner une des abréviations normalisées définies lorsqu'un intitulé est trop long (l'usage des abréviations doit être évité tant que possible pour des raisons de lisibilité des écrans).

Intitulé du champ sur trois longueurs : l'intitulé abrégé étant limité à 12 caractères, l'intitulé normal à 20 caractères, et l'intitulé long à 35 caractères.

Ces intitulés étant des textes traduisibles, ils sont stockés dans une table dédiée, la table ATEXTE. Quand un nouveau texte est saisi, après création d'une rubrique, une fenêtre apparaît dont le titre est Texte. On a alors le choix entre les 3 options suivantes :

• considérer que le texte saisi est un nouveau texte et l'intégrer dans la base des textes en lui attribuant un nouveau numéro. Ce numéro est obligatoirement supérieur à 50.000 (c'est un texte spécifique).

• rechercher un texte proche de celui saisi afin de reprendre le même. Une fenêtre de sélection s'ouvre alors pour cela.

• abandonner la saisie du texte.

Lorsqu'on passe en modification d'un texte déjà saisi au préalable, on a en outre un choix supplémentaire qui s'affiche dans la fenêtre, dont le titre est à présent Texte nnn (nnn étant son numéro). En effet, on peut alors modifier le texte dont le numéro est donné, pour le rendre conforme au texte qui vient d'être saisi (cette modification sera faite partout où le texte correspondant est utilisé, dès lors que les écrans correspondants auront été revalidés).

Par ailleurs, il est possible d'appeler, par le clic droit de souris, la fonction Abréviation qui permet de sélectionner une des abréviations normalisées définies lorsqu'un intitulé est trop long (l'usage des abréviations doit être évité tant que possible pour des raisons de lisibilité des écrans).

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. Une description détaillée de toutes les options possibles est disponible.

Code d'une table liée à celle que vous modifiez par l'intermédiaire du champ courant. Pour les types de données faisant référence à un objet cette zone est renseignée automatiquement.

Cette zone n'est saisie que si une table liée a été précisée. Si cette zone n'est pas renseignée, le lien est fait directement à partir du champ de la ligne courante (ce qui suppose que la clé primaire de la table liée n'a qu'une seule composante). Dans le cas où la clé primaire possède plusieurs composantes l'expression de lien doit être indiquée sous la forme: comp1;comp2;comp;... où comp1,comp2, comp3,... sont les différentes composantes de la clé.
Voici quelques exemples possibles d'expressions :

• si un champ MONCHAMP est contrôlé dans une des tables diverses (par exemple la table numéro 43), on mettra dans la colonne Table liée la valeur ATABDIV, et dans la colonne Expression de lien la valeur 43 ;MONCHAMP

• si un champ MONCHAMP est indicé, l'expression peut utiliser la variable indice qui est censée varier de 0 à dim(MONCHAMP)-1. Exemples classiques : des familles statistiques multiples (articles, fournisseurs, clients…) dont la structure de clé est le numéro de la famille suivi du code statistique. L'expression de clé s'écrit alors sous la forme indice+1 ;MONCHAMP(indice).

• Si la composante de clé est une variable globale, il faudra préciser la classe [V] devant le nom de cette variable.
• pour ignorer un élément de clé dans le contrôle d'intégrité de la base, utiliser pour cet élément la variable [V]GSUPCLE.

Ce champ est lié à la case à cocher Copie législation.

En effet, il permet d'indiquer le champ contenant la législation, ou bien le champ permettant le lien avec la table maître contenant la législation.

Lors de l'annulation d'une ligne dans la table liée (table d'origine), une action particulière peut être effectué sur la table que vous êtes en train de modifier ou de créer (table de destination). Cette action est définir par le code ci-dessous:

• Bloquant : Annulation de l'enregistrement de la table d'origine impossible si un lien existe avec la table en cours de définition.
• Suppression : Effacement des enregistrements de la table en cours vérifiant le lien avec la table d'origine.
• RAZ : Remise à zéro du champ de la table en cours vérifiant le lien avec la table origine.
• Autre : Aucun traitement particulier n'est effectué.

Cette zone permet d'indiquer si l'utilitaire de vérification de cohérence doit vérifier le lien.

Le champ Obligatoire permet de définir si le champ peut être vide, ou s'il doit impérativement contenir valeur non vide. Par champ vide, on entend la chaîne de longueur vide, une valeur numérique nulle, une valeur de menu local égale à zéro (pas de choix effectué) ou la date vide [0/0/0].

Lorsque le champ est une clé d'une table, si le contrôle d'annulation est positionné à la valeur RAZ, le lien ne peut pas être obligatoire (puisque l'annulation peut effacer la valeur du champ clé) : le champ Obligatoire est alors automatiquement positionné à Non.

Ce champ correspond au nom sous lequel l'index est connu dans la base de données. Une norme est utilisée dans toutes les tables de l'applicatif : elle consiste à nommer les clés en utilisant l'abréviation de la table, suivi de 0 pour la clé principale, 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.

On saisit ici la liste des champs composant l'index, séparé par un '+' s'il y a plusieurs champs (par exemple, dans la table des sites FACILITY, on trouve une clé dont la définition est LEGCPY+FCY).

Un champ trié en descendant est précédé du signe "-" (attention, si utilisé en liste gauche).

Le premier champ composant un index est sans signe et est forcément ascendant.

Cette colonne permet de définir si la clé admet ou pas des homonymes.

Utilisez cette colonne pour indiquer un index cluster par défaut, fourni par Sage.

Si vous sélectionnez Non, aucun index cluster par défaut n'est défini.

Si vous sélectionnez Oui, l'index cluster indiqué est utilisé.

Pour modifier l'index cluster, définissez un Index cluster spécifique ou sélectionnez la case à cocher Index cluster désactivé pour ne pas utiliser d'index.

Cette valeur peut être modifiée par un patch.

Ce paramètre par défaut ne s'applique pas si vous avez déjà configuré un index cluster en local dans le fichier de configuration ou dans le champ Index cluster spécifique.

Sélectionnez Oui pour définir cet index comme index cluster. Vous pouvez uniquement sélectionner un index par table.

Un index cluster est un type d'index dans lequel les enregistrements de la table sont ordonnés pour correspondre à l'index.

Ce paramétrage est spécifique et ne peut pas être modifié par un patch.

Si cette zone n'est pas renseignée, l'index sera toujours présent. Si cette zone correspond à code activité non actif, l'index ne sera pas généré.

Il est possible d'ajouter une clé spécifique par un code activité commençant par X, Y ou Z.

Utilisez cette colonne pour désactiver les index cluster associés à la table. L'index éventuel livré par Sage dans la colonne Index cluster par défaut est désactivé, et ce même si vous n'avez pas défini d'index cluster dans la colonne réservée à ce paramétrage.

Sélectionnez cette case à cocher pour désactiver l'index cluster.

On peut saisir dans ce bloc un texte décrivant la configuration technique de table dans la base de données. Ce texte est enregistré dans un fichier "nom de table.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.

Ces trois cases à cocher permettent de définir les opérations à tracer sur les enregistrements de la table :

• Création
• Modification
• Suppression

Remarque :
Attention aux objets "tableau" et "combiné" qui n'effectuent pas de mise à jour d'enregistrement mais opèrent par suppression et création d'enregistrement.

permet une notification automatisée par workflow.

Une tache batch de workflow déclenche un événement workflow pour chaque ligne de la table AUDITH dont le statut workflow est « a traiter », puis met à jour le statut par « traité ».

Il permet la synchro incrémentale des tables de faits BI. Il n'est présent que si le code activité ABI est actif.

Mis à jour par la génération du dataware en fonction du type de mise à jour prévue pour les tables de faits. Dans les règles de synchro BI, si une table de fait est mise à jour en synchro incrémentale à partir d'une table X3, cette table est flaguée "AUDIT BI".

On précise l'une des clés de la table. Il est préférable qu'elle soit sans homonyme, pour des facilités d'identification d'enregistrement à la lecture de l'audit.

Si ce champ n'est pas renseigné, la clé primaire est prise en compte.

Liste des champs à auditer. On ne renseigne pas ce tableau, si l'on souhaite tracer uniquement les opérations sur enregistrement, sans tracer le contenu des champs. 

On aura une trace pour un enregistrement modifié, si au moins une des conditions sur champs est vérifiée par les nouvelles valeurs de champ; alors qu'en création ou suppression d'enregistrement, on aura systématiquement une trace.