{"id":24417,"date":"2024-02-15T14:53:34","date_gmt":"2024-02-15T22:53:34","guid":{"rendered":"https:\/\/docs.extraview.com\/v25\/book\/converting-text-area-fields-html-area-fields-1\/"},"modified":"2025-02-17T17:07:39","modified_gmt":"2025-02-18T01:07:39","slug":"converting-text-area-fields-html-area-fields-1","status":"publish","type":"page","link":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/converting-text-area-fields-html-area-fields-1\/","title":{"rendered":"Converting Text Area Fields to HTML Area Fields"},"content":{"rendered":"<p>Providing a rich text environment to users is often more productive that allowing them to enter and update pure text.&nbsp; ExtraView&#8217;s HTML Area and Log Area field types have an extensive range of features that go beyond text.&nbsp; The key features are:<\/p>\n<ul>\n<li>\n\t\tFormatting of text, including bold, underline and italics.&nbsp; Text may be in different fonts, colors, sizes and styles.&nbsp; Text may be justified to the left, right, centered or full-justified<\/li>\n<li>\n\t\tText may be indented and bulleted<\/li>\n<li>\n\t\tImages may be embedded directly into the body of the field, placed there via copy and paste or by selection from files<\/li>\n<li>\n\t\tEntire documents \/ images may be embedded within the body of the field<\/li>\n<li>\n\t\tLinks to web pages may be inserted<\/li>\n<li>\n\t\tTables of any number of rows \/ columns may be created<\/li>\n<\/ul>\n<p>Note that Log Area fields must have the option to <strong>Present as HTML<\/strong> set to provide rich text.<\/p>\n<p>When configuring new layouts, the administrator may create new fields with the HTML Area display type and to create new Log Area fields with the <strong>Present as HTML<\/strong> option.&nbsp; When upgrading existing installations, it is possible to convert these existing Text Area and Log Area fields to utilize richh text, using the following utility.&nbsp; You must be an Administrator to perform this task, and you must be able to run the Java utility that ExtraView provides to perform the conversion.&nbsp; It is not recommended that you simply alter the display type of an existing field, especially if your existing data contains any references to HTML codes, as these will not appear correctly after the alteration of the field type.<\/p>\n<ul>\n<li>\n\t\tIt is strongly recommended that you take a backup of the entire ExtraView database before beginning this process and that the system is offline to users while you perform the conversion.&nbsp; The utility offers the ability to back up the database table that contains the text<\/li>\n<li>\n\t\tThe utility must be run on one field at one time.&nbsp; If you wish to convert multiple fields, run the utility once per field<\/li>\n<li>\n\t\tThe utility will work with Text Area and Log Area display type of fields.&nbsp; After the conversion utility is run, use the data dictionary to update the display type of Text Area fields to HTML Area fields.&nbsp; With Log Area fields, you enable the <strong>Present as HTML<\/strong> option after you run the utility<\/li>\n<li>\n\t\tExtraView provides a batch file to run the file on Windows operating systems, and a shell file to run the file on Linux\/Unix operating systems<\/li>\n<li>\n\t\tThe following is an example of the conversion process for Windows:<\/p>\n<ul>\n<li>\n\t\t\t\tEnter a command window<br \/>\n\t\t\t\t&nbsp;<\/li>\n<li>\n\t\t\t\tNavigate to your ExtraView root directory.&nbsp; Alter the path to match your Apache Tomcat folder. The example assumes your root ExtraView directory is named <code>evj<\/code><\/p>\n<p><code>cd C:\\ApacheHome\\apache-tomcat-8.5.12\\webapps\\evj\\WEB-INF\\data<\/code><\/p>\n<\/li>\n<li>\n\t\t\t\tIf not already set up, create the following environment variables, again matching the locations to those of your system:<\/p>\n<p><code>set TOMCAT_HOME=\"C:\\ApacheHome\\apache-tomcat-8.5.12\"<\/code><\/p>\n<p><code>set JAVA_HOME=\"c:\\PROGRA~1\\java\\jdk1.8.0_121\"<\/code><\/p>\n<p>\t\t\t\t<code>set EV_BASE=\"C:\\ApacheHome\\apache-tomcat-8.5.12\\webapps\\evj\"<\/code><br \/>\n\t\t\t\t&nbsp;<\/li>\n<li>\n\t\t\t\tRun the conversion utility upon the field you wish to update.&nbsp; The optional <code>-b<\/code> parameter takes a backup of the fields that are being converted and stores them in a database table.&nbsp; The <code>field_name<\/code> is the name of the field being converted<\/p>\n<p>\t\t\t\t<code>doTextToHTMLConverter.bat [-b] field_name<\/code><br \/>\n\t\t\t\t&nbsp;<\/li>\n<li>\n\t\t\t\tOnce the conversion program is complete, sign on to ExtraView as an administrator and alter the display type of the Text Area field you converted from Text Area to HTML Area.&nbsp; With Log Area fields, you enable the <strong>Present as HTML<\/strong> option after you run the utility<br \/>\n\t\t\t\t&nbsp;<\/li>\n<li>\n\t\t\t\tYou may also want to adjust the size of the field as it is used in various layouts, either with a global data dictionary attribute or with layout cell attributes on the individual layouts.&nbsp; HTML Area fields often look better when they are wider than their Text Area counterparts.&nbsp; For the standard toolbar used, a SIZE layout cell attribute of 160 is typically correct for all browsers to display the rich text correctly<br \/>\n\t\t\t\t&nbsp;<\/li>\n<li>\n\t\t\t\tPerform sample checks of the field you have converted to ensure the process was successful.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Providing a rich text environment to users is often more productive that allowing them to enter and update pure text.&nbsp; ExtraView&#8217;s HTML Area and Log Area field types have an extensive range of features that go beyond text.&nbsp; The key features are: Formatting of text, including bold, underline and italics.&nbsp; Text may be in different&#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":24373,"menu_order":66,"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-24417","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>Converting Text Area Fields to HTML Area Fields - 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\/installation-upgrade-guide-1\/software-installation-upgrades-1\/converting-text-area-fields-html-area-fields-1\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Converting Text Area Fields to HTML Area Fields - Product Documentation\" \/>\n<meta property=\"og:description\" content=\"Providing a rich text environment to users is often more productive that allowing them to enter and update pure text.&nbsp; ExtraView&#8217;s HTML Area and Log Area field types have an extensive range of features that go beyond text.&nbsp; The key features are: Formatting of text, including bold, underline and italics.&nbsp; Text may be in different...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/converting-text-area-fields-html-area-fields-1\/\" \/>\n<meta property=\"og:site_name\" content=\"Product Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2025-02-18T01:07:39+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\/installation-upgrade-guide-1\/software-installation-upgrades-1\/converting-text-area-fields-html-area-fields-1\/\",\"url\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/converting-text-area-fields-html-area-fields-1\/\",\"name\":\"Converting Text Area Fields to HTML Area Fields - Product Documentation\",\"isPartOf\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\"},\"datePublished\":\"2024-02-15T22:53:34+00:00\",\"dateModified\":\"2025-02-18T01:07:39+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/converting-text-area-fields-html-area-fields-1\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/converting-text-area-fields-html-area-fields-1\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/converting-text-area-fields-html-area-fields-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\":\"Installation &#038; Upgrade Guide\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Software Installation &#038; Upgrades\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"Converting Text Area Fields to HTML Area Fields\"}]},{\"@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":"Converting Text Area Fields to HTML Area Fields - 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\/installation-upgrade-guide-1\/software-installation-upgrades-1\/converting-text-area-fields-html-area-fields-1\/","og_locale":"en_US","og_type":"article","og_title":"Converting Text Area Fields to HTML Area Fields - Product Documentation","og_description":"Providing a rich text environment to users is often more productive that allowing them to enter and update pure text.&nbsp; ExtraView&#8217;s HTML Area and Log Area field types have an extensive range of features that go beyond text.&nbsp; The key features are: Formatting of text, including bold, underline and italics.&nbsp; Text may be in different...","og_url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/converting-text-area-fields-html-area-fields-1\/","og_site_name":"Product Documentation","article_modified_time":"2025-02-18T01:07:39+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\/installation-upgrade-guide-1\/software-installation-upgrades-1\/converting-text-area-fields-html-area-fields-1\/","url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/converting-text-area-fields-html-area-fields-1\/","name":"Converting Text Area Fields to HTML Area Fields - Product Documentation","isPartOf":{"@id":"https:\/\/docs.extraview.com\/v25\/#website"},"datePublished":"2024-02-15T22:53:34+00:00","dateModified":"2025-02-18T01:07:39+00:00","breadcrumb":{"@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/converting-text-area-fields-html-area-fields-1\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/converting-text-area-fields-html-area-fields-1\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/converting-text-area-fields-html-area-fields-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":"Installation &#038; Upgrade Guide","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/"},{"@type":"ListItem","position":4,"name":"Software Installation &#038; Upgrades","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/"},{"@type":"ListItem","position":5,"name":"Converting Text Area Fields to HTML Area Fields"}]},{"@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\/24417","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=24417"}],"version-history":[{"count":0,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24417\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24373"}],"wp:attachment":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/media?parent=24417"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}