Types de données
Cette fonction permet de définir des types de données utilisables dans tous les dictionnaires où des données sont définies : zones des écrans, champs des tables, paramètres des états...
On rattache à un type un certain nombre de caractéristiques (type interne, format, longueur, actions…) automatiquement rattachées à tous les champs utilisant ce type. Il n'est toutefois pas nécessaire de définir toutes les caractéristiques d'un type. En effet, les caractéristiques non définies au niveau du type seront demandées à la définition de l'écran, ce qui permet de définir des types génériques. Des explications détaillées sont fournies dans la documentation sur la saisie du format.
Safe X3 livre un certain nombre de types de donnée contenant uniquement le type interne, c'est à dire le type de stockage du champ. Ces types de données ne sont en aucun cas modifiables. En voici la liste :
Code Type | Définition |
A | Chaîne alphanumérique |
ABB | Blob |
ACB | Clob |
C | Entier court |
D | Date |
DCB | Montant décimal |
L | Entier long |
M | Menu local |
MM | Menu local avec possibilité de filtre des éléments |
M ou MM correspondent à un menu local dont le numéro est donné par le contenu de la colonne Menu dans le dictionnaire des tables ou écrans. Un menu local est une table d'intitulés, saisie soit sous la forme d'une combo box, soit sous la forme de boutons radios, soit sous la forme d'une case à cocher (s'il s'agit du menu local 1 qui stocke les valeurs Oui / Non). Dans la base de données, on ne stocke que le numéro du choix dans la liste (0 si la zone n'est pas renseignée, 1 si le premier intitulé de la liste est sélectionné, et ainsi de suite).
On trouvera dans le tableau ci-dessous des types de données correspondant à des éléments techniques du superviseur :
Code Type | Définition |
ABS | Variable de bas de tableau |
Champ indiquant le type d'un blob | |
AX1 | Texte traduit (longueur 12) |
AX2 | Texte traduit (longueur 20) |
AX3 | Texte traduit (longueur 30) |
W | Filler |
ABS identifie la zone écran de bas de tableau. Cette zone est obligatoire pour tout bloc tableau défini dans un écran. Si le tableau est saisissable, cette zone devra être en mode saisie ; si le tableau est invisible, cette zone devra être en mode invisible.
W identifie un filler. Ce type de donnée placé sur une zone écran aura seulement pour effet de laisser un espace entre la zone précédente et la zone suivante, si ces deux zones sont sur une même ligne. Il est cependant préférable d'utiliser, à cette fin, la rubrique colonne du dictionnaire des écrans et de n'utiliser les champs avec type de donnée W qu'en dernier recours.
AX1, AX2, AX3 identifient les textes traduits. En fait, ce champ n'est pas créé dans la base de donnée. Il sert juste par son nom de zone d'identifiant pour le texte traduit qui sera stocké dans la table dédiée ATEXTRA.
On trouvera dans le tableau ci-dessous une liste des types fonctionnels particulièrement importants (liste non exhaustive) :
Code Type | Définition |
MD1 à MD4 | Formats de montants dépendant de la devise (qui doit être en ligne) : dans la table des devises, on définit les 4 formats correspondants. |
MC1 à MC4 | Formats de montants dépendant de la devise : il s'agit des même types que ci-dessus, mais ils sont optimisés pour une utilisation dans un tableau déroulant dans lequel une colonne est saisie dans une devise qui ne dépend pas de la ligne courante. |
MS1 à MS4 | Montants en monnaie du site |
ADI | Code stocké dans une table diverse (dont le numéro est donné, dans le dictionnaire des tables, par l'expression de lien) |
HM | heure : minute |
QTY | Quantité |
QT1 à QT5 | Quantité optimisée pour bloc tableau (même remarque que ci-dessus : le format d'une colonne ne doit pas dépendre de la ligne courante) |
VCR | Numéro pièce (avec possibilité de tunnel sur l'objet déclaré en paramètre). |
Pré-requis
Reportez-vous à la documentation de Mise en oeuvre
Gestion de l'écran
En-tête
Champs
Les champs suivants sont présents dans cet onglet :
|
|
|
|
Fermer
Ecran de saisie
Champs
Les champs suivants sont présents dans cet onglet :
Objet
| Permet d'indiquer, le cas échéant, l'objet associé au type de données. La table liée gérée par l'objet est affichée. La présence d'un code objet déclenche automatiquement:
|
|
|
Format
| Permet d'optimiser l'affichage des gros tableaux. Ceci est réservé au type de donnée du standard, car il nécessite un traitement particulier, dans le superviseur.
|
|
|
|
|
| Permet d'optimiser l'affichage des gros tableaux. Ceci est réservé au type de donnée du standard, car il nécessite un traitement particulier, dans le superviseur.
|
| Ce champ permet de saisir une formule de calcul pour attribuer une valeur par défaut aux zones de ce type. Un exemple peut être vu sur le type CRY, qui définit le code pays : la variable GPAYS, qui définit le pays local, est proposée en valeur par défaut pour tous les champs de ce type. Cette valeur par défaut est automatiquement proposée sur les zones des écrans utilisant ce type de donnée. Cependant, si une zone utilisant ce type de donnée a sa propre valeur par défaut dans l'écran, c'est cette dernière qui est prise en compte; dans ce cas, la valeur par défaut du type de donnée est ignorée. |
Tableau Actions
| Ce tableau permet de déclarer des actions cataloguées dans le dictionnaire des actions. L'objectif est que sur tous les champs ayant ce type de donnée, les actions définies ici s'exécuteront systématiquement. Si un même type d'action est défini à la fois sur le type de donnée et sur la zone d'écran, les actions s'exécuteront consécutivement et dans l'ordre suivant : celle du type de donnée puis celle du champ. Il y a un cas particulier pour les actions « sélection », « bouton » et "icône", pour lesquelles, seule, l'action de la zone d'écran s'exécutera. Ce tableau permet de définir les actions particulières associées à la zone. Les types d'actions possibles sont:
|
| Indiquez les actions à effectuer de manière systématique sur ce type de données. |
| Ce champ permet de définir le contexte d'exécution de l'action:
|
Fermer
Onglet Convergence
Champs
Les champs suivants sont présents dans cet onglet :
Objet
| Permet d'indiquer, le cas échéant, l'objet associé au type de données. La table liée gérée par l'objet est affichée. La présence d'un code objet déclenche automatiquement:
|
|
|
Format
| Permet d'optimiser l'affichage des gros tableaux. Ceci est réservé au type de donnée du standard, car il nécessite un traitement particulier, dans le superviseur.
|
|
|
|
|
| Permet d'optimiser l'affichage des gros tableaux. Ceci est réservé au type de donnée du standard, car il nécessite un traitement particulier, dans le superviseur.
|
| Ce champ permet de saisir une formule de calcul pour attribuer une valeur par défaut aux zones de ce type. Un exemple peut être vu sur le type CRY, qui définit le code pays : la variable GPAYS, qui définit le pays local, est proposée en valeur par défaut pour tous les champs de ce type. Cette valeur par défaut est automatiquement proposée sur les zones des écrans utilisant ce type de donnée. Cependant, si une zone utilisant ce type de donnée a sa propre valeur par défaut dans l'écran, c'est cette dernière qui est prise en compte; dans ce cas, la valeur par défaut du type de donnée est ignorée. |
Tableau Actions
| Ce tableau permet de déclarer des actions cataloguées dans le dictionnaire des actions. L'objectif est que sur tous les champs ayant ce type de donnée, les actions définies ici s'exécuteront systématiquement. Si un même type d'action est défini à la fois sur le type de donnée et sur la zone d'écran, les actions s'exécuteront consécutivement et dans l'ordre suivant : celle du type de donnée puis celle du champ. Il y a un cas particulier pour les actions « sélection », « bouton » et "icône", pour lesquelles, seule, l'action de la zone d'écran s'exécutera. Ce tableau permet de définir les actions particulières associées à la zone. Les types d'actions possibles sont:
|
| Indiquez les actions à effectuer de manière systématique sur ce type de données. |
| Ce champ permet de définir le contexte d'exécution de l'action:
|
Fermer
Onglet Classe
Champs
Les champs suivants sont présents dans cet onglet :
Type
|
|
Détails
|
|
|
|
|
|
|
|
|
|
Représentations par défaut
|
|
|
Tableau Règles
|
|
|
|
|
|
|
|
|
|
|
|
Tableau Paramètres
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Fermer
Icône Actions
Onglet Liens
Champs
Les champs suivants sont présents dans cet onglet :
Tableau Liens
|
|
|
|
|
|
|
|
Fermer
Etats
Par défaut, les états suivants sont associés à la fonction :
ATYPE : Type de donnée
Mais ceci peut être modifié par paramétrage.
Boutons spécifiques
Les champs suivants sont présents dans la fenêtre ouverte par ce bouton : Bloc numéro 1
Bloc numéro 2
Fermer Ce bouton permet de recopier la définition du type de donnée vers un autre dossier. |
Barre de menu
Documentation / Paragraphes
Cette fonction permet d'accéder à la gestion de la documentation, sur le premier paragraphe de la documentation (si elle existe) associé à la fiche courante.
Documentation / Liens
Cette fonction permet d'accéder à la gestion des liens. Elle permet de définir des liens entre la fiche courante et d'autres fiches (par exemple des liens entre fonctions et paramètres). Ces liens, purement documentaires, permettent d'alimenter la mécanique de génération des squelettes de documentation.
Documentation / Génération
Ce menu permet de lancer une génération de documentation. La génération peut se lancer également à partir du bouton [Génération] dans le bas de la fenêtre.
Trois types de génération peuvent être lancées, séparément ou simultanément :
- la génération du squelette de documentation à partir du dictionnaire (tables ADOCUMENT, ADOCBLB, ADOCCLB).
- la génération de la documentation à partir des tables précédentes.
- la génération de la documentation sur champ.
Les bornes proposées par défaut tiennent compte de la fiche en cours, mais elles peuvent être modifiées au lancement.
Messages d'erreur
Outre les messages génériques, les messages d'erreur suivants peuvent apparaître lors de la saisie :
Longueur incorrecte
La longueur associée au champ est incompatible avec le type de données interne donné.
Menu local non défini
Le numéro du menu local est incorrect
Caractère invalide
Des caractères incorrects ont été saisis dans le format.
Format incorrect
Le format qui a été défini est invalide.
Option incorrecte
L'option associée au format est invalide.
Type de donnée non modifiable
Les types de données de base ne sont pas modifiables. Exemple : "A","C","D","L","M","MM","DCB","AV","W","ACB","ABB".