Reportez-vous à la documentation de Mise en oeuvre
La définition d'un écran se fait à l'aide de 2 onglets : l'onglet général de définition de la transaction, et l'onglet comprenant les formules de sélections des enregistrements à traiter et les tables à mettre à jour.
Présentation
L'en-tête permet d'identifier la transaction.
Champs
Les champs suivants sont présents dans cet onglet :
| Ce code identifie la transaction système à lancer. |
|   |
On définit, dans cet onglet, le contexte général lié à la transaction système :
Champs
Les champs suivants sont présents dans cet onglet :
Bloc numéro 1
| Sélectionnez un module pour le paramétrage. Ce champ vous permet de renseigner si l'écran doit être créé dans la base de données du dossier. Il l'est si le module auquel l'écran est rattaché est actif pour le dossier. |
|   |
| Un code activité vous permet de :
Si le code activité est désactivé :
|
| Ce code d'accès permet d'interdire l'accès à la fiche courante pour certains utilisateurs. Si le champ est alimenté, seuls les utilisateurs qui ont des droits de lecture sur ce code d'accès peuvent visualiser l'enregistrement ; et seuls les utilisateurs avec des droits d'écriture peuvent le modifier. Le droit d'exécution qui peut être attaché au code accès permet d'autoriser l'exécution de la transaction système. Compte tenu du fait que cette fonction est sensible, il est conseillé de renseigner un code d'accès et de limiter soigneusement le nombre d'utilisateurs ayant le droit d'exécution. |
| Définit la table principale sur laquelle la transaction va être exécutée. |
Tableau Tables liées
| Identifie les tables liées à la table principale. |
| Ce champ est défini comme une ou plusieurs expressions calculées et séparées par un point-virgule. Chaque expression est évaluée, et le résultat permet de connaître la valeur de la clé utilisée pour réaliser la jointure. Lorsque les jointures multiples sont autorisées, vous ne pouvez donner que les premiers segments de clé. Dans les expressions, vous pouvez utiliser des constantes, et des champs issus des tables précédemment définies dans la liste des liens. |
Tableau Paramètres
| Définit le type de données correspondant au paramètre saisi. Ceci permet de contrôler sa valeur par le biais d'une table, le cas échéant. |
|   |
| Définit le nombre de caractères maximum devant être saisis pour renseigner le paramètre. |
| Lorsque le paramètre à saisir est de type menu local, on définit ici le numéro du menu concerné. |
| Ce champ définit un complément nécessaire à la définition du type de données, lorsqu'il est nécessaire. Dans le cadre d'une table diverse, le complément définit le numéro de la table, par exemple. |
| Permet de définir une valeur par défaut par le biais d'une expression calculée pouvant contenir des constantes et des variables. |
| Le code d'une table de contrôle peut être saisi dans ce champ pour réaliser un contrôle de validité particulier associé au paramètre défini dans la transaction système. |
Présentation
Cet onglet permet de préciser par des critères de sélection les lignes de la jointure parcourues, et de détailler les mises à jour faites par la transaction système sur ces lignes. Ce peut être :
Champs
Les champs suivants sont présents dans cet onglet :
Tableau Sélections
| Ce champ permet de définir des expressions logiques pour filtrer les enregistrements à mettre à jour ou à supprimer. Il est possible d'utiliser les champs de la table principale, des tables liées et des variables définiEs dans le tableau des paramètres de lancement du premier onglet (V1 à Vn). Si le résultat d'une de ces expressions est faux, l'enregistrement ne sera pas affecté. |
Tableau Mise à jour
| Définit la table sur laquelle une opération doit être faite. |
| L'opération réalisée peut être :
|
| Définit le champ dont on veut donner la valeur (en modification ou en création). Ce champ est issu de la table saisie sur la ligne. |
| Cette formule est évaluée pour donner la valeur au champ à affecter. On peut utiliser dans cette formule les champs des tables en lignes, des constantes, ainsi que les variables V1 à Vn définies par le tableau des paramètres de lancement du premier onglet. |
Les champs suivants sont présents dans la fenêtre ouverte par ce bouton : Bloc numéro 1
Bloc numéro 2
Ce bouton permet d'exécuter directement la transaction. Il s'agit de l'utilitaire de transactions système. |
Les champs suivants sont présents dans la fenêtre ouverte par ce bouton : Bloc numéro 1
Bloc numéro 2
Ce bouton permet de recopier la définition de la transaction vers un autre dossier. Attention, il faudra valider la transaction dans le dossier de destination. |
Il est important de noter que l'on peut faire des duplications et modifications simultanées dans la même transaction, à condition de respecter l'ordre de déclaration. Par exemple, si on saisit les lignes suivantes :
Table | Transaction | Champ | Formules |
TABLE1 | Modification | CHAMP1 | EXPRESSION1 |
TABLE1 | Création | CHAMP2 | EXPRESSION2 |
TABLE2 | Création | CHAMP3 | EXPRESSION3 |
TABLE2 | Modification | CHAMP4 | EXPRESSION4 |
TABLE3 | Modification | CHAMP5 | EXPRESSION5 |
L'algorithme appliqué sera le suivant :
Pour [toutes les lignes de la jointure concernée]
Lecture de la ligne courante de TABLE1, Affectation de CHAMP1 et CHAMP2, puis création d'une ligne de TABLE1
Lecture de la ligne courante de TABLE2, Affectation de CHAMP3, puis création d'une ligne de TABLE2
Affectation de CHAMP4, puis modification par réécriture de la ligne courante de TABLE2
Lecture de la ligne courante de TABLE3, Affectation de CHAMP5, puis modification par réécriture de TABLE3
En tout état de cause, un développeur pourra visualiser le traitement généré par la validation. Son nom est défini par le code de la transaction, préfixé par les caractères WMAMI.
Outre les messages génériques, les messages d'erreur suivants peuvent apparaître lors de la saisie :
La longueur d'une variable est contrôlée en fonction de son type.
Type | Longueur maximum |
Libellé | 30 |
Entier court | 4 |
Entier long | 8 |
Caractères | 250 |
Date | 4, 6 ou 8 (longueur autorisée ) |
Décimal | 32 ( pour partie entière et décimale) |
Le numéro renseigné correspond à un chapitre de messages et non à un menu local.
Le numéro renseigné ne correspond pas à un menu local existant.
On ne peut mettre à jour une table non définie en tant que table principale ou table liée dans cette fiche transaction.
Le champ doit exister dans le dictionnaire de la table précisée sur cette même ligne.
La dimension exprimée pour ce champ ne doit pas excédée celle définie pour ce même champ dans le dictionnaire de la table.