Les codes activités offrent les possibilités suivantes :

  • permettre de rendre actifs ou inactifs des éléments du dictionnaire ( exemple : tables, index, onglets, blocs ou champs d'écran …). Par exemple, le fait de rendre actif ou non un code activité donné permet donc de désactiver, dans les écrans, certains champs optionnels.
  • affecter un dimensionnement aux zones de tables.
  • rendre paramétrable le dimensionnement des champs, des blocs d'écran
  • identifier les éléments développés pour les localisations standard : ces éléments sont identifiés par un code activité commençant par K.
  • identifier les éléments développés en spécifique et en vertical. Dès lors que le code activité commence par X, Y, ou Z, l'élément est considéré comme non standard et n'est donc pas affecté par un patch standard. Pour être plus précis, une norme a été établie à partir de la version 5 des progiciels X3 :
    • Les codes commençant par X sont réservés aux développements verticaux
    • Les codes commençant par Y ou Z sont réservés aux développements spécifiques.

La valeur des codes activité est définie en gestion de dossier. Seuls les codes qui ne sont pas dépendants d'un autre code sont saisis; les autres en sont déduits. Pour plus de détail, et en particulier pour consulter la règle de nommage des codes voir l'aide sur le champ "dépendance".

Mode d'emploi pour modifier la valeur d'un code activité.

La méthode :

Se placer, dans le dossier mère,

  • Modifier le code activité, sur la fiche du dossier fille à traiter, par la fonction GESADS.
    ( NE SURTOUT PAS modifier directement la fiche code activité dans le dossier à traiter. En effet, la validation s'appuyant sur la différence code activité (entre fiche code activité et fiche dossier), n'aurait rien à traiter.)
  • Lancer la validation du dossier à traiter. La validation entraînera une suppression ou création des éléments soumis au code activité.

Solution d'exception pour développeurs initiés :

Pour des développeurs avertis qui ne désirent pas passer par la gestion des dossiers (validation de dossiers trop longue, ou impossible à réaliser sur des dossiers qui sont toujours utilisés).

Pour des codes activité de dimensionnement uniquement. Interdit pour des codes activité actif/inactif. En effet, la suppression ou la création d'élément en fonction de l'activation ou non d'un code activité est complètement gérée dans la validation dossier, mais ne l'est pas dans la validation de chaque dictionnaire.

Se placer dans le dossier à traiter,

  • Modifier le code activité, directement sur la fiche code activité.
  • Valider uniquement les éléments soumis au code activité par la fonction de validation dictionnaire située dans : "Développement \ Utilitaires \ Dictionnaire \ Validation"

Pré-requis

Habilitations

Cette fonction est de type objet. Les opérations de création, modification, et suppression de fiche peuvent être activées ou désactivées pour un utilisateur donné. Des filtres par rôles peuvent également être mis en place sur cette fonction.

Gestion de l'écran

Ce paramétrage se fait sur un seul onglet.

Ecran de saisie

Présentation

On y décrit les caractéristiques détaillées du code activité.

Fermer

 

Champs

Les champs suivants sont présents dans cet onglet :

Bloc numéro 1

Le code activité identifie une option qui peut être de type oui/non, ou qui définit un nombre d'occurrences.

Cette option, qui doit être renseignée à la création d'un dossier, permet d'influer sur la structure des écrans du progiciel et aussi éventuellement sur la structure de la base de données.

  • Intitulé (champ ZLIBACT)

Cet intitulé permet d'expliquer à quoi sert le code activité.

Bloc numéro 2

  • Actif (champ FLACT)

Pour le développement, ce champ positionné à Oui active les tables, les écrans, ou les champs dans les tables et les écrans qui dépendent du code activité. Inversement, si ce champ est à Non, les écrans et les tables, ou les champs qui en dépendent ne sont pas accessibles et n'apparaissent pas.

Attention, en exploitation, pour tout changement de positionnement de code activité, il est nécessaire de :

  • faire la modification du code activité, dans la fiche dossier, à partir du dossier mère
  • puis de déclencher une validation du dossier fille.
  • Module (champ MODULE)

Module d'appartenance du paramétrage.
  • Rang (champ RANG)

Ce champ permet d'indiquer l'ordre dans lequel vont s'afficher les codes activités dans la gestion des dossiers. Les codes activités dépendant d'une formule sont calculés dans l'ordre croissant de ce numéro.
  • Type (champ TYP)

Ce champ permet de classer les codes activités dans les onglets de la gestion des dossiers.
  • Dimension mini (champ DIMFIL)

Certains champs dans des tables peuvent voir varier leur nombre d'occurrences en fonction d'un code activité. Souvent le nombre d'occurrences est le même pour un champ donné entre la table et l'écran, mais il arrive parfois que l'on désire simplement cacher les champs dans les écrans en gardant les occurrences dans la table.

Dans ce cas, il est possible de donner une valeur différente à cette colonne par rapport à la précédente. Cette dimension correspond généralement à la dimension générée dans les états Crytal Reports.

  • Dimension maxi (champ DIMMAX)

Cette valeur correspond à la dimension maximum des variables gérées dans les traitements.

  • Dimension écran (champ DIME)

Définit le nombre d'occurrences utilisées dans les écrans, et également dans les tables concernées, sachant que pour une table, un nombre minimum (et un nombre maximum) peuvent exister, ce qui conduira alors à utiliser, pour dimensionner les tables, la formule :

min(max(MINI,ECRAN),MAXI).

  • Dépendance (champ DEP)

Dès lors que sa valeur est différente de Non, ce champ permet d'indiquer que la valeur d'un code activité n'est pas saisi, mais automatiquement déterminé en fonction de la valeur d'autres codes activité. Les valeurs possibles sont les suivantes :

  • Inverse : Le code activité prend la valeur inverse du code activité saisi en regard; il sera actif si le code activité correspondant est inactif, et inactif s'il est actif.
  • Dimensionnement : le code activité est alors composé d'une racine, suivi d'un nombre M (de 1 à 9), et il est associé à un code activité qui peut prendre des valeurs numériques de 1 à N. Le code activité est actif si la valeur du code associé est supérieure ou égale à M; sinon, il est inactif.

On peut prendre l'exemple du code ANA, associés par des liens de dimensionnement aux codes AX1 à AX9. Si ANA vaut 5, les codes AX1 à AX5 seront actifs, les codes AX6 ç AX9 seront inactifs.

  • Formule : permet de calculer la valeur d'un code activité en fonction d'une formule saisie. Cette expression calculée peut intégrer des constantes, des fonctions, et des variables sous la forme d'autres codes activité. Ces codes activité peuvent être des codes saisis, ou des codes calculés antérieurement (l'ordre de calcul des codes actités dépendant de codes antérieurs est défini par le rang). Un code activité non porteur d'une dimension vaut 1 s'il est actif, et 0 s'il est inactif.

Par exemple, si la formule donnée pour le code XXX est max(XAA,XAB), XXX sera actif si l'un des deux odes activité XAA ou XAB est actif. Si ces codes portent une dimension, la dimension obtenue sera le maximum des deux dimensions.

 
  • Formule (champ ACTFOR)

Lorsque le code activité dépend d'une formule, on définit ici la formule à évaluer pour obtenir la valeur du code activité. Cette formule peut être :

  • une formule logique (si elle est vraie, le code activité sera actif, sinon il sera inactif).
  • une formule numérique renvoyant une valeur entière positive (pour les codes activité porteurs d'une dimension).

Fermer

 

Etats

Par défaut, les états suivants sont associés à la fonction :

  LISACT : Liste des codes activités

Mais ceci peut être modifié par paramétrage.

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)

Ce champ permet de définir 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)

Ce champ permet de définir le dossier dans lequel la fiche va être copiée. Les syntaxes possibles sont décrites dans l'annexe dédiée.

Fermer

Ce bouton permet de recopier la définition de la fiche depuis ou vers un autre dossier.

Barre de menu

Documentation / Paragraphes

Cette fonction permet d'accéder à la gestion de la documentation, sur le premier paragraphe de la documentation (si elle existe) associé à la fiche courante.

Documentation / Liens

Cette fonction permet d'accéder à la gestion des liens. Elle permet de définir des liens entre la fiche courante et d'autres fiches (par exemple des liens entre fonctions et paramètres). Ces liens, purement documentaires, permettent d'alimenter la mécanique de génération des squelettes de documentation.

Documentation / Génération

Présentation

Ce menu permet de lancer une génération de documentation. La génération peut se lancer également à partir du bouton [Génération] dans le bas de la fenêtre.

Trois types de génération peuvent être lancées, séparément ou simultanément :

  • la génération du squelette de documentation à partir du dictionnaire (tables ADOCUMENT, ADOCBLB, ADOCCLB).
  • la génération de la documentation à partir des tables précédentes.
  • la génération de la documentation sur champ.

Les bornes proposées par défaut tiennent compte de la fiche en cours, mais elles peuvent être modifiées au lancement.

Fermer

 

Champs

Les champs suivants sont présents dans cet onglet :

Sélections

  • Toutes langues existantes (champ ALLLAN)

Si cette case est cochée, toutes les langues sont prises en compte pour l'opération.

Si la case n'est pas cochée, on prendra, selon les cas :

  • la langue par défaut de l'utilisateur, si aucun code langue n'est saisi.
  • la langue saisie par ailleurs sinon.

Permet de définir la langue de génération (quand la case permettant de générer dans toutes les langues n'est pas cochée).
  • Tous types (champ ALLTYP)

Si cette case est cochée, tous les types de documentation sont pris en compte pour la génération. Il est à noter que, dans ce cas, on limite la génération aux documentations standard (seules les documentations de code inférieur à X sont prises en compte).

Permet de définir le type de documentation à prendre en compte dans le traitement (quand on n'a pas coché la case pour les prendre tous en compte).
  • Codes documentations (champ FUNDEB)

Permet de donner une borne sur les codes à prendre en compte pour la génération de documentation.
  • champ FUNFIN

 

Génération ADOCUMENT

  • Génération ADOCUMENT (champ GENDOC)

Ce radio-bouton permet créer/mettre à jour le squelette de la documentation (hiérarchie des paragraphes) à partir des éléments techniques trouvés dans le dictionnaire des données. On peut choisir de reprendre uniquement les documentations existantes ou créer de nouvelles documentations si besoin.

Les liens de documentation sont également pris en compte. Les paragraphes susceptibles d'être créés sont définis dans l'annexe technique correspondante.

Génération document final

  • champ GENFIN

Ce radio-bouton permet de générer la documentation finale à partir du contenu des paragraphes de documentation. Cette documentation est créée dans différents sous-répertoires du répertoire défini par le paramètre utilisateur DIRDOC.

Il faut utiliser la génération "Selon code activité" pour obtenir la génération des documentations des fonctions ayant des codes activités >= "X"
La génération "Complète" ne traite que les codes activités standards.
  • Uniquement les documentations validées (champ HLPVLD)

Permet de générer le document final uniquement pour les documentations validées.
  • Aides sur champs liées aux documentations (champ HLPLNKFLD)

Si cette case est cochée, on traite spécifiquement les aides sur champs relatives aux documentations sur fonction ou objet traitées par ailleurs. Pour savoir quelles sont les aides sur champ à traiter, on explore les écrans associés aux paragraphes de documentation correspondants.
  • Autres aides sur champs (champ HLPFLD)

Si cette case est cochée, on crée la documentation finale à partir du contenu des paragraphes de documentation. Cette documentation est créée dans le sous-répertoire FLD du répertoire défini par le paramètre utilisateur DIRDOC.
  • Codes aides sur champs (champ HLPDEB)

Permet de donner une borne sur les codes à prendre en compte pour la génération de documentation.
  • champ HLPFIN

 
  • Répertoire de génération (champ REPERT)

 

Fermer

 

Messages d'erreur

Outre les messages génériques, les messages d'erreur suivants peuvent apparaître lors de la saisie :

Code activité dépendant de xxx

On a déclaré que le code activité est en dépendance par rapport à un autre code activité qui lui-même est dépendant.

Erreur en évaluation de la formule

La formule saisie ne respecte pas la norme Adonix.

Tables mises en oeuvre

Les tables suivantes sont mises en oeuvre par la fonction :

Table

Intitulé Table

ACTIV [ACV]

Codes activité

ATEXTE [ATX]

Messages du dictionnaire