Common Event Action Fields
Adding an Event to an Element
Each service item element has an Events tab where you can add events. The only difference is the available list of events by element.
Example of Events tab:
Event drop-down list contains all the available events for the element.
Action drop-down list is all the available actions.
Add button will open the dialog that matches the selected Action.
Remedy table holds all the events related to the current element.
Up and Down buttons are used to change the order of the events.
Delete button removes the selected event.
View/Modify button opens the selected event for inspection and/or modification.
Common Fields
Example of the common fields in an event action:
Event is the name of the event that was selected when the action dialog was created. The event can be changed after the dialog has been created. The action cannot be changed.
Status is a drop-down list that contains Enabled (default) and Disabled. Disabled is helpful during troubleshooting or testing.
Action Name is a descriptive name for the event - required.
Description is an optional field that can be used if you need more descriptive text.
Fire Event If is a qualificaiton that determines if the event should "fire". If the qualification resolves to "true", the event will happen. A blank qualification defaults to true. There will be either two or three drop-down lists.
Example of Fire Event If - If Statements menu:
The If Value menu is only available if the element is a List question.
The Operators menu includes the following javascript logical helpers: AND, equal to, greater then, greater than or equal, less than, less than or equal, or, not equal, and NOT.
Table describing the If Statement options:
If Statement | Description |
Page is New | Resolves to True if the page has not been previously submitted |
Page is NOT New | Resolves to True when you return to a previously submitted page |
This is a Review Request | Resolves to True when the page type is Review Request |
This is NOT a Review Request | Resolves to True when the page type is not Review Request |
This is an Approval | Resolves to True when the request is in approval mode |
This is NOT an Approval | Resolves to True when the request is not an approval |
User is Authenticated | Resolves to True if a user was authenticated before the request is loaded |
User is NOT Authenticated | Resolves to True if the user is not authenticated when the request is loaded |
Checkbox is Checked | Resolves to True if the question is answer type List and type Check box and the customer clicks one of the possible check box answers. If you want to check for a specific value checked you need to add a “This Value Equals” parameter. To recognize “unchecking”, manually change the inserted text from obj.checked==true to obj.checked!=true |
Page is NOT Loading | Resolves to True when the DOM is done loading for the request |
RETURN was pressed | Used in combination with keyup event, this will resolve to True when the ENTER key is pressed. |
This Value Equals | Check to see if the answer on the question the event fires on is equal to a certain value. If the question is answer type list, the selection of possible values is automatically added as a drop-down list under the Fire Event If field. |
This Value NOT Equal to | Check to see if the answer on the question the event fires on is NOT equal to a certain value. If the question is answer type list, the selection of possible values is automatically added as a drop-down list under the Fire Event If field. |
Request Submission ID is NULL | Resolves to True if the request is anonymous(no KS_SRV_CustomerSurvey_base record has been created) |
Request Submission ID is NOT NULL | Resolves to True if the request is targeted (a KS_SRV_CustomerSurvey_base record has been created) |