Workflow Monitor
The Workflow monitor is used to present those events pending signature by a given user. This presentation, that can be set up by transaction, can be performed on one or more tabs. From each event, it is possible to view information relating to the triggering context, the messages sent or the signature history. The event can also be signed or approved, depending on the cases.
Prerequisite
Refer to documentation Implementation
Screen management
The entry in the workbench is performed on a varying number of tabs, depending on the selected transaction. On each tab, there is information that can be different and set up on a case by case basis. In a similar way, each of these tabs can display all or part of the events to be processed, the allocation being performed based on rules that can be set up. Finally, the events can be highlighted (by color, font size) or sorted out according to different criteria on a case by case basis.
Header
The header describes global filtering criteria on events to be processed, knowing that finer filters can exist on each tab of the function.
Exception delegate (field DELEXP) |
When this box is checked, the user sees the notifications sent to the users for whom said user has been granted an exceptional delegation. This box can only be checked if the user has at least one such delegation. |
Recipient (field USER) |
It defines the code of the user who is recipient of the Workflow events that are pending signature and need to be viewed. This code can only be entered in two cases:
If this field cannot be entered, it is by default equal to the user current value. If this field can be entered, but no value has been assigned, the following notifications can be viewed:
|
Start date (field DATDEB) |
If this date is entered, only the data where the last modification or creation date is later than or equal to it are viewed in the inquiry. It should be noted that the proposed date is by default today's date, decreased by a number of days equal to the value of the WRKDAY parameter. |
End date (field DATFIN) |
If this date is entered, only the data where the last modification or creation date is earlier than or equal to it are viewed in the inquiry. By default this date is equal to today's date. |
Tab Workbench
The Workflow notifications for which a signature or approval rule has been set up can be found in each tab of this type (there may be up to 8 of them).
The default information sorting order and the highlighting (using a particular style) of those lines that need to be stressed can be set up by tab.
Block number 1
field PAGFIR |
Navigation buttons that allow all the lines of the workbench to be run through. |
field PAGPRV |
field PAGNXT |
field PAGLST |
field W |
field PAGCUR |
field SAICRI |
Button that makes it possible to open an entry screen of a line selection criterion in the form of a logical expression. |
Sequence no. (field CHRONO) |
Chronological number assigned when a Workflow is triggered. In the case of a Manual workflow, a number is assigned for each triggering record. In all the other cases, a single chronological number is assigned per triggering record. Thus, when a notification is sent to several users from the same event, the chronological number is the same. |
Recipient (field DEST) |
It defines the notification recipient. If an approval or a signature is expected, it usually is up to them to provide it. This recipient is not necessarily the recipient who was defined in the original rule. Indeed, if the rule foresees a delegation to the first available recipient, and the original recipient has specified a delegate with authority for the concerned dates, the delegate will be the one to receive the notification (or their delegate if they have themselves designated a delegate...). |
Recipient e-mail (field EMAIL) |
When a message is sent by the rule to a recipient, the latter's e-mail address appears in this field. |
Workflow no. (field NUMGRP) |
This sequence number is assigned for each line dealt with (so there are several of them in the case of header/line Workflows with groupings). |
Company (field CPY) |
When a data model is attached to the rule and this model defines a current company depending on the context (either directly or via a site), the corresponding company is stored in the event. This company can be used (but it is not compulsory) to define the allocation rule that will specify the recipients of the notification. |
Delegate (field DELEGUE) |
This field is set to No if the user is the first notification recipient. It is set to Yes if the user receives the notification as a non-replacing delegate (All or Cascade options), and if, at the same time, said user has the signature authority (if they do not have the signature authority, the notification does not appear in the workbench). It should be noted that if this field is set to Yes, there is at least another line bearing the same sequence number with the No value in the table that stores the workbench data (there may be other lines with the same sequence number and the flag being set to Yes if there are several delegates with signature authority). The first signature on one of the concerned lines automatically updates all those lines that bear the same sequence number by considering them signed. |
Send mail (field ENVOI) |
This field is equal to Yes if a message has been sent during the execution of the rule. |
Sender (field EMETTEUR) |
It defines the notification issuer, in other words, the user whose action has triggered the Workflow. In a Signature Workflow, the issuer is the one who has signed the previous notification. For any other Workflow, the issuer is the user whose action triggers the sending of the notification. |
Email transmission (field MAIENV) |
When a list of the workbench has been signed by an http link being triggered from a message, this field stores the e-mail address of the user who has signed in such a manner. |
Issue date (field DATENV) |
It corresponds to the system date (as it is known to the processing server) at the moment when the Workflow event is being executed. |
Issue time (field TIMENV) |
It corresponds to the system time (as it is known to the processing server) at the moment when the Workflow event is being executed. |
Type of workflow (field NATURE) |
It corresponds to the value of the Workflow nature defined for the triggering event. It can represent a convenient criterion to sort out the lines, filter them or dispatch them to various tabs of the workbench. |
Tracked text (field TEXSUI) |
It contains the evaluated text from the Approval request text section defined in the Approval request tab of the rule. Usually a comment is parameterized to explain the Workflow triggering circumstances. |
Event type (field TYPEVT) |
It defines the event type of the Workflow rule at the origin of the notification line in the workbench. |
Event code (field CODEVT) |
It corresponds to the event code at the origin of the Workflow, in other words, to the code of:
|
Workflow code (field CODWRK) |
It identifies the Workflow rule whose execution has sent the notification. |
Action on (field OPERATION) |
It contains the operation code in the triggering context:
|
Signature leadtime (field DATMAXSIG) |
This field contains the date on which the Workflow shall have been signed. It is equal to the triggering date if no signature process has been implemented, or if no deadline has been defined. In fact, when the Workflow event expects a signature :
When a reminder of this type is made :
If these batch rules are not used and if no other rule has been defined to change these fields, the number of reminders remains equal to 0 and the reminder date remains empty, because no other standard Workflow process can modify this value. |
Signature flag (field FLGSIG) |
This field defines the signature level corresponding to the line notification. It can take the following values defined in the local menu 2922:
|
Answer (field ACTSIG) |
This field is empty as long as the event has not been signed. If it has been signed, the entered answer code can be found, as is it defined in the miscellaneous table number 54. |
Signer (field USRSIG) |
When a line in the notification grid has been signed, the code of the user who has signed appears here. It is not necessarily the original recipient, since another user may have been granted the authority to sign. |
Email signature (field MAISIG) |
When a message containing an approval request by activation of an http link has been sent, this field makes it possible to find out the e-mail address of the recipient. |
Signature date (field DATSIG) |
If the Workflow notification involves an approval request (simple approval or signature), this field makes it possible to find out the date on which the approval request has been performed (it stays empty has long as the approval request has not been performed). |
Signature time (field TIMSIG) |
If the Workflow notification implies an approval request (simple approval or signature), this field makes it possible to find out the time when the approval request has been performed (it stays empty has long as the approval request has not been performed). |
Response reason (field REASON) |
It contains the title associated with the reason code entered upon rule signature, when this entry is possible upon signature. This supposes that a list of possible reasons be defined via a miscellaneous table number on the corresponding signature line. |
Reason code (field REACOD) |
It contains the reason code entered upon rule signature, when this entry is possible upon signature. This supposes that a list of possible reasons be defined via a miscellaneous table number on the corresponding signature line. |
Reason no. (field REANUM) |
When a reason code entry has been planned upon rule signature, this field contains the miscellaneous table number that defines the possible reasons on the corresponding signature line. |
Release key (field CLEOBJ) |
In the case of an object Workflow, the object key can be found in this field (it is the Original triggering key field). In the case of a signature Workflow, the sequence number at the origin of the signature can be found in this field. In all other cases, this field is not assigned. |
Triggering table (field IDENTREF) |
This technical field contains the code of the triggering table along with the code of the corresponding key, in exactly the same manner as for the Line identifier field. On the other hand, in case of a signature-type event, this field remains empty, in other words, it is not transmitted from the original notification. |
Identifying return (field IDENTRET) |
When a return icon is associated with the Workflow, this field contains the name of the function on which the return is performed. If the function is of object type, the corresponding key can then be found, separated from the table by a "/" (the key segments, for a key in several parts, are separated by a "~"). |
Line identifier (field IDENTGRP) |
This technical field includes, first the name of the table containing the original triggering event , then the current key linked to the group that caused the triggering. The separator between table and key is "/" while the separator between the key segments (when comprised of several fields) is "~". The content is defined in the following fashion:
|
Origin chrono (field NUMORG) |
This sequence number is entered only for notifications linked to a Signature type event. It is used to find out the sequence number of the original event, the one whose signature has triggered the current line. |
Original recipient (field USRORG) |
This field is entered only on those lines associated with a Signature type event. It is used to find out the recipient of the original Workflow (the one who actually received the notification after possible application of the delegation rules: it is not necessarily the one who has signed). |
Reminder date (field DATREL) |
This field contains the date upon which the last signature reminder has been performed for the notification. It is not assigned if no signature process has been implemented. In fact, when the Workflow event expects a signature :
When a reminder of this type is made :
If these batch rules are not used and if no other rule has been defined to change these fields, the number of reminders remains equal to 0 and the reminder date remains empty, because no other standard Workflow process can modify this value. |
No. reminder (field NBRREL) |
This field contains the number of signature reminders performed for the Workflow event. In fact, when the Workflow event expects a signature :
When a reminder of this type is made :
If these batch rules are not used and if no other rule has been defined to change these fields, the number of reminders remains equal to 0 and the reminder date remains empty, because no other standard Workflow process can modify this value. |
Signature level (field LEVSIG) |
This field corresponds to the signature level, when signature events follow each other:
The corresponding LEVSIG variable is frequently used in the Workflow rules when the allocation rule of the original event specifies all the signers (1 to 9 maximum). For the original event as for the signature events that follow each other, the USER(LEVSIG+1) recipient formula only needs to be specified to obtain the user number N in the list. This makes it possible, among others, to have recursive signature rules, that are executed as long as signers are left. |
Return icon (field CONTXT) |
When a Workflow sends a message with a login icon enclosed, the login context (folder, server, service, function...) is defined in the form of an alphanumeric field. This technical field contains this context. The various segments of this field are divided by the "/" character. |
Back to desktop (field CONTXTSYRA) |
Back to mobile (field CONTXTMOBI) |
Original trigger key (field CLEDEC) |
It identifies the key at the origin of the Workflow circuit. When it is sub-divided into several parts, this key is a concatenation of the key parts separated by the tilde character (~). The key values depend on the context:
|
No. of signers (field NBRUSR) |
It defines the number of users returned by the allocation rule, if any. If there is none, but the rule is of the Signature type, the number of signers defined in the original rule is inherited. If there is no allocation rule, the returned value is 0. |
Object (field ABROBJ) |
When the first event at the origin of a signature cicuit is an object, this field identifies the object code. In the other cases, it is empty. It is then transmitted to the various signature events that could follow the first one. |
First recipient (field USRTOP) |
It defines the first recipient of the Workflow event. Indeed, an event can send a notification to several series of recipients, each one of them being defined by a line in the recipient grid. This field represents the evaluated recipient for the first line if the delegation option is No, All or Cascade. If the option is First available and the user is indeed not available and has granted delegation, the delegated user appears in this field. |
Context 1 (field VALCTX1) |
This field belongs to a group of fifteen generic fields that store contextual values assessed upon Worflow release based on formulas entered in the grid named Context of the Request approval tab of the Workflow. The values stored in this grid can be used for the following purposes:
|
Context 2 (field VALCTX2) |
Context 3 (field VALCTX3) |
Context 4 (field VALCTX4) |
Context 5 (field VALCTX5) |
Context 6 (field VALCTX6) |
Context 7 (field VALCTX7) |
Context 8 (field VALCTX8) |
Context 9 (field VALCTX9) |
Context 10 (field VALCTX10) |
Context 11 (field VALCTX11) |
Context 12 (field VALCTX12) |
Context 13 (field VALCTX13) |
Context 14 (field VALCTX14) |
Context 15 (field VALCTX15) |
Signer 1 (field USRSIG1) |
It is used to define the successive signers, when a recipient allocation rule returns N signers for the Workflow rule. This information is namely used to correctly manage the signature cancellations. Regarding Signature type events for which no allocation rule has been defined, the signers associated with the triggering rule are used. In this way, when N cascading signers have been defined in the original rule and all the signature rules that follow do not have any allocation rule, it is possible to find out the whole signature circuit at each level. It should be noted that the users defined by the rule before the possible application of delegation rules appear here. For instance, if the first recipient of the signature rule is not available, and they are replaced, the Signer 1 field will contain the original signer, whereas the First recipient field will contain the replacement to whom the signature request has been actually sent. |
Signer 2 (field USRSIG2) |
Signer 3 (field USRSIG3) |
Signer 4 (field USRSIG4) |
Signer 5 (field USRSIG5) |
Signer 6 (field USRSIG6) |
Signer 7 (field USRSIG7) |
Signer 8 (field USRSIG8) |
Signer 9 (field USRSIG9) |
Triggering operation | ||||||||
This function is used to zoom back to the function and original context of the Workflow. In the case of an object Workflow, the zoom back is performed to the corresponding record. |
||||||||
Original triggering operation | ||||||||
This function can be accessed when the event at the origin of the notification is of Signature type; in this case, the zoom back is performed to the original event (if need be, in a recursive way) in order to find out the function and record that triggered the start of the process. |
||||||||
Return | ||||||||
This function is used to return to the function and context described by the return icon of the Workflow setup. If nothing particular has been defined, it is the operation of origin that is proposed. |
||||||||
Group mails | ||||||||
Field descriptions
Grid Recipients
Grid Copy
Object
Message
Block number 5 This function is used to display in a selection window the list of messages sent to all users to whom the notification is destined. There is a line for each group of recipients defined by a line in the setup grid of the Workflow recipients. When double-clicking on one of these lines, a window opens to display the detail of the sent message and the list of recipients. |
||||||||
Mail history | ||||||||
Field descriptions
Grid Recipients
Grid Copy
Object
Message
Block number 5 This function allows the display in a selection window of the list of messages sent to the successive users having signed the notification of origin and the following notifications (when the signature process occurs at several levels). The lines appear in the reverse chronological order (the most recent signatures first). When double-clicking on one of these lines, a window opens to display the detail of the sent message and the list of recipients. |
||||||||
Signature | ||||||||
This function is used to trigger the line signature process. It is only available if the user has been granted signature authorization and if the line has not been signed already. A window opens then to propose a selection of possible answers, depending on the setup. An additional reason can also be entered depending on the setup, it can even be free text (for instance, to motivate a refusal). |
||||||||
Approval | ||||||||
This function is used to approve the line. This function is only available if the line has not been signed. No other entry is requested, since the line switches to the Approved status as early as this operation has been performed. |
||||||||
Cancel | ||||||||
This function is used to cancel a granted signature (by returning to the former request status). It is only available if the following conditions are all met:
This operation is different from a request rejection or refusal operation that will be dealt with in an entirely conventional way by standard setup. |