Dictionnaire des actions

• Code action (champ ACTION)

Indiquez le code action àdéfinir.

• Intitulé (champ ZINTITA)

Destiné à figurer sur les états et les écrans dans lesquels le code de la fiche peut être saisi ou sélectionné. Ce texte permet de donner une description de la fiche concernée.

• Code activité (champ CODACT)

La validation du dossier Adonixne mettra pas à jour les actions dont le code activité commence parX Y ou Z.

• Module (champ MODULE)

Indiquer le module par lequel est utilisé cetteaction. Si cette action est utilisée par plusieurs modules,indiquer "superviseur".

• Modèle (champ TYP)

Ce champ est capital puisqu' on en déduit le traitement à lancer, à l'exécution de cette action. Voir le détail développement. A ce niveau, les valeurs possibles sont les suivantes :

  Gestion d'objet
  Consultation
  Traitement standard ( peut être lancé en batch )
  Saisie fenêtre
  Sélection dans liste ( fenêtre de sélection )
  Sélection dans table ( fenêtre de sélection )
  Affichage divers ( appel d'un sous-programme fonctionnel par Gosub )

  Hors modèle ( appel d'un sous-programme fonctionnel par Call )

Le type  "Hors modèle" permet de lancer directement un traitement fonctionnel sans passer par un modèle; ce type d'action ne pourra pas être appelé depuis une fonction.

• Intitulé bouton (champ ZINTITC)

L'intitulé s'affiche dans le menu contextuel du champ sur lequel est placée cette action.

• Code consultation (champ PARAM1)

Identifiant de la consultation à renseigner sur une action de modèle « Consultation ».

• Type (champ TYPUTI)

• Fenêtre principale (champ PARAM2)

Ce champ sert à identifier la fenêtre principale de saisie pour les modèles "saisie fenêtre" ou "traitement standard".

• Saisie initiale (champ PARAM3)

A renseigner sur un modèle « Traitement standard ». Y a-t-il une saisie initiale ? et de quel type ? Les valeurs possibles sont les suivantes :

 Pas de saisie initiale

  Confirmation Oui / Non ( message permettant la confirmation de l'exécution de cette action )
  Boite de dialogue ( saisie fenêtre restreinte : boutons limités à « OK », et « FIN», pas de menus, un seul écran).
  Saisie fenêtre ( saisie fenêtre par le modèle « Saisie fenêtre »).
  Sélection de liste ( fenêtre de sélection )
  Sélection de table ( fenêtre de sélection )

• Fenêtre critères (champ PARAM4)

A renseigner si la saisie initiale est :
  Boite de dialogue
  Saisie fenêtre

• Script standard (champ CODTRT)

Traitement standard dans lequel le déveleloppement écrit les compléments du modèle superviseur ou le sous-programme. Voir le détail développement.

• Sous-programmes (champ SUBPRG)

Ce champ est saisissable sur une action de type « Traitement divers ». Il n'y a pas de traitement superviseur associé à cette action, mais seulement ce sous-programme. Il est défini soit dans le traitement standard, soit dans le traitement spécifique.

Un seul sous-programme est exécuté : Celui du spécifique si le traitement existe, sinon celui du standard. L'ajout de spécifique sur une action standard de type « Traitement divers » vient donc en annule et remplace.

• Script spécifique (champ SPETRT)

Traitement spécifique dans lequel le spécifique écrit les compléments du modèle superviseur ou le sous-programme. La mise à jour du traitement spécifique ne nécessite pas de protection par code activité.  

Voir le détail développement.

• Expression (champ INSTRU)

Ce champ est saisissable sur une action de type « Hors modèle ». Elle peut venir en ajout du sous-programme. Dans ce cas, elle s'exécutera suite au sous-programme.

• Identifiant action (champ PARAM5)

Cela permet d'identifier une ou plusieurs actions depuis un traitement, par les variables suivantes :

• TABLE pour une action de type « Sélection table »
• LISTE pour une action de type « Sélection liste »
• TRAIT pour une action de type « Affichage divers »

• Action suite (champ ACTSUI)

Ce champ permet de préciser une autre action du dictionnaire. On a ainsi la possibilité d'enchaîner jusqu'à 5 actions. Dans ce cas, la valeurs des paramètres de toutes ces actions sont à saisir au lancement. Les actions ainsi enchaînées peuvent être de modèle différent.

Si l'action principale est placée sur un champ, on a la possibilité de ne pas exécuter les actions enchaînées en positionnant la variable mkstat.

Si l'action principale est placée sur un bouton bas d'écran ou un menu, on a la possibilité de ne pas exécuter l'action ou les actions enchaînées en positionnant la variable OK = 0 dans l'action AVANT_SUITE.

• Workflow (champ AMSFLG)

Flag permettant d'autoriser ou pas cette action en workflow. Cette autorisation n'est permise que sur une action de type "Traitement divers". Ce flag est notamment contrôlé en création d'une règle de workflow.

• Batch (champ ABTFLG)

Flag permettant d'autoriser ou pas cette action en batch. Cette autorisation n'est permise que sur une action de type « Traitement standard ». Ce flag est notamment contrôlé en création d'une tâche batch.

• Public (champ PUBFLG)

Ce flag indique que cet élément est publié. Il est donc ré-utilisable par le spécifique. Une documentation associée est livrée.

• Batch obligatoire en WEB (champ NOWEB)

Si ce flag est positionné, cette action ne pourra pas s'exécuter en interactif, qu'en mode client/serveur et effectivement pas sur les versions web (web natif, web services). Cela permet d'éviter de lourd traitement en interactif en version web.

• champ TEXTE

Texte alimentant le paragraphe PRE "présentation", de l'aide sur fiche. Dans la gestion de la documentation, on identifie la fiche d'aide par :

• type documentation = ACT
• code documentation = nom de l'action

• Zone courante (champ TYPACT)

Lorsque cette zone est cochée, le premier paramètre est considéré comme étant la zone courante. Si cette action est placée sur un champ, le premier paramètre est renseigné automatiquement par la valeur du champ courant ; Il n'apparaît donc pas, dans la liste des paramètres à renseigner sur le champ, dans le dictionnaire des écrans.

• Action avant/après zone (champ PARAM6)

Possibilité d'ajouter du traitement avant et / ou après un modèle Objet, Consultation, Traitement standard, Saisie fenêtre, lorsque cette action est placée sur le menu contextuel d'un champ. Ceci permet de préparer un contexte (par exemple affecter la variable GCONSULT) avant d'exécuter l'action et/ou déclencher par exemple un affichage après l'action.

Le code de l'action 'avant' est le nom de l'étiquette précédé de A. Le code de l'action 'après' est le nom de l'étiquette précédé de B.

Exemple : si l'action est imputée au bouton 2 du champ CHP, les étiquettes avant et après seront AB2_CHP et BB2_CHP. Elles doivent être programmées dans l'étiquette $ACTION du traitement standard ou spécifique.

• No (champ NUMLIG)

• Code (champ CODPAR)

codes paramètres de l'action.

L'ordre dans lequel les codes paramètres doivent être saisis dans le présent tableau est très important : il doit correspondre à l'ordre dans lequel les paramètres ont été saisis dans le sous-programme qui permet l'exécution de l'action.

Chaque paramètre doit avoir été déclaré, dans le dictionnaire des paramètres. Avant de créer un code paramètre, vérifiez qu'il n'existe pas déjà sous un autre code afin d'éviter les redondances. La touche de sélection vous permet d'en obtenir la liste.

• Type paramètre (champ TYPPAR)

Indique la nature du paramètre : char, integer, decimal etc. Cette information n'est saisissable qu'en création du paramètre, dans le dictionnaire des paramètres.

Attention ! On ne peut utiliser un paramètre de type clob/blob, dans une action, que dans les deux cas suivants :

• Sur une action de type "Traitement divers", sur tous les paramètres,
• Sur toute autre action, et seulement si la case "Zone courante" est cochée, sur le premier paramètre.

• Type d'argument (champ ADRVAL)

Il indique comment est passé le paramètre.

          par adresse ( une variable est nécessaire pour passer le paramètre. En sortie du sous-programme, la valeur du paramètre éventuellement modifiée est retournée au traitement appelant ).

          par valeur ( le paramètre est passé par une variable ou par constante. En sortie du sous-programme, la valeur du paramètre même si elle est modifiée n'est pas retournée au traitement appelant).