{"id":24182,"date":"2024-02-15T14:53:34","date_gmt":"2024-02-15T22:53:34","guid":{"rendered":"https:\/\/docs.extraview.com\/v25\/book\/file-import-data-dictionary-1\/"},"modified":"2025-02-14T10:23:25","modified_gmt":"2025-02-14T18:23:25","slug":"file-import-data-dictionary-1","status":"publish","type":"page","link":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/import-export-1\/file-import-data-dictionary-1\/","title":{"rendered":"File Import &#8211; Data Dictionary"},"content":{"rendered":"<p>The purpose of this feature is to create new fields in the data dictionary from a spreadsheet. When creating a large ExtraView installation, there is often a significant amount of replication with similar fields, but with different <b>names<\/b>. You are able to create a spreadsheet with a set of fields plus their attributes from a comma- or tab-delimited file, and upload this file into ExtraView. Note that the template that you download is a Microsoft Excel spreadsheet. This allows the use of validation within the spreadsheet while preparing the input file. <b>You must save the file as a comma-delimited or tab-delimited file before you import it back into ExtraView.<\/b><\/p>\n<p>Significant validation is performed on the file you upload, with a similar two-step process as in uploading issue data. You are also able to save the templates you create for future use, allowing you to prepare fields in batches, and upload them as and when you are prepared.<\/p>\n<p><img decoding=\"async\" src=\"\/v25\/extraview-media\/images\/ag\/import_export\/importing_files_spreadsheet.png\" width=\"90%\" \/><\/p>\n<p><span class=\"imageCaption\">Importing fields from a spreadsheet<\/span><\/p>\n<h3>\n\tPreparing the import file<\/h3>\n<p>Use Microsoft Excel or a similar spreadsheet tool to create your input data. An empty spreadsheet for use as an input file can be downloaded from within the utility. <b>You must save the file as a comma-delimited or tab-delimited file before you import it back into ExtraView<\/b> See the previous screenshot for details of how to download an empty spreadsheet.<\/p>\n<p><img decoding=\"async\" src=\"\/v25\/extraview-media\/images\/ag\/import_export\/preparing_import_file.png\" width=\"100%\" \/><\/p>\n<p>Similar to the web-based input for the data dictionary, the following fields are available for input:<\/p>\n<table class=\"border\">\n<tbody>\n<tr class=\"tableHeaderRow\">\n<td>\n\t\t\t\tField Name<\/td>\n<td>\n\t\t\t\tDescription<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tArea<\/td>\n<td>\n\t\t\t\tThe title of the Business Area for the field. If the field is to be global, use * <b>Global Area<\/b> *. This field is required<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tProject<\/td>\n<td>\n\t\t\t\tThe title of the Project within the Business Area to which you want to load the fields. If you are creating a global field, this will be * <b>Master Project<\/b> * If you are loading the fields for use across a single Business Area, this will be the default Project for the Business Area. If you want the field to only be visible within a single Project, then you will use the title of that Project. This field is required<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tField belongs to<\/td>\n<td>\n\t\t\t\tThis must be set to <b>Issue records<\/b> if you want the field to be available to the main body of issues, or to <b>Repeating row records<\/b> if you want to use the field on a repeating row. This field is required<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tFixed name<\/td>\n<td>\n\t\t\t\tThis is the fixed name for the field. Names can only consist of the characters A to Z, 0 to 9, and \u2018_\u2019. The first character of a fixed name must be alphabetic and the name can be up to 30 characters in length. Names cannot contain characters from non-English alphabets. A further restriction is that you may not have two underscore characters together in a name. This field is required<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tTitle to display<\/td>\n<td>\n\t\t\t\tThe display title for the field. This may be up to 100 characters long and may contain any characters such as punctuation. This field is required<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tDisplay type<\/td>\n<td>\n\t\t\t\tThis must map to a valid display type within ExtraView. This field is required. The valid entries are:<\/p>\n<ul>\n<li>\n\t\t\t\t\t\tButton<\/li>\n<li>\n\t\t\t\t\t\tCheckbox<\/li>\n<li>\n\t\t\t\t\t\tCurrency<\/li>\n<li>\n\t\t\t\t\t\tCustom<\/li>\n<li>\n\t\t\t\t\t\tDate<\/li>\n<li>\n\t\t\t\t\t\tDay<\/li>\n<li>\n\t\t\t\t\t\tDecimal<\/li>\n<li>\n\t\t\t\t\t\tHTML Area<\/li>\n<li>\n\t\t\t\t\t\tImage<\/li>\n<li>\n\t\t\t\t\t\tLabel<\/li>\n<li>\n\t\t\t\t\t\tList<\/li>\n<li>\n\t\t\t\t\t\tLog Area<\/li>\n<li>\n\t\t\t\t\t\tNumber<\/li>\n<li>\n\t\t\t\t\t\tPop-up<\/li>\n<li>\n\t\t\t\t\t\tPrint Text<\/li>\n<li>\n\t\t\t\t\t\tRadio Button &#8211; Horizontal<\/li>\n<li>\n\t\t\t\t\t\tRadio Button &#8211; Vertical<\/li>\n<li>\n\t\t\t\t\t\tTab<\/li>\n<li>\n\t\t\t\t\t\tText Area<\/li>\n<li>\n\t\t\t\t\t\tText Field<\/li>\n<li>\n\t\t\t\t\t\tTime Interval<\/li>\n<li>\n\t\t\t\t\t\tUser<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tAlias of<\/td>\n<td>\n\t\t\t\tIf the field is to be created as an alias of another field, and the other field is of type list, tab, or radio button then place the other field name in this column<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tAllow Selection on reports<\/td>\n<td>\n\t\t\t\tCreate as Yes or No<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tTotal field on reports<\/td>\n<td>\n\t\t\t\tCreate as Yes or No<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tRemember last value<\/td>\n<td>\n\t\t\t\tCreate as Yes or No<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tMultiple value<\/td>\n<td>\n\t\t\t\tCreate as Yes or No<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tFilter criteria<\/td>\n<td>\n\t\t\t\tCreate as Yes or No<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tIs sortable<\/td>\n<td>\n\t\t\t\tCreate as Yes or No<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tDisplay as URL<\/td>\n<td>\n\t\t\t\tCreate as Yes or No<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tURL<\/td>\n<td>\n\t\t\t\tIf you are using the field as a display as URL, then provide the URL here<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tHelp Text<\/td>\n<td>\n\t\t\t\tThe help text for the tooltip on the field<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tHelp URL<\/td>\n<td>\n\t\t\t\tThe URL to use if you are providing your own help on the field<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tCurrency unit<\/td>\n<td>\n\t\t\t\tThe currency unit for the field<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tCurrency symbol<\/td>\n<td>\n\t\t\t\tThe currency symbol to be used for the field<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tThousands separator<\/td>\n<td>\n\t\t\t\tCreate as Yes or No<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tNegative sign<\/td>\n<td>\n\t\t\t\tCreate as Yes or No<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tInternal precision<\/td>\n<td>\n\t\t\t\tA number from -24 to 10 indicating how many digits of precision should be maintained for internal computations with this field<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tReport precision<\/td>\n<td>\n\t\t\t\tA number from -24 to 10 indicating how many digits of precision should be displayed on reports or read-only displays of this field<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tRounding mode<\/td>\n<td>\n\t\t\t\tSelect from one of the following list:<\/p>\n<ul>\n<li>\n\t\t\t\t\t\tRound Up<\/li>\n<li>\n\t\t\t\t\t\tRound Down<\/li>\n<li>\n\t\t\t\t\t\tRound Floor<\/li>\n<li>\n\t\t\t\t\t\tRound Half Up<\/li>\n<li>\n\t\t\t\t\t\tRound Half Down<\/li>\n<li>\n\t\t\t\t\t\tRound Half Even<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n\t\t\t\tPercentage type<\/td>\n<td>\n\t\t\t\tCreate as Yes or No<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3>\n\tUploading the File and Providing any Mappings<\/h3>\n<p>This utility is very similar in usage to importing issue data. Please see the previous section in this guide for full instructions.<\/p>\n<p><img decoding=\"async\" src=\"\/v25\/extraview-media\/images\/ag\/import_export\/importing_fields_data_dictionary.png\" width=\"90%\" \/><\/p>\n<p><span class=\"imageCaption\">Importing fields into the data dictionary<\/span><\/p>\n<p>The key difference in using this utility and using the import issue data feature is that there is a prompt on the screen, <b>Override existing field<\/b>. If you check this, then you may update the properties of the field given in the <b>Fixed name<\/b> column.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The purpose of this feature is to create new fields in the data dictionary from a spreadsheet. When creating a large ExtraView installation, there is often a significant amount of replication with similar fields, but with different names. You are able to create a spreadsheet with a set of fields plus their attributes from a&#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":24165,"menu_order":8,"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-24182","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>File Import - Data Dictionary - 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\/import-export-1\/file-import-data-dictionary-1\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"File Import - Data Dictionary - Product Documentation\" \/>\n<meta property=\"og:description\" content=\"The purpose of this feature is to create new fields in the data dictionary from a spreadsheet. When creating a large ExtraView installation, there is often a significant amount of replication with similar fields, but with different names. You are able to create a spreadsheet with a set of fields plus their attributes from a...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/import-export-1\/file-import-data-dictionary-1\/\" \/>\n<meta property=\"og:site_name\" content=\"Product Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2025-02-14T18:23: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=\"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\/import-export-1\/file-import-data-dictionary-1\/\",\"url\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/import-export-1\/file-import-data-dictionary-1\/\",\"name\":\"File Import - Data Dictionary - Product Documentation\",\"isPartOf\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\"},\"datePublished\":\"2024-02-15T22:53:34+00:00\",\"dateModified\":\"2025-02-14T18:23:25+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/import-export-1\/file-import-data-dictionary-1\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/import-export-1\/file-import-data-dictionary-1\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/import-export-1\/file-import-data-dictionary-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\":\"Administration Guide\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Import \/ Export\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/import-export-1\/\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"File Import &#8211; Data Dictionary\"}]},{\"@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":"File Import - Data Dictionary - 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\/import-export-1\/file-import-data-dictionary-1\/","og_locale":"en_US","og_type":"article","og_title":"File Import - Data Dictionary - Product Documentation","og_description":"The purpose of this feature is to create new fields in the data dictionary from a spreadsheet. When creating a large ExtraView installation, there is often a significant amount of replication with similar fields, but with different names. You are able to create a spreadsheet with a set of fields plus their attributes from a...","og_url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/import-export-1\/file-import-data-dictionary-1\/","og_site_name":"Product Documentation","article_modified_time":"2025-02-14T18:23:25+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\/import-export-1\/file-import-data-dictionary-1\/","url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/import-export-1\/file-import-data-dictionary-1\/","name":"File Import - Data Dictionary - Product Documentation","isPartOf":{"@id":"https:\/\/docs.extraview.com\/v25\/#website"},"datePublished":"2024-02-15T22:53:34+00:00","dateModified":"2025-02-14T18:23:25+00:00","breadcrumb":{"@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/import-export-1\/file-import-data-dictionary-1\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/import-export-1\/file-import-data-dictionary-1\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/import-export-1\/file-import-data-dictionary-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":"Administration Guide","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/"},{"@type":"ListItem","position":4,"name":"Import \/ Export","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/import-export-1\/"},{"@type":"ListItem","position":5,"name":"File Import &#8211; Data Dictionary"}]},{"@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\/24182","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=24182"}],"version-history":[{"count":0,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24182\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24165"}],"wp:attachment":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/media?parent=24182"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}