evget

Displays the data for one issue

SYNOPSIS

evget [-r] [-c "field1, field2, ... fieldn"] [-f myfile.txt] [-a ] ID

DESCRIPTION

This command displays field data for a single issue. By default, all fields on the Detailed Report layout to which a user has read permission, will be displayed. The Detailed Report for the user's current Business Area and Project is selected. There are three ways of specifying a subset of these fields to be displayed -

  • The -f option
  • The -c option
  • The existence of a file named $HOME/.evget (evget.txt on Windows). However, only fields on the Detailed Report layout can be displayed with this command.

NOTE: Even though attachments may be displayed on the Detailed Report layout, evget cannot display attachments.

If the file $HOME/.evget exists (evget.txt on Windows), and neither the -c option nor the -f option are specified, evget will use the contents of this file as the list of field names whose values will be displayed. The format of this file is:

  • Only one field name may be placed per line in this file
  • Only fixed database names may be used in this file
  • Blank lines are ignored
  • Lines whose first non-blank character is a hash (#) are ignored
  • A line containing only the string, __END__ marks the end of the field list. This line, and all lines after this line in the file are ignored.

OPTIONS

-r

Data for all fields is returned in XML format. All other command line options are ignored when -r is used.

-c "field1, field2, ... , fieldn"

Allows the user to provide a comma-separated list of fields to be displayed, as command line options. Field names must be identified using the fixed database names. If the -f option is used in combination with the -c option, all the fields included in myfile.txt will be displayed in addition to the fields specified with the -c option. When the -c option is used, the file $HOME/.evget is ignored.

-f myfile.txt

Allows the user to specify a file that contains a list of all the fields to be displayed. The format of this file is identical to the format of the file $HOME/.evget, described above. When the -f option is used, the file $HOME/.evget is ignored. -a left|normal

Controls the alignment of the displayed data. With -a normal, the colons which separate the display titles from their values are aligned vertically. With -a left, all the output is left justified. ID

Must be a valid Issue number.

NOTES

Use the evfields command with the -g option to generate a sample get.txt file. This file may then be modified and saved as $HOME/.evget, to specify the default fields to be displayed by evget.

EXAMPLE 1

$ evget 10200
Assigned To: Internal IS Support
Category:
Changed by: Bill Smith
Comments: 6/30/04 System Administrator This needs to be fixed quickly
Date Created: 1/7/04
Description: Round corners, square edges, measure once
Documentation Impact:
ID #: 10200
Last Modified: 7/23/04
Operating System:
Originator: Guest User
Priority: P 3
Product: Tracker Enterprise
Reproducible:
Resolution:
Severity: Low
Status: Open
Title: Metal mounting bracket is too short
$

EXAMPLE 2

$ evget -r 10200
<?xml version="1.0" encoding="UTF-8"?>
<problem_record>
<id title="ID #"><!--[CDATA[10200]]--></id>
<date_created title="Date Created"><!--[CDATA[1/7/04]]--></date_created>
<timestamp title="Last Modified"><!--[CDATA[7/23/04]]--></timestamp>
<category title="Category"><!--[CDATA[]]--></category>
<originator title="Originator"><!--[CDATA[Guest User]]--></originator>
<last_change_user title="Changed by"><!--[CDATA[Bill Smith]]--></last_change_user>
<short_descr title="Title"><!--[CDATA[Metal mounting bracket is too short]]--></short_descr>
<product_name title="Product"><!--[CDATA[Tracker Enterprise]]--></product_name>
<priority title="Priority"><!--[CDATA[P 3]]--></priority>
<status title="Status"><!--[CDATA[Open]]--></status>
<assigned_to title="Assigned To"><!--[CDATA[Internal IS Support]]--></assigned_to> <resolution title="Resolution"><!--[CDATA[]]--></resolution>
<os title="Operating System"></os>
<severity_level title="Severity"><!--[CDATA[Low]]--></severity_level>
<dev_reproducible title="Reproducible"><!--[CDATA[]]--></dev_reproducible>
<description title="Description"><!--[CDATA[Round corners, square edges, measure once ]]--></description>
<comments title="Comments">< !--[CDATA[6/30/04 System Administrator This needs to be fixed quickly ]]--></comments>
<document_impact title="Documentation Impact">< !--[CDATA[ ]]--></document_impact> </problem_record>
$