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

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre

Gestion de l'écran

En-tête

Présentation

L'en-tête permet d'identifier l'action.

 

Champs

Les champs suivants sont présents dans cet onglet :

Indiquez le code action àdéfinir.

  • Intitulé (champ ZINTITA)

 

 

Onglet Général

Présentation

On y trouve les informations générales relatives à l'action.

 

Champs

Les champs suivants sont présents dans cet onglet :

Caractéristiques

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 "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)

 

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

  • Type (champ TYPUTI)

 

Paramètres

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 )

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 »

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 :

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

 

Onglet Paramètres

Présentation

On y trouve les informations relatives à l'ensemble des paramètres de l'action.

 

Champs

Les champs suivants sont présents dans cet onglet :

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.

Tableau

  • No (champ NUMLIG)

 

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).

 

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

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.

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.

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

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.

Messages d'erreur

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

Zone obligatoire

La fenêtre principale est obligatoire sur une action de type « Saisie fenêtre ».

Tables mises en oeuvre

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre