Reportez-vous à la documentation de Mise en oeuvre
Présentation
L'en-tête contient les informations qui identifient la classe.
Champs
Les champs suivants sont présents dans cet onglet :
| 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é de la représentation. |
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, Lookupet 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 :
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).
Champs
Les champs suivants sont présents dans cet onglet :
Général
| Sélectionnez le code classe. Il définit la classe associée à la représentation. Il est obligatoire. |
| Saisissez le nom de la propriété qui identifie l'instance de la classe dans la représentation. |
| 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
| 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. |
| 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
| 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. |
| Sélectionnez le module technique auquel la représentation est associée. |
Type
| Type d'écran pour lequel la représentation a été créée. |
| Cette case est réservée au superviseur. Elle ne doit pas être cochée pour une représentation normale. |
Tableau Facettes
| Liste des facettes liées ou non à la représentation. |
| 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
| Nom des comportements gérés. |
| Cochez la case Actif pour activer les comportements correspondants. |
Tableau Collections
| 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. |
| 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. |
| Saisissez le libellé de la collection. |
| Ce champ définit comment l'ensemble des propriétés est stocké en mémoire. Ce nombre peut être 0, 1 ou Maximum. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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
| Sélectionnez un type de code. Standard
Vertical
Spécifique
|
| 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. |
| Saisissez l'ordre dans lequel les étiquettes $METHODS et $PROPERTIES sont appelées dans l'évènement. |
| 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. |
Icône Actions
Présentation
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.
Champs
Les champs suivants sont présents dans cet onglet :
Tableau Propriétés
| Saisissez le nom de la propriété tel qu'il est utilisé dans le script de Sage X3. |
| Saisissez un ordre de classement de la propriété. |
| Saisissez le libellé de la propriété affiché dans l'interface utilisateur. |
| Saisissez le libellé court de la propriété. Il peut être utilisé lors de la personnalisation de l'interface utilisateur. |
| 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. |
| 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). |
| 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. |
| 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. |
| 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. |
| 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. |
|   |
| 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. |
| Lorsque ce champ a pour valeur 'Oui', la propriété est valide, mais uniquement si elle contient une valeur. |
| 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. |
| Saisissez la propriété utilisée lorsque la table de contrôle dépend d'une autre table. |
| 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. |
| 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
| Nom de la colonne de chaque segment de clé. Vous ne pouvez pas le modifier. |
| Libellé de chaque segment de clé. Vous ne pouvez pas le modifier. |
| Type de données du segment de clé. Vous ne pouvez pas le modifier. |
| 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 de chaque paramètre, affiché automatiquement. Vous ne pouvez pas le modifier. |
| Description de chaque paramètre, affichée automatiquement. Vous ne pouvez pas la modifier. |
| 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 de données de chaque segment de clé, affiché automatiquement. Vous ne pouvez pas le modifier. |
| 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. |
Présentation
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 statefulsont disponibles. Par conséquent, les opérations statelessne 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.
Champs
Les champs suivants sont présents dans cet onglet :
Tableau Méthodes
| 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). |
| Saisissez le libellé de la méthode. |
| 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. |
| 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
| Sélectionnez le nom de la variable contenant la valeur du paramètre, comme dans le code appelé par l'évènement $METHODS. |
| 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. |
| Saisissez le libellé de la variable. |
| Sélectionnez le mode qui définit comment le paramètre est transmis dans l'appel. Par Adresse
Par Valeur
Constante
|
| 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
|
| Renseignez la classe du paramètre lorsque le champ Type a pour valeur 'Instance'. |
Présentation
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 :
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 filtreest é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éfauta 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é.
Champs
Les champs suivants sont présents dans cet onglet :
Tableau Sections
| Saisissez un code unique pour une représentation, composé de 12 lettres ou chiffres maximum. |
| Saisissez le libellé, c'est-à-dire le nom de la section affiché dans la page. Ce nom est obligatoire. |
| Saisissez l'ordre d'affichage des sections par défaut. L'ordre peut être discontinu et peut comporter jusqu'à quatre chiffres. |
|   |
| 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
| Saisissez un code unique pour une représentation, composé de 12 lettres ou chiffres maximum. |
| Saisissez le libellé, c'est-à-dire le nom du bloc affiché dans la page. Ce nom est obligatoire. |
| Renseignez le code de la section dans laquelle le bloc se trouve. |
| Saisissez l'ordre d'affichage par défaut des blocs dans les sections. L'ordre peut être discontinu et peut comporter jusqu'à quatre chiffres. |
|   |
|   |
| 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
| Saisissez un code unique de filtre ou sélectionnez un filtre défini au niveau de la classe. |
| Cette case est cochée automatiquement si le filtre a été défini au niveau de la classe. |
| Ce libellé (texte de dictionnaire et donc traduisible) correspond au libellé du lien de filtre présent sur la page. |
| 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. |
| 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. |
| 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. |
| 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 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 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. |
|   |
| 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. |
Présentation
Une représentation affiche sur l'appareil (mobile, tablette, ordinateur) une liste de propriétés, qui peuvent être :
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.
Champs
Les champs suivants sont présents dans cet onglet :
Tableau Propriétés
| 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. |
| 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. |
| 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. |
| Code du bloc par défaut dans lequel se trouve la propriété dans l'interface utilisateur. |
| Saisissez l'ordre de saisie des propriétés dans les blocs. L'ordre peut être discontinu et peut comporter jusqu'à quatre chiffres. |
| 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. |
| 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. |
|   |
| 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. |
| 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. |
| 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). |
| 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é. |
| 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. |
|   |
|   |
|   |
|   |
|   |
|   |
|   |
|   |
| 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. |
|   |
|   |
|   |
Présentation
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.
Champs
Les champs suivants sont présents dans cet onglet :
Filtre
| 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
|
| 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. |
|   |
| Saisissez le nom de l'ancre selon le type de lien.
|
Tableau Liens
|   |
| 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 :
|
| 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. |
| Choisissez Oui pour activer le lien ou Non pour le désactiver. |
| 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. |
| Saisissez le libellé du lien. Ce libellé peut être traduit. |
| 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
|
| Sélectionnez la représentation si le type de lien est Représentation. |
| Sélectionnez l'action si le type de lien est Représentation. |
|   |
| Sélectionnez l'instance si le type de lien est Méthode ou Opération. |
|   |
| Sélectionnez le nom de la méthode ou de l'opération si le type de lien est Méthode ou Opération. |
|   |
| Sélectionnez la fonction si le type de lien est Sage X3 Classic. |
| Indiquez un URL si le type de lien est URL. |
|   |
| 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. |
| Saisissez dans quel ordre doit être rangé le lien dans l'arborescence des menus. |
| 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
|
| 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. |
| Indiquez le code du lien créé manuellement (connu comme lien non-généré) et qui doit être remplacé. |
| 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. |
|   |
|   |
|   |
|   |
Tableau Clés
|   |
|   |
|   |
|   |
| 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
|   |
|   |
|   |
|   |
|   |
|   |
|   |
|   |
|   |
| 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.
|
|   |
|   |
Icône Actions
Présentation
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).
Champs
Les champs suivants sont présents dans cet onglet :
Tableau Menu
| Saisissez un code unique pour la représentation (sans conflit avec un code de lien). |
| Saisissez le libellé affiché avec l'arborescence des menus. Ce libellé peut être traduit. |
| Renseignez le code du menu parent, s'il y a un menu parent. |
| Saisissez un numéro correspondant à l'ordre souhaité d'apparition de la ligne. L'affichage des lignes s'effectue selon les valeurs croissantes. |
| Renseignez le code activité, pour protéger l'entrée de menu. |
Tableau Configuration par défaut
|   |
|   |
| Renseignez le menu ou le code du lien. |
|   |
|   |
| Renseignez le code activité. |
Seules les actions des liens autres que les opérations CRUD habituelles et autres que les actions des liens automatiques (PDF, intégration Office, etc.) sont décrites.
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. |
Cliquez sur cette action pour effectuer une validation générale de la représentation.
Outre les messages génériques, les messages d'erreur suivants peuvent apparaître lors de la saisie :
Une propriété ou une collection qui a été utilisée dans un lien n'est plus disponible dans la représentation.
Un lien généré a un lien de remplacement généré lui-même.
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).
Un lien de remplacement doit être au statut actif.
Ce message s'affiche dans plusieurs cas :
Le type n'est pas correct.
Le code saisi ne correspond pas à une méthode de la classe.
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.
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.