Rational Developer for System z


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

In this lesson, you will configure the actionValidator extension you defined for this plug-in project.
The actionValidators extension point allows contributing extensions to validate the values and the relationships between values of all parameters 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 will use the actionValidator extension to check the valid combination of parameters.
  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 will see the Extension Element Details listed.
  3. In the actionId text field, enter the action 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 associated with the PDS RAM, com.ibm.carma.sample.PDSRAM.
  5. Finally, in the class text field, enter the class that will contain the code to apply the actionValidator to the parameters of the HowTo custom action. For this sample, the class will be, com.ibm.carma.plugin.howto.action.ActionValidationAction. You will create this class later on in this exercise.
You have now defined a parameterValidator extension for the PDS RAM on the HowTo action using the ActionValidationAction Java™ class.

Feedback