triggeritemAdded by IBM on October 10, 2012 | Version 1 (Original)
|Identifies the item that triggered a form submission. Items triggering form submissions have a type option setting of refresh, submit, or done.
When a user selects an item that triggers a form submission, the triggeritem option is added to the form globals and assigned the item reference of the selected item.
This option is not saved or transmitted as part of the form. Instead, it is automatically created each time the form is read into memory, and is maintained only during display or processing.
Table 1. triggeritem parameters
|item reference||string||identifies the trigger item|
Example This sample indicates that the item triggering the request is on the page called "Page_one" and has is called "submit_button".
- Actions of type submit or done set the triggeritem to the SID of the triggering item. Actions of type refresh first clear the triggeritem by setting it to empty (""), then set the triggeritem to the SID of the triggering item.