<CriteriaMap>

This CriteriaMap tag is used to define the criteria to be used by the lov tag.

Relationship with other tags

The CriteriaMap tag is child tag of tag lovDef.

The CriteriaMap tag has the following child tag: Map.

Example

The following example shows the XML for a CriteriaMap tag.

   <lovDef     name="owner_lov";   list-source="users" >
      <CriteriaMap>   
         <Map  listFieldRef="USERID"   fieldRef="OWNER" >
      </CriteriaMap>
      <FieldMap>   
         <Map  listFieldRef="USERNAME"   fieldRef="OWNER" >
      </FieldMap>   
      <DisplayList>
         <FieldRef name="USERID" >
         <FieldRef name="USERNAME" >   
      </DisplayList> 
   </lovDef>

CriteriaMap defines query criteria from base page for the search in the LOV dialog. It contains one or multiple maps. Each map specifies two attributes: “listFieldRef” and “fieldRef”. A “listFieldRef” refers to a field defined in the list data source; a “fieldRef” refers to a field defined in the work item. From the UI point of view, a map tells the field in the base page will provide data to a search field in the LOV dialog as a query criterion. For example, in above case, the value 11 for field “STATUS” in base page will be passed to LOV dialog for list field “STATUS” as a searching criterion -- “STATUS=11” on list-source “bugStatusTable”.

Inside each Map section, the listFieldRef refers to a field defined in the list data source. The FieldRef refers to a field defined in the work item.

Attributes

Name	Type	Supports EL?	Description