Product Documentation

Each item added to the ExtraView database is automatically given an ID. The ID is a sequence which is incremented by one for each issue that is inserted into the database. The field is always read-only to users and developers. It may be used as a filter on reports. The ID is the primary key to all items. The sequence is applied without reference to which Business Area or Project to which the item belongs. For some purposes it is useful to have a unique sequence per Business Area or per Project, with the items within each Business Area or Project being given sequential numbers.

Further, it can be advantageous to provide formatting to this identifier to easily distinguish items in different Business Areas/Projects. This can be achieved through the use of the ALT_ID field. The ID field is still maintained automatically within ExtraView, but the mechanism described here can be set up to provide a unique sequence within the ALT_ID field. You should only set up this mechanism on a new database as existing items are not back-populated with the ALT_ID values. To set up separate sequences for each Business Area:

• Within the data dictionary entry for the ALT_ID field, place a pattern in the default value of ALT_ID
• You should not use the characters < and > within ALT_ID titles

  
  Entering the ALT_ID pattern

  This pattern is created as follows:
   

  • $$AREA.SEQ$$. This is the unique sequence for the area within which the item is being created. You should always include this
  • $$AREA.SHORT_TITLE$$. This is an optional set of characters entered into the definition for the Business Area. For example, you may provide a short title in the Business Area maintenance screen of CR to define a change request and a short title of FR to indicate a feature request. You enter the short title into the Abbreviated title for ALT_ID field

    
    Entering an abbreviated title for the ALT_ID
     

  • Any constant string. For example, you may include punctuation characters such as : and –
  • Replaceable variables of the form $$FIELD_NAME$$. These allow the use of other fields on the input form to become part of the ALT_ID
  • You must not use a space character within the pattern.  This ensures that keyword searching is kept simple within installations that have enabled ALT_ID
  • Set a starting number for the sequence at the prompt Starting sequence number for ALT_ID
• You must set the behavior setting ITEM_ID_DISPLAY to a value of ALT_ID
• Place the ALT_ID field onto all appropriate layouts as opposed to using the ID field. Typically this will be the add, edit, detailed report, Quicklist and other similar layouts. You may still set a layout cell attribute of FIELD/LAYOUT VISIBLE IF ID is not null to hide the ALT_ID before the item is saved.
• If you clone an issue, then the new ALT_ID is generated from the default pattern if it is writeable, and the default value for ALT_ID is non-empty.

To use this feature for Projects, within the definition for the PROJECT field, use the above instructions with $$PROJECT.SEQ$$ as opposed to $$AREA.SEQ$$.

Examples:

Fields