{"id":24314,"date":"2024-02-15T14:53:34","date_gmt":"2024-02-15T22:53:34","guid":{"rendered":"https:\/\/docs.extraview.com\/v25\/book\/evupdate-1\/"},"modified":"2025-03-04T17:00:25","modified_gmt":"2025-03-05T01:00:25","slug":"evupdate-1","status":"publish","type":"page","link":"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/evupdate-1\/","title":{"rendered":"evupdate"},"content":{"rendered":"<p>Modify the field values of an existing issue<\/p>\n<h3>SYNOPSIS<\/h3>\n<p class=\"fixedWidthFont\">evupdate [-n]<\/p>\n<p class=\"fixedWidthFont\">evupdate [-n][-i] [field1=value1 field2=value2 &#8230; fieldn=valuen] [q]<\/p>\n<p class=\"fixedWidthFont\">evupdate [-n] -e [-v] [-f &lt;mytemplate&gt;]<\/p>\n<h3>DESCRIPTION<\/h3>\n<p>This command allows a user to modify an existing issue in 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 modified through the GUI. The fields used with this command are those that are placed on the EDIT_PROBLEM layout for the current business area and project.<\/p>\n<p>This command may be run three different ways.<\/p>\n<h4>Interactive Menu<\/h4>\n<p>When the <span class=\"fixedWidthFont\">-e<\/span> command line option is not specified, and the user does not terminate a list of fields on the command line with the letter <span class=\"fixedWidthFont\">q<\/span>, <span class=\"fixedWidthFont\">evupdate<\/span> will display a menu of all the fields available for modifying an issue. Each field is identified by a number. After the menu is displayed, the user will see the prompt, <span class=\"fixedWidthFont\">Enter number or q to submit:<\/span>. When a field number is entered, <span class=\"fixedWidthFont\">evupdate<\/span> 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.<\/p>\n<p>In this menu, an asterisk (*) will identify any field that is required but does not have a value. After a value has been entered for a required field, the asterisk will be removed from the display.<\/p>\n<p>After all the desired field values have been entered, press <span class=\"fixedWidthFont\">q<\/span> to exit the menu and submit the update to ExtraView.<\/p>\n<h4>Command-line only<\/h4>\n<p>If all desired fields are included on the command line, and a trailing <span class=\"fixedWidthFont\">q<\/span> ends the command line, the issue will be immediately submitted to ExtraView for update.<\/p>\n<p>When field values are provided on the command line without a trailing <span class=\"fixedWidthFont\">q<\/span>, the user will go into the interactive menu with those field values already populated.<\/p>\n<h4>Edit Mode<\/h4>\n<p>The <span class=\"fixedWidthFont\">-e<\/span> 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 modifying the issue.<\/p>\n<p>In UNIX, the editor defaults to <span class=\"fixedWidthFont\">\/bin\/vi<\/span>. In Microsoft Windows environments, the editor defaults to <span class=\"fixedWidthFont\">c:\\windows\\notepad.exe<\/span>. An alternate editor may be specified by either the EVEDITOR environment variable, by an EDITOR line in the <span class=\"fixedWidthFont\">evconfig.txt<\/span> file, or by the EDITOR environment variable.<\/p>\n<p>The template file will be created by one of five methods:<\/p>\n<ol>\n<li>The <span class=\"fixedWidthFont\">-f &lt;mytemplate&gt;<\/span> command line option<\/li>\n<li>The EVADD environment variable<\/li>\n<li>The existence of the file <span class=\"fixedWidthFont\">$HOME\/.evadd<\/span> (<span class=\"fixedWidthFont\">evadd.txt<\/span> on Windows)<\/li>\n<li>The existence of the file <span class=\"fixedWidthFont\">evcli\/add.txt<\/span><\/li>\n<li>The file will automatically be generated from the list of fields returned by <span class=\"fixedWidthFont\">evaddlist<\/span>.<\/li>\n<\/ol>\n<p>The format of a template file is similar to the following:<\/p>\n<pre><code>Title: \nProduct: \nComments:\n.\nAttachments:<\/code><\/pre>\n<p>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, evupdate will treat the rest of the template file as part of the multi-line field, when the issue is submitted to ExtraView.<\/p>\n<p>Similarly, when entering multi-line fields either through the interactive menu, or with the <span class=\"fixedWidthFont\"> -a<\/span> option, the field must be terminated with a line containing just a period.<\/p>\n<p>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 in directly, by using the <span class=\"fixedWidthFont\">~r fname<\/span> 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.<\/p>\n<p>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 <b>Attachments<\/b>. Only one attachment may be specified per line.<\/p>\n<h3>OPTIONS<\/h3>\n<table class=\"border\">\n<tbody>\n<tr>\n<td class=\"fixedWidthFont\" align=\"center\" width=\"120\">-n<\/td>\n<td>suppresses the email notification sent whenever an issue is updated<\/td>\n<\/tr>\n<tr>\n<td class=\"fixedWidthFont\" align=\"center\" width=\"100\">-i<\/td>\n<td>indicates that fields will be identified by their fixed database names instead of by their display titles<\/td>\n<\/tr>\n<tr>\n<td class=\"fixedWidthFont\" align=\"center\" width=\"100\">-a<\/td>\n<td>runs the command in prompt mode<\/td>\n<\/tr>\n<tr>\n<td class=\"fixedWidthFont\" align=\"center\" width=\"100\">-e<\/td>\n<td>runs the command in edit mode<\/td>\n<\/tr>\n<tr>\n<td class=\"fixedWidthFont\" align=\"center\" width=\"100\">-v<\/td>\n<td>adds additional field list value information in the initial template file used with in edit mode<\/td>\n<\/tr>\n<tr>\n<td class=\"fixedWidthFont\" align=\"center\" width=\"100\">-f templatefile<\/td>\n<td>use templatefile as the initial template file<\/td>\n<\/tr>\n<tr>\n<td class=\"fixedWidthFont\" align=\"center\" width=\"100\">fieldn=valuen<\/td>\n<td>assigns an initial value to a field. fieldn is the Display Title of a field. valuen must be a valid value for that field<\/td>\n<\/tr>\n<tr>\n<td class=\"fixedWidthFont\" align=\"center\" width=\"100\">q<\/td>\n<td>ends a list of \u2018fieldname=value\u2019 pairs, the user will not be prompted for additional input.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3>NOTES<\/h3>\n<p>Repeating row data may not be added to an issue through the CLI.<\/p>\n<h3>EXAMPLE<\/h3>\n<pre><code>% evupdate 12256\n 1. Title           11. Severity\n 2. Product         12. Assigned To\n 3. Category        13. OS\n 4. Component       14. Customer\n 5. Platforms       15. Clarify ID\n 6. Description     16. Owner\n 7. Comments        17. View\n 8. Workaround      18. Test Case ID\n 9. Release Notes   19. Test Case Location\n 10. Priority \n\nEnter number or q to submit: 10 \nCurrent value of Priority: P3\n\n     1. P0 \n     2. P1\n     3. P2\n     4. P3\n     5. P4\n     6. P5\n\nChoice for Priority? 2\n 1. Title           11. Severity\n 2. Product         12. Assigned To\n 3. Category        13. OS\n 4. Component       14. Customer\n 5. Platforms       15. Clarify ID\n 6. Description     16. Owner\n 7. Comments        17. View\n 8. Workaround      18. Test Case ID\n 9. Release Notes   19. Test Case Location\n 10. Priority \n\nPriority =&gt; P1 \nEnter number or q to submit: q \nBug # 12256 updated. \n%<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"<p>Modify the field values of an existing issue SYNOPSIS evupdate [-n] evupdate [-n][-i] [field1=value1 field2=value2 &#8230; fieldn=valuen] [q] evupdate [-n] -e [-v] [-f &lt;mytemplate&gt;] DESCRIPTION This command allows a user to modify an existing issue in the ExtraView database. All permissions and business rules, including email notification, are implemented the same way through the CLI&#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":24277,"menu_order":68,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_lmt_disableupdate":"no","_lmt_disable":"","_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"class_list":["post-24314","page","type-page","status-publish","hentry"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v25.1 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>evupdate - Product Documentation<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/evupdate-1\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"evupdate - Product Documentation\" \/>\n<meta property=\"og:description\" content=\"Modify the field values of an existing issue SYNOPSIS evupdate [-n] evupdate [-n][-i] [field1=value1 field2=value2 &#8230; fieldn=valuen] [q] evupdate [-n] -e [-v] [-f &lt;mytemplate&gt;] DESCRIPTION This command allows a user to modify an existing issue in the ExtraView database. All permissions and business rules, including email notification, are implemented the same way through the CLI...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/evupdate-1\/\" \/>\n<meta property=\"og:site_name\" content=\"Product Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2025-03-05T01:00:25+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/evupdate-1\/\",\"url\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/evupdate-1\/\",\"name\":\"evupdate - Product Documentation\",\"isPartOf\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\"},\"datePublished\":\"2024-02-15T22:53:34+00:00\",\"dateModified\":\"2025-03-05T01:00:25+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/evupdate-1\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/evupdate-1\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/evupdate-1\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/docs.extraview.com\/v25\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"ExtraView 25\",\"item\":\"https:\/\/docs.extraview.com\/v25\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Command Line Interface\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"evupdate\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\",\"url\":\"https:\/\/docs.extraview.com\/v25\/\",\"name\":\"ExtraView Product Documentation\",\"description\":\"ExtraView Documentation\",\"publisher\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/docs.extraview.com\/v25\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#organization\",\"name\":\"ExtraView Corporation\",\"url\":\"https:\/\/docs.extraview.com\/v25\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png\",\"contentUrl\":\"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png\",\"width\":512,\"height\":512,\"caption\":\"ExtraView Corporation\"},\"image\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"evupdate - Product Documentation","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/evupdate-1\/","og_locale":"en_US","og_type":"article","og_title":"evupdate - Product Documentation","og_description":"Modify the field values of an existing issue SYNOPSIS evupdate [-n] evupdate [-n][-i] [field1=value1 field2=value2 &#8230; fieldn=valuen] [q] evupdate [-n] -e [-v] [-f &lt;mytemplate&gt;] DESCRIPTION This command allows a user to modify an existing issue in the ExtraView database. All permissions and business rules, including email notification, are implemented the same way through the CLI...","og_url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/evupdate-1\/","og_site_name":"Product Documentation","article_modified_time":"2025-03-05T01:00:25+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/evupdate-1\/","url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/evupdate-1\/","name":"evupdate - Product Documentation","isPartOf":{"@id":"https:\/\/docs.extraview.com\/v25\/#website"},"datePublished":"2024-02-15T22:53:34+00:00","dateModified":"2025-03-05T01:00:25+00:00","breadcrumb":{"@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/evupdate-1\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/evupdate-1\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/evupdate-1\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/docs.extraview.com\/v25\/"},{"@type":"ListItem","position":2,"name":"ExtraView 25","item":"https:\/\/docs.extraview.com\/v25\/"},{"@type":"ListItem","position":3,"name":"Command Line Interface","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/"},{"@type":"ListItem","position":4,"name":"evupdate"}]},{"@type":"WebSite","@id":"https:\/\/docs.extraview.com\/v25\/#website","url":"https:\/\/docs.extraview.com\/v25\/","name":"ExtraView Product Documentation","description":"ExtraView Documentation","publisher":{"@id":"https:\/\/docs.extraview.com\/v25\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/docs.extraview.com\/v25\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/docs.extraview.com\/v25\/#organization","name":"ExtraView Corporation","url":"https:\/\/docs.extraview.com\/v25\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/","url":"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png","contentUrl":"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png","width":512,"height":512,"caption":"ExtraView Corporation"},"image":{"@id":"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/"}}]}},"taxonomy_info":[],"featured_image_src_large":false,"author_info":{"display_name":"carl.koppel","author_link":"https:\/\/docs.extraview.com\/v25\/author\/carl-koppel\/"},"comment_info":0,"_links":{"self":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24314","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/comments?post=24314"}],"version-history":[{"count":0,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24314\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24277"}],"wp:attachment":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/media?parent=24314"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}