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 -

  1. The -f option
  2. The -c option
  3. 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

















    ]]>
    This needs to be fixed quickly
    ]]>
    ]]>

    $