Add a new issue into the ExtraView database. The command can be executed in several ways, depending on the options provided.
evadd [-n]
evadd [-n][-i] [field1=value1 field2=value2 ... fieldn=valuen] [q]
evadd [-n] -a
evadd [-n] -e [-v] [-f
This command allows a user to insert a new issue into the ExtraView database. All permissions and business rules, including email notification, are implemented the same way through the CLI as they are when issues are added through the GUI. The fields used with this command are those that are placed on the ADD_PROBLEM layout for the current business area and project.
This command may be run four different ways.
If neither the -a nor the -e command line options are specified, evadd will display a menu of all the fields available for adding a new issue. Each field is identified by a number. After the menu is displayed, the user will see the prompt, "Enter number or q to submit:". When a field number is entered, evadd will prompt for the value for that field. If the field is a list, the list of available values for that list will be displayed. If the field is a multiple line text field, the user may enter multiple lines of input text. These fields must be terminated by a line containing just a period.
In this menu, an asterisk (*) will identify all fields that are required but do not yet have values. After a value has been entered for a required field, the asterisk will be removed from the display.
After all the desired field values have been entered, press q to exit the menu and submit the issue to ExtraView.
If all required fields are included on the command line, and a trailing q ends the command line, the issue will be immediately submitted to ExtraView.
When field values are provided on the command line without a trailing q, the user will go into the interactive menu with those field values already populated.
With the -a option, the user will be prompted for a value for each field, in the same order as the fields are displayed with the evaddlist command. If the user tries to skip over a required field, a warning message is shown, "Must provide a value!", and the user is prompted for that field again.
To go back to a previous field in the list, enter a b at any prompt.
At the end of the list of fields, the issue is submitted to ExtraView. If there are fields which were not initially filled in, which are required as the result of a “required if” field attribute, the user will be notified of those missing values, and will be placed into the interactive menu, with all the field values preserved. In this case, the required fields will not be identified by an asterisk.
The -e option invokes an editor to perform the data entry. The editor will use a template file as the basis for collecting the field values for adding the issue.
In UNIX / Linux systems, the editor defaults to /bin/vi. In Microsoft Windows environments, the editor defaults to c:winnt40notepad.exe. An alternate editor may be specified by either setting up an EVEDITOR environment variable, by specifying the EDITOR line in the evconfig.txt file, or by using the EDITOR environment variable.
The template file will be created by one of five methods:
The format of a template file is similar to the following:
|
Title:
Product: Comments: |
The period following the Comments field in the example above signifies that a multiple line input is allowed. Text for multi-line fields should be inserted immediately after the line containing the multi-line field title (Comments in this example). A period on a line by itself terminates a multi-line field. If a multi-line field is not terminated with a period, evadd will treat the rest of the template file as part of the multi-line field, when the issue is submitted to ExtraView.
Similarly, when entering multi-line fields either through the interactive menu, or with the -a option, the field must be terminated with a line containing just a period.
When entering text into a multiple line field, the user may read in the contents of an existing file, as if that file had been typed it directly in, by using the ~r fname command on a line by itself. This is very useful for entering information into fields with display types of Text Area, Log Area, or Print Text.
When adding an attachment (through any of the methods described above, type in the attachment file name, followed by a space, and then the attachment description, on the lines following the keyword ‘Attachments’. Only one attachment may be specified per line.
| -n | suppresses the email notification sent whenever a new issue is created |
| -i | indicates that fields will be identified by their fixed database names instead of by their display titles |
| -a | runs the command in prompt mode |
| -e | runs the command in edit mode |
| -v | adds additional field list value information in the initial template file used within edit mode |
| -f templatefile | use templatefile as the initial template file |
| fieldn=valuen | assigns an initial value to a field. ‘fieldn’ is the Display Title of a field. ‘valuen’ must be a valid value for that field |
| q | ends a list of ‘fieldname=value’ pairs, the user will not be prompted for additional input. |
Repeating record data may not be added to an issue with the evadd command. First enter the base issue with evadd, and then use evupdate to add the repeating record data.
Entering an issue with evadd and no parameters –
|
$ evadd
*1. Title *10. Priority *2. Product 11. Severity 3. Category 12. Owner 4. Component 13. OS 5. Platforms 14. Customer 6. Description 15. Originator 7. Comments 16. View 8. Workaround 17. Test Case ID 9. Release Notes 18. Test Case Location Enter number or q to submit? 1 Title => This is the title 1. Global Interaction Choice for Product? 3 1. Title *10. Priority Title => This is the title, Product => SMS 1. Enhancement Choice for Category? 3 1. Title *10. Priority Title => This is the title, Product => SMS 1. Title *10. Priority Title => This is the title, Product => SMS Enter number or q to submit? 10 1. Low Choice for Priority? 3 1. Title 10. Priority Title => This is the title, Product => SMS |
This shows entering all the fields and values at the command line. Note that the field names such as short_descr, owner, status, etc. can be ascertained by using the evfields command.
|
$ evadd short_descr="This is the title of the problem"
owner=username status=OPEN priority=HIGH description="This is the description of the problem" customer=GE |
This example uses the -a option. You are prompted for the value for each field, in the order of fields that appear with the evaddlist command. If you try to skip over a field that is required, you will see a prompt that reminds you that you "Must provide a value!".
|
% evadd -a
Title? This is the title of the problem 1. Net Transactions Choice for Product? 3 1. P0 Choice for Priority? 2 1. NetBSD Choice for OS? 3 |
