Lesson 4: Configure the com.ibm.carma.ui.actionValidators extension

Edit online

In this lesson, you configure the actionValidator extension that you defined for this plug-in project.

About this task

The actionValidators extension point allows contributing extensions to validate the values and the relationships between values of all parameters that are associated with an action. If invalid combinations of parameters are detected, the OK button is disabled and the user is unable to submit the information. For example, in this sample either the string1 or string2 fields are considered required but not both. You use the actionValidator extension to check the valid combination of parameters.

Procedure

  1. You should be working in the Plug-in Development perspective and have the Plug-in Editor for your com.ibm.carma.plugin.howto plug-in project open.
  2. On the Extensions page, select the (actionValidator) option below the com.ibm.carma.ui.actionValidators extension point. To the right you see the Extension Element Details listed.
  3. In the actionId text field, enter the action that is defined on the PDS RAM to associate this validator to. For this sample, use the HowTo custom action on the PDS RAM, actionId 100.
  4. In the uniqueId text field, enter the unique identification that is associated with the PDS RAM, com.ibm.carma.sample.PDSRAM.
  5. Finally, in the class text field, enter the class that contains the code to apply the actionValidator to the parameters of the HowTo custom action. For this sample, the class is, com.ibm.carma.plugin.howto.action.ActionValidationAction. You create this class later on in this exercise.

Results

You have now defined a parameterValidator extension for the PDS RAM on the HowTo action using the ActionValidationAction Java™ class.