{"id":23972,"date":"2024-02-15T14:53:34","date_gmt":"2024-02-15T22:53:34","guid":{"rendered":"https:\/\/docs.extraview.com\/v25\/book\/importing-issues-within-add-and-edit-screens-0\/"},"modified":"2025-03-02T20:55:02","modified_gmt":"2025-03-03T04:55:02","slug":"importing-issues-within-add-and-edit-screens-0","status":"publish","type":"page","link":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/design-center-4\/add-edit-layouts-1\/importing-issues-within-add-and-edit-screens-0\/","title":{"rendered":"Importing Issues within Add and Edit Screens"},"content":{"rendered":"<p><a href=\"v25\/importing-issues-add-or-edit-screen-0\/\">Click for end user documentation<\/a><\/p>\n<p>It can be useful as part of a workflow to configure the ability for an end user to directly import a file containing issues directly from an <em>add<\/em> or <em>edit<\/em> screen.\u00a0 This page discusses how to configure this feature.<\/p>\n<p>As an end user feature there are some deliberate limitations, compared to the administrative function to import issues.\u00a0 These limitations make it much simpler for the user:<\/p>\n<ul>\n<li>The upload uses a predefined import template<\/li>\n<li>All the field mappings are therefore done for the end user<\/li>\n<li>There is no need to provide the end user with administrative access.<\/li>\n<\/ul>\n<p>The process to configure this feature is as follows:<\/p>\n<h3>Step 1 &#8211; Create an empty import file with the field titles the end user will import<\/h3>\n<p>This is useful for two reasons.\u00a0 First, the file can be provided to end users as an empty container into which the issues they want to create can be entered.\u00a0 Secondly, this provides the basis for providing field mappings, especially if the titles you want the end user to use do not match the titles within the ExtraView database.\u00a0 As an example, we want to create a list of customers and their information:<\/p>\n<p><img decoding=\"async\" style=\"width: 70%;\" src=\"\/v25\/extraview-media\/images\/ag\/fields_and_layouts\/import-template.png\" alt=\"\" \/><\/p>\n<p>Save this file with a type of CSV.\u00a0 For our example, a name of customer-list.csv is used.<\/p>\n<h3>Step 2 &#8211; Create the import template with the Administration utility<\/h3>\n<p>This is created as a standard template within the <strong>File Import &#8211; Issue Data<\/strong> administration utility.\u00a0 See <a href=\"v25\/file-import-issue-data-1\/\">here <\/a>for details.\u00a0 Note:<\/p>\n<ul>\n<li>The Business Area and Project should be the same as the one used as the user will use to add the issues as part of their workflow<\/li>\n<li>The mode should be <strong>Insert<\/strong><\/li>\n<li>Choose the file you created in the last step to upload<\/li>\n<li>Click the <strong>Create Template &amp; Upload File<\/strong> button<\/li>\n<li>After mapping the field titles in your import file to the ExtraView fields you will see a screen similar to:<img decoding=\"async\" style=\"width: 100%;\" src=\"\/v25\/extraview-media\/images\/ag\/fields_and_layouts\/import-mapping.png\" alt=\"\" \/><\/li>\n<li>Click the <strong>Save Mappings<\/strong> button<\/li>\n<\/ul>\n<p>For more information on configuring file import templates, click <a href=\"v25\/file-import-issue-data-1\/\">here<\/a>.<\/p>\n<h3>Step 3 &#8211; Use a Predefined Button, or Define a New Button within the Data Dictionary<\/h3>\n<p>This button will appear to the end user to activate the import process.<\/p>\n<p>A button name UPLOAD_FILE_BTN is provided within the Data Dictionary and can be used.\u00a0 If needed, you can alter the title <strong>Import Issues<\/strong> and any other attribute of the field, or you can use the remainder of the instructions in this section to define a new button field.<\/p>\n<p>If you want to create a field from scratch:<\/p>\n<ul>\n<li>Navigate to the <strong>Labels \/ Buttons<\/strong> tab of the <strong>Data Dictionary <\/strong>within <strong>Administration<\/strong><\/li>\n<li>Add a new Menubar Button.\u00a0 For our example, we will name this as <strong>IMPORT_CUSTOMER_BTN<\/strong> and it will have a title of <strong>Import Customer List<\/strong><\/li>\n<li>Edit the button you just created and add an <strong>Action Type<\/strong> of <strong>ExtraView File Upload<\/strong><\/li>\n<li>Select the file upload template you created in Step 2 from the list provided<\/li>\n<li>Provide <strong>Help Text<\/strong> &#8211; These are the instructions that will appear to the end user of the import.\u00a0 This is a rich text field<\/li>\n<li>Click the <strong>Update <\/strong>button<\/li>\n<li>Your screen will be similar to this:<img decoding=\"async\" style=\"width: 100%;\" src=\"\/v25\/extraview-media\/images\/ag\/fields_and_layouts\/import-dd.png\" alt=\"\" \/><\/li>\n<\/ul>\n<h3>Step 4 &#8211; Place the Button on an <em>add<\/em> or <em>edit<\/em> Screen Layout<\/h3>\n<p>Navigate to the layout where the layout is to be placed and add the button field you created to the layout.<\/p>\n<p>One optional feature here is that you can embed a report, typically showing the results of the import so that the end user can see the results of their import directly on the report.<\/p>\n<ul>\n<li>If you want to embed a report with the results, create the report first.\u00a0 Typically, the report will use the <strong>Business Area<\/strong>, <strong>Project <\/strong>and the <strong>Date Created <\/strong>as filters, although any report can be used<\/li>\n<li>Place the button field on the layout<\/li>\n<li>If embedding a report, use the <strong>Layout Cell Attributes<\/strong> to select the report to be embedded, along with any other report attributes you wish to set<\/li>\n<li>Add the layout cell attribute named\u00a0<strong>Drilldown Target<\/strong> to the menubar button you created and select the embedded report for the Drilldown Target. This causes the action to refresh the results of the embedded report once the file import has completed.<\/li>\n<\/ul>\n<h3>Step 5 &#8211; Using the Import Functionality<\/h3>\n<p>As an end user function, c<a href=\"v25\/importing-issues-add-or-edit-screen-0\">lick here for end user documentation<\/a>.<\/p>\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Click for end user documentation It can be useful as part of a workflow to configure the ability for an end user to directly import a file containing issues directly from an add or edit screen.\u00a0 This page discusses how to configure this feature. As an end user feature there are some deliberate limitations, compared&#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":23946,"menu_order":0,"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-23972","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>Importing Issues within Add and Edit Screens - 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\/administration-guide-1\/site-configuration-menu-1\/design-center-4\/add-edit-layouts-1\/importing-issues-within-add-and-edit-screens-0\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Importing Issues within Add and Edit Screens - Product Documentation\" \/>\n<meta property=\"og:description\" content=\"Click for end user documentation It can be useful as part of a workflow to configure the ability for an end user to directly import a file containing issues directly from an add or edit screen.\u00a0 This page discusses how to configure this feature. As an end user feature there are some deliberate limitations, compared...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/design-center-4\/add-edit-layouts-1\/importing-issues-within-add-and-edit-screens-0\/\" \/>\n<meta property=\"og:site_name\" content=\"Product Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2025-03-03T04:55:02+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=\"4 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\/administration-guide-1\/site-configuration-menu-1\/design-center-4\/add-edit-layouts-1\/importing-issues-within-add-and-edit-screens-0\/\",\"url\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/design-center-4\/add-edit-layouts-1\/importing-issues-within-add-and-edit-screens-0\/\",\"name\":\"Importing Issues within Add and Edit Screens - Product Documentation\",\"isPartOf\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\"},\"datePublished\":\"2024-02-15T22:53:34+00:00\",\"dateModified\":\"2025-03-03T04:55:02+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/design-center-4\/add-edit-layouts-1\/importing-issues-within-add-and-edit-screens-0\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/design-center-4\/add-edit-layouts-1\/importing-issues-within-add-and-edit-screens-0\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/design-center-4\/add-edit-layouts-1\/importing-issues-within-add-and-edit-screens-0\/#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\":\"Administration Guide\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Site Configuration Menu\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"Design Center\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/design-center-4\/\"},{\"@type\":\"ListItem\",\"position\":6,\"name\":\"Add &#038; Edit Layouts\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/design-center-4\/add-edit-layouts-1\/\"},{\"@type\":\"ListItem\",\"position\":7,\"name\":\"Importing Issues within Add and Edit Screens\"}]},{\"@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":"Importing Issues within Add and Edit Screens - 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\/administration-guide-1\/site-configuration-menu-1\/design-center-4\/add-edit-layouts-1\/importing-issues-within-add-and-edit-screens-0\/","og_locale":"en_US","og_type":"article","og_title":"Importing Issues within Add and Edit Screens - Product Documentation","og_description":"Click for end user documentation It can be useful as part of a workflow to configure the ability for an end user to directly import a file containing issues directly from an add or edit screen.\u00a0 This page discusses how to configure this feature. As an end user feature there are some deliberate limitations, compared...","og_url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/design-center-4\/add-edit-layouts-1\/importing-issues-within-add-and-edit-screens-0\/","og_site_name":"Product Documentation","article_modified_time":"2025-03-03T04:55:02+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/design-center-4\/add-edit-layouts-1\/importing-issues-within-add-and-edit-screens-0\/","url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/design-center-4\/add-edit-layouts-1\/importing-issues-within-add-and-edit-screens-0\/","name":"Importing Issues within Add and Edit Screens - Product Documentation","isPartOf":{"@id":"https:\/\/docs.extraview.com\/v25\/#website"},"datePublished":"2024-02-15T22:53:34+00:00","dateModified":"2025-03-03T04:55:02+00:00","breadcrumb":{"@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/design-center-4\/add-edit-layouts-1\/importing-issues-within-add-and-edit-screens-0\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/design-center-4\/add-edit-layouts-1\/importing-issues-within-add-and-edit-screens-0\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/design-center-4\/add-edit-layouts-1\/importing-issues-within-add-and-edit-screens-0\/#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":"Administration Guide","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/"},{"@type":"ListItem","position":4,"name":"Site Configuration Menu","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/"},{"@type":"ListItem","position":5,"name":"Design Center","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/design-center-4\/"},{"@type":"ListItem","position":6,"name":"Add &#038; Edit Layouts","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/design-center-4\/add-edit-layouts-1\/"},{"@type":"ListItem","position":7,"name":"Importing Issues within Add and Edit Screens"}]},{"@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\/23972","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=23972"}],"version-history":[{"count":0,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/23972\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/23946"}],"wp:attachment":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/media?parent=23972"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}