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. In order to display the element list in the UI, you have to add a Create Element List step to the action.

    Right-click the action TUTORIAL_ACT_CreateIssueFilterLevel and select New Child > Create Element List.

    This adds a new Create Element List relationship to the action.

  9. Right-click Create Element List -TARGET_ID_MISSING, and then click Edit.

    This opens the Edit Properties dialog box.

  10. Under Target ID select the file descriptor TUTORIAL_FD_StaticIssueFilterList.
  11. 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.

The action Tutorial_ACT_CreateStaticPriorityLevel should call the tool TUTORIAL_TOOL_CMD_ListIssues when the property TUTORIAL_PROP_STATIC_IssueFilter contains the value "All Issues". Otherwise the action should call the tool TUTORIAL_TOOL_AWM_CreateStaticPriorityLevel.

This can be achieved by specifying an If/Else statement. To do this:

  1. Right-click the action descriptor TUTORIAL_ACT_CreateStaticPriorityLevel , and then click New Child > Statement > If/Else.
  2. Right-click If (CONDITION MISSING) and select New Child > Condition > Simple Condition.
  3. Right-click Simple Condition (CONDITION PROPRTEY MISSING), and then click Edit.

    This opens the Edit Properties dialog box.

  4. Double-click the Target ID value cell, and then click TUTORIAL_PROP_STATIC_IssueFilter.
  5. Double-click the Value value cell, and type All Issues.
  6. Click OK.
  7. Right-click the action descriptor TUTORIAL_ACT_CreateStaticPriorityLevel , and then click New Child > Statement > If/Else.
  8. Right-click If (CONDITION MISSING), and then click Edit.

    This opens the Edit Properties dialog box.

  9. Double-click the Statement value cell, and then select Else from the list.
  10. Drag and drop the tool TUTORIAL_TOOL_CMD_ListIssues onto the If statement.

    This opens the Create Relationships dialog box.


    Statement Tool Dialog
  11. Click OK.
  12. Drag and drop the tool TUTORIAL_TOOL_AWM_CreateStaticPriorityLevel onto the Else statement.

    This opens the Create Relationships dialog box.

  13. 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.
  7. In order to display the element list in the UI, you have to add a Create Element List step to both the if and else statement.
  8. Right-click the If statement and select New Child > Create Element List.

    This adds a new Create Element List relationship to the If statement.

  9. Right-click Create Element List -TARGET_ID_MISSING, and then click Edit.

    This opens the Edit Properties dialog box.

  10. Under Target ID select the file descriptor TUTORIAL_FD_IssueList.
  11. Click OK.
  12. Right-click the Else statement and select New Child > Create Element List.

    This adds a new Create Element List relationship to the Else statement.

  13. Right-click Create Element List -TARGET_ID_MISSING, and then click Edit.

    This opens the Edit Properties dialog box.

  14. Under Target ID select the file descriptor TUTORIAL_FD_StaticIssuePriorityList.
  15. 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.
  6. In order to display the element list in the UI, you must add a Create Element List step to the action.

    Right-click the action TUTORIAL_ACT_ListFilteredIssues and select New Child > Create Element List.

    This adds a new Create Element List relationship to the action.

  7. Right-click Create Element List -TARGET_ID_MISSING, and then click Edit.

    This opens the Edit Properties dialog box.

  8. Under Target ID select the file descriptor TUTORIAL_FD_IssueList.
  9. 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.
  9. In order to display the element list in the UI, you must add a Create Element List step to the action.

    Right-click the action TUTORIAL_ACT_ShowIssues and select New Child > Create Element List.

    This adds a new Create Element List relationship to the action.

  10. Right-click Create Element List -TARGET_ID_MISSING, and then click Edit.

    This opens the Edit Properties dialog box.

  11. Under Target ID select the file descriptor TUTORIAL_FD_IssueList.
  12. 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 .