{"id":24519,"date":"2024-02-15T14:53:34","date_gmt":"2024-02-15T22:53:34","guid":{"rendered":"https:\/\/docs.extraview.com\/v25\/book\/ucaddinit-1\/"},"modified":"2024-02-15T14:53:34","modified_gmt":"2024-02-15T22:53:34","slug":"ucaddinit-1","status":"publish","type":"page","link":"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/user-custom-methods-1\/ucaddinit-1\/","title":{"rendered":"ucAddInit"},"content":{"rendered":"<h3>\n\tPurpose<\/h3>\n<p>ucAddInit is called as the Add routine is first entered. This method can be used to provide processing before the <em>add issue<\/em> screen is launched.<\/p>\n<h3>\n\tApplies To<\/h3>\n<p><em>Add Issue<\/em> screen<\/p>\n<h3>\n\tSignature<\/h3>\n<pre class=\"code\">\r\n <code>public void ucAddInit(SesameSession session,  \/\/ contains values of form elements\r\n                       HashMap values)         \/\/ selected Vals hashmap<\/code>\r\n<\/pre>\n<h3>\n\tNotes<\/h3>\n<p>The business rule directive &lt;== load ==&gt; in conjunction with the SCREEN_NAME equaling ADD provides a similar opportunity to influence the <em>add<\/em> screen before it is loaded.<\/p>\n<h3>\n\tExample<\/h3>\n<p>&lt;== load ==&gt; if (SCREEN_NAME = &#8216;ADD&#8217;) { FIELD_NAME = VALUE; } This example shows how to set the values of data on the form after reading data from the both the current user and that user&#8217;s manager&#8217;s account. This will happen before the <em>add issue<\/em> screen is entered, thus pre-populating the &#8220;Manager&#8217;s Work Phone&#8221; and &#8220;Manager&#8217;s Cell Phone&#8221; fields, depending upon the user accessing the screen.<\/p>\n<pre class=\"code\">\r\n <code>public void ucAddInit(SesameSession session,  \/\/ contains values of form elements\r\n                       HashMap values)         \/\/ selected Vals hashmap\r\n{\r\n    \/\/ Call Business Rules\r\n    super.ucAddInit(session, values);\r\n    \r\n    \/\/ Get area &amp; project\r\n    String areaId = (String) values.get(\"AREA\");\r\n    String projectId = (String) values.get(\"PROJECT\");\r\n    projectId = projectId.substring(projectId.indexOf(\"|\") + 1, projectId.length());\r\n    Z.log.writeToLog(Z.log.WARN, \"UC: ucAddInit - areaId=\" + areaId +\r\n        \", projectId=\" + projectId);\r\n    \r\n    \/\/ Check for specific area &amp; project\r\n    if (A_CUSTOMER_ISSUES.equals(areaId) &amp;&amp; P_CUSTOMER_ISSUES_DATA.equals(projectId) )\r\n    {\r\n        Connection dbConn = null;\r\n        SecurityUser originator = null;\r\n        SecurityUser manager = null;\r\n        String wPhone = null;\r\n        String cPhone = null;\r\n        \r\n        try\r\n        {\r\n            \/\/ Get database connection\r\n            dbConn = Z.pool.getConnection(\"ucAddInit\");\r\n            \r\n            \/\/ Lookup originator's manager User ID,\r\n            \/\/ which is stored in the account USER_DEFINED_1 field\r\n            originator = SecurityUser.getReference(dbConn, session.getUserId());    \r\n            manager = SecurityUser.getReference(dbConn, originator.getUserField1());\r\n            \r\n            \/\/ If manager's account found, get work and cell phone info\r\n            if (manager != null) {\r\n                wPhone = manager.getWorkTelephone();\r\n                cPhone = manager.getCellPhone();\r\n            }\r\n            Z.log.writeToLog(Z.log.WARN, \"UC: ucAddInit - wPhone=\" + wPhone +\r\n                \", cPhone=\" + cPhone);\r\n            \r\n            \/\/ Set form data\r\n            values.put(\"MANAGER_WORK_PHONE\", wPhone);\r\n            values.put(\"MANAGER_CELL_PHONE\", cPhone);\r\n            \r\n        } catch (Exception e) {\r\n            Z.log.writeToLog(Z.log.ERROR, \"UC: ucAddInit Exception: \" + e);\r\n            ErrorWriter.write(e, ErrorWriter.LOGERR);\r\n            \r\n        } finally {\r\n            \/\/ Close the database connection\r\n            if (dbConn != null) { Z.pool.close(dbConn); }\r\n        }\r\n    }\r\n}<\/code>\r\n<\/pre>\n","protected":false},"excerpt":{"rendered":"<p>Purpose ucAddInit is called as the Add routine is first entered. This method can be used to provide processing before the add issue screen is launched. Applies To Add Issue screen Signature public void ucAddInit(SesameSession session, \/\/ contains values of form elements HashMap values) \/\/ selected Vals hashmap Notes The business rule directive &lt;== load&#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":24510,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_lmt_disableupdate":"","_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-24519","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>ucAddInit - 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\/user-custom-guide-1\/java-interface-1\/user-custom-methods-1\/ucaddinit-1\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"ucAddInit - Product Documentation\" \/>\n<meta property=\"og:description\" content=\"Purpose ucAddInit is called as the Add routine is first entered. This method can be used to provide processing before the add issue screen is launched. Applies To Add Issue screen Signature public void ucAddInit(SesameSession session, \/\/ contains values of form elements HashMap values) \/\/ selected Vals hashmap Notes The business rule directive &lt;== load...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/user-custom-methods-1\/ucaddinit-1\/\" \/>\n<meta property=\"og:site_name\" content=\"Product Documentation\" \/>\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=\"2 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\/user-custom-guide-1\/java-interface-1\/user-custom-methods-1\/ucaddinit-1\/\",\"url\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/user-custom-methods-1\/ucaddinit-1\/\",\"name\":\"ucAddInit - Product Documentation\",\"isPartOf\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\"},\"datePublished\":\"2024-02-15T22:53:34+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/user-custom-methods-1\/ucaddinit-1\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/user-custom-methods-1\/ucaddinit-1\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/user-custom-methods-1\/ucaddinit-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\":\"User Custom Guide\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Java Interface\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"User Custom Methods\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/user-custom-methods-1\/\"},{\"@type\":\"ListItem\",\"position\":6,\"name\":\"ucAddInit\"}]},{\"@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":"ucAddInit - 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\/user-custom-guide-1\/java-interface-1\/user-custom-methods-1\/ucaddinit-1\/","og_locale":"en_US","og_type":"article","og_title":"ucAddInit - Product Documentation","og_description":"Purpose ucAddInit is called as the Add routine is first entered. This method can be used to provide processing before the add issue screen is launched. Applies To Add Issue screen Signature public void ucAddInit(SesameSession session, \/\/ contains values of form elements HashMap values) \/\/ selected Vals hashmap Notes The business rule directive &lt;== load...","og_url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/user-custom-methods-1\/ucaddinit-1\/","og_site_name":"Product Documentation","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/user-custom-methods-1\/ucaddinit-1\/","url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/user-custom-methods-1\/ucaddinit-1\/","name":"ucAddInit - Product Documentation","isPartOf":{"@id":"https:\/\/docs.extraview.com\/v25\/#website"},"datePublished":"2024-02-15T22:53:34+00:00","breadcrumb":{"@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/user-custom-methods-1\/ucaddinit-1\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/user-custom-methods-1\/ucaddinit-1\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/user-custom-methods-1\/ucaddinit-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":"User Custom Guide","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/"},{"@type":"ListItem","position":4,"name":"Java Interface","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/"},{"@type":"ListItem","position":5,"name":"User Custom Methods","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/user-custom-methods-1\/"},{"@type":"ListItem","position":6,"name":"ucAddInit"}]},{"@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\/24519","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=24519"}],"version-history":[{"count":0,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24519\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24510"}],"wp:attachment":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/media?parent=24519"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}