Actions
This function is used to define the actions that can be used in the screens, in the data types for the actions on the fields, in the windows for the buttons at the bottom of the screen or the menus and in the functions.
An action generally triggers a supervisor process called "Model" to which it is possible to attach a functional process.
A certain number of actions can be linked together (up to a maximum of 5).
Prerequisite
Refer to documentation Implementation
Screen management
Header
The header is used to identify the action.
Action code (field ACTION) |
Specify the action code to be defined. |
Description (field ZINTITA) |
Tab General
The general information relative to the action is found in this tab.
Characteristics
Activity code (field CODACT) |
The validation of the ADONIX folder does not update the actions where the activity code begins with X Y or Z. |
Module (field MODULE) |
Specify the module using this action. If the action is used by several modules, indicate "Supervisor". |
Template (field TYP) |
This field is important because it is used to identify the process to be launched on the execution of this action. See the development detail. At this level, the possible values are as follows :
Object management Miscellaneous process(called from a functional sub-program by Call) The "miscellaneous process" is used to directly launch a functional process without using a template ; this type of action cannot be called from a function. |
Block number 2
Button title (field ZINTITC) |
Inquiry code (field PARAM1) |
Identifying the inquiry to be entered in a template action "Inquiry". |
Type (field TYPUTI) |
Parameters
Main window (field PARAM2) |
This field serves to identify the principal entry window for the "Window entry" of "Standard process" templates. |
First entry (field PARAM3) |
To be entered for a "Standard process" template. Is it an initial entry ? and what type ? The possible values are as follows :
No initial entry |
Criteria window (field PARAM4) |
To be entered if the initial entry is : |
Standard script (field CODTRT) |
Standard process in which the Adonix development describes the supervisor model or sub-program additions. See the development detail. |
Subprograms (field SUBPRG) |
This field can be entered in an action of the type "Miscellaneous process". There is no supervisor process associated with this action, only with this sub-program. It is defined either in the standard process, or in the specific/custom process. A single sub-program is executed : This is the specific/custom if the process exists, if not it is the standard. The addition of a customization to a standard action of the type "Miscellaneous process" is then cancelled and replaced. |
Specific script (field SPETRT) |
Specific/custom process in which the customization writes the supervisor template or sub-program additions. The update of a specific/custom process does not require protection with an activity code. |
Expression (field INSTRU) |
This field can be entered in an action of the type "Miscellaneous process". It can appear as an addition to the sub-program. In this case, it will be executed following the sub-program. |
Action identifier (field PARAM5) |
This is used to identify one or more actions from a process, by the following variables :
|
Linked action (field ACTSUI) |
This field is used to specify another dictionary action. In this way there is the possibility to link up to 5 actions. In this case, the values of the parameters for all these actions are to be entered at the launch. The actions linked in this way can be from a different template. If the principal action is placed in a field, there is the possibility to not execute the linked actions by setting the mkstat variable. If the principal action is placed in a button at the bottom of the screen or in a menu, there is the possibility to not execute the linked actions by setting the variable OK = 0 in the action BEFORE NEXT. |
Accessibility
Workflow (field AMSFLG) |
Flag that is used to authorize or not this action in workflow. This authorization is only allowed for an action of the type "Miscellaneous process". This flag is is checked in particular on creation of a workflow rule. |
Batch (field ABTFLG) |
Flag that is used to authorize or not this action in batch mode. This authorization is only allowed for an action of the type "Standard process". This flag is checked in particular on creation of a batch task. |
Public (field PUBFLG) |
This flag indicates that this element is published. It can therefore be re-used by the custom/specific. An associated documentation is available. |
Batch mandatory in WEB (field NOWEB) |
If this flag is set, the said action will not be carried out in interactive mode, but in Customer/Server mode, and not on Web versions (Native Web, Web services). This helps prevent heavy processings in interactive mode in Web version. |
Description
field TEXTE |
Text loading the PRE "presentation" paragraph, in the record help. In the documentation management, the record help is identified by :
|
Tab Parameter Definitions
The information related to all the action parameters is found here.
Block number 1
Current field (field TYPACT) |
When this field is checked, the first parameter is considered as being the current field. If this action is placed in a field, the first parameter is entered automatically by the value of the current field ; It therefore does not appear in the list of parameters to be entered in the field in the screen dictionary. |
Action before/after field (field PARAM6) |
Possibility to add a process before and/or after an Object, Inquiry, Standard process, Entry window template, when this action is placed in the contextual menu for a field. This makes it possible to prepare a context (for example assign the variable GCONSULT) before executing an action and/or starting by example, a display after the action. The "before" action code is the name of the label preceded by A. The "after" action code is the name of the label preceded with B. Example : if the action is linked to the button 2 of the field CHP, the before and after labels will be AB2_CHP and BB2_CHP. It must be programmed in the $ACTION label of the standard or specific/custom process. |
No. (field NUMLIG) |
Code (field CODPAR) |
parameter codes for the action. The order in which the parameter codes should be entered in the grid is very important : It must correspond with the order in which the parameters have been entered in the sub-program that allows the execution of the action. Each parameter must have been declared in the parameters dictionary. Before creating this parameter code, verify that it doesn't exist already under another code in order to avoid redundancies. The selection key allows you to obtain the list. |
Parameter type (field TYPPAR) |
Indicate the nature of the parameter : char, integer, decimal etc. This information can only be entered during the creation of the parameter, in the parameter dictionary. Warning ! A parameter of the type clob/bob can only be used in an action in one of the following two cases :
|
Argument type (field ADRVAL) |
It indicates how the parameter is passed. by address ( a variable is necessary to pass the parameter. On exiting the sub-program, the value of any modified parameter is returned to the calling process). by value ( the parameter is passed by a variable or by a constant. On exiting the sub-program, the value of the parameter even if it is modified is not returned to the calling process). |
Reports
By default, the following reports are associated with this function :
ACTION : Action dictionary
This can be changed using a different setup.
Specific Buttons
Copy
This button is used to copy the definition of the action to another folder. Warning, the associated processes are not copied. Block number 1
Block number 2
|