Dictionnaire des actions
Cette fonction permet de définir des actions utilisables dans les écrans, dans les types de données pour les actions sur champs, dans les fenêtres pour les boutons bas d'écran ou les menus, et dans les fonctions.
Une action déclenche généralement un traitement superviseur appelé « modèle » sur lequel on peut greffer un traitement fonctionnel.
Un certains nombres d'actions peuvent être chaînées ( jusqu'à 5 maximum).
Pré-requis
Reportez-vous à la documentation de Mise en oeuvre
Gestion de l'écran
En-tête
L'en-tête permet d'identifier l'action.
Code action (champ ACTION) |
Indiquez le code action à
définir. |
Intitulé (champ ZINTITA) |
Onglet Général
On y trouve les informations générales relatives à l'action.
Caractéristiques
Code activité (champ CODACT) |
La validation du dossier Adonix
ne mettra pas à jour les actions dont le code activité commence par
X Y ou Z. |
Module (champ MODULE) |
Indiquer le module par lequel est utilisé cette
action. 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 Hors modèle ( appel d'un sous-programme fonctionnel par Call ) Le "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. |
Bloc numéro 2
Intitulé bouton (champ ZINTITC) |
Code consultation (champ PARAM1) |
Identifiant de la consultation à renseigner sur une action de modèle « Consultation ». |
Type (champ TYPUTI) |
Paramètres
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 |
Fenêtre critères (champ PARAM4) |
A renseigner si la saisie initiale est : |
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é. |
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 :
|
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. |
Accessibilité
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. |
Descriptif
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 :
|
Onglet Paramètres
On y trouve les informations relatives à l'ensemble des paramètres de l'action.
Bloc numéro 1
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 :
|
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). |
Etats
Par défaut, les états suivants sont associés à la fonction :
ACTION : Dictionnaire des actions
Mais ceci peut être modifié par paramétrage.
Boutons spécifiques
Copie
Ce bouton permet de recopier la définition de l'action vers un autre dossier. Attention, les traitements associés ne sont pas copiés. Bloc numéro 1
Bloc numéro 2
|