d'une fenêtre composée d'un en-tête et d'un ou plusieurs onglets situés sur la partie droite, et de listes de sélection situées à gauche ("browser"). Un enregistrement est géré à la fois.
d'une fenêtre composée d'un écran unique contenant la liste des enregistrements de la table.
Cet objet permet de gérer un enregistrement dans une table (une fiche tiers, par exemple), ou dans plusieurs tables (l'en-tête de commande et les lignes correspondantes).
En plus de la liste gauche principale de l'objet, il est possible d'en définir davantage. Ceci se fait, par la déclaration d'un objet de type browser pour chaque liste gauche supplémentaire.
Reportez-vous à la documentation de Mise en oeuvre
Présentation
L'en-tête permet d'identifier l'objet.
Fermer
Champs
Les champs suivants sont présents dans cet onglet :
| Le code d'un objet est constitué de 1 à 3 caractères alphanumériques. Les mots réservés d'adonix sont interdits. |
| Destiné à 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 de la fiche concernée. |
|   |
| Code de la table principale gérée par l'objet. |
|   |
Fermer
Champs
Les champs suivants sont présents dans cet onglet :
Général
| Indique le module applicatif auquel est rattaché la fiche (et le code rattaché le cas échéant). Les fiches utilisées par plusieurs modules sont classées dans l'un des modules tronc commun ou superviseur. Un développement associé au module (et le code correspondant) ne peut être utilisé que si le module est actif dans le dossier courant. |
| Dans le cas où l'objet géré est identifié par une clé à 2 composantes (par exemple une table diverses où la première composante représente le numéro de table), la première composante de clé devient un paramètre pour la gestion de l'objet. Vous devez alors indiquez le libellé de ce paramètre (Numéro de table, dans l'exemple).
|
| S'il est défini, un code activité rattaché à unOBJet permet de rendre celui-ci optionnel. |
| On définit ici le champ de la fiche principaleoù se trouve le code du site auquel est rattachél'enregistrement. |
|
On définit ici le champ de la fiche principale où se trouve lecode du code d'accès auquel est rattaché l'enregistrement. Le fait de définir ce code permet de gérer automatiquement lesrestrictions d'accès aux données d'un code d'accès. |
Bloc numéro 2
| Cette caractéristique définit la manière dont l'objet gère les enregistrements de la table. Les choix possibles sont Simple, En tableau, Combiné.Une quatrième valeur égale à Browser va permettre de créer de façon indépendante, des browsers qu'on intègrera ensuite dans une fenêtre. Simple. c'est le type le plus fréquent. Il correspond au cas où on gère dans une fiche un enregistrement de la table principale, une liste d'enregistrements étant affichée dans la liste de gauche. L'écran de gestion des objets obéit lui-même à cette logique (c'est un objet lui-même, son code est AOB), mais on trouvera de nombreux autres exemples : clients, factures, écritures, commandes... sont tous des objets simples. Tableau. Cela correspond au cas où la table, suffisamment petite, peut être directement chargée dans les lignes d'un seul tableau affiché à l'écran. Dans ce cas, la liste de gauche n'existe plus (elle n'est plus utile). La gestion de la codification des rubriques est elle-même faite ainsi. Combiné. Cela correspond au cas où on charge dans un tableau un ensemble d'enregistrements d'une table, enregistrements dont la clé est faite de N parties (N>1), dont les N-1 parties sont fixes et dont la dernière partie varie. Attention, ce n'est pas le cas pour les factures (qui ont une clé de type clé de pièce / numéro de ligne), car dans ce cas-là, on fait une gestion d'objet simple sur l'en-tête et on gère le chargement des lignes dans le code associé à l'objet. Un exemple d'un tel objet est la gestion des fiches techniques : pour un code de contrôle, on a 1 à N lignes présentées dans un tableau. Browser. Ce type permet de définir des listes de gauches que l'on rattachera ensuite à une fenêtre. Les informations à saisir sur ce type d'objet sont réduites aux informations pour la constitution d'une liste de gauche. |
Liens
| Cette zone définit le code dumenu dans lequel la fonction de gestion de l'OBJet sera présentepour l'utilisateur ADMIN. |
| Indiquez le rang où apparaîtra lafonction dans le menu ci dessus. |
| Ce code impression définit le ou les états lancés par appui sur le choix de menu Fichier / Imprimer. Il est à noter que les bornes de l'état peuvent être renseignées à partir de la fiche courante : en effet, le choix Fichier / Imprimern'est accessible que si une fiche courante est affichée à l'écran. Par défaut, lors de l'utilisation de ces boutons, le progiciel tentera d'éditer les états dont les noms sont donnés ici. Mais il existe une table d'indirection qui permet de redéfinir, à partir du code interne donné ici, un ou plusieurs états (par exemple l'impression des bons de préparation et bon de livraison dans l'objet des livraisons). |
| Ce code impression définit le ou les états lancés par appui sur le choix de menu Fichier / Liste. Le choix Fichier / Listeest toujours accessible, et est censé permettre d'imprimer des listes générales liées aux tables en ligne. Par défaut, lors de l'utilisation de ces boutons, le progiciel tentera d'éditer les états dont les noms sont donnés ici. Mais il existe une table d'indirection qui permet de redéfinir, à partir du code interne donné ici, un ou plusieurs états (par exemple l'impression des bons de préparation et bon de livraison dans l'objet des livraisons). |
| Traitements dans lesquels, il sera possible d'écrire des sous-programmes complémentaire à la gestion d'objet pour cette fonction. Un traitement est réservé au développement standard , le suivant aux verticaux et le dernier aux spécifiques. Aide développement. |
|   |
| Traitements dans lesquels, il sera possible d'écrire des sous-programmes complémentaire à la gestion d'objet pour cette fonction. Un traitement est réservé au développement standard , le suivant aux verticaux et le dernier aux spécifiques. Aide développement. |
Options
| Cette case à cocher permet d'activer le bouton 'Statistiques' dans l'objet. Ce bouton permet d'appeler les interrogations statistiques dont le ou les premiers critères sont définis par des données liées à la table principale ou à des tables liées à l'objet. |
| Le superviseur autorisera ou pas les suppressions différées sur la table principale ainsi que les tables secondaires gérées par l'objet. Cette possibilité est offerte pour les utilisateurs paramétrés en confirmation de suppression. Lorsque cet utilisateur supprime une fiche de l'objet, une fenêtre de confirmation s'affiche. Et, sur cette fenêtre, l'utilisateur peut cocher la case « suppression différée ». La fiche sera donc toujours présente jusqu'à ce que l'utilitaire de suppression différée soit lancé. |
|
Cette zone permet d'indiquer que l'OBJet est importable par lafonction import-export. |
| Permet de déclencher le lock logique lorsqu'on entre en modification d'un enregistrement, alors qu'en standard, il est positionné dès la visualisation de l'enregistrement. Pour entrer en modification, il faut dans ce cas cliquer sur l'cône représentant un livre bleu situé en bas de l'écran.
|
Fermer
Présentation
On retrouve toutes les informations permettant de construire le liste gauche principale de l'objet ainsi que la fenêtre de sélection. De plus, on a la possibilité de se définir des options de sélection.
Ce tableau permet de définir des filtres de sélection portant sur les enregistrements de la table gérée. Ces filtres, exprimés sous forme de conditions logiques portant sur les champs de la table et d'éventuelles constantes, sont identifiés par une lettre (majuscule pour le standard, minuscule pour le spécifique). Ils sont ensuite positionnés ou pas sur les champs ayant un type de donnée lié à cet objet.
Prenons l'exemple suivant :
Dans la saisie des commandes de vente, on ne veut autoriser que les clients actifs. Pour ce faire, un filtre de sélection est défini dans l'objet Client, avec la condition BPCSTA=2, et l'intitulé « Client actif ». Dans l'écran des commandes SOH0, on a un champ client BPCORD de type de donnée BPC ( type est lié à l'objet BPC). Sur le menu contextuel du type de donnée BPC, le menu « Options » permet de positionner ou pas chacun des filtres déclarés dans l'objet des clients.
La liste des colonnes devant apparaître dans la liste de gauche est saisie dans le tableau du bas du 2ème onglet. Ces colonnes peuvent être des champs de la table principale ou d'une table secondaire identifiée dans le 3ème onglet si l'expression de lien est renseignée. Elles peuvent être aussi une expression ; dans ce cas, on précisera le type de donnée pour stocker le résultat de l'expression.
Fermer
Champs
Les champs suivants sont présents dans cet onglet :
Tableau Options de sélection
| Ce tableau permet de définir des options de gestion de l'objet. Une option permet de caractériser des sous ensembles de fiches identifiés par une condition (clients actifs, comptes lettrables, ...). Une option est définie par:
|
| Ce tableau permet de définir des options de gestion de l'objet. Une option permet de caractériser des sous ensembles de fiches identifiés par une condition (clients actifs, comptes lettrables, ...). Une option est définie par:
|
|   |
|   |
Ecran de sélection
| Cette zone permet de définir un index de parcours du fichier principal pour l'affichage dans la liste de gauche et des fenêtres de sélection. Si la zone est vide, c'est le premier index de la table qui est utilisé. |
| Cette zone permet de définir un sens de parcours de la table principale pour l'affichage dans la liste de gauche et les fenêtres de sélection de l'objet. |
| Cette zone permet de préciser uneou plusieurs options pour les fiches présentes dans la fenêtre desélection. |
| Lorsque la clé de parcours choisie pour la liste gauche est composée de plusieurs parties, la liste se fait alors en présentant d'abord uniquement la première partie de la clé. En double-cliquant sur l'une des valeurs de clés, on explore les sous-valeurs de clé, et ce sur le nombre de niveaux de sous-clés existant. Lorsque tous les niveaux de clés sont explorés, on peut sélectionner un enregistrement de la table. Un exemple de ce fonctionnement peut être constaté sur l'objet de gestion des sites : chaque site étant rattaché à une société, on visualise d'abord la liste des sociétés, et on a ensuite la possibilité de déplier une société en double-cliquant dessus : on voit alors la liste des sites de la société, et on peut en sélectionner un. si la case n'est pas cochée, il s'agit d'une liste simple. |
| Tout champ d'un écran dont le type est lié à un objet dispose d'une fenêtre de sélection accessible par clic droit ou par . Cette valeur permet de définir le nombre de caractères utilisés pour préciser où doit commencer la sélection, en fonction de ce qui a été saisi dans la zone avant la sélection. Si cette valeur vaut N, la sélection débute à partir de la première clé dont les N premiers caractères sont supérieurs ou égaux à la chaîne saisie. Ainsi :
|
| On saisit ici la table dans laquelle se trouve le champ à afficher.Cette table est soit la table principale, soit l'une des tables définies comme liée à la table principale dans la définition de l'objet. Cette zone peut être vide si on affiche une expression calculée. |
| On saisit ici les champs présents dans la liste gauche. Ils sont issus de la table définie précédemment. |
| Lorsqu' une colonne de la liste gauche est évaluée, on définit ici l'expression calculée dont le résultat remplit la colonne. Un type de données est alors nécessaire pour permettre le formatage du champ. |
| Cet intitulé est utilisé comme titre de la colonne, aussi bien dans la liste gauche que dans les fenêtres de sélection de l'objet. Par défaut, l'intitulé du champ est utilisé. Il faut noter que cet intitulé est traduisible. Ainsi, si un intitulé non connu est saisi, la fenêtre de choix permettant de créer un nouveau texte dans le dictionnaire s'ouvre automatiquement. |
| Ce type de données est utilisé pour formater l'expression précédente dans la liste gauche. |
| Cette information permet de formatter les données par le choix d'option. Les options dépendent du type de données (utiliser la fenêtre de recherche). |
| Possibilité d'indiquer une longueur à une colonne alphanumérique construite par une expression. Si non renseignée, la longueur de 30 caractères est prise par défaut. |
Fermer
Présentation
Permet de définir, un ensemble de tables nécessaires à l'exécution de la fonction, le lien tables écrans pour la gestion de l'import, les écrans complémentaires accessibles par bouton ou menu pour les web services.
Fermer
Champs
Les champs suivants sont présents dans cet onglet :
| Tables supplémentaires à la table de base gérée par l'objet. Ces tables sont ouvertes puis fermées automatiquement à l'exécution de l'objet, sous l'abréviation indiquée ou sinon sous l'abréviation du dictionnaire. Les champs de ces tables sont accessibles dans l'objet. De plus, les champs de ces tables sont utilisables pour définir une colonne de liste gauche et des écrans de sélection à partir du moment où l'expression de lien est renseignée. Il est possible de définir des liens hiérarchisés, à la condition de renseigner ces tables, dans le tableau, dans l'ordre de la hiérarchie. La clé de lien doit être sans homonyme. Si elle est non renseignée, le superviseur prend la clé primaire. |
|   |
|   |
|   |
|   |
Tableau Import
| Pour l'import, on précise toutes les tables qui seront mises à jour. Puis, pour chaque table, on précise le ou les écrans qui la gèrent. Et enfin, pour chacun bloc tableau, on indique la variable de bas de tableau lorsque ces informations sont pour alimenter une table détail. |
|   |
|   |
Tableau Ecrans complémentaires
| Pour les WEB services, on indique les écrans supplémentaires utilisés dans la gestion de l'objet, depuis un bouton bas d'écran ou un menu.
|
|   |
Fermer
Icône Actions
Ce bouton permet de créer automatiquement les liens nécessaires vers la tables des textes traduits ATEXTRA.
Fermer
Présentation
Permet de définir, un ensemble de vues nécessaires à l'exécution de la fonction. Ces vues seront ouvertes et fermées dans le traitement généré lié à l'objet WOobjet.
Fermer
Champs
Les champs suivants sont présents dans cet onglet :
| Ces vues sont ouvertes puis fermées automatiquement à l'exécution de l'objet, sous l'abréviation indiquée ou sinon sous l'abréviation du dictionnaire. Les champs de ces vues sont accessibles dans l'objet. |
|   |
|   |
Fermer
Par défaut, les états suivants sont associés à la fonction :
PRTSCR : Impression écran
Mais ceci peut être modifié par paramétrage.
La validation permet de générer le traitement automatique lié à l'objet ( WOxxx, ou xxx est le code objet ) |
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 de l'objet vers un autre dossier. Attention, il faudra valider l'objet dans le dossier de destination. |
Outre les messages génériques, les messages d'erreur suivants peuvent apparaître lors de la saisie :
La table liée est obligatoire pour les objets sauf pour les browsers.
Sur une liste hiérarchisée ( simple ou picking ), le nombre d'éléments déclarés pour la liste de gauche doit être supérieur ou égal au nombre d'éléments de l'index utilisé.
Si la zone « site » est renseignée, la valeur saisie est un nom de champ qui doit exister dans la table principale.
Pour des raisons techniques, le caractère ' « ' est interdit dans tous les champs de texte : l'intitulé de l'objet, l'intitulé paramètre, l'intitulé des options, l'expression de condition, le message d'erreur, l'expression de lien.
L'expression saisie ne respecte pas la syntaxe X3. Un message explicatif détaille l'erreur.
On tente de saisir une option de sélection, qui n'existe pas dans le tableau des options de sélection.
La table doit être déclarée dans la liste des tables à ouvrir de l'onglet « Environnement ».
La table doit être déclarée dans la liste des tables à ouvrir de l'onglet « Environnement » et avoir une expression de lien correcte.
Le champ doit existé dans la table saisie dans le champ précédent.
Le champ saisi est de type « AXX ». Cela signifie qu'il n'existe pas dans la base mais permet juste le lien vers la table des textes ATEXTRA.
Le champ saisi est d'un type de donnée qui ne l'autorise pas à être dans la liste de gauche : Type « AXX », Clob ou Blob.
On tente d'enlever le flag « import » alors que des modèles d'import existe déjà.
L'abréviation d'une table ou d'une vue doit être unique sur l'ensemble des tables et des vues définies sur l'objet.