Available Actions or Events

The preceding examples in this chapter only show some of the operations you can perform in a form service request. The tables in this section describe other operations you may want to perform.

Form Service Request Events

Action or Event	Description	Parameters
Set Control Value	Sets the value of a control on a form, like filter fields or any other form control.	controlID ("25") value("Bob" or "01/01/2015")
Set QBE Value	Sets the value of a QBE column.	controlID ("1[42]" or "1_2[25]") value ("Jill" or "55")
Set Checkbox Value	Sets the value of a check box.	controlID ("77") value ("on" or "off")
Set Radio Button	Sets the value of a radio button.	controlID ("87") value ("87")
Set Combo Value	Sets the value of a combo box entry.	controlID ("125") value (2) - The index of the entry.
Do Action	Presses a button or Hyper Item.	controlID ("156")
Select Row	Selects the specified row in a grid.	controlID ("1.30") - The grid ID, dot, then a row index (zero based).
Select All Rows	Select all rows in the specified grid (if multiple selection is allowed).	controlID ("1") - The grid ID.
Un Select All Rows	Un-selects all rows in the specified grid (if multiple selection is allowed).	controlID ("1") - The grid ID.
Un Select Row	Un-selects the specified row in a grid.	controlID ("1.30") - The grid ID, dot, then a row index (zero based).
Click Grid Cell	Clicks the hyperlink in a grid cell (if the cell is enabled as a link).	controlID ("1.5.22") - The grid ID, dot, row index, dot, grid column ID.
Click Grid Column Aggregation (Available starting with EnterpriseOne Tools 9.2.0.2.)	Clicks the icon for aggregation of a column (if available in the application).	"command": "ClickGridColumnAggregate", controlID ("1.24") – The grid ID, dot, then grid column ID. You must include the capability in the used capability list in order to perform this action.
Next Grid Page (Available starting with EnterpriseOne Tools 9.2.1.)	Clicks the > icon on the grid so the next set of records can be returned. This is especially useful in an application stack call in which the application stays open and you can keep retrieving additional records.	"command":"NextGrid", "controlID":"1"

In addition to interacting with fields on the form, you can interact with grids using grid action events. If you use a grid action event, you must include "grid" as a required capability in the LoginEnvironment constructor. See Understanding AIS Server Capabilities for more information.

The types of grid action events include:

• Selecting grid rows

  This action enables you to delete records in the grid by sending a row select event, followed by a delete button press event, and then finally an OK button press event. This is the exact sequence that a user would follow to delete a record in an EnterpriseOne application.

• Inserting grid rows

  This action enables you to insert one or more rows into a grid, setting the column value for each row. This includes text entry columns, drop-down columns, or check box columns. You must include an OK button pressed event to commit the inserts.

• Updating grid rows

  This action enables you to update one or more existing grid rows by setting the column values for each row. This includes text entry columns, drop-down columns, or check box columns. You must include an OK button pressed event to commit the updates.

The following table describes the commands that you can use in grid column events to set values for a cell in a grid insert or update event:

Grid Column Events in a Form Service Request

Grid Column Events	Description	Parameters
Set Grid Cell Value	Sets the value of a cell in a grid.	"value": "720", "command": "SetGridCellValue", "columnID": "28"
Set Grid Combo Value	Sets the value of a dropdown column in a grid. The value you send is the 'Code' for the UDC associated with that column.	"value": "ABC", "command": "SetGridComboValue", "columnID": "43"