Représentations

• Code représentation (champ CODREP)

• Intitulé (champ AZINTREP)

Intitulé de la représentation.

• 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.

• 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.

• 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.

• champ TYPMSKREP

• Système (champ FLGSYSTEM)

Cette case est réservée au superviseur. Elle ne doit pas être cochée pour une représentation normale.

• 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.

• Code (champ CODCOM)

Nom des comportements gérés.

• Actif (champ ENACOM)

Cochez la case Actif pour activer les comportements correspondants.

• Code (champ CODCOL)

Renseignez le code de la collection.

• Si la collection est définie au niveau de la représentation, le code est unique et contient maximum 12 caractères.
  
• Si la collection est définie au niveau de la classe ou au niveau d'une classe enfant, le chemin de la classe doit être indiqué. Par exemple, si un document a un niveau de ligne dans lequel une collection a été définie, la syntaxe est DOC.LINE.COLLECTION, où DOC et LINE sont les instances des classes imbriquées.

 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.

• Type (champ TYPTRT)

Sélectionnez un type de code.

Standard

Code fourni par le fournisseur du logiciel.

Vertical

Code fourni par le fournisseur du logiciel ou par un partenaire afin de couvrir des besoins pour le secteur d'activité donné.

Spécifique

Code fourni par un partenaire pour un client ou entré par l'équipe de développement d'un client pour couvrir leurs besoins spécifiques.

• Fichier (champ CODTRT)

Sélectionnez le nom du script. Les conventions de nommage indiquent d'utiliser cette dénomination : repr_Ryyyy, où :

• repr est le code de la classe,
• yyyy est STD pour les scripts livrés en "standard".
• yyyy est VER pour les scripts livrés en "vertical".
• yyyy est SPE pour les scripts livrés en "spécifique".

 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.

• 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)

• 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.

• 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.
Un paramètre ou une clé peuvent avoir une des valeurs suivantes :

• Le nom d’une propriété de l’instance ou de l’une de ces instances enfants. Le chemin ne contient jamais This. Par exemple : PRICE, ADDLINE.TEXT
• Les propriétés du contexte telles que  ACTX.USER
• Une propriété de l’instance en cours seulement si la propriété est dans la même collection, au même indice. Par exemple, COLLECTION.PROPERTY: le même indice est utilisé.
• Une constante (alphanumérique ou numérique). Par exemple : «VEN », « SUP », « 00123 », 3.14 ou 67800. Ceci est possible uniquement si le paramètre est transmis par valeur.
• Une propriété de la classe, lorsqu’un paramètre doit être transmis en tant que pointeur et non par valeur, à condition que ce paramètre n’ait pas de sens dans le contexte d’utilisation et qu’il ne sera pas utilisé. L’instance dédiée est AVOID.
• This est accepté uniquement si le paramètre est une instance. Il doit être seul.
• =num$(P) où P est une propriété de la classe. Cette valeur n’est possible que lorsque les conditions suivantes sont remplies :
• Le paramètre est de type alphanumérique et est déclaré par valeur.
• La propriété P est de type  TinyInt, Integer, Decimal, Clob, Char, Date, Uuident ou Datetime.
• =val(P) où P est une propriété de la classe. Cette valeur n’est possible que lorsque les conditions suivantes sont remplies :
• Le paramètre est de type TinyInt, Integer ou Decimal et est déclaré par valeur.
• La propriété P est de type  Clob, Char ou Date.

• 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

Une référence est transmise à l'appel et toute modification apportée à l'appel sur la variable change automatiquement la valeur du paramètre.

Par valeur 

Un paramètre est copié et la valeur transmise peut être modifiée pendant l'appel, sans que l'appel impacte la valeur du paramètre.

Constante

Une référence est transmise à l'appel mais le paramètre est en lecture seule. Une modification pendant l'appel génère une erreur.

• 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.

• 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.

• 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

Une référence est transmise à l'appel et toute modification apportée à l'appel sur la variable changera automatiquement la valeur du paramètre.

Par Valeur

Le paramètre est copié et la valeur transmise peut être modifiée pendant l'appel, sans que l'appel impacte la valeur du paramètre.

Constante

Une référence est transmise à l'appel mais le paramètre est en lecture seule. Une modification pendant l'appel génère une erreur.

• Dim (champ DIMPARMET)

Définit si le paramètre envoyé est un tableau et quelle est la première valeur de l'index.

No

Pas de tableau.

From 1

Tableau avec index commençant à 1.

From 0

Tableau avec index commençant à 0.

• Classe (champ CLAPARMET)

Renseignez la classe du paramètre lorsque le champ Type a pour valeur 'Instance'.

• 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.

• 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.

• 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.

• 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.

• 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)

• Code activité (champ OPTACT)

• 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)

• 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.

• 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.

• 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é.

• Un champ présent dans la représentation est saisi par son nom avec la syntaxe suivante : RUNNING_TOTAL.
• Un champ présent dans la classe principale est défini avec la syntaxe suivante : SORDER.CUSTOMER.
• Un champ présent dans une classe enfant est défini avec la syntaxe suivante : SORDER.LINE.ITEMCODE.

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.

• Code activité (champ ACTPRO)

• 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 :

• SORDER est une représentation pour les commandes de vente; elle associée à la classe SORDER; le code de l'instance est SORD.
• COUNTRY est une propriété de la classe SORDER.
• Pour la propriété SORD.COUNTRY, dont l'alias est COUNTRY_ORDER, le champ P.Filtre est coché.

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)

• Lookup (champ LOKPRO)

• Etat initial (champ STALOKPRO)

• Summary (champ SUMPRO)

• Etat initial (champ STASUMPRO)

• 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é

Le type d'ancre Propriété permet de :

• Déclencher une opération.
• Afficher plus d'informations sur la propriété.
• Guider la saisie de valeurs correctes.

L'icône  qui donne accès aux différents liens se trouve juste à côté de la valeur du champ.

Si vous choisissez ce type d'ancre, dans le champ Ancre, saisissez l'alias de la propriété.

Ligne de collection

L'icône  qui donne accès aux différents liens se trouve au début de la ligne d'un tableau. En général, le type d'ancre Ligne de collection déclenche une opération qui s'applique à l'ensemble de la ligne.

Si vous choisissez ce type d'ancre, dans le champ Ancre, saisissez le nom de la collection.

Collection

L'icône  qui donne accès aux différents liens est présent dans l'en-tête de la collection, soit juste au dessus du tableau. Ce type d'ancre Collection s'applique à l'ensemble de la collection.

Si vous choisissez ce type d'ancre, dans le champ Ancre, saisissez le nom de la collection.

Page

Les liens de type Page sont les liens du panneau de droite et ils s'appliquent à la page.

Si vous choisissez ce type d'ancre, ne saisissez pas de nom dans le champ Ancre.

Fiche/Enregistrement

Les liens de type Fiche/Enregistrement sont également présents dans le panneau de droite, mais uniquement s'il y a une fiche/un enregistrement dans la page.

Si vous choisissez ce type d'ancre, ne saisissez pas de nom dans le champ Ancre.

• 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.

• Ancre (champ WANCLNK)

• Code (champ WCODLNK)

• 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

Si vous cliquez sur ce type de lien, une autre représentation est appelée. Ce type de lien ne peut pas être appelé dans une facette Edit.

Dans la colonne Représentation, sélectionnez le code de la représentation.

Dans la colonne Action, sélectionnez l'action.

L'action ne peut être que l'une des actions prises en charge par la représentation. Si l'action se fait sur une fiche en particulier, la clé doit figurer dans le tableau Clés. C'est le cas par exemple pour Afficher détailou Afficher résumé, alors que la clé n'est pas nécessaire pour l'action Créer une fiche.

Méthode

Une méthode est déclenchée. Comme elle est liée à un contexte donné, une méthode ne peut pas être appelée sur une facette Edit.

Dans la colonne Chemin de l'instance, sélectionnez l'instance sur laquelle la méthode agit.

Dans la colonne Méthode/Opération, indiquez le nom de la méthode.

 Seules les instances disponibles sur la ligne peuvent être envisagées. Si le chemin de l'instance n'est pas renseigné, la méthode est la méthode de la représentation.

Opération

Une opération est déclenchée.

Dans la colonne Chemin de l'instance, sélectionnez l'instance.

Dans la colonne Méthode/Opération, sélectionnez le nom de l'opération.

Sage X3 Classic

Si vous cliquez sur ce type de lien, la page d'une fonction s'ouvre en mode classique (édition).

Dans la colonne Fonction, sélectionnez le nom de la fonction.

URL

Si vous cliquez sur ce type de lien, la page de l'URL s'ouvre.

Dans la colonne URL, indiquez l'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

L'hyperlien apparaît dans une liste déroulante associée à l'élément.

Detail

L'hyperlien est associé à la valeur du champ lui-même. Cliquez dans le champ pour déclencher le lien.

Lookup

L'hyperlien est associé à l'action Sélection. L'icône est une loupe située près de la valeur du champ.

Summary

L'hyperlien est associé à l'action Voir résumé. L'icône Voir résumé est située près du champ.

• Remplacement (champ WREMSTDLNK)

• 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)

• Query (champ WQRYLNK)

• Edit (champ WEDILNK)

• Lookup (champ WLOKLNK)

• Summary (champ WSUMLNK)

• 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.
Un paramètre ou une clé peuvent avoir une des valeurs suivantes :

• Le nom d’une propriété de l’instance ou de l’une de ces instances enfants. Le chemin ne contient jamais This. Par exemple : PRICE, ADDLINE.TEXT
• Les propriétés du contexte telles que  ACTX.USER
• Une propriété de l’instance en cours seulement si la propriété est dans la même collection, au même indice. Par exemple, COLLECTION.PROPERTY: le même indice est utilisé.
• Une constante (alphanumérique ou numérique). Par exemple : «VEN », « SUP », « 00123 », 3.14 ou 67800. Ceci est possible uniquement si le paramètre est transmis par valeur.
• Une propriété de la classe, lorsqu’un paramètre doit être transmis en tant que pointeur et non par valeur, à condition que ce paramètre n’ait pas de sens dans le contexte d’utilisation et qu’il ne sera pas utilisé. L’instance dédiée est AVOID.
• This est accepté uniquement si le paramètre est une instance. Il doit être seul.
• =num$(P) où P est une propriété de la classe. Cette valeur n’est possible que lorsque les conditions suivantes sont remplies :
• Le paramètre est de type alphanumérique et est déclaré par valeur.
• La propriété P est de type  TinyInt, Integer, Decimal, Clob, Char, Date, Uuident ou Datetime.
• =val(P) où P est une propriété de la classe. Cette valeur n’est possible que lorsque les conditions suivantes sont remplies :
• Le paramètre est de type TinyInt, Integer ou Decimal et est déclaré par valeur.
• La propriété P est de type  Clob, Char ou Date.

• 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.
Un paramètre ou une clé peuvent avoir une des valeurs suivantes :

• Le nom d’une propriété de l’instance ou de l’une de ces instances enfants. Le chemin ne contient jamais This. Par exemple : PRICE, ADDLINE.TEXT
• Les propriétés du contexte telles que  ACTX.USER
• Une propriété de l’instance en cours seulement si la propriété est dans la même collection, au même indice. Par exemple, COLLECTION.PROPERTY: le même indice est utilisé.
• Une constante (alphanumérique ou numérique). Par exemple : «VEN », « SUP », « 00123 », 3.14 ou 67800. Ceci est possible uniquement si le paramètre est transmis par valeur.
• Une propriété de la classe, lorsqu’un paramètre doit être transmis en tant que pointeur et non par valeur, à condition que ce paramètre n’ait pas de sens dans le contexte d’utilisation et qu’il ne sera pas utilisé. L’instance dédiée est AVOID.
• This est accepté uniquement si le paramètre est une instance. Il doit être seul.
• =num$(P) où P est une propriété de la classe. Cette valeur n’est possible que lorsque les conditions suivantes sont remplies :
• Le paramètre est de type alphanumérique et est déclaré par valeur.
• La propriété P est de type  TinyInt, Integer, Decimal, Clob, Char, Date, Uuident ou Datetime.
• =val(P) où P est une propriété de la classe. Cette valeur n’est possible que lorsque les conditions suivantes sont remplies :
• Le paramètre est de type TinyInt, Integer ou Decimal et est déclaré par valeur.
• La propriété P est de type  Clob, Char ou Date.

• Valeur début (champ VALPARDEBL)

• Valeur fin (champ VALPARFINL)

• Code (champ CODMENU)

Saisissez un code unique pour la représentation (sans conflit avec un code de lien).

• Libellé (champ ZLIBMENU)

• 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.

• 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é.