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

Champs

Les champs suivants sont présents dans cet onglet :

Bloc numéro 1

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

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)

 

 

Ecran de saisie

Présentation

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.

 

Champs

Les champs suivants sont présents dans cet onglet :

Bloc numéro 1

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.

Tableau

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.

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.

 

Onglet Divers

Présentation

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.

 

Champs

Les champs suivants sont présents dans cet onglet :

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

Les champs suivants sont présents dans la fenêtre ouverte par ce bouton :

Bloc numéro 1

  • champ OBJET

 

  • champ CLES

 

Bloc numéro 2

  • Depuis le dossier (champ DOSORG)

Indiquez le dossier à partir duquel la fiche va être copiée. Les syntaxes possibles sont décrites dans l'annexe dédiée.

  • Tous dossiers (champ TOUDOS)

Cette option permet de copier la fiche vers tous les dossiers définis dans le dictionnaire (table ADOSSIER de la solution courante).

  • Vers le dossier (champ DOSDES)

Indiquez le dossier dans lequel la fiche va être copiée. Les syntaxes possibles sont décrites dans l'annexe dédiée.

Permet de copier la fiche courante vers un autre dossier.

Génère le code lié au modèle de données :

  • s'il est associé à une structure, on valide les structures et on génère le traitementWMLxxxxxx correspondant
  • s'il est indexable, on crée la ou les requêtes SQL dont le moteur de recherche a besoin pour indexer la base.

Barre de menu

Messages d'erreur

Il n'y a pas de message d'erreur autre que les messages d'erreur génériques.

Tables mises en oeuvre

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre