The Create Issue for Item view supports users in simultaneously creating individual issues for a number of automatically selected items. The xml dictates for which item type the view will be available, and can be configured to suit a specific meta model or use case, e.g., "Review issues" or "Planning issues" for requirements in a specification, or  "Bug reports"  based on test cases in a Test. This article describes how to configure the view.


Prerequisites


Configuring the View

  1. Go to File > Configure the explorer. 
  2. On the Item views tab, select Create issue for item.

  3. Click View example XML and copy the script as a starting point for your configuration. 
  4. Click Edit configuration and paste the configuration in the Edit XML window. 
  5. Modify the configuration to meet the needs of the use case. (See the explanation of available elements below.)
  6. When you are ready to test and make it available to users, check the Active box. Users must log out and back in to see the new option.


Example Data


Example Configuration

Below is an example XML for the view.

<Config>
  <TopItemType itemType="5RSE"/>
  <ItemRefType></ItemRefType>
  <LeftSide>
    <Grid>
      <Columns>
        <TypeColumn width="200"/>
        <IssueStatusColumn objectName="Issue" caption="Issue"/>
      </Columns>
      <ForEachPart type="ITSR">
        <DefObj>
          <Row>
            <ForEach select="/issueref::IR">
              <RowObject name="Issue"/>
            </ForEach>
          </Row>
        </DefObj>
      </ForEachPart>
    </Grid>
  </LeftSide>
</Config>


Note: Given the above example, the view will only be available for item type "5RSE". The view supports inheritance so it can be configured to, e.g., support all item types by using itemType="I".


Explanation of the Configuration Elements

<Config> is the top tag and can include one configuration. Multiple configurations are not currently supported.

<TopItemType> is required, and identifies the item type for which the configuration is valid. The itemType attribute defines the item type that activates the view.

<ItemRefType> defines the SID for the item-issue relationship to be used to link the item(s) to the generated issue(s). If not specified, the default Item references relationship is used. 

<LeftSide> and sub-elements, such as <Grid> and <Columns>, define the layout and content of the list of items.