Handler - MonitoringStamp
MonitoringStamp handler listens a monitored attribute and sets its own value, if the value of the monitored attribute changes to a defined one. The value of this attribute can be cleared also, when the value of the monitored attribute changes to the defined value. It is also definable, whether the attribute is updated or not, once the value is set. The value of the attribute can be defined. It can be a text defined by the admin, or it can be retrieved from a field of a data card.
Example of usage: MonitoringStamp handler is attached to two attributes: "Open date" and "Closing date". Both monitor "Status" field. Value for the "Open date" field is created, when the "Status" changes for the first time to "Open". It will not be updated again. The "Closing date" will be set, when the "Status" changes to "Closed". When the status changes to "Open", the "Closing date" will be cleared and updated again when the status changes to "Closed".
Example of OpenDate-attribute metadata configuration
Example of ClosingDate-attribute metadata configuration
MonitoringStamp handler is similar to ChangeStamp handler, but the handler is attached to the attribute whose value will be changed, not to the monitored attribute like the ChangeStamp.
The following tables provide information on the attribute settings and metadata requirements for MonitoringStamp handler. Compulsory metadata is provided in a Required attribute metadata table including proposals for possible metadata values.
Table 1. Attribute Settings
| Handler name | Datatype |
|---|---|
MonitoringStamp |
Any. Be sure, that value of value metadata matches with datatype |
Table 2. Required Attribute Metadata
| Name | Value | Description |
|---|---|---|
Monitored attribute |
[attribute_code] | Attribute code of the targeted attribute that it monitored. |
Value for this attribute |
[new value for field]
|
New value for the attribute, when the monitored attribute changes to one of the defined values. Value can be hard coded. Value can be retrieved from the data card. It can be one of the mentioned macros. Ensure that value matches with the datatype of the attribute. |
Table 3. Optional Attribute Metadata
| Name | Value | Description |
|---|---|---|
Update this attribute if it has a value |
[on|off], [true/false] |
If value is "on/true", the value of this attribute may be changed or cleared, when a value of Monitored attribute is changed. If value is "off/false", the value of this attribute is not changed or cleared, once it has a value. This condition is checked at first and it may prevent other changes. |
Set value to this attribute, when monitored attribute's value is |
[value of monitored attribute] | Value of monitored attribute, that changes the value of this attribute. Multiple lines can be given. |
Clear this attribute, when monitored attribute's value is |
[value of monitored attribute] | Value of monitored attribute, that clears the value of this attribute. Multiple lines can be given. |
Clear this attribute, if monitored attribute has any other value, that are defined by 'set' values (on/off) |
[on|off] | If this metadata is set to on, the value of this attribute is cleared always except when the value of the monitored attribute is a 'set'. |
Don't update this attribute, if monitored attribute's value is |
[value of monitored attribute] | Values of monitored attribute, that are ignored. This is used to configure values of monitored attribute, which should not either set, change or clear the value of this attribute. Multiple lines can be given. |
Don't update this attribute if it has value and monitored attribute's value is |
[value of monitored attribute] | Values of monitored attribute, that are ignored, if this attribute has a value already. This is used to configure values of monitored attribute, which should not set or change the value of this attribute, if the value exists already. If value of this attribute is empty, changing the monitored attribute to the given value will update this attribute also. Multiple lines can be given. |
Editable |
[on|off] |
If on, user can edit this field manually. The changes of monitored attribute will override manually given values. |
Table of Contents