Représentations
Une représentation est une entité du dictionnaire qui décrit les propriétés utilisées par l’interface utilisateur.
Une représentation est toujours associée à une classe. À ce titre, elle peut avoir ses propres éléments tels que des propriétés, des scripts associés et des méthodes. Ces éléments spécifiques, en plus de ceux déjà détenus par la classe associée, sont un complément des règles liées au comportement de l'interface utilisateur.
Utilisez cette fonction pour créer et mettre à jour des représentations. Une représentation déjà décrite dans le dictionnaire doit être validée pour pouvoir être utilisée par le logiciel.
Pré-requis
Reportez-vous à la documentation de Mise en oeuvre
Gestion de l'écran
En-tête
L'en-tête contient les informations qui identifient la classe.
Code représentation (champ CODREP) |
Identifiant unique de la représentation. Cet identifiant est utilisé pour générer automatiquement des noms de scripts dans la couche superviseur lors d'une validation. |
Intitulé (champ AZINTREP) |
Intitulé de la représentation. |
Onglet Général
Cette section décrit les informations principales de la représentation.
Tableau Facettes
Il liste les facettes prises en charge pour la représentation : Detail, Edit, Query, Lookup et Summary.
Tableau Comportements gérés
Il décrit les comportements gérés pour la représentation.
Tableau Collections
Il décrit les collections définies au niveau de la représentation. Les collections qui ont été définies dans la classe doivent être déclarées si l'une des conditions suivantes est remplie :
- Les caractéristiques des collections sont modifiées.
- Un champ a été ajouté à la collection.
Tableau Scripts
Il liste :
- Les scripts et les codes des méthodes définies par le développeur.
- Les scripts dans lesquels les étiquettes $METHODS et $PROPERTIES sont disponibles pour les développeurs partenaires qui souhaitent ajouter leur propre code associé à des événements de superviseur (en particulier pour la gestion des opérations de Création, Lecture, Mise à jour, Suppression, ou opérations CRUD, soit Create, Read, Update and Delete).
Général
Code classe (champ CODCLA) |
Sélectionnez le code classe. Il définit la classe associée à la représentation. Il est obligatoire. |
Instance (champ ABRCLA) |
Saisissez le nom de la propriété qui identifie l'instance de la classe dans la représentation. |
Utilisée pour les résultats de recherche (champ DEFREP) |
Si vous cochez cette case, la représentation est sélectionnée par défaut pour afficher le détail des données en utilisant le lien sur la page des résultats de la recherche. Pour une classe donnée et un type donné, une seule représentation peut être sélectionnée. |
Fonctions
Habilitation (champ AFCRIGHT) |
Sélectionnez le code d'une fonction. Ce code permet au superviseur de vérifier si l'utilisateur a accès à cette fonction. Le profil utilisateur définit pour chaque utilisateur les fonctions auxquelles il a accès, et définit éventuellement des filtres par société et par site. Ce champ Habilitation n'est pas obligatoire, mais si aucune fonction n'est renseignée, la représentation est alors disponible sans restriction à tous les utilisateurs qui ont accès à l'endpoint. |
Convergence (champ FONCTION) |
Renseignez une fonction de Sage X3, invoquée en mode Edition (pages classiques) lorsque l'utilisateur modifie un enregistrement en mode Detail alors qu'une facette Edit n'a pas été spécifiée pour la représentation. Ce champ n'est pas obligatoire. |
Caractéristiques
Code activité (champ CODACT) |
Renseignez un code activité. Ce code activité est utilisé pour protéger les représentations pendant le processus de patch standard si le code commence par les lettres X, Y ou Z, ou pour rendre les représentations optionnelles. Il se comporte comme tous les codes activités définis dans les dictionnaires. |
Module (champ MODULE) |
Sélectionnez le module technique auquel la représentation est associée. |
Type
champ TYPMSKREP |
Type d'écran pour lequel la représentation a été créée. |
Système (champ FLGSYSTEM) |
Cette case est réservée au superviseur. Elle ne doit pas être cochée pour une représentation normale. |
Tableau Facettes
Code (champ CODFAC) |
Liste des facettes liées ou non à la représentation. |
Actif (champ ENAFAC) |
La case Actif est cochée ou non automatiquement en fonction des comportements gérés cochés dans le tableau Comportement gérés. |
Tableau Comportements gérés
Code (champ CODCOM) |
Nom des comportements gérés. |
Actif (champ ENACOM) |
Cochez la case Actif pour activer les comportements correspondants. |
Tableau Collections
Code (champ CODCOL) |
Renseignez le code de la collection.
Déclarer les collections présentes au niveau de la classe n'est utile que si des champs présents uniquement dans la représentation doivent être ajoutés. |
Alias (champ ALIASCOL) |
L'alias est le nom unique qui identifie la collection. Il doit être défini si un chemin de classe a été donné, et doit être unique pour la représentation. |
Libellé (champ INTITCOL) |
Saisissez le libellé de la collection. |
Nb mini (champ MINCOL) |
Ce champ définit comment l'ensemble des propriétés est stocké en mémoire. Ce nombre peut être 0, 1 ou Maximum. |
Act (champ ACTCOL) |
Renseignez un code activité de dimensionnement. Il permet de définir la taille maximale de la collection sur la base de la valeur du code d'activité. Ce code n'est pas obligatoire. |
Nb max (champ MAXCOL) |
Saisissez la taille maximale de la collection. Vous pouvez renseigner ce champ uniquement s'il n'y a pas code activité sur la collection. Ce champ n'est pas obligatoire. Si vous laissez ce champ vide, la taille de la collection augmente automatiquement sans limite lorsque de nouvelles lignes sont créées. |
Compteur (champ PROCOL) |
Propriété de la représentation qui contient le nombre de lignes créées dans la collection. Sélectionnez une propriété lorsque le nombre de lignes d'un document est indiqué dans l'en-tête. |
Insertion (champ FLGINSCOL) |
Si les cases des colonnes Insertion, Suppression, Tri et Ajout sont cochées (ont pour valeur 'Oui'), les opérations d'insertion, de suppression, de tri et d'ajout de lignes sont possibles dans la collection. Si la collection a été définie dans la classe, ces valeurs sont les mêmes dans la représentation. Vous pouvez décocher ces cases au niveau de la représentation, mais vous ne pouvez pas les cocher si l'opération n'est pas prise en charge au niveau de la classe. Les méthodes correspondantes sont appelées ADDLINE, ADELLINE, ASORT et AINSERT. |
Suppression (champ FLGSUPCOL) |
Si les cases des colonnes Insertion, Suppression, Tri et Ajout sont cochées (ont pour valeur 'Oui'), les opérations d'insertion, de suppression, de tri et d'ajout de lignes sont possibles dans la collection. Si la collection a été définie dans la classe, ces valeurs sont les mêmes dans la représentation. Vous pouvez décocher ces cases au niveau de la représentation, mais vous ne pouvez pas les cocher si l'opération n'est pas prise en charge au niveau de la classe. Les méthodes correspondantes sont appelées ADDLINE, ADELLINE, ASORT et AINSERT. |
Tri (champ FLGTRICOL) |
Si les cases des colonnes Insertion, Suppression, Tri et Ajout sont cochées (ont pour valeur 'Oui'), les opérations d'insertion, de suppression, de tri et d'ajout de lignes sont possibles dans la collection. Si la collection a été définie dans la classe, ces valeurs sont les mêmes dans la représentation. Vous pouvez décocher ces cases au niveau de la représentation, mais vous ne pouvez pas les cocher si l'opération n'est pas prise en charge au niveau de la classe. Les méthodes correspondantes sont appelées ADDLINE, ADELLINE, ASORT et AINSERT. |
Ajout (champ FLGAPDCOL) |
Si les cases des colonnes Insertion, Suppression, Tri et Ajout sont cochées (ont pour valeur 'Oui'), les opérations d'insertion, de suppression, de tri et d'ajout de lignes sont possibles dans la collection. Si la collection a été définie dans la classe, ces valeurs sont les mêmes dans la représentation. Vous pouvez décocher ces cases au niveau de la représentation, mais vous ne pouvez pas les cocher si l'opération n'est pas prise en charge au niveau de la classe. Les méthodes correspondantes sont appelées ADDLINE, ADELLINE, ASORT et AINSERT. |
Tableau Scripts
Type (champ TYPTRT) |
Sélectionnez un type de code. Standard
Vertical
Spécifique
|
Fichier (champ CODTRT) |
Sélectionnez le nom du script. Les conventions de nommage indiquent d'utiliser cette dénomination : repr_Ryyyy, où :
Les conventions de nommage ne sont pas obligatoires puisqu'un script peut être partagé par différentes classes. |
Ordre (champ RANTRT) |
Saisissez l'ordre dans lequel les étiquettes $METHODS et $PROPERTIES sont appelées dans l'évènement. |
Code activité (champ ACTTRT) |
Code utilisé pour protéger le script pendant le processus de patch standard si le code commence par les lettres X, Y ou Z, ou pour activer et désactiver l'appel du script. |
Editeur de traitements |
Onglet Propriétés
Cette section décrit les propriétés définies au niveau de la représentation. Les propriétés définies au niveau de la classe ne doivent pas être listées.
Tableau Propriétés
Il liste les propriétés et les informations relatives.
Tableau Clés
Il liste les segments de clé correspondant à la ligne sélectionnée dans le tableau Propriétés, si le type de propriétés est lié à une table ou à une classe persistante.
Tableau Paramètres
Il liste les paramètres d'une propriété, selon la ligne sélectionnée dans le tableau Propriétés, si les règles de la propriété exigent des paramètres complémentaires. Vous devez alors entrer une valeur pour appeler la règle avec les bons paramètres, selon le contexte.
Tableau Propriétés
Propriété (champ CODFLD) |
Saisissez le nom de la propriété tel qu'il est utilisé dans le script de Sage X3. |
Ordre (champ NUMFLD) |
Saisissez un ordre de classement de la propriété. |
Libellé (champ AZINTFLD) |
Saisissez le libellé de la propriété affiché dans l'interface utilisateur. |
Libellé court (champ AZINTSHTFL) |
Saisissez le libellé court de la propriété. Il peut être utilisé lors de la personnalisation de l'interface utilisateur. |
Type (champ CODTYP) |
Renseignez le type de données associé à la propriété. Il fait référence au dictionnaire des types de données. Ce champ est obligatoire. |
Menu (champ NOLIB) |
Renseignez le numéro du menu local si le type de données dans le champ précédent est M (pour "Menu local"). Les numéros définissent toutes les valeurs disponibles pour la propriété (par exemple, le numéro 1 correspond au menu local Non/Oui). |
Long (champ LONG) |
Saisissez la longueur du champ si le type de données ne détermine pas la longueur. La longueur du champ peut être exprimée en nombre de caractères (pour des valeurs de type chaîne), ou en chiffres selon ce format : N.M, où 'N' est le nombre de chiffres avant la décimale et 'M' est le nombre de décimales. |
Act (champ ACTFLD) |
Code utilisé pour protéger des propriétés spécifiques dans des classes standards pendant le processus de patch standard si le code commence par les lettres X, Y ou Z, ou pour les rendre optionnelles, selon la valeur du code activité donné lors de la configuration du dossier Sage X3. Il se comporte comme tous les codes activités définis dans les dictionnaires. |
Collection (champ FLDGRP) |
Renseignez le code de la collection si la propriété n'est pas unique. Ce code fait référence à une des collections définies dans la première section du dictionnaire des classes. Cela peut être soit un tableau de références enfants (table principale/structures de ligne) soit un tableau non normalisé stocké dans plusieurs colonnes d'une base de données. |
Table du lob (champ LOBTAB) |
Lorsque le type de données est CLOB ou BLOB et est géré par le superviseur, ces champs Table du lob et Champ lob décrivent dans quelle table et dans quelle colonne l'élément support est stocké. Selon la table utilisée, le tableau Clés est alimenté afin que le lien s'établisse en donnant la valeur de la clé. Lorsque le type de données n'est pas géré par le superviseur, le lien est fait par un programme, et vous ne pouvez pas saisir de valeur dans ces deux champs. |
Champ lob (champ LOBFLD) |
Content type (champ LOBCNT) |
Lorsque le type de données est CLOB ou BLOB et est géré par le superviseur, sélectionnez le type de contenu associé au type de données. |
Oblig (champ OBLIG) |
Lorsque ce champ a pour valeur 'Oui', la propriété est valide, mais uniquement si elle contient une valeur. |
Table de contrôle (champ CODCTL) |
Renseignez la table de contrôle qui permet d'effectuer un contrôle supplémentaire de la cohérence, défini par une simple configuration. |
Dépendance (champ TABCONT) |
Saisissez la propriété utilisée lorsque la table de contrôle dépend d'une autre table. |
Code d'accès (champ ACS) |
Renseignez le code d'accès, mis en place par une configuration, qui permet de contrôler l'accès à la propriété pour un utilisateur. |
Accesseur GET (champ FLGACCGET) |
Si vous cochez cette case, un code d'appel 'Accesseur GET' est généré sur la propriété. Vous pouvez changer la valeur de cette case dans le dictionnaire, même pour des développements spécifiques sur des classes standards spécifiques. Si la case est cochée, elle ne sera pas décochée lors d'un patch. Cochez cette case seulement si nécessaire. En effet, appeler des accesseurs GET sur toutes les propriétés peut réduire l'efficacité de l'exécution. |
Tableau Clés
Code (champ CODCLE) |
Nom de la colonne de chaque segment de clé. Vous ne pouvez pas le modifier. |
Libellé (champ INTCLE) |
Libellé de chaque segment de clé. Vous ne pouvez pas le modifier. |
Type (champ TYPCLE) |
Type de données du segment de clé. Vous ne pouvez pas le modifier. |
Valeur (champ VALCLE) |
Formule de la valeur du segment de clé. Seul un sous-ensemble du langage de script de Sage X3 peut être utilisé pour fournir les valeurs des clés ou des paramètres, car ces valeurs doivent être évaluées par le client.
|
Tableau Paramètres
Code (champ CODPAR) |
Code de chaque paramètre, affiché automatiquement. Vous ne pouvez pas le modifier. |
Libellé (champ INTITPAR) |
Description de chaque paramètre, affichée automatiquement. Vous ne pouvez pas la modifier. |
Mode (champ ADRVAL) |
Le mode définit comment le paramètre est transmis dans l'appel. Vous ne pouvez pas le modifier. Par adresse
Par valeur
Constante
|
Type (champ TYPINTPAR) |
Type de données de chaque segment de clé, affiché automatiquement. Vous ne pouvez pas le modifier. |
Valeur (champ VALEUR) |
Indiquez la formule qui fournit la valeur d'un paramètre. Seul un sous-ensemble du langage de script de Sage X3 est utilisé pour la formule entrée dans ce champ. |
Onglet Méthodes
Cette section définit les méthodes pour la représentation. Comme la représentation est liée à un processus d'interface utilisateur, seules les méthodes stateful sont disponibles. Par conséquent, les opérations stateless ne peuvent être définies que pour les classes.
Tableau Méthodes
Il liste les méthodes et les informations correspondantes.
Tableau Paramètres
Il liste les paramètres associés à la méthode du tableau Méthodes et leurs informations correspondantes.
Tableau Méthodes
Code (champ CODMET) |
Saisissez le code qui identifie le nom de la méthode qui peut être appelée pour la représentation. Pendant le temps d'exécution, la variable ACTION contient ce code lorsque l'évènement correspondant est exécuté dans l'étiquette $METHODS avec CURPTH = " " (dans les fichiers sources de la représentation associée). |
Libellé (champ INTITMET) |
Saisissez le libellé de la méthode. |
Retour (champ DONMET) |
Sélectionnez le type de données de la valeur renvoyée par la méthode lorsqu'elle est appelée par Fmet. C'est le type de la variable ARET_VALUE disponible dans l'événement associé à la méthode. |
Code activité (champ ACTMET) |
Renseignez le code activité qui permet de désactiver une méthode. Au moment de l'exécution, si le code activité n'est pas actif, la méthode ne sera pas disponible. |
Tableau Paramètres
Code (champ CODPARMET) |
Sélectionnez le nom de la variable contenant la valeur du paramètre, comme dans le code appelé par l'évènement $METHODS. |
Type (champ TYPPARMET) |
Type de données du paramètre envoyé à la méthode. Il fait référence au mot-clé utilisé pour la déclaration de la variable. |
Libellé (champ INTITPARME) |
Saisissez le libellé de la variable. |
Mode (champ MODPARMET) |
Sélectionnez le mode qui définit comment le paramètre est transmis dans l'appel. Par Adresse
Par Valeur
Constante
|
Dim (champ DIMPARMET) |
Définit si le paramètre envoyé est un tableau et quelle est la première valeur de l'index. No
From 1
From 0
|
Classe (champ CLAPARMET) |
Renseignez la classe du paramètre lorsque le champ Type a pour valeur 'Instance'. |
Onglet Organisation
Cette section spécifie l'organisation hiérarchique par défaut mise en place pour la représentation, ainsi que des informations supplémentaires utilisées pour la page de requête. Une représentation définit :
- Une page, divisée en sections.
- Des sections, divisées en blocs.
- Des blocs contenant une seule propriété ou plusieurs propriétés organisées en collection. La collection est alors généralement représentée sous forme de tableau dans l'interface utilisateur.
Les sections, les blocs et les propriétés sont placés par défaut dans une page selon un algorithme prédéfini. La fonction de personnalisation permet à un utilisateur de changer une mise en page sans perdre l'organisation hiérarchique de la représentation.
Tableau Sections
Il liste les sections de la page.
Tableau Blocs
Il liste les blocs de la page.
Tableau Filtres
Il liste les filtres qui peuvent être utilisés pour la représentation en cours. Les filtres présents dans cette liste sont utilisés dans la facette Query. Un filtre défini comme étant obligatoire sera toujours appliqué lors de la requête.
Tous les autres filtres sont affichés sous forme de liens sur le côté droit de la page. Si vous cliquez sur un lien, la requête est actualisée en appliquant le filtre correspondant, en plus du filtre obligatoire, s'il en existe un. Si vous cliquez sur plusieurs liens, il n'y a pas de combinaison de filtres, mais le nouvel ensemble de filtres remplace le précédent.
S'il y a au moins un filtre qui n'est pas le filtre obligatoire dans le tableau, un lien supplémentaire appelé Aucun filtre est également présent, pour permettre aux utilisateurs de faire une requête uniquement avec le filtre établi par défaut. Lors de la saisie de la requête, le filtre dont le champ Défaut a pour valeur Oui est le filtre par défaut, mais il peut être remplacé par n'importe quel autre filtre.
Tableau Ordre de tri
Il permet de définir l'ordre par défaut utilisé pour afficher les lignes de la requête. S'il n'est pas rempli, c'est l'index par défaut pour la table principale associée à la classe qui est utilisé.
Tableau Sections
Code (champ CODSEC) |
Saisissez un code unique pour une représentation, composé de 12 lettres ou chiffres maximum. |
Libellé (champ AZINTSEC) |
Saisissez le libellé, c'est-à-dire le nom de la section affiché dans la page. Ce nom est obligatoire. |
Ordre d'affichage (champ NIVSEC) |
Saisissez l'ordre d'affichage des sections par défaut. L'ordre peut être discontinu et peut comporter jusqu'à quatre chiffres. |
Empilement (champ STACKED) |
Code activité (champ ACTSEC) |
Renseignez le code activité. Ce utilisé pour protéger les sections spécifiques pendant le processus de patch standard si le code commence par les lettres X, Y ou Z, ou pour rendre les sections optionnelles. Il se comporte comme tous les codes activités définis dans les dictionnaires. |
Tableau Blocs
Code (champ CODBLC) |
Saisissez un code unique pour une représentation, composé de 12 lettres ou chiffres maximum. |
Libellé (champ AZINTBLC) |
Saisissez le libellé, c'est-à-dire le nom du bloc affiché dans la page. Ce nom est obligatoire. |
Section (champ SECBLC) |
Renseignez le code de la section dans laquelle le bloc se trouve. |
Ordre d'affichage (champ NIVBLC) |
Saisissez l'ordre d'affichage par défaut des blocs dans les sections. L'ordre peut être discontinu et peut comporter jusqu'à quatre chiffres. |
Empilement (champ BLOCSTACKE) |
Num colonne (champ BLOCCOLNUM) |
Code activité (champ ACTBLC) |
Code utilisé pour protéger les blocs spécifiques pendant le processus de patch standard si le code commence par les lettres X, Y ou Z, ou pour rendre les blocs optionnels. Il se comporte comme tous les codes activités définis dans les dictionnaires. |
Tableau Filtres
Code (champ OPTCOD) |
Saisissez un code unique de filtre ou sélectionnez un filtre défini au niveau de la classe. |
Classe (champ OPTFLGCLA) |
Cette case est cochée automatiquement si le filtre a été défini au niveau de la classe. |
Libellé (champ AZOPTLIB) |
Ce libellé (texte de dictionnaire et donc traduisible) correspond au libellé du lien de filtre présent sur la page. |
Code activité (champ OPTACT) |
Si le code activité est renseigné, le lien est optionnel. Si ce code commence par la lettre X, Y ou Z, le lien n'est pas standard. |
Oblig (champ OPTOBY) |
Un seul filtre peut être défini comme obligatoire. Ce filtre sera toujours utilisé et peut être associé à l'un des autres filtres listés dans le tableau. |
Défaut (champ OPTDEF) |
Vous ne pouvez définir qu'un seul filtre en tant que filtre par défaut. Ce filtre est appliqué par défaut dans les représentations où il est présent. Mais l'utilisateur peut sélectionner un autre filtre par défaut. |
Condition option (champ OPTCND) |
Définit la condition appliquée lorsque le filtre est activé. Il s'agit d'une expression logique qui peut inclure des opérateurs, des propriétés de la classe, et des constantes. |
Message erreur (champ AZOPTERR) |
Message affiché lorsqu'un filtre a été défini et lorsqu'il y a une tentative d'accès à une entrée qui ne remplit pas les conditions de filtre. |
Ordre de tri
Index (champ CODIND) |
Index par défaut utilisé pour la requête. Cet index ne peut être que l'un des index présents dans la table principale associé à la classe. |
champ ADESIND |
Descripteur index (champ DESCRIPT) |
Décrivez un index si aucun index par défaut n'a été défini dans le champ Index. Une description de tri peut être définie ici sur les champs présents dans la facette Query, avec la syntaxe habituelle des clés. Par exemple : -FIELD1+FIELD2 -FIELD3+FIELD4. Lorsqu'une telle syntaxe est utilisée, l'ordre de tri est: par FIELD1 en mode descendant, puis par FIELD2 en mode ascendant, puis par FIELD3 en mode descendant, enfin par FIELD4 en mode ascendant. Cela correspond à la variable supplémentaire dans l'URL : &OrderBy=FIELD1 Desc;FIELD2;FIELD3 Desc;FIELD4. |
Onglet Propriétés exposées
Une représentation affiche sur l'appareil (mobile, tablette, ordinateur) une liste de propriétés, qui peuvent être :
- Les propriétés définies dans la représentation.
- Les propriétés présentes dans la classe principale ou ses classes enfants.
Tableau Propriétés
Il liste toutes les propriétés disponibles. Par l'action de sélection, accédez à la liste des classes, classes enfants et propriétés à inclure. Vous pouvez aussi entrer dans une propriété sur une ligne.
Tableau Propriétés
Alias (champ ALIAS) |
Alias unique dans la représentation. Il est utilisé pour désigner la propriété dans le flux de données échangées avec le client. Il peut comporter jusqu'à 30 caractères. Les caractères doivent être composés de lettres majuscules, de chiffres ou d'underscores. Les lettres minuscules ne sont pas autorisées dans l'alias. |
Propriété (champ CODPRO) |
Ce champ définit le chemin de la propriété.
Les segments dans le chemin sont les codes des instances enfants telles qu'elles sont définies dans la représentation ou dans la description de la classe. |
Collection (champ FLDGRPPRO) |
Si vous renseignez ce champ, la propriété est un membre d'une collection qui peut être l'une des collections présentes soit sur la représentation, soit sur une classe, soit sur une classe enfant. Le point est utilisé dans la syntaxe du chemin de la collection. Par exemple : SORDER.LINE.QTY est le chemin pour une collection dans la classe enfant ORDERLINE (instance LINE) de la classe SALESOREDER (instance SORDER) associée à la représentation. Quand une collection est présente sur une représentation, les propriétés au sein de cette collection sont montrées dans l'interface utilisateur sous forme de tableau. Lorsqu'il y a un seul membre dans la collection, il est alors présenté sous forme de liste. Les propriétés présentes dans une collection doivent être rangées dans l'ordre et dans le même bloc . Cela signifie qu'une propriété peut intégrer un bloc uniquement si elle appartient à la collection correspondante. Une propriété étrangère, qu'elle soit indépendante ou présente dans une autre collection, ne peut pas être admise parmi les propriétés d'une collection particulière. |
Bloc (champ BLCPRO) |
Code du bloc par défaut dans lequel se trouve la propriété dans l'interface utilisateur. |
Ordre (champ ORDPRO) |
Saisissez l'ordre de saisie des propriétés dans les blocs. L'ordre peut être discontinu et peut comporter jusqu'à quatre chiffres. |
Libellé (champ AZINTPRO) |
Saisissez le libellé et le libellé court affichés dans l'interface utilisateur. L'utilisateur peut modifier la position des libellés ou les masquer dans la fonction de personnalisation. |
Libellé court (champ AZINTSHTPR) |
Saisissez le libellé et le libellé court affichés dans l'interface utilisateur. L'utilisateur peut modifier la position des libellés ou les masquer dans la fonction de personnalisation. |
Num colonne (champ COLNUM) |
Code activité (champ ACTPRO) |
Le code activité peut être utilisé pour rendre la propriété optionnelle (si le code activité n'est pas actif, la propriété disparaît automatiquement du prototype), et pour protéger les caractéristiques des propriétés si le code d'activité est spécifique. |
Unité (champ UOMPRO) |
Si la propriété est une valeur numérique attachée à une unité (par exemple, une quantité ou un montant en devise), la propriété qui définit l'unité utilisée doit être saisie. La propriété doit être une des propriétés de la représentation. Seule une propriété ayant un type de données associée à une table qui gère les unités peut être sélectionnée. |
P. Filtre (champ PARFILPRO) |
Si cette case est cochée, la valeur correspondante constitue un filtre lors de l'appel de la facette Query. Par exemple :
A des fins de filtrage des commandes de ventes aux Etats-Unis, l'utilisateur sélectionne l'option suivante dans l'URL, option qui appelle la représentation SORDER en mode Query : ...?url=http://myserver:8124/x3/erp/DEMO/SORDER?representation=SORDER.$query&where=COUNTRY_ORDER eq 'US' Il n'est pas nécessaire de cocher cette case pour toutes les propriétés de la facette Query, car la possibilité de filtrage sur les valeurs de la colonne est implicite (la ligne de filtre permet d'entrer directement les valeurs). |
P. Entrée (champ PARENTPRO) |
Si cette case est cochée, la valeur correspondante peut être un filtre lorsque les facettes Edit ou Detail sont appelées, ce qui est particulièrement important si l'un des paramètres n'est pas présent dans la clé. |
Query (champ QRYPRO) |
Les colonnes Query, Detail, Edit, Look up et Summary représentent les différentes facettes dans lesquelles la propriété peut être utilisée. Quand les cases de ces colonnes sont cochées, la propriété est présente dans la facette correspondante. Après chaque colonne de facette se trouve la colonne Etat initial. Un état initial peut être visible ou invisible, selon chaque facette. Cet état initial peut ensuite être modifié dynamiquement par le développeur partenaire avec un script utilisant une méthode ASETATTRIBUTE. En plus de la colonne Etat initial, La colonne Edit est associée à la colonne Saisissable. Si la case de cette colonne est cochée, le champ correspondant est alors en mode édition et donc modifiable. Si la case n'est pas cochée, le champ est seulement en mode consultation. Un filtre peut être mis en place sur les propriétés présentes sur la facette Query si ces propriétés sont saisies. |
Etat initial (champ STAQRYPRO) |
Detail (champ DETPRO) |
Etat initial (champ STADETPRO) |
Edit (champ EDIPRO) |
Etat initial (champ STAEDIPRO) |
Saisissable (champ TYPAFFPRO) |
Masquable (champ ISMASKABLE) |
Retour ligne (champ BREAKAFTER) |
Lookup (champ LOKPRO) |
Les colonnes Query, Detail, Edit, Look up et Summary représentent les différentes facettes dans lesquelles la propriété peut être utilisée. Quand les cases de ces colonnes sont cochées, la propriété est présente dans la facette correspondante. Après chaque colonne de facette se trouve la colonne Etat initial. Un état initial peut être visible ou invisible, selon chaque facette. Cet état initial peut ensuite être modifié dynamiquement par le développeur partenaire avec un script utilisant une méthode ASETATTRIBUTE. En plus de la colonne Etat initial, La colonne Edit est associée à la colonne Saisissable. Si la case de cette colonne est cochée, le champ correspondant est alors en mode édition et donc modifiable. Si la case n'est pas cochée, le champ est seulement en mode consultation. Un filtre peut être mis en place sur les propriétés présentes sur la facette Query si ces propriétés sont saisies. |
Etat initial (champ STALOKPRO) |
Summary (champ SUMPRO) |
Etat initial (champ STASUMPRO) |
Onglet Liens
Cette section définit les liens disponibles à différents endroits de l'interface utilisateur. Les liens déclenchent des opérations ou des méthodes selon le contexte. Parce qu'il peut y avoir beaucoup de liens dans une représentation, cette section présente une liste restreinte des liens disponibles selon les filtres suivants : le champ Type d'ancre et les cases Affichage des liens générés ou Uniquement les liens invalides.
Tableau Liens
Il liste les liens filtrés selon le type d'ancre donné.
Tableau Clés
Quand un lien nécessite une clé pour fonctionner, ce tableau est alimenté avec les éléments correspondants, et vous devez indiquez la formule dans la colonne Valeur.
Tableau Paramètres
Quand un lien nécessite des paramètres supplémentaires pour fonctionner, ce tableau est alimenté avec une liste des paramètres, et vous devez indiquez la formule dans la colonne Valeur.
Filtre
Type ancre (champ TYPANCLNK) | ||||||||||||
Un lien est associé à un élément de l'interface, c'est-à-dire à une propriété, une ligne de collection, une collection, une page ou une fiche/un enregistrement. Propriété
Ligne de collection
Collection
Page
Fiche/Enregistrement
|
||||||||||||
Affichage des liens générés (champ OPTSTDLNK) | ||||||||||||
Cochez Affichage des liens générés ou Uniquement les liens invalides pour sélectionner uniquement les liens correspondants. Les liens générés viennent du type de données. Vous pouvez désactiver des liens qui ne devraient pas être présents ou les remplacer par d'autres liens, par exemple si vous souhaitez remplacer des liens par défaut par d'autres liens (tels qu'une sélection ou un zoom). Quand un patch modifie la structure d'une représentation, en supprimant certaines de ses propriétés par exemple, certains liens peuvent ne plus fonctionner. Afin de maintenir la représentation en état de fonctionnement, les liens sont alors marqués comme non valides : dans ce cas, validez à nouveau les liens invalides. |
||||||||||||
Uniquement les liens invalides (champ OPTINVLNK) | ||||||||||||
Ancre (champ CODANCLNK) | ||||||||||||
Saisissez le nom de l'ancre selon le type de lien.
|
Tableau Liens
Ancre (champ WANCLNK) |
Code (champ WCODLNK) |
Code du lien. Pour une ancre donnée, il ne peut y avoir qu'un seul lien avec un nom donné. Il existe des codes dédiés pour les liens standards. Par exemple :
|
Généré (champ WFLGSTDLNK) |
Cette case est cochée par défaut lorsque le lien est hérité d'un type de données. Vous ne pouvez pas modifier les caractéristiques d'un lien, mais vous pouvez le désactiver ou le remplacer par un autre lien. |
Lien actif (champ WENALNK) |
Choisissez Oui pour activer le lien ou Non pour le désactiver. |
Invalide (champ WINVLNK) |
Cette case est cochée par défaut quand le lien ne peut pas être utilisé en raison de l'absence de certains paramètres sur la facette correspondante, suite à un patch de maintenance par exemple. Une tentative de validation engendre une trace détaillant les erreurs. Cochez la case Uniquement les liens invalides pour afficher uniquement le lien concerné par l' erreur. L'erreur doit être résolue pour rétablir le lien, sinon le lien ne sera pas disponible. |
Libellé (champ WINTITLNK) |
Saisissez le libellé du lien. Ce libellé peut être traduit. |
Type (champ WTYPLNK) |
Indiquez ce qui est déclenché lorsque vous cliquez sur un lien : une représentation, un méthode, une opération, une page Sage X3 classique ou un URL. Représentation
Méthode
Opération
Sage X3 Classic
URL
|
Représentation (champ WREPLNK) |
Sélectionnez la représentation si le type de lien est Représentation. |
Action (champ WCMPLNK) |
Sélectionnez l'action si le type de lien est Représentation. |
Cible (champ WTARLNK) |
Chemin de l'instance (champ WCLAPTRLNK) |
Sélectionnez l'instance si le type de lien est Méthode ou Opération. |
Code classe (champ WCLALNK) |
Méthode / Opération (champ WMETLNK) |
Sélectionnez le nom de la méthode ou de l'opération si le type de lien est Méthode ou Opération. |
Asynchrone (champ WFLGASYLNK) |
Fonction (champ WCODFNCLNK) |
Sélectionnez la fonction si le type de lien est Sage X3 Classic. |
URL (champ WFREELNK) |
Indiquez un URL si le type de lien est URL. |
Etat (champ WRPTCOD) |
Menu (champ WMENLNK) |
Pour des liens de type Page ou Fiche/Enregistrement, vous pouvez créer une arborescence de menus dans l'onglet Menu. Dans ce cas, indiquez dans ce champ Menu le menu auquel le lien est associé. Si vous n'indiquez pas de menu, l'opération est associée au menu de premier niveau. |
Ordre (champ WORDLNK) |
Saisissez dans quel ordre doit être rangé le lien dans l'arborescence des menus. |
Attribut (champ WATTLNK) |
Description de l'apparence du lien dans l'interface utilisateur. L'interaction exacte dépend du type d'appareil (mobile, tablette, ou ordinateur). Lien simple
Detail
Lookup
Summary
|
Remplacement (champ WREMSTDLNK) |
Dans cette colonne vous pouvez remplacer le lien par défaut (généré manuellement) par un lien généré automatiquement. Vous pouvez désactiver un lien généré s'il ne doit pas être présent. |
Code activité (champ WACVLNK) |
Indiquez le code du lien créé manuellement (connu comme lien non-généré) et qui doit être remplacé. |
Detail (champ WDETLNK) |
Les colonnes Detail, Query, Edit, Lookup et Summary définissent les facettes dans lesquelles les liens sont disponibles. Cochez les cases pour que le lien soit disponible. |
Query (champ WQRYLNK) |
Edit (champ WEDILNK) |
Lookup (champ WLOKLNK) |
Summary (champ WSUMLNK) |
Tableau Clés
Code (champ CODCLELNK) |
Libellé (champ INTCLELNK) |
Type (champ TYPCLELNK) |
Mode (champ MODCLELNK) |
Valeur (champ VALCLELNK) |
Formule de la valeur du segment de clé. Seul un sous-ensemble du langage de script de Sage X3 peut être utilisé pour fournir les valeurs des clés ou des paramètres, car ces valeurs doivent être évaluées par le client.
|
Tableau Paramètres
Code (champ CODPARLNK) |
Libellé (champ DESPARLNK) |
Type (champ TYPPARLNK) |
P. Filtre (champ PARFILLNK) |
P. Entrée (champ PARENTLNK) |
Mode (champ MODPARLNK) |
Saisie (champ AFFPARLNK) |
Numéro (champ MNLPARLNK) |
Longueur (champ LNGPARLNK) |
Valeur (champ VALPARLNK) |
Indiquez la formule du paramètre. Seul un sous-ensemble du langage de script de Sage X3 peut être utilisé pour fournir les valeurs des clés ou des paramètres, car ces valeurs doivent être évaluées par le client.
|
Valeur début (champ VALPARDEBL) |
Valeur fin (champ VALPARFINL) |
Lien invalide/valide |
Onglet Menus
Dans cette section, vous pouvez définir les menus qui organisent les liens.
Tableau Menu
Il affiche, pour chaque ligne, la définition du menu.
Tableau Configuration par défaut
Il permet de définir, pour chaque facette, le lien par défaut qui apparait en premier dans le panneau de droite, et son style. Les seules informations à indiquer sont le menu ou le code du lien dans la colonne Lien/Menu et un code activité dans la colonne Code activité (les autres colonnes sont alimentées automatiquement).
Tableau Menu
Code (champ CODMENU) |
Saisissez un code unique pour la représentation (sans conflit avec un code de lien). |
Libellé (champ ZLIBMENU) |
Saisissez le libellé affiché avec l'arborescence des menus. Ce libellé peut être traduit. |
Parent (champ PARMENU) |
Renseignez le code du menu parent, s'il y a un menu parent. |
Ordre (champ ORDMENU) |
Saisissez un numéro correspondant à l'ordre souhaité d'apparition de la ligne. L'affichage des lignes s'effectue selon les valeurs croissantes. |
Code activité (champ ACTMENU) |
Renseignez le code activité, pour protéger l'entrée de menu. |
Tableau Configuration par défaut
Facette (champ FACCETTE) |
Défaut (champ DEFLNKFAC) |
Lien/Menu (champ LNKMENFAC) |
Renseignez le menu ou le code du lien. |
Type ancre (champ LIBAFFLNK) |
Libellé (champ LIBLNKMEN) |
Code activité (champ ACTLNKFAC) |
Renseignez le code activité. |
Actions spécifiques
Cette action existe aussi dans le dictionnaire des classes. Cliquez sur cette action pour afficher une fenêtre composée des éléments suivants : Vue graphique de la classe ou de la représentation Ci-dessous, la liste des icônes utilisées dans la vue graphique :
1) Dans la vue graphique, les collections ou tables de référence peuvent être donnés dans les formats suivants : [0 - n] , où n est une constante : la collection a une taille variable, mais avec un maximum défini par une constante. [0 - ACT] , où ACT est un code activité: la collection a une taille variable, mais avec un maximum défini par la valeur du code activité. [Maximum - n], où n est une constante : la collection a une taille constante définie par une constante. [Maximum - ACT], où ACT est un code activité : la collection a une taille constante définie par la valeur du code activité. 2) La cardinalité d'une relation est définie par l'un de ces choix : [0 1] [0 n] [1 1] [1 n]
ChampNombre de classes
ChampProfondeur arborescence Profondeur maximale de l'arborescence. Tableau Classes
|
Cliquez sur cette action pour valider la représentation. Cette action :
Le programme généré ne doit pas être modifié. Il est recréé automatiquement à chaque validation. |
Barre de menus
Cliquez sur cette action pour effectuer une validation générale de la représentation.
|
Messages d'erreur
[<<<Outre les messages génériques, les messages d'erreur suivants peuvent apparaître lors de la saisie :
Propriété ou collection inexistanteUne propriété ou une collection qui a été utilisée dans un lien n'est plus disponible dans la représentation.
Le lien de remplacement $1$ doit être non généréUn lien généré a un lien de remplacement généré lui-même.
Le lien de remplacement $1$ doit correspondre aux type et action du lien $2$Un lien de remplacement doit être compatible avec le lien qu'il remplace (avoir la même ancre et le même type d'ancre).
Le lien de remplacement $1$ doit être actifUn lien de remplacement doit être au statut actif.
Lien "$1$" non autorisé sur facette $2$Ce message s'affiche dans plusieurs cas :
- Sur une facette Lookup ou Summary : ni les liens de la méthode, ni liens des pages classiques sont autorisés.
- Sur une facette Edit : seuls les liens sur les représentations avec une action Lookup ou Summary et les liens URL sont autorisés.
Le type n'est pas correct.
La méthode appelée n'existe pas.Le code saisi ne correspond pas à une méthode de la classe.
Informations complémentaires
Des modifications effectuées sur la représentation peuvent avoir un impact sur d'autres représentations qui ont un lien sur une facette de cette représentation. L'entrée d'une représentation dans le dictionnaire peut déclencher une mise à jour automatique des liens. Dans ce cas, un message demande à l'utilisateur de sauvegarder la représentation mise à jour. Le lien sur les représentations se fait alors automatiquement lors de l'installation d'un patch ou lors de la revalidation du dossier.
Représentations devenues obsolètes
Dans les modules Achats et Ventes, certaines représentations ne sont plus utilisées ni maintenues. De nouvelles représentations sont disponibles pour les remplacer.