Notifications

• Workflow code (field CODE)

This field identifies the Workflow rule.

• Title (field INTIT)

It used to define a name associated with each record.

• Active (field ENAFLG)

As long as this box has not been checked, the Workflow rule is not likely to be triggered.

• field TYPEVT

The Workflow event type can take the following values :

• Object : the function here is of the object type (record managed in creation, modification, duplication, deletion...mode). Then the event code corresponds to the object code.
• Function entry : the rule is triggered when entering a function of the software. The event code corresponds to the function code (an object coded as XXX corresponds to the GESXXX function, as a consequence, this type of event can also be used for objects).
• Print : a report is launched, and its code can be specified in the event code field.
• End of task: a Workflow is triggered at the end of the batch task, and its code corresponds to the event code (the batch task in question needs to have the box User message checked, otherwise it will not work. a warning message indicates otherwise, yet the entry is not forbidden for all that).
• Task interruption : this workflow rule is triggered when a user decides, from the task monitoring, to interrupt a batch task whose code corresponds to the event code. The user sends an interruption request to the batch server, and the server stops the task. Given the execution context of this event, the triggering possibilities are limited. Indeed :
• the usual environment variables (for instance, GUSER) are not available, only the current record in the [ABR] ABATRQT abbreviation table is.
• only a message can be sent via e-mail (no tracking table can be updated).
• Import/Export : this type of event is triggered at the beginning (and/or end) of the import (and/or export), and the event code makes it possible te specify the template being used.
• Signature : this rule is triggered when signing a former rule, whose code can be given by the event code.
• Manual : this rule is triggered by running through a set of tables described in the data template. This read is triggered via a manual operation which can obviously be launched in batch mode. This is especially useful to trigger the Workflow rules linked with field modifications in the database (the rule runs through the audit tables).
• Miscellaneous : this rule is triggered for particular events identified by a finite list of event codes. These events can either be generic for all software written in Adonix technology (for instance, connection, disconnection...), or they can depend on a function specific to the software being used. The list of the generic events is drawn up in a first documentation appendix, and the list of events specific to each software, in a second documentation appendix.

• field CODEVT

This field specifies the triggering context, based on the previously defined type :

• for an Object type, the code of the corresponding object is given.
• for a Function entry type, the function code is given.
• for a Printing type, the report code is given.
• for an End of task or Task interruption type, the code of the batch task is given.
• for an Import/Export type, the import/export template being used is given.
• for a Signature type, the code of the rule at the origin of the signature request is given.
• for a Manual type, no code is entered.
• for a Miscellaneous type, the code that identifies the miscellaneous event at the origin of the rule triggering is given.

This field is mandatory only for the event type Miscellaneous. If not entered, the event is triggered in a generic way, remembering that it is always possible to further test the context to be selective (thanks namely to the GFONCTION, GOLDETAT...variables).

• field LIBEVT

Name associated with the code entered in the previous section

• Creation (field ACREA)

• Modification (field AMODI)

• Deletion (field ASUPP)

• Return (field RETOUR)

If checked, this box makes it possible to enclose in the message sent an icon containing the context used to remind the record (by double-clicking on it). Note that this only works for a client-server connection.

• Log (field TRACE)

This box can only be checked if the triggering event corresponds to the end of a batch task.

In that case, if it is checked, the trace file associated with the batch task will be enclosed to the message sent.

• field FLD1

Indicate a field from the table.

• field OPE1

Indicate the comparison operation.

Specific operators :

- Not required to have all the records for an object.

- As permission to utilise the wildcards * ?

• field VALEUR1

Indicate the comparison value (without quotation marks for the alphanumeric fields).

• field ANDOR2

Indicate the link between criteria lines.

Example :

If Expr1 and Expr2 or Expr3 (Expr = expression) are entered we would have :

(Expr1 & (Expr2 | (Expr3)))

• field FLD2

• field OPE2

• field VALEUR2

• field ANDOR3

• field FLD3

• field OPE3

• field VALEUR3

• field ANDOR4

• field FLD4

• field OPE4

• field VALEUR4

• field ANDOR5

• field FLD5

• field OPE5

• field VALEUR5

• Expression (field EXP1)

Indicate if necessary an expression to complete the search.

The criterion is added to the previous criteria by the link AND.

The expression cannot contain fields from a table other than the principal table for the object. These can be indexed.

• Type (field TYPDES1)

A recipient can be linked to a user code (their details are then searched for in the user record), or a Business Partner (in that case, their details will be entered in the grid to identify on the BP record the concerned recipients).

• field DESTIN1

This field identifies the recipients. It is written in the form of logical expressions (Calculation formula) including on-line variables at the moment of execution.

• field FNCDES1

This information is only entered if the recipient type is a business partner. It refers to the local menu that defines the functions of the contacts in the Business Partner record.

• Send mail (field ENVOI1)

Three values concerning the recipients of the line can be entered here :

• No: they will not be sent any message.
• Yes  : a message will be sent to them as main recipients.
• Copy : a message is sent to them in copy mode.

• Warning (field SUIVI1)

This flag is used to tell whether the recipients of the line will receive a notification in their planning workbenches, depending on the value entered :

• No: in that case, no notification will be available in the planning workbench.
• Yes  : a notification will be sent to them, it may only be initialled to indicate that the user has read it.
• With signature : this notification needs to be signed by one of the recipients of the line.

Whenever a notification is sent to at least one of the recipient lines, the Approval request tab defines the text that will appear in the approval request, along with the answers that may be brought in case of a signature request.

• Type (field TYPDES2)

• field DESTIN2

• field FNCDES2

• Send mail (field ENVOI2)

• Warning (field SUIVI2)

• Object (field OBJET)

This field is used to specify the content of the Subject field of the message sent, in the form of a calculated expression that will be evaluated when the event is triggered.

• Text (field TEXTE)

This field is used to define the main content of the message. It is written as free text which includes logical expressions (calculation formula) between two vertical lines that serve as separators. For example, it is possible to write such contents as :

The event which occured on | num$(date$) | generated this sending by | GUSER |.