Cette fonction permet de définir un groupe de tables liées (soit directement, soit en cascade), par des liens de type (1,1) ou (1,N) à une table principale supposée être en ligne.

Un tel modèle de données peut ensuite être utilisé :

  • dans une règle de Workflow, soit parce que c'est le seul contexte disponible pour décrire les tables à parcourir (cas d'une règle de type Manuel, où le modèle est obligatoire), soit pour enrichir le contexte de déclenchement (cas des autres types).
  • dans une règle d'affectation, où le modèle est obligatoire. Il définit alors le groupe de tables dans lequel se trouvent les champs sur lesquels est basée la règle d'affectation des utilisateurs. Le modèle de données associé à une règle de Workflow et celui associé à la règle d'affectation sont obligatoirement identiques.
  • dans un état ZPL, afin de décrire la logique d'extraction des données pour imprimer des étiquettes.
  • dans un modèle de paramétrage, afin de décrire les données de paramétrage à extraire ou à copier.
  • dans la description de données à indexer par un moteur de recherche.

Il est à noter que cette fonction est considérée comme faisant partie de développement, même si elle sert de support par ailleurs à un ensemble de paramétrage. Toute fiche créée par cette fonction doit donc être protégée par un code activité.

Pré-requis

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre

Gestion de l'écran

En-tête

Bloc numéro 1

Code modèle (champ MODELE)

Code identifiant la fiche courante.

Intitulé (champ ZINTIT)
Actif (champ ENAFLG)

Sélectionnez cette case à cocher pour activer la fiche courante.

Les enregistrements non sélectionnés conservent leur contenu et paramétrage, mais ne pourront pas être utilisés en rappelant leur code dans :

  • les autres enregistrements, comme les documents et paramètres,
  • les traitements en masse.

Les habilitations sur une fonction donnée peuvent interdire la création d'une fiche active. Dans ce cas, la case est désactivée par défaut. Elle est modifiable uniquement par un utilisateur autorisé, ou via un Workflow de signature.

Caractéristiques

Code activité (champ CODACT)

Un code activité vous permet de :

  • rendre optionnel un élément du dictionnaire si la valeur associée au code activité est nulle,
  • signer les éléments spécifiques dès lors qu'ils sont marqués par un code commençant par X, Y ou Z,
  • dimensionner un nombre de lignes maximum lorsque le code activité marque des éléments d'un tableau,

Si le code activité est désactivé :

  • l'élément marqué n'est pas utilisable,
  • le code associé n'est pas généré ou activé.
Module (champ MODULE)

Sélectionnez un module pour le paramétrage.

Ce champ vous permet de renseigner si l'écran doit être créé dans la base de données du dossier. Il l'est si le module auquel l'écran est rattaché est actif pour le dossier.

Propriétés

Modèle de paramétrage (champ FLGAPH)

Indique que le modèle de données est associé à modèle de paramétrage.

Workflow (champ FLGWRK)

Indique que le modèle de données est associé à un workflow.

Définition livrable (champ FLGADLV)
Node (API) (champ FLGNODE)

Ecran de saisie

On trouve dans l'écran de définition, l'ensemble de l'arborescence des tables à parcourir, toutes liées directement ou indirectement à une table principale. Les lignes du tableau définissent les jointures successives à réaliser pour disposer de tout le contexte en ligne.

A noter que des conditions peuvent être ajoutées pour filtrer les lignes liées. Il est important de noter que ces conditions ne sont pas prises en compte pour l'indexation. Les conditions liées aux données à indexer doivent en effet être définies dans l'onglet correspondant.

Bloc numéro 1

Table principale (champ TABREF)

Identifie la table principale à partir de laquelle on lit d'autres tables par des liens directs ou en cascade. Cette table est supposée être en ligne si le modèle est utilisé dans une règle Workflow de type différent de Manuel. Dans le cas d'un Workflow de type Manuel, elle fait partie de la jointure qui est ouverte et parcourue à l'exécution du Workflow.
Nom de node (champ ANODNAM)
Nom de package (API) (champ APACKNAM)
Modèle de données ref. (API) (champ FLGREFAWM)

Tableau

Table liée (champ TABLNK)

Table dans laquelle la classe référencée est persistée.
Abrev (champ ABRLNK)

Correspond à l'abréviation sous laquelle la table liée est ouverte.

Si ce champ n'est pas saisi, l'abrévation est l'abréviation par défaut de la table. Il peut être utile de saisir une abréviation pour ne pas rentrer en conflit avec le contexte appelant.
Table origine (champ TABORI)

Identifie la table principale à l'origine du lien décrit dans la ligne courante. Ce peut être la table principale, ou une des tables liées des lignes précédentes.
Abrev (champ ABRORI)

Correspond à l'abréviation sous laquelle la table liée est ouverte.

Si ce champ n'est pas saisi, l'abrévation est l'abréviation par défaut de la table. Il peut être utile de saisir une abréviation pour ne pas rentrer en conflit avec le contexte appelant.
Clé (champ CLELNK)

Définit le code de la clé de la table utilisée pour réaliser la lecture des lignes liées. Par défaut, la première clé de la table est utilisée.

Une fois ce champ alimenté, le tableau suivant Mapping clés - propriétés est alimenté suivant le code des différents segments de clé.
Type (champ TYPLNK)

Pour chaque ligne, il peut y avoir de 0 à N lignes (dans le cas 1,1 ou 1,N, il existe au moins une ligne).
Expression de lien (champ EXPLNK)

Ce champ est défini comme une ou plusieurs expressions calculées et séparées par un point-virgule. Chaque expression est évaluée, et le résultat permet de connaître la valeur de la clé utilisée pour réaliser la jointure. Lorsque les jointures multiples sont autorisées, vous ne pouvez donner que les premiers segments de clé.

Dans les expressions, vous pouvez utiliser des constantes, et des champs issus des tables précédemment définies dans la liste des liens.
Expression de sélection (champ EXPSEL)

Cette formule de sélection s'applique sur la table définie dans la colonne Table liée, et permet de filtrer les données dans le modèle. Attention, ces conditions ne s'appliquent pas pour le processus d'indexation. La syntaxe est la syntaxe de script de Sage X3 utilisée dans les instructions Filter.
Nom de node (champ ANODLNK)
Nom de propriété (API) (champ APROPLNK)
Nom de package (API) (champ APACKLNK)
Référence ou collection mutable (champ AISMUTABLE)

Onglet Divers

Cet onglet permet de définir des caractéristiques particulières du modèle de données, en fonction de l'utilisation qui en est faite.

Workflow

Champ société (champ FLDCPY)

Ce champ définit la société courante, du point de vue de la règle de Workflow. Ainsi, lorsque la règle d'affectation est déclinée par société, on prend la bonne règle en fonction de la valeur du champ.
Champ site (champ FLDFCY)

Ce champ définit un site courant, ce qui permet d'en déduire la société courante (si elle n'est pas définie par le champ société), du point de vue de la règle de Workflow. Ainsi, lorsque la règle d'affectation est déclinée par société, la bonne règle est choisie en fonction de la valeur du champ.

Modèle de paramétrage

Champ législation (champ FLDLEG)

Ce champ permet de filtrer les enregistrements concernant une législation pendant la création d'un patch ou l'intégration d'un patch réalisé par la fonction ACOPAPH (modèles de patch).

Tableau Options

Intitulé option (champ AZOPTLIB)
Code option (champ OPTCOD)
Condition option (champ OPTCND)
Message erreur (champ AZOPTERR)

Boutons spécifiques