Dynamic Actions are control items that dynamically can affect the display of regions or items on a page. There are several situations when you want to show or hide items. For example, a text item asking for a maiden name should only be displayed when the person is female and married. In other cases, it is irrelevant to ask for a maiden name (on the other hand, with homosexual marriages it's possible for a man to have a "maiden" name, and in some cases a man can adopt the family name of his wife, but let's not make this example more difficult than necessary).
The same applies to the Commission field in the employees table. This item should only be enterable when the employee's job is a salesman. Let's build the functionality for this last situation.
You should already have an application and a simple single record form on the employees table.
Right-click on the Dynamic Actions link in the leftmost section and click on Create.
Select Standard and proceed to the next step.
Enter a name for this dynamic action. For example,
D_JOB_COMM_SHOW. Click on Next.In the next screen, the Selection Type is Item(s) and in the Item(s) field, enter the name of the item holding Job. You can use the List of Values button to select the right Page Item.
In the Condition list box, select equal to.
In the Value textarea, enter SALESMAN. Click on Next.
Select Show as the True Action and go to the next step.
In the next screen select Item(s) in the Selection Type. In the shuttle item that now appears, move the name of the commission field to the right.
Click on the Create button.
You have now created a dynamic action which shows the Commission field when the job is SALESMAN and hides the Commission field when the job is not SALESMAN.
The Dynamic Actions are actually event handlers in HTML. There are several event handlers.
Because these events are HTML (or rather JavaScript) they are handled client side. This has the advantage that the page doesn't have to be reloaded completely when an action is triggered to show or hide items.
|
Event |
Meaning |
|---|---|
|
Item has been refreshed (that is, by page refresh) | |
|
Fires before item has been refreshed (that is, by page refresh) | |
|
User navigates to another item | |
|
User navigates to another item and the value of the item has changed | |
|
User clicks on the item with a pointing device (like a mouse) | |
|
User double-clicks on the item with a pointing device | |
|
User navigates to the item via the tab key or a pointing device | |
|
User clicks on a key on the keyboard | |
|
User clicks on a key on the keyboard (=onkeyDown followed by onkeyUp) | |
|
User releases the key after having pressed it | |
|
The browser loads all content | |
|
User clicks on the mouse button when the mouse pointer is over the item | |
|
User clicks on the item with the pointing device | |
|
User moves away the mouse from the item | |
|
User moves the mouse while the mouse pointer is over the item | |
|
User moves the mouse pointer over the item | |
|
User moves away the mouse pointer from the item | |
|
User releases the mouse button after having it pressed | |
|
Form is submitted | |
|
Document view is resized | |
|
Document view is scrolled | |
|
User selects some text in a text field | |
|
|
Form is submitted |
|
Page is unloaded |
In our example, we use the onchange event handler. So, when the user changes the value in JOB, the onchange is triggered and it calls the action to show or hide the COMMISSION field, depending on the value in JOB. If it is SALESMAN then show commission, else hide commission.
You can control the display of more than one item at a time. Simply separate the items by a comma in the items field.
You can also control the display of regions. So, you can show or hide a complete report. Instead of item, select region and the name of the region in the affected element section when defining an action.