head	1.9;
access;
symbols
	TIGRIS_1_1_0RC2:1.5
	TIGRIS_1_1_0RC1:1.5
	TIGRIS_1_1:1.5.0.4
	TIGRIS_1_0_8:1.5
	TIGRIS_1_0_8RC3:1.5
	TIGRIS_1_0_8RC2:1.5
	TIGRIS_1_0_8RC1:1.5
	TIGRIS_1_0_7:1.5
	TIGRIS_1_0_7RC3:1.5
	TIGRIS_1_0_7RC2:1.5
	TIGRIS_1_0_7RC1:1.5
	TIGRIS_1_0_6:1.5
	TIGRIS_1_0_6RC5:1.5
	TIGRIS_1_0_6RC4:1.5
	TIGRIS_1_0_6RC3:1.5
	TIGRIS_1_0_6RC2:1.5
	TIGRIS_1_0_6RC1:1.5
	TIGRIS_1_0_5:1.5
	TIGRIS_1_0_5RC6:1.5
	TIGRIS_1_0_5RC5:1.5
	TIGRIS_1_0_5RC4:1.5
	TIGRIS_1_0_5RC3:1.5
	TIGRIS_1_0_5RC2:1.5
	TIGRIS_1_0_5RC1:1.5
	TIGRIS_1_0_4:1.5
	TIGRIS_1_0_3:1.5
	TIGRIS_1_0_2:1.5
	TIGRIS_1_0_1:1.5
	TIGRIS_1_0:1.5.0.6
	TIGRIS_1_0_0:1.5
	TIGRIS_1_0_0_RC1:1.5.0.2;
locks; strict;
comment	@# @;


1.9
date	2001.06.27.23.45.34;	author lori;	state Exp;
branches;
next	1.8;

1.8
date	2001.06.21.07.07.40;	author jefflove;	state Exp;
branches;
next	1.7;

1.7
date	2001.06.11.03.14.33;	author jefflove;	state Exp;
branches;
next	1.6;

1.6
date	2001.06.04.20.39.25;	author lori;	state Exp;
branches;
next	1.5;

1.5
date	2001.03.22.19.48.06;	author lori;	state Exp;
branches;
next	1.4;

1.4
date	2001.03.16.23.51.00;	author lori;	state Exp;
branches;
next	1.3;

1.3
date	2001.02.11.18.29.47;	author jrobbins;	state Exp;
branches;
next	1.2;

1.2
date	2001.02.09.00.59.20;	author susank;	state Exp;
branches;
next	1.1;

1.1
date	2001.01.29.19.41.02;	author lori;	state Exp;
branches;
next	;


desc
@@


1.9
log
@slight content addition about options for viewing project members' assigned issues
@
text
@
  <div class="docs" id="ddissuesquery">
  <!--
           The contents of this file are subject to the Mozilla Public
           License Version 1.1 (the "License"); you may not use this file
           except in compliance with the License. You may obtain a copy of
           the License at http://www.mozilla.org/MPL/
          
           Software distributed under the License is distributed on an "AS
           IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
           implied. See the License for the specific language governing
           rights and limitations under the License.
          
           The Original Code is the Issuezilla Issue Tracking System.
          
           The Initial Developer of the Original Code is Netscape Communications
           Corporation. Portions created by Netscape are
           Copyright (C) 1998 Netscape Communications Corporation. All
           Rights Reserved.
          
           Contributor(s): 

           Contributor(s): Terry Weissman <terry@@mozilla.org>
      -->
   <h2>Querying and tracking issues</h2>

   <h3>More help on IssueZilla: Index</h3>

   <div class="toc">
    <ul>
     <li>
      <a href="ProjectIssues.html">Project issue tracking</a> 

      <ul>
       <li><a href="ddIssues_EnterModify.html">Entering and modifying issues</a></li>

       <li>
        <strong>You are here:</strong> Querying and tracking issues 

        <ul>
         <li><a href="#queryfields">Issue query selection fields</a></li>

         <li><a href="#queryresults">Sorting/customizing query results</a></li>

         <li><a href="#customqueries">Customizing/remembering queries</a></li>

         <li><a href="#trackissue">Tracking your own issues (or by assignee)</a></li>

         <li><a href="#otherqueries">Running other queries</a></li>

         <li><a href="#browserinfo">Browser information</a></li>
        </ul>
       </li>

       <li><a href="ddIssues_Reports.html">Generating status reports about project issues</a></li>
      </ul>
     </li>
    </ul>
   </div>

   <div class="courtesylinks">
    <p><a href="/servlets/HelpTOC">Back to main Help index</a></p>
   </div>

   <h3>First, a clue about querying ...</h3>

   <p>The IssueZilla query form allows you to call up a subset of issues from a project's issue database. If you do not select an option, then either all values for those fields or the designated default values are included in the query. Submitting a query without setting any options at all, for example, returns <i>all</i> project issues with a status of NEW, STARTED, or REOPENED. Thus, you can narrow query results by adding more conditions, that is, by selecting options and/or entering information in the query form fields. You can save your results list in your bookmark file. You can also save your query configuration to reuse later.</p>

   <p>Field descriptions are provided here to help you fine tune your querying as necessary.</p>

   <h3><a id="queryfields" name="queryfields">Issue query selection fields</a></h3>

   <dl>
    <dt>Type</dt>

    <dd>refers to the classification of issues as either <a href="/docs/ddIssues_EnterModify.html#issue_type">tasks, defects, features, or enhancements</a>.</dd>

    <dt>Component</dt>

    <dd>is the the part of the software in development associated with the issue if you are querying to find. If you don't choose a component or subcomponent, the query addresses all issues for the <i>project</i>.</dd>

    <dt>Sub Component</dt>

    <dd>is a subset of the component you selected in the previous field. If you don't choose a sub component, the query addresses all issues for the <i>component</i>.</dd>

    <dt>Status</dt>

    <dd>is set with <a href="/docs/issue_lifecycle.html">NEW, STARTED and REOPENED</a> selected as the default. When searching for issues that are UNCONFIRMED, RESOLVED, VERIFIED, or CLOSED, remember to change this status field appropriately.</dd>

    <dt>Resolution</dt>

    <dd>is the qualification of issues with a status of <a href="/docs/issue_lifecycle.html#resolvedissues">RESOLVED, VERIFIED, OR CLOSED</a>. All resolved issues must be assigned one of these <a href="/docs/issue_lifecycle.html#resolvedissues">values</a>.</dd>

    <dt>Priority</dt>

    <dd>queries for issues by their rank of importance using the following scale: P1 is highest priority, given to issues that should be addressed as soon as possible; P5 is the lowest priority.</dd>

    <dt>Platform</dt>

    <dd>is the type of computer the issues is associated with. This field is most critical when searching for defects. When querying for other types of issues, it may not be necessary to make a selection in this field.</dd>

    <dt>OS</dt>

    <dd>is the type of operating system the issue is associated with. Again, when querying for other types of issues, it may not be necessary to make a selection in this field.</dd>

    <dt>Version</dt>

    <dd>The release of the software associated with this issue. Leaving this field unselected queries all versions of the selected project or component.</dd>

    <dt>Target Milestone</dt>

    <dd>queries for issues associated with different project milestones, if your project has these. Milestones typically are dates when certain features or overall versions are expected to be completed.</dd>

    <dt>Email</dt>

    <dd>
     lets you query for issues by the email address of assignee, reporter, QA contact, cc list, or added comments. A duplicate field lets you further refine queries based on this criteria. To search for issues associated with an email address: 

     <ul>
      <li>Type a portion of an email address into the text field.</li>

      <li>Select fields to query for association with that email address.</li>
     </ul>

     <p>The second field enables you to look for two different email addresses. If you specify both, then only issues matching both are returned in your query results. For example, this is useful to find issues "created by Ralph" and "assigned to Fred."</p>

     <p>You can also use the drop down menus to specify whether you want to match addresses by doing a substring match, regular expressions, or exact match of a fully specified email address.</p>

     <ul>
      <li>Additional input fields let you further qualify queries by issue number(s), date changes, number of votes, and changes in field values.</li>

      <li>Summary is the one-line abbreviated description of the issue used by default in reports and query results.</li>

      <li>A description entry enables querying by text string from the longer, detailed issue description.</li>

      <li>URL lets you query by the web page location associated with issues, when applicable.</li>

      <li>
       Status Whiteboard is a field defined by the project owner (or users with administrative permissions in IssueZilla). Input values to query by this field thus depend upon how it is being used in a particular project. 

       <p>Those who prefer to devise their own query schemes beyond options provided in these from fields provided can <a href="booleanchart.html">set up Boolean chart queries</a>.</p>
      </li>
     </ul>
    </dd>
   </dl>

   <h3><a id="queryresults" name="queryresults">Sorting and customizing query results</a></h3>

   <p>Before submitting a query, you can select to sort by issue number, importance, or assignee. After you submitted a query during a IssueZilla login session, you have the option to "Reuse the same sort as last time."</p>

   <p>Once you view the query results, clicking on any of the column headings will sort the displayed results within that column.</p>

   <p>Using the links at the bottom of the query results page, you can also:</p>

   <ul>
    <li>Switch to "long format" view of results to display complete contents of issues.</li>

    <li>Load a new query form.</li>

    <li>Enter a new issue.</li>

    <li>Change which columns appear in query results.</li>

    <li>Change several issues at once. (This option displays a page that lets you select issues from your query results list and modify specific fields in all of these simultaneously.)</li>

    <li>Send email to owners of issues listed.</li>

    <li>Edit the configuration of the last query.</li>
   </ul>

   <p>To add the target milestone for each issue to your query results -- and you should do so when a particular issue is slated for release --</p>

   <ol>
    <li>Do a query (or click "view assigned issues").</li>

    <li>Click the "change columns" link at the bottom.</li>

    <li>Click the "target milestone" check box.</li>

    <li>Submit.</li>
   </ol>

   <p>The target milestone column will now included for all your subsequent queries because login sessions are cookie-based. You can unmark this checkbox or mark others at any time to change your customized query results.</p>

   <h3><a id="customqueries" name="customqueries">Remembered queries</a></h3>

   <p>Once you've set up a fairly complex query to ferret out certain issues, you can tell IssueZilla to "remember" your custom queries as a time saver. Using the options just above the <i>Submit query</i> button, you can save your most recent query under a unique name and reuse it anytime you are logged in to IssueZilla. You can also change and reset the default query that the query page loads during your login sessions.</p>

   <p>To include your custom, named queries in the footer of the query page, use the "Edit prefs" link in the IssueZilla tool bar, and select the "Page Footer" option. All of your named queries have the option to be included in the IssueZilla tool bar on every page or only on the query page.</p>

   <h3><a id="trackissue" name="trackissue">Tracking issues by assignee</a></h3>

   <p><b>To view a list of project issues assigned to you</b>, click the <i>My Issues</i> link in the Project Issues page.</p>

   <p>One you have invoked IssueZilla, you can also click the <i>My issues</i> link in the secondary Issue Tracking tool bar.</p>

   <p><b>You have two options for viewing other project members' assigned issues</b>:</p>
<ul>
<li>Create an IssueZilla query using the "search the issue database" link and search by the "assigned to" field with the person's name entered. (The default setting for the "status" in the query screen includes NEW, STARTED, and REOPENED.)</li>
<li>Select the "Members" link in the project resource toolbar to view a list of project members by name, each with a link to their assigned project issues.</li>
</ul>

   <p>You can also generate reports by user and create a page of project members listed by name, each with a link to their specific list of issues.</p>

   <h3><a id="otherqueries" name="otherqueries">Running queries not supported by the pretty boxes</a></h3>

   <p>There is a hacky way to do some searches that aren't supported by the query form. The issue list script will build queries based on the URL, so you can add other criteria.</p>

   <p>For example, if you wanted to see all issues reported against the X platform and assigned to user "jwz," you could ask for all issues assign to jwz, then edit the URL in the "Location" box, adding the clause "&amp;rep_platform=X-Windows" to the URL.</p>

   <p>Here is a list of some of the field names you could use for additional unsupported searches ...</p>

   <ul>
    <li>version</li>

    <li>rep_platform</li>

    <li>op_sys</li>

    <li>reporter area</li>

    <li>issue_file_loc</li>

    <li>short_desc</li>
   </ul>

   <h3><a id="browserinfo" name="browserinfo">Browser notes</a></h3>

   <p>IssueZilla uses several non-standard Netscape extensions, but this does not seem to case any problem with other browsers. The Lynx browser does work, but Lynx seems to cache results of a .cgi. You'll sometimes need to press CONTROL-R to reload the screen to see an update.</p>

   <div class="courtesylinks">
    <p><a href="ProjectIssues.html">Back to Project Issues help</a><br />
     <a href="/servlets/HelpTOC">Back to main Help index</a></p>
   </div>
  </div>
 


@


1.8
log
@html usage revision
@
text
@d197 5
a201 1
   <p><b>To view other project members' assigned issues</b>, create a query using the "search the issue database" link and search by the "assigned to" field with the person's name entered. (The default setting for the "status" in the query screen includes NEW, STARTED, and REOPENED.)</p>
@


1.7
log
@extensive markup rework - first pass toward house xhtmlification
@
text
@a0 9
<!DOCTYPE html PUBLIC "-//CollabNet//DTD XHTML 1.0 Transitional//EN"
"http://collabnet.com/dtds/collabnet_transitional_10.dtd">
<html>
 <head>
  <title>IssueZilla Queries and Tracking</title>
<style type="text/css">
 div.c1 {margin-left: 2em}
</style>
 </head>
d2 1
a2 1
 <body>
d4 22
a25 21
         The contents of this file are subject to the Mozilla Public
         License Version 1.1 (the "License"); you may not use this file
         except in compliance with the License. You may obtain a copy of
         the License at http://www.mozilla.org/MPL/
        
         Software distributed under the License is distributed on an "AS
         IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
         implied. See the License for the specific language governing
         rights and limitations under the License.
        
         The Original Code is the Issuezilla Issue Tracking System.
        
         The Initial Developer of the Original Code is Netscape Communications
         Corporation. Portions created by Netscape are
         Copyright (C) 1998 Netscape Communications Corporation. All
         Rights Reserved.
        
         Contributor(s): 

         Contributor(s): Terry Weissman <terry@@mozilla.org>
    -->
d27 1
a27 2
  <div class="docs" id="docid">
<h2>Querying and tracking issues</h2>
d29 43
a71 1
  <p><strong>More help on IssueZilla: Index</strong></p>
a72 1
  <div>
d74 9
a82 1
    <dt><a href="ProjectIssues.html">Project issue tracking</a></dt>
d84 1
a84 1
    <dd><a href="ddIssues_EnterModify.html">Entering and modifying issues</a></dd>
d86 9
a94 2
    <dd>
     <strong>You are here: Querying and tracking issues</strong> 
d96 1
a96 3
     <ul>
      <li><strong><a href="#queryfields">Issue query selection fields</a><br />
      </strong></li>
d98 1
a98 2
      <li><strong><a href="#queryresults">Sorting/customizing query results</a><br />
      </strong></li>
d100 1
a100 2
      <li><strong><a href="#customqueries">Customizing/remembering queries</a><br />
      </strong></li>
d102 1
a102 2
      <li><strong><a href="#trackissue">Tracking your own issues (or by assignee)</a><br />
      </strong></li>
d104 1
a104 2
      <li><strong><a href="#otherqueries">Running other queries</a><br />
      </strong></li>
d106 1
a106 3
      <li><strong><a href="#browserinfo">Browser information</a></strong></li>
     </ul>
    </dd>
d108 1
a108 1
    <dd><a href="ddIssues_Reports.html">Generating status reports about project issues</a></dd>
d110 1
a110 3
    <dt><a href="/servlets/HelpTOC">Back to main Help index</a></dt>
   </dl>
  </div>
d112 1
a112 1
  <h3>First, a clue about querying ...</h3>
d114 1
a114 1
  <p>The IssueZilla query form allows you to call up a subset of issues from a project's issue database. If you do not select an option, then either all values for those fields or the designated default values are included in the query. Submitting a query without setting any options at all, for example, returns <i>all</i> project issues with a status of NEW, STARTED, or REOPENED. Thus, you can narrow query results by adding more conditions, that is, by selecting options and/or entering information in the query form fields. You can save your results list in your bookmark file. You can also save your query configuration to reuse later.</p>
d116 2
a117 1
  <p>Field descriptions are provided here to help you fine tune your querying as necessary.</p>
d119 2
a120 1
  <h3><a id="queryfields" name="queryfields">Issue query selection fields</a></h3>
d122 2
a123 54
  <ul>
   <li>
    <h3>Type</h3>
    refers to the classification of issues as either <a href="/docs/ddIssues_EnterModify.html#issue_type">tasks, defects, features, or enhancements</a>.
   </li>

   <li>
    <h3>Component</h3>
    is the the part of the software in development associated with the issue if you are querying to find. If you don't choose a component or subcomponent, the query addresses all issues for the <i>project</i>.
   </li>

   <li>
    <h3>Sub Component</h3>
    is a subset of the component you selected in the previous field. If you don't choose a sub component, the query addresses all issues for the <i>component</i>.
   </li>

   <li>
    <h3>Status</h3>
    is set with <a href="/docs/issue_lifecycle.html">NEW, STARTED and REOPENED</a> selected as the default. When searching for issues that are UNCONFIRMED, RESOLVED, VERIFIED, or CLOSED, remember to change this status field appropriately.
   </li>

   <li>
    <h3>Resolution</h3>
    is the qualification of issues with a status of <a href="/docs/issue_lifecycle.html#resolvedissues">RESOLVED, VERIFIED, OR CLOSED</a>. All resolved issues must be assigned one of these <a href="/docs/issue_lifecycle.html#resolvedissues">values</a>.
   </li>

   <li>
    <h3>Priority</h3>
    queries for issues by their rank of importance using the following scale: P1 is highest priority, given to issues that should be addressed as soon as possible; P5 is the lowest priority.
   </li>

   <li>
    <h3>Platform</h3>
    is the type of computer the issues is associated with. This field is most critical when searching for defects. When querying for other types of issues, it may not be necessary to make a selection in this field.
   </li>

   <li>
    <h3>OS</h3>
    is the type of operating system the issue is associated with. Again, when querying for other types of issues, it may not be necessary to make a selection in this field.
   </li>

   <li>
    <h3>Version</h3>
    The release of the software associated with this issue. Leaving this field unselected queries all versions of the selected project or component.
   </li>

   <li>
    <h3>Target Milestone</h3>
    queries for issues associated with different project milestones, if your project has these. Milestones typically are dates when certain features or overall versions are expected to be completed.
   </li>

   <li>
    <h3>Email</h3>
    lets you query for issues by the email address of assignee, reporter, QA contact, cc list, or added comments. A duplicate field lets you further refine queries based on this criteria. To search for issues associated with an email address: 
d125 6
a130 2
    <ul>
     <li>Type a portion of an email address into the text field.</li>
d132 1
a132 2
     <li>Select fields to query for association with that email address.</li>
    </ul>
d134 1
a134 1
    <p>The second field enables you to look for two different email addresses. If you specify both, then only issues matching both are returned in your query results. For example, this is useful to find issues "created by Ralph" and "assigned to Fred."</p>
d136 1
a136 1
    <p>You can also use the drop down menus to specify whether you want to match addresses by doing a substring match, regular expressions, or exact match of a fully specified email address.</p>
d138 2
a139 2
    <ul>
     <li>Additional input fields let you further qualify queries by issue number(s), date changes, number of votes, and changes in field values.</li>
d141 5
a145 1
     <li>Summary is the one-line abbreviated description of the issue used by default in reports and query results.</li>
d147 1
a147 1
     <li>A description entry enables querying by text string from the longer, detailed issue description.</li>
d149 1
a149 1
     <li>URL lets you query by the web page location associated with issues, when applicable.</li>
d151 1
a151 2
     <li>
      Status Whiteboard is a field defined by the project owner (or users with administrative permissions in IssueZilla). Input values to query by this field thus depend upon how it is being used in a particular project. 
d153 1
a153 5
      <p>Those who prefer to devise their own query schemes beyond options provided in these from fields provided can <a href="booleanchart.html">set up Boolean chart queries</a>.</p>
     </li>
    </ul>
   </li>
  </ul>
d155 2
a156 1
  <h3><a id="queryresults" name="queryresults">Sorting and customizing query results</a></h3>
d158 1
a158 1
  <p>Before submitting a query, you can select to sort by issue number, importance, or assignee. After you submitted a query during a IssueZilla login session, you have the option to "Reuse the same sort as last time."</p>
d160 1
a160 1
  <p>Once you view the query results, clicking on any of the column headings will sort the displayed results within that column.</p>
d162 1
a162 1
  <p>Using the links at the bottom of the query results page, you can also:</p>
d164 1
a164 2
  <ul>
   <li>Switch to "long format" view of results to display complete contents of issues.</li>
d166 1
a166 1
   <li>Load a new query form.</li>
d168 2
a169 1
   <li>Enter a new issue.</li>
d171 1
a171 1
   <li>Change which columns appear in query results.</li>
d173 2
a174 1
   <li>Change several issues at once. (This option displays a page that lets you select issues from your query results list and modify specific fields in all of these simultaneously.)</li>
d176 1
a176 1
   <li>Send email to owners of issues listed.</li>
d178 1
a178 2
   <li>Edit the configuration of the last query.</li>
  </ul>
d180 2
a181 1
  <p>To add the target milestone for each issue to your query results -- and you should do so when a particular issue is slated for release --</p>
d183 1
a183 2
  <ol>
   <li>Do a query (or click "view assigned issues").</li>
d185 1
a185 1
   <li>Click the "change columns" link at the bottom.</li>
d187 1
a187 1
   <li>Click the "target milestone" check box.</li>
d189 1
a189 2
   <li>Submit.</li>
  </ol>
d191 1
a191 1
  <p>The target milestone column will now included for all your subsequent queries because login sessions are cookie-based. You can unmark this checkbox or mark others at any time to change your customized query results.</p>
d193 1
a193 1
  <h3><a id="customqueries" name="customqueries">Remembered queries</a></h3>
d195 1
a195 1
  <p>Once you've set up a fairly complex query to ferret out certain issues, you can tell IssueZilla to "remember" your custom queries as a time saver. Using the options just above the <i>Submit query</i> button, you can save your most recent query under a unique name and reuse it anytime you are logged in to IssueZilla. You can also change and reset the default query that the query page loads during your login sessions.</p>
d197 1
a197 1
  <p>To include your custom, named queries in the footer of the query page, use the "Edit prefs" link in the IssueZilla tool bar, and select the "Page Footer" option. All of your named queries have the option to be included in the IssueZilla tool bar on every page or only on the query page.</p>
d199 1
a199 1
  <h3><a id="trackissue" name="trackissue">Tracking issues by assignee</a></h3>
d201 1
a201 1
  <p><b>To view a list of project issues assigned to you</b>, click the <i>My Issues</i> link in the Project Issues page.</p>
d203 1
a203 1
  <p>One you have invoked IssueZilla, you can also click the <i>My issues</i> link in the secondary Issue Tracking tool bar.</p>
d205 1
a205 1
  <p><b>To view other project members' assigned issues</b>, create a query using the "search the issue database" link and search by the "assigned to" field with the person's name entered. (The default setting for the "status" in the query screen includes NEW, STARTED, and REOPENED.)</p>
d207 1
a207 1
  <p>You can also generate reports by user and create a page of project members listed by name, each with a link to their specific list of issues.</p>
d209 2
a210 1
  <h3><a id="otherqueries" name="otherqueries">Running queries not supported by the pretty boxes</a></h3>
d212 1
a212 1
  <p>There is a hacky way to do some searches that aren't supported by the query form. The issue list script will build queries based on the URL, so you can add other criteria.</p>
d214 1
a214 1
  <p>For example, if you wanted to see all issues reported against the X platform and assigned to user "jwz," you could ask for all issues assign to jwz, then edit the URL in the "Location" box, adding the clause "&amp;rep_platform=X-Windows" to the URL.</p>
d216 1
a216 1
  <p>Here is a list of some of the field names you could use for additional unsupported searches ...</p>
d218 1
a218 6
  <p>version<br />
   rep_platform<br />
   op_sys<br />
   reporter area<br />
   issue_file_loc<br />
   short_desc</p>
d220 2
a221 1
  <h3><a id="browserinfo" name="browserinfo">Browser notes</a></h3>
d223 1
a223 1
  <p>IssueZilla uses several non-standard Netscape extensions, but this does not seem to case any problem with other browsers. The Lynx browser does work, but Lynx seems to cache results of a .cgi. You'll sometimes need to press CONTROL-R to reload the screen to see an update.</p>
d225 1
a225 2
  <div class="courtesylinks">
   <a href="ProjectIssues.html">Back to Project Issues help</a><br />
d228 2
a229 1
    <a href="/servlets/HelpTOC">Back to main Help index</a>
d232 1
a232 3
 </div>
</body>
</html>
@


1.6
log
@fixed broken link referencing issue types; issue 4370
@
text
@d1 2
d4 39
a42 1
<head>
d44 1
a44 1
<title>IssueZilla Queries and Tracking</title>
d46 2
a47 2
</head>
<body>
a48 56
<!--
     The contents of this file are subject to the Mozilla Public
     License Version 1.1 (the "License"); you may not use this file
     except in compliance with the License. You may obtain a copy of
     the License at http://www.mozilla.org/MPL/
    
     Software distributed under the License is distributed on an "AS
     IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
     implied. See the License for the specific language governing
     rights and limitations under the License.
    
     The Original Code is the Issuezilla Issue Tracking System.
    
     The Initial Developer of the Original Code is Netscape Communications
     Corporation. Portions created by Netscape are
     Copyright (C) 1998 Netscape Communications Corporation. All
     Rights Reserved.
    
     Contributor(s): 

     Contributor(s): Terry Weissman <terry@@mozilla.org>
-->
    <span class="Header" nowrap>Querying and tracking issues</span>
<p>

<span class="PlainText"><strong>More help on IssueZilla: Index</strong>
<ul>
<dl>
<dt><a href="ProjectIssues.html">Project issue tracking</a>
	<dd><a href="ddIssues_EnterModify.html">Entering and modifying issues</a>
	<dd><strong>You are here: Querying and tracking issues</a>
	<ul>
	     <li><a href="#queryfields">Issue query selection fields</a><br>
	     <li><a href="#queryresults">Sorting/customizing query results</a><br>
	     <li><a href="#customqueries">Customizing/remembering queries</a><br>
	     <li><a href="#trackissue">Tracking your own issues (or by assignee)</a><br>
	     <li><a href="#otherqueries">Running other queries</a><br>
	     <li><a href="#browserinfo">Browser information</a>
	</ul></strong>
	<dd><a href="ddIssues_Reports.html">Generating status reports about project issues</a>
<dt><a href="/servlets/HelpTOC">Back to main Help index</A>
</dl>
</ul>

<p>
<hr noshade size=1>
    <span class="InputHeader">First, a clue about querying ...</span>
<span class="PlainText">

     <p>The IssueZilla query form allows you to call up a subset of issues from a project's issue database. If you do not select an option, then either all values for those fields or the designated default values are included in the query. Submitting a query without setting any options at all, for example, returns <i>all</i> project issues with a status of NEW, STARTED, or REOPENED. Thus, you can narrow query results by adding more conditions, that is, by selecting options and/or entering information in the query form fields. You can save your results list in your bookmark file. You can also save your query configuration to reuse later.
	<p>Field descriptions are provided here to help you fine tune your querying as necessary.
<p>

<hr noshade size=1>
     <a name="queryfields"><span class="InputHeader">Issue query selection fields</span></a>
     <p>
d50 16
a65 24
      <li><span class="InputHeader">Type</span> refers to the classification of issues as either <a href="/docs/ddIssues_EnterModify.html#issue_type">tasks, defects, features, or enhancements</a>. 
      <p>
      <li><span class="InputHeader">Component</span> is the the part of the software in development associated with the issue if you are querying to find. If you don't choose a component or subcomponent, the query addresses all issues for the <i>project</i>.
      <p>
      <li><span class="InputHeader">Sub Component</span> is a subset of the component you selected in the previous field. If you don't choose a sub component, the query addresses all issues for the <i>component</i>.
      <p>
      <li><span class="InputHeader">Status</span> is set with <a href="/docs/issue_lifecycle.html">NEW, STARTED and REOPENED</a> selected as the default. When searching for issues that are UNCONFIRMED, RESOLVED, VERIFIED, or CLOSED, remember to change this status field appropriately.
      <p>
      <li><span class="InputHeader">Resolution</span> is the qualification of issues with a status of <a href="/docs/issue_lifecycle.html#resolvedissues">RESOLVED, VERIFIED, OR CLOSED</a>. All resolved issues must be assigned one of these <a href="/docs/issue_lifecycle.html#resolvedissues">values</a>.
      <p>
      <li><span class="InputHeader">Priority</span> queries for issues by their rank of importance using the following scale: P1 is highest priority, given to issues that should be addressed as soon as possible; P5 is the lowest priority.
      <p>
      <li><span class="InputHeader">Platform</span> is the type of computer the issues is associated with. This field is most critical when searching for defects. When querying for other types of issues, it may not be necessary to make a selection in this field.
      <p>
      <li><span class="InputHeader">OS</span> is the type of operating system the issue is associated with. Again, when querying for other types of issues, it may not be necessary to make a selection in this field.
      <p>
      <li><span class="InputHeader">Version</span> The release of the software associated with this issue. Leaving this field unselected queries all versions of the selected project or component. 
      <p>
      <li><span class="InputHeader">Target Milestone</span> queries for issues associated with different project milestones, if your project has these. Milestones typically are dates when certain features or overall versions are expected to be completed.
      <p>
      <li><span class="InputHeader">Email</span> lets you query for issues by the email address of assignee, reporter, QA contact, cc list, or added comments. A duplicate field lets you further refine queries based on this criteria. To search for issues associated with an email address: 
     <ul>
       <li>Type a portion of an email address into the text field. 
       <li>Select fields to query for association with that email address. 
d67 174
a240 17
     <p>The second field enables you to look for two different email addresses. If you specify both, then only issues matching both are returned in your query results. For example, this is useful to find issues "created by Ralph" and "assigned to Fred." 
     <p>You can also use the drop down menus to specify whether you want to match addresses by doing a substring match, regular expressions, or exact match of a fully specified email address. 
     <p>
     <ul>
      <li>Additional input fields let you further qualify queries by issue number(s), date changes, number of votes, and changes in field values.
      <p>
      <li>Summary is the one-line abbreviated description of the issue used by default in reports and query results. 
      <p>
      <li>A description entry enables querying by text string from the longer, detailed issue description.
      <p>
      <li>URL lets you query by the web page location associated with issues, when applicable.
      <p>
      <li>Status Whiteboard is a field defined by the project owner (or users with administrative permissions in IssueZilla).  Input values to query by this field thus depend upon how it is being used in a particular project.
      <p>Those who prefer to devise their own query schemes beyond options provided in these from fields provided can <a href="booleanchart.html">set up Boolean chart queries</a>.
     </ul>
     </ul>
    <p>
d242 5
a246 70
<hr noshade size=1>
     <a name="queryresults"><span class="InputHeader">Sorting and customizing query results</span></a>
     <p>Before submitting a query, you can select to sort by issue number, importance, or assignee. After you submitted a query during a IssueZilla login session, you have the option to "Reuse the same sort as last time."
     <p>Once you view the query results, clicking on any of the column headings will sort the displayed results within that column.<p>
     <p>Using the links at the bottom of the query results page, you can also:
     <p>
     <ul>
      <li>Switch to "long format" view of results to display complete contents of issues.
      <li>Load a new query form.
      <li>Enter a new issue.
      <li>Change which columns appear in query results.
      <li>Change several issues at once. (This option displays a page that lets you select issues from your query results list and modify specific fields in all of these simultaneously.)
      <li>Send email to owners of issues listed.
      <li>Edit the configuration of the last query.
     </ul>
     <p>
To add the target milestone for each issue to your query results -- and you should do so when a particular issue is slated for release --
     <p>
      <ol>
       <li>Do a query (or click "view assigned issues").
       <li>Click the "change columns" link at the bottom. 
       <li>Click the "target milestone" check box.
       <li>Submit.  
      </ol>
     <p>The target milestone column will now included for all your subsequent queries because login sessions are cookie-based. You can unmark this checkbox or mark others at any time to change your customized query results.
     <p>

<hr noshade size=1>
     <a name="customqueries"><span class="InputHeader">Remembered queries</span></a>
     <p>Once you've set up a fairly complex query to ferret out certain issues, you can tell IssueZilla to "remember" your custom queries as a time saver. Using the options just above the <i>Submit query</i> button, you can save your most recent query under a unique name and reuse it anytime you are logged in to IssueZilla. You can also change and reset the default query that the query page loads during your login sessions.
     <p>To include your custom, named queries in the footer of the query page, use the "Edit prefs" link in the IssueZilla tool bar, and select the "Page Footer" option.  All of your named queries have the option to be included in the IssueZilla tool bar on every page or only on the query page. 

<hr noshade size=1>
     <a name="trackissue"><span class="InputHeader">Tracking issues by assignee</span></a>
     <p><b>To view a list of project issues assigned to you</b>, click the <i>My Issues</i> link in the Project Issues page.
<p>One you have invoked IssueZilla, you can also click the <i>My issues</i> link in the secondary Issue Tracking tool bar.

     <p><b>To view other project members' assigned issues</b>, create a query using the "search the issue database" link and search by the "assigned to" field with the person's name entered. (The default setting for the "status" in the query screen includes NEW, STARTED, and REOPENED.)

     <p>You can also generate reports by user and create a page of project members listed by name, each with a link to their specific list of issues.
     <p>
     <p>

<hr noshade size=1>
     <a name="otherqueries"><span class="InputHeader">Running queries not supported by the pretty boxes</span></a>
      <p>There is a hacky way to do some searches that aren't supported by the query form.  The issue list script will build queries based on the URL, so you can add other criteria.
     <p>
For example, if you wanted to see all issues reported against the X platform and assigned to user "jwz," you could ask for all issues assign to jwz, then edit the URL in the "Location" box, adding the clause "&rep_platform=X-Windows" to the URL.
     <p>
Here is a list of some of the field names you could use for additional unsupported searches ...
     <p>
     version<br>
     rep_platform<br>
     op_sys<br>
     reporter area<br>
     issue_file_loc<br>
     short_desc<br>
     <p>

<hr noshade size=1>
     <a name="browserinfo"><span class="InputHeader">Browser notes</span></a>
     <p>IssueZilla uses several non-standard Netscape extensions, but this does not seem
to case any problem with other browsers.  The Lynx browser does work, but Lynx seems to cache results of a .cgi.  You'll sometimes need to press CONTROL-R to reload the screen to see an update.
<p>   
 
<hr noshade size=1>
<a href="ProjectIssues.html">Back to Project Issues help</a><br>
<a href="/servlets/HelpTOC">Back to main Help index</a></p></span>
</span>
</span>
d249 2
@


1.5
log
@fixed span class tag fonts
@
text
@d66 1
a66 1
      <li><span class="InputHeader">Type</span> refers to the classification of issues as either <a href="/docs/DomainDocsIssues_EnterModify.html#issue_type">tasks, defects, features, or enhancements</a>. 
@


1.4
log
@added index
@
text
@d56 1
d63 1
a63 1
     <p><a name="queryfields"><span class="InputHeader">Issue query selection fields</span></a>
d142 1
a142 1
     <p><a name="trackissue"><span class="InputHeader">Tracking issues by assignee</span></a>
d178 1
a178 1

@


1.3
log
@added <title> tags to all files
@
text
@d1 2
a2 2
<HTML>
<HEAD>
d4 1
a4 1
<TITLE>Issuezilla Queries and Tracking</TITLE>
d6 2
a7 2
</HEAD>
<BODY>
a30 2
<TABLE BORDER="0" CELLSPACING="1" CELLPADDING="3" BORDER="0" WIDTH="100%">
  <TR>
d32 3
a34 3
<P>
<span class="InputHeader">Contents</span>
<span class="PlainText">
d36 88
a123 79
     <li><A HREF="#queryfields">Issue query selection fields</A><BR>
     <li><A HREF="#queryresults">Sorting/customizing query results</A><BR>
     <li><A HREF="#customqueries">Customizing/remembering queries</A><BR>
     <li><A HREF="#trackissue">Tracking your own issues (or by assignee)</A><BR>
     <li><A HREF="#otherqueries">Running other queries</A><BR>
     <li><A HREF="#browserinfo">Browser information</A><p>
</ul></span>
<P>
<HR noShade SIZE=1>
    <SPAN class="InputHeader">First, a clue about querying ...</SPAN>
 
    <span class="PlainText" VALIGN="top">     
     <P>The IssueZilla query form allows you to call up a subset of issues from a project's issue database. If you do not select an option, then either all values for those fields or the designated default values are included in the query. Submitting a query without setting any options at all, for example, returns <I>all</I> project issues with a status of NEW, STARTED, or REOPENED. Thus, you can narrow query results by adding more conditions, that is, by selecting options and/or entering information in the query form fields. You can save your results list in your bookmark file. You can also save your query configuration to reuse later.
	<P>Field descriptions are provided here to help you fine tune your querying as necessary.
<P>

<HR noShade SIZE=1>
     <P><A NAME="queryfields"><SPAN class="InputHeader">Issue query selection fields</SPAN></A>
     <P>
     <UL>
      <LI><SPAN class="InputHeader">Type</span> refers to the classification of issues as either <A HREF="/docs/DomainDocsIssues_EnterModify.html#issue_type">tasks, defects, features, or enhancements</A>. 
      <P>
      <LI><SPAN class="InputHeader">Component</span> is the the part of the software in development associated with the issue if you are querying to find. If you don't choose a component or subcomponent, the query addresses all issues for the <I>project</I>.
      <P>
      <LI><SPAN class="InputHeader">Sub Component</span> is a subset of the component you selected in the previous field. If you don't choose a sub component, the query addresses all issues for the <I>component</I>.
      <P>
      <LI><SPAN class="InputHeader">Status</span> is set with <A HREF="/docs/issue_lifecycle.html">NEW, STARTED and REOPENED</A> selected as the default. When searching for issues that are UNCONFIRMED, RESOLVED, VERIFIED, or CLOSED, remember to change this status field appropriately.
      <P>
      <LI><SPAN class="InputHeader">Resolution</span> is the qualification of issues with a status of <A HREF="/docs/issue_lifecycle.html#resolvedissues">RESOLVED, VERIFIED, OR CLOSED</A>. All resolved issues must be assigned one of these <A HREF="/docs/issue_lifecycle.html#resolvedissues">values</A>.
      <P>
      <LI><SPAN class="InputHeader">Priority</span> queries for issues by their rank of importance using the following scale: P1 is highest priority, given to issues that should be addressed as soon as possible; P5 is the lowest priority.
      <P>
      <LI><SPAN class="InputHeader">Platform</span> is the type of computer the issues is associated with. This field is most critical when searching for defects. When querying for other types of issues, it may not be necessary to make a selection in this field.
      <P>
      <LI><SPAN class="InputHeader">OS</span> is the type of operating system the issue is associated with. Again, when querying for other types of issues, it may not be necessary to make a selection in this field.
      <P>
      <LI><SPAN class="InputHeader">Version</span> The release of the software associated with this issue. Leaving this field unselected queries all versions of the selected project or component. 
      <P>
      <LI><SPAN class="InputHeader">Target Milestone</span> queries for issues associated with different project milestones, if your project has these. Milestones typically are dates when certain features or overall versions are expected to be completed.
      <P>
      <LI><SPAN class="InputHeader">Email</span> lets you query for issues by the email address of assignee, reporter, QA contact, cc list, or added comments. A duplicate field lets you further refine queries based on this criteria. To search for issues associated with an email address: 
     <UL>
       <LI>Type a portion of an email address into the text field. 
       <LI>Select fields to query for association with that email address. 
     </UL>
     <P>The second field enables you to look for two different email addresses. If you specify both, then only issues matching both are returned in your query results. For example, this is useful to find issues "created by Ralph" and "assigned to Fred." 
     <P>You can also use the drop down menus to specify whether you want to match addresses by doing a substring match, regular expressions, or exact match of a fully specified email address. 
     <P>
     <UL>
      <LI>Additional input fields let you further qualify queries by issue number(s), date changes, number of votes, and changes in field values.
      <P>
      <LI>Summary is the one-line abbreviated description of the issue used by default in reports and query results. 
      <P>
      <LI>A description entry enables querying by text string from the longer, detailed issue description.
      <P>
      <LI>URL lets you query by the web page location associated with issues, when applicable.
      <P>
      <LI>Status Whiteboard is a field defined by the project owner (or users with administrative permissions in IssueZilla).  Input values to query by this field thus depend upon how it is being used in a particular project.
      <P>Those who prefer to devise their own query schemes beyond options provided in these from fields provided can <A HREF="booleanchart.html">set up Boolean chart queries</A>.
     </UL>
     </UL>
    <P>

<HR noShade SIZE=1>
     <A NAME="queryresults"><SPAN class="InputHeader">Sorting and customizing query results</SPAN></A>
     <P>Before submitting a query, you can select to sort by issue number, importance, or assignee. After you submitted a query during a IssueZilla login session, you have the option to "Reuse the same sort as last time."
     <P>Once you view the query results, clicking on any of the column headings will sort the displayed results within that column.<P>
     <P>Using the links at the bottom of the query results page, you can also:
     <P>
     <UL>
      <LI>Switch to "long format" view of results to display complete contents of issues.
      <LI>Load a new query form.
      <LI>Enter a new issue.
      <LI>Change which columns appear in query results.
      <LI>Change several issues at once. (This option displays a page that lets you select issues from your query results list and modify specific fields in all of these simultaneously.)
      <LI>Send email to owners of issues listed.
      <LI>Edit the configuration of the last query.
     </UL>
     <P>
d125 32
a156 32
     <P>
      <OL>
       <LI>Do a query (or click "view assigned issues").
       <LI>Click the "change columns" link at the bottom. 
       <LI>Click the "target milestone" check box.
       <LI>Submit.  
      </OL>
     <P>The target milestone column will now included for all your subsequent queries because login sessions are cookie-based. You can unmark this checkbox or mark others at any time to change your customized query results.
     <P>

<HR noShade SIZE=1>
     <A NAME="customqueries"><SPAN class="InputHeader">Remembered queries</SPAN></A>
     <P>Once you've set up a fairly complex query to ferret out certain issues, you can tell IssueZilla to "remember" your custom queries as a time saver. Using the options just above the <I>Submit query</I> button, you can save your most recent query under a unique name and reuse it anytime you are logged in to IssueZilla. You can also change and reset the default query that the query page loads during your login sessions.
     <P>To include your custom, named queries in the footer of the query page, use the "Edit prefs" link in the IssueZilla tool bar, and select the "Page Footer" option.  All of your named queries have the option to be included in the IssueZilla tool bar on every page or only on the query page. 

<HR noShade SIZE=1>
     <P><A NAME="trackissue"><SPAN class="InputHeader">Tracking issues by assignee</SPAN></A>
     <P><B>To view a list of project issues assigned to you</B>, click the <I>My Issues</I> link in the Project Issues page.
<P>One you have invoked IssueZilla, you can also click the <I>My issues</I> link in the secondary Issue Tracking tool bar.

     <P><B>To view other project members' assigned issues</B>, create a query using the "search the issue database" link and search by the "assigned to" field with the person's name entered. (The default setting for the "status" in the query screen includes NEW, STARTED, and REOPENED.)

     <P>You can also generate reports by user and create a page of project members listed by name, each with a link to their specific list of issues.
     <P>
     <P>

<HR noShade SIZE=1>
     <A NAME="otherqueries"><SPAN class="InputHeader">Running queries not supported by the pretty boxes</SPAN></A>
      <P>There is a hacky way to do some searches that aren't supported by the query form.  The issue list script will build queries based on the URL, so you can add other criteria.
     <P>
For example, if you wanted to see all issues reported against the X platform and assigned to jwz, you could ask for all issues assign to jwz, then edit the URL in the "Location" box, adding the clause "&rep_platform=X-Windows" to the URL.
     <P>
d158 12
a169 12
     <P>
     version<BR>
     rep_platform<BR>
     op_sys<BR>
     reporter area<BR>
     issue_file_loc<BR>
     short_desc<BR>
     <P>

<HR noShade SIZE=1>
     <A NAME="browserinfo"><SPAN class="InputHeader">Browser notes</SPAN></A>
     <P>IssueZilla uses several non-standard Netscape extensions, but this does not seem
d171 1
a171 1
<P>   
d173 7
a179 7
<HR noShade SIZE=1>
<A HREF="ProjectIssues.html">Back to Project Issues help</A><BR>
<a href="Help.html">Back to main Help index</a></p></span>
</SPAN>
</TR>
</TABLE></BODY>
</HTML>
@


1.2
log
@removed window's nasty line breaks, and corrected more links in HelpBox files
PR:
Obtained from:
Submitted by:
Reviewed by:
@
text
@d1 7
d171 2
a172 1
</TABLE>@


1.1
log
@new and revised help documentation for v1.0
@
text
@d1 163
a163 163

<!--
     The contents of this file are subject to the Mozilla Public
     License Version 1.1 (the "License"); you may not use this file
     except in compliance with the License. You may obtain a copy of
     the License at http://www.mozilla.org/MPL/
    
     Software distributed under the License is distributed on an "AS
     IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
     implied. See the License for the specific language governing
     rights and limitations under the License.
    
     The Original Code is the Issuezilla Issue Tracking System.
    
     The Initial Developer of the Original Code is Netscape Communications
     Corporation. Portions created by Netscape are
     Copyright (C) 1998 Netscape Communications Corporation. All
     Rights Reserved.
    
     Contributor(s): 

     Contributor(s): Terry Weissman <terry@@mozilla.org>
-->
<TABLE BORDER="0" CELLSPACING="1" CELLPADDING="3" BORDER="0" WIDTH="100%">
  <TR>
    <span class="Header" nowrap>Querying and tracking issues</span>
<P>
<span class="InputHeader">Contents</span>
<span class="PlainText">
<ul>
     <li><A HREF="#queryfields">Issue query selection fields</A><BR>
     <li><A HREF="#queryresults">Sorting/customizing query results</A><BR>
     <li><A HREF="#customqueries">Customizing/remembering queries</A><BR>
     <li><A HREF="#trackissue">Tracking your own issues (or by assignee)</A><BR>
     <li><A HREF="#otherqueries">Running other queries</A><BR>
     <li><A HREF="#browserinfo">Browser information</A><p>
</ul></span>
<P>
<HR noShade SIZE=1>
    <SPAN class="InputHeader">First, a clue about querying ...</SPAN>
 
    <span class="PlainText" VALIGN="top">     
     <P>The IssueZilla query form allows you to call up a subset of issues from a project's issue database. If you do not select an option, then either all values for those fields or the designated default values are included in the query. Submitting a query without setting any options at all, for example, returns <I>all</I> project issues with a status of NEW, STARTED, or REOPENED. Thus, you can narrow query results by adding more conditions, that is, by selecting options and/or entering information in the query form fields. You can save your results list in your bookmark file. You can also save your query configuration to reuse later.
	<P>Field descriptions are provided here to help you fine tune your querying as necessary.
<P>

<HR noShade SIZE=1>
     <P><A NAME="queryfields"><SPAN class="InputHeader">Issue query selection fields</SPAN></A>
     <P>
     <UL>
      <LI><SPAN class="InputHeader">Type</span> refers to the classification of issues as either <A HREF="/docs/DomainDocsIssues_EnterModify.html#issue_type">tasks, defects, features, or enhancements</A>. 
      <P>
      <LI><SPAN class="InputHeader">Component</span> is the the part of the software in development associated with the issue if you are querying to find. If you don't choose a component or subcomponent, the query addresses all issues for the <I>project</I>.
      <P>
      <LI><SPAN class="InputHeader">Sub Component</span> is a subset of the component you selected in the previous field. If you don't choose a sub component, the query addresses all issues for the <I>component</I>.
      <P>
      <LI><SPAN class="InputHeader">Status</span> is set with <A HREF="/docs/issue_lifecycle.html">NEW, STARTED and REOPENED</A> selected as the default. When searching for issues that are UNCONFIRMED, RESOLVED, VERIFIED, or CLOSED, remember to change this status field appropriately.
      <P>
      <LI><SPAN class="InputHeader">Resolution</span> is the qualification of issues with a status of <A HREF="/docs/issue_lifecycle.html#resolvedissues">RESOLVED, VERIFIED, OR CLOSED</A>. All resolved issues must be assigned one of these <A HREF="/docs/issue_lifecycle.html#resolvedissues">values</A>.
      <P>
      <LI><SPAN class="InputHeader">Priority</span> queries for issues by their rank of importance using the following scale: P1 is highest priority, given to issues that should be addressed as soon as possible; P5 is the lowest priority.
      <P>
      <LI><SPAN class="InputHeader">Platform</span> is the type of computer the issues is associated with. This field is most critical when searching for defects. When querying for other types of issues, it may not be necessary to make a selection in this field.
      <P>
      <LI><SPAN class="InputHeader">OS</span> is the type of operating system the issue is associated with. Again, when querying for other types of issues, it may not be necessary to make a selection in this field.
      <P>
      <LI><SPAN class="InputHeader">Version</span> The release of the software associated with this issue. Leaving this field unselected queries all versions of the selected project or component. 
      <P>
      <LI><SPAN class="InputHeader">Target Milestone</span> queries for issues associated with different project milestones, if your project has these. Milestones typically are dates when certain features or overall versions are expected to be completed.
      <P>
      <LI><SPAN class="InputHeader">Email</span> lets you query for issues by the email address of assignee, reporter, QA contact, cc list, or added comments. A duplicate field lets you further refine queries based on this criteria. To search for issues associated with an email address: 
     <UL>
       <LI>Type a portion of an email address into the text field. 
       <LI>Select fields to query for association with that email address. 
     </UL>
     <P>The second field enables you to look for two different email addresses. If you specify both, then only issues matching both are returned in your query results. For example, this is useful to find issues "created by Ralph" and "assigned to Fred." 
     <P>You can also use the drop down menus to specify whether you want to match addresses by doing a substring match, regular expressions, or exact match of a fully specified email address. 
     <P>
     <UL>
      <LI>Additional input fields let you further qualify queries by issue number(s), date changes, number of votes, and changes in field values.
      <P>
      <LI>Summary is the one-line abbreviated description of the issue used by default in reports and query results. 
      <P>
      <LI>A description entry enables querying by text string from the longer, detailed issue description.
      <P>
      <LI>URL lets you query by the web page location associated with issues, when applicable.
      <P>
      <LI>Status Whiteboard is a field defined by the project owner (or users with administrative permissions in IssueZilla).  Input values to query by this field thus depend upon how it is being used in a particular project.
      <P>Those who prefer to devise their own query schemes beyond options provided in these from fields provided can <A HREF="booleanchart.html">set up Boolean chart queries</A>.
     </UL>
     </UL>
    <P>

<HR noShade SIZE=1>
     <A NAME="queryresults"><SPAN class="InputHeader">Sorting and customizing query results</SPAN></A>
     <P>Before submitting a query, you can select to sort by issue number, importance, or assignee. After you submitted a query during a IssueZilla login session, you have the option to "Reuse the same sort as last time."
     <P>Once you view the query results, clicking on any of the column headings will sort the displayed results within that column.<P>
     <P>Using the links at the bottom of the query results page, you can also:
     <P>
     <UL>
      <LI>Switch to "long format" view of results to display complete contents of issues.
      <LI>Load a new query form.
      <LI>Enter a new issue.
      <LI>Change which columns appear in query results.
      <LI>Change several issues at once. (This option displays a page that lets you select issues from your query results list and modify specific fields in all of these simultaneously.)
      <LI>Send email to owners of issues listed.
      <LI>Edit the configuration of the last query.
     </UL>
     <P>
To add the target milestone for each issue to your query results -- and you should do so when a particular issue is slated for release --
     <P>
      <OL>
       <LI>Do a query (or click "view assigned issues").
       <LI>Click the "change columns" link at the bottom. 
       <LI>Click the "target milestone" check box.
       <LI>Submit.  
      </OL>
     <P>The target milestone column will now included for all your subsequent queries because login sessions are cookie-based. You can unmark this checkbox or mark others at any time to change your customized query results.
     <P>

<HR noShade SIZE=1>
     <A NAME="customqueries"><SPAN class="InputHeader">Remembered queries</SPAN></A>
     <P>Once you've set up a fairly complex query to ferret out certain issues, you can tell IssueZilla to "remember" your custom queries as a time saver. Using the options just above the <I>Submit query</I> button, you can save your most recent query under a unique name and reuse it anytime you are logged in to IssueZilla. You can also change and reset the default query that the query page loads during your login sessions.
     <P>To include your custom, named queries in the footer of the query page, use the "Edit prefs" link in the IssueZilla tool bar, and select the "Page Footer" option.  All of your named queries have the option to be included in the IssueZilla tool bar on every page or only on the query page. 

<HR noShade SIZE=1>
     <P><A NAME="trackissue"><SPAN class="InputHeader">Tracking issues by assignee</SPAN></A>
     <P><B>To view a list of project issues assigned to you</B>, click the <I>My Issues</I> link in the Project Issues page.
<P>One you have invoked IssueZilla, you can also click the <I>My issues</I> link in the secondary Issue Tracking tool bar.

     <P><B>To view other project members' assigned issues</B>, create a query using the "search the issue database" link and search by the "assigned to" field with the person's name entered. (The default setting for the "status" in the query screen includes NEW, STARTED, and REOPENED.)

     <P>You can also generate reports by user and create a page of project members listed by name, each with a link to their specific list of issues.
     <P>
     <P>

<HR noShade SIZE=1>
     <A NAME="otherqueries"><SPAN class="InputHeader">Running queries not supported by the pretty boxes</SPAN></A>
      <P>There is a hacky way to do some searches that aren't supported by the query form.  The issue list script will build queries based on the URL, so you can add other criteria.
     <P>
For example, if you wanted to see all issues reported against the X platform and assigned to jwz, you could ask for all issues assign to jwz, then edit the URL in the "Location" box, adding the clause "&rep_platform=X-Windows" to the URL.
     <P>
Here is a list of some of the field names you could use for additional unsupported searches ...
     <P>
     version<BR>
     rep_platform<BR>
     op_sys<BR>
     reporter area<BR>
     issue_file_loc<BR>
     short_desc<BR>
     <P>

<HR noShade SIZE=1>
     <A NAME="browserinfo"><SPAN class="InputHeader">Browser notes</SPAN></A>
     <P>IssueZilla uses several non-standard Netscape extensions, but this does not seem
to case any problem with other browsers.  The Lynx browser does work, but Lynx seems to cache results of a .cgi.  You'll sometimes need to press CONTROL-R to reload the screen to see an update.
<P>   
 
<HR noShade SIZE=1>
<A HREF="ProjectIssues.html">Back to Project Issues help</A><BR>
<a href="Help.html">Back to main Help index</a></p></span>
</SPAN>
</TR>
@

