- Action: Location, Messages, Authorization, & Implementation

Action locations can be adjusted via the ActionDescriptor property group, as well as in the Actions and Events setup within the WOW Builder. Below each value you can find an example of the Property as well as a screen shot describing where (within the running WOW application) the action will appear.

Action Location (for Row action):

ActionDescriptor { actTyp:row; loc:top,bottom; detailsLoc:buttons right, buttons left; name:action_name; }

Action Location (for Row Collection action):

Action Properties:

Action Messages:

• • No Rows Selected Error Text - On a Results (Table) screen, lets you specify a message to display when no rows are selected when an action is run. May be useful when TableDisplay property selectionType is not set to “none”. If coding a custom action class, you will need to add code to extract the message and display it:

TableDrivenActionRow actionRow = (TableDrivenActionRow) props;

throw new CMException(actionRow.getNoSelectionErrorText());

• • Confirmation Text - Text to display (warning - do you want to run this action?) before the action runs. Default is to provide no warning before running the action.

  • Action Completion Text - Alternate completion text to display after the action runs successfully. If coding a custom action class, you will need to add code to extract the message and display it:

TableDrivenActionRow actionRow = (TableDrivenActionRow) props;

if (ec instanceof HttpExecutingContext) {

String message = actionRow.getMessage();

if ((message != null && message.trim().length() > 0)) {

DataEngineServlet.setUserMessage(message,

((HttpExecutingContext) ec).getRequest());

} else {

DataEngineServlet.setUserMessage(null, ((HttpExecutingContext)

ec).getRequest());

}

}

Authorization:

Authorization works the same way as operation authorization. It controls which users are able to see/use and action. This is only applicable when an application is secured (signon required).

• • Security Type - The type of security measures to use.

  • Security Level - Used when the Security Type is set to Level Security. Specifies the minimum Security Level users must have in order to access the feature.

  • Authorization Operation - Used when the Security Type is set to Operation Security. Specifies the User Authorization Operation used to limit access to the operation. Only users matching the specified criteria will have access to view and run the operation. If no operation is selected, all users will be authorized to execute this operation. All User Authorization Operations defined for the current application should appear in the drop down selection.

Implementing the Drop Down Location:

To fully implement a Row action using the drop down location, it must be configured as follows:

• 1. Define 1 or more actions with a location of Drop Down and Operation Inheritance (scope) pointing to the desired operation to contain the drop down options.

  2. For the operation (step a), the SQL results must include a derived field to be used for showing the drop down option(s) associated with each row. For example => Select a.*, ‘’ as D_DROPDOWN From xxx.yyy where field D_DROPDOWN is the derived field in this example.

  3. In the same operation’s properties, include this DisplayColumns property to make the drop down field editable from the table (results) display:

DisplayColumns { editableResults:D_DROPDOWN; }

• 1. Create a derived field descriptor for derived field D_DROPDOWN and set the following in Advanced Settings:

  2. Field Class: planetj.wow.action.ActionField

  3. Field Descriptor Type: Derived

Once configured, the derived field should look like this, with a drop down choice for each drop down action created: