Specifying the Action Descriptors

You need to be able to call tools within your application. This is done by adding action descriptors. The issue tracking system requires five actions in total:

  1. An action to return the children at the application level - entries All Issues and Issues by Priority.
  2. An action to return the children of the entry All Issues or Issues by Priority.
  3. An action to return a list of issues filtered by the priority.
  4. An action to display a list of issues filtered by the priority in the Table Results view.
  5. An action to display the raiser of an issue.

To specify the action to generate the first level in the Application Explorer view:

  1. Right-click Action Descriptors category folder, and then click New Child > Action Descriptor.

    This opens the Enter Object ID dialog box.

  2. In the New ID field, next to the Action Descriptor field, type TUTORIAL_ACT_CreateIssueFilterLevel.
  3. Click OK.
  4. Right-click TUTORIAL_ACT_CreateIssueFilterLevel, and then click Edit.

    This opens the Edit Properties dialog box.

  5. Double-click the Label value cell, and type Get Issue Filters.
  6. Click OK.
  7. Drag and drop the TUTORIAL_TOOL_AWM_CreateIssueFilterLevel tool onto the TUTORIAL_ACT_CreateIssueFilterLevel action descriptor.

    This opens the Create Relationships dialog box.


    Create Relationships - Action Tool
  8. Click OK.

To specify the action to produce the children of the first tree view level in the Application Explorer view:

  1. Right-click Action Descriptors category folder, and then click New Child > Action Descriptor.

    This opens the Enter Object ID dialog box.

  2. In the New ID field, next to the Action Descriptor field, type TUTORIAL_ACT_CreateStaticPriorityLevel.
  3. Click OK.
  4. As we have two different tools to generate the children of a first level tree entry depending on whether it is the All Issues or the Issues by Priority entry, you need to associate two tools and specify respective enabling conditions.

    Drag and drop the TUTORIAL_TOOL_CMD_ListIssues, and TUTORIAL_TOOL_AWM_CreateStaticPriorityLevel tools onto the TUTORIAL_ACT_CreateStaticPriorityLevel action descriptor.

    This opens the Create Relationships dialog box.

  5. Click OK.

The TUTORIAL_TOOL_CMD_ListIssues tool must only be enabled when the property TUTORIAL_PROP_STATIC_IssueFilter contains the value All Issues. This can be achieved by specifying an enabling condition on the action for tool relationship. To do this:

  1. In the Action Descriptors category folder, expand the action TUTORIAL_ACT_CreateStaticPriorityLevel.
  2. Right-click TUTORIAL_TOOL_CMD_ListIssues, and then click New Child > Enabled Condition.
  3. Right-click Enabled Condition, and then click New Child > Simple Condition.
  4. Right-click Condition, and then click Edit.

    This opens the Edit Properties dialog box.

  5. Double-click the Target ID value cell, and then click TUTORIAL_PROP_STATIC_IssueFilter.
  6. Double-click the Value value cell, and type All Issues.
  7. Click OK.

If the action TUTORIAL_ACT_CreateStaticPriorityLevel is called for the All Issues entry in the tree view, the tool TUTORIAL_TOOL_CMD_ListIssues is called with the input value *. You can achieve this by specifying a parameter override:

  1. In the Action Descriptors category folder, expand the action TUTORIAL_ACT_CreateStaticPriorityLevel.
  2. Right-click TUTORIAL_TOOL_CMD_ListIssues, and then click New Child > Parameter Override.
  3. Right-click Parameter Override, and then click Edit.

    This opens the Edit Properties dialog box.

  4. Double-click the New Static Value value cell, and type *.
  5. Double-click the Parm To Override value cell, and click TUTORIAL_PROP_ELE_Priority.
  6. Click OK.

Create an enabling condition for the TUTORIAL_TOOL_AWM_CreateStaticPriorityLevel tool belonging to the TUTORIAL_ACT_CreateStaticPriorityLevel action descriptor in the same way. This time set the attribute operator of the simple condition to equals not:

  1. In the Action Descriptors category folder, expand the action TUTORIAL_ACT_CreateStaticPriorityLevel.
  2. Right-click TUTORIAL_TOOL_AWM_CreateStaticPriorityLevel, and then click New Child > Enabled Condition.
  3. Right-click Enabled Condition, and then click New Child > Simple Condition.
  4. Right-click Condition, and then click Edit.

    This opens the Edit Properties dialog box.

  5. Double-click the Operator value cell, and click Equals not.
  6. Double-click the Target ID value cell, and then click TUTORIAL_PROP_STATIC_IssueFilter.
  7. Double-click the Value value cell, and type All Issues.
  8. Click OK.

    Your action descriptor TUTORIAL_ACT_CreateStaticPriorityLevel should look like:


    TUTORIAL_ACT_CreateStaticPriorityLevel

Create another action and name it TUTORIAL_ACT_ListFilteredIssues:

  1. Right-click Action Descriptors category folder, and then click New Child > Action Descriptor.

    This opens the Enter Object ID dialog box.

  2. In the New ID field, next to the Action Descriptor field, type TUTORIAL_ACT_ListFilteredIssues.
  3. Click OK.
  4. Drag and drop the TUTORIAL_TOOL_CMD_ListIssues tool onto the TUTORIAL_ACT_ListFilteredIssues action descriptor.

    This opens the Create Relationships dialog box.

  5. Click OK.

Create another action and name it TUTORIAL_ACT_ShowIssues. This is the action that displays a list of issues filtered by the priority in the Table Results view:

  1. Right-click Action Descriptors category folder, and then click New Child > Action Descriptor.

    This opens the Enter Object ID dialog box.

  2. In the New ID field, next to the Action Descriptor field, type TUTORIAL_ACT_ShowIssues.
  3. Click OK.
  4. Drag and drop the TUTORIAL_TOOL_CMD_ListIssues tool onto the TUTORIAL_ACT_ShowIssues action descriptor.

    This opens the Create Relationships dialog box.

  5. Click OK.
  6. Right-click TUTORIAL_ACT_ShowIssues, and then click Edit.

    This opens the Edit Properties dialog box.

  7. Double-click the Label value cell, and type Show Issues in Table.
  8. Click OK.

Create the final action and name it TUTORIAL_ACT_ShowRaiser:

  1. Right-click Action Descriptors category folder, and then click New Child > Action Descriptor.

    This opens the Enter Object ID dialog box.

  2. In the New ID field, next to the Action Descriptor field, type TUTORIAL_ACT_ShowRaiser.
  3. Click OK.
  4. Drag and drop the TUTORIAL_TOOL_CMD_GetRaiser, and TUTORIAL_TOOL_AWM_DIA_ShowRaiser tools onto the TUTORIAL_ACT_ShowRaiser action descriptor.

    This opens the Create Relationships dialog box.

  5. Click OK.
  6. Right-click TUTORIAL_ACT_ShowRaiser, and then click Edit.

    This opens the Edit Properties dialog box.

  7. Double-click the Label value cell, and type Show Raiser.
  8. Click OK.

    Your action descriptors should look like:


    All Action Descriptors
  9. Click File > Save.