{"id":24070,"date":"2024-02-15T14:53:34","date_gmt":"2024-02-15T22:53:34","guid":{"rendered":"https:\/\/docs.extraview.com\/v25\/book\/special-values-1\/"},"modified":"2025-02-13T11:43:03","modified_gmt":"2025-02-13T19:43:03","slug":"special-values-1","status":"publish","type":"page","link":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/special-values-1\/","title":{"rendered":"Special Values"},"content":{"rendered":"

Special values are used within rules to reference values outside the issue, or to set specific values to aid in manipulating the issue.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n
\n

\n\t\t\t\t\tEMAIL_IGNORE_GROUP<\/h3>\n<\/td>\n

\n

This allows you to check or uncheck the checkbox that sends notification with the EMAIL_CUSTOMER<\/span> field on the add<\/em> and the edit<\/em> screens. Normally this is the Guest<\/b> or Customer<\/b> Role. Set to a value of ‘Y’<\/span> to set the value to checked, or to a value of ‘N’<\/span> to set a value of unchecked. Use a preupdate<\/span> rule such as:<\/p>\n

\t\t\t\t\tif (SCREEN_NAME=’ADD’ && STATUS=’Fixed’) {
\n\t\t\t\t\t  EMAIL_IGNORE_GROUP = ‘Y’;
\n\t\t\t\t\t}<\/span><\/p>\n

\t\t\t\t\tValid values are \u2019Y<\/span>\u2019 and \u2019N<\/span>\u2019. Note that the value may be in upper or lower case.<\/p>\n<\/td>\n<\/tr>\n

\n

\n\t\t\t\t\tEXT_SITE_URL<\/h3>\n<\/td>\n

\n

This special value references and returns the value of the behavior setting named EXT_SITE_URL.<\/p>\n<\/td>\n<\/tr>\n

\n

\n\t\t\t\t\tGENERATE_EMAIL<\/h3>\n<\/td>\n

\n

This allows you to check or uncheck the checkbox that governs notification on the add<\/em> and the edit<\/em> screens. Use a preupdate<\/span> rule such as:<\/p>\n

if (SCREEN_NAME=’ADD’ && CATEGORY=’Undetermined’) {<\/span>
\n\t\t\t\t\t  GENERATE_EMAIL = ‘N’; <\/span>
\n\t\t\t\t\t}<\/span><\/p>\n

Valid values are \u2019Y<\/span>\u2019 and \u2019N<\/span>\u2019. Note that the value may be in upper or lower case.<\/p>\n<\/td>\n<\/tr>\n

\n

\n\t\t\t\t\tSCREEN_LOAD<\/h3>\n<\/td>\n

\n

There are several occasions when load <\/code>directive rules are executed:<\/p>\n

    \n
  • \n\t\t\t\t\t\tWhen an add <\/em>screen loads<\/li>\n
  • \n\t\t\t\t\t\tWhen an edit <\/em>screen loads<\/li>\n
  • \n\t\t\t\t\t\tWhen the user clicks the Update & Continue<\/strong> button on the menubar of an edit<\/em> screen.  This operation is fulfilled via an Ajax request to the server so no screen refresh occurs.<\/li>\n<\/ul>\n

    There are times when you want different rules processing to happen, especially if the Update & Continue<\/strong> button is clicked from an edit <\/em>screen.  The SCREEN_NAME<\/code> special value allows the rules programmer to differentiate between the add<\/em> and the edit<\/em> screens.  The SCREEN_LOAD<\/code> special value allows the rules programmer to differentiate when the Update & Continue<\/strong> button is causing the issue to be loaded.  The SCREEN_NAME special value may have the value FULL <\/code>or AJAX<\/code>, with usage such as:<\/p>\n

    if (SCREEN_NAME='EDIT' && SCREEN_LOAD='FULL') {<\/code>
    \n\t\t\t\t\t  ... do something ...
    \n\t\t\t\t\t};<\/code><\/p>\n

    or<\/p>\n

    if (SCREEN_NAME='EDIT' && SCREEN_LOAD='AJAX') {
    \n\t\t\t\t\t  ... do something else ...
    \n\t\t\t\t\t};<\/code><\/p>\n<\/td>\n<\/tr>\n

\n

\n\t\t\t\t\tSCREEN_NAME<\/h3>\n<\/td>\n

\n

This has two possible values, ADD or EDIT. This allows you to define a rule that will only be executed on the Add <\/em>or Edit <\/em>screens. For example:<\/p>\n

\t\t\t\t\tif (SCREEN_NAME=’ADD’ && STATUS=’OPEN’) {<\/span>
\n\t\t\t\t\t   ….
\n\t\t\t\t\t}<\/span><\/p>\n

\t\t\t\t\twill execute the rule, only if you are adding an issue and the status is OPEN.<\/p>\n<\/td>\n<\/tr>\n

\n

\n\t\t\t\t\tSITE_URL<\/h3>\n<\/td>\n

\n

This special value references and returns the value of the behavior setting named SITE_URL.<\/p>\n<\/td>\n<\/tr>\n

\n

\n\t\t\t\t\tSYSDATE<\/h3>\n<\/td>\n

\n

This provides a value of the current timestamp<\/p>\n<\/td>\n<\/tr>\n

\n

\n\t\t\t\t\tSYSDAY<\/h3>\n<\/td>\n

\n

This provides the Date Value of the current time<\/p>\n<\/td>\n<\/tr>\n

\n

\n\t\t\t\t\tUSER<\/h3>\n<\/td>\n

\n

This references the current user<\/p>\n<\/td>\n<\/tr>\n

\n

\n\t\t\t\t\tUSER_ROLE<\/h3>\n<\/td>\n

\n

This references or sets the current user role. Setting the user role is only allowed under specific conditions:<\/p>\n

    \n
  1. \n\t\t\t\t\t\tThis will only work on the edit<\/em> screen, not the add<\/em> screen<\/li>\n
  2. \n\t\t\t\t\t\tTo set a new role to the current user, the current user must be able to adopt the new role. I.e., their user account must specify that they are allowed to adopt the new role as part of the user configuration.<\/li>\n
  3. \n\t\t\t\t\t\tIf the rule attempts to set a role to a role to which the user does not have permission, the role will be changed to the role identified by the behavior setting named LIMITED_USER_ROLE. Thus, you may still affect a role change to a user who has a single role defined, but this will typically be the Guest or Customer role.<\/li>\n<\/ol>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    \n\t <\/h3>\n","protected":false},"excerpt":{"rendered":"

    Special values are used within rules to reference values outside the issue, or to set specific values to aid in manipulating the issue. EMAIL_IGNORE_GROUP This allows you to check or uncheck the checkbox that sends notification with the EMAIL_CUSTOMER field on the add and the edit screens. Normally this is the Guest or Customer Role….<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":24034,"menu_order":2,"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-24070","page","type-page","status-publish","hentry"],"acf":[],"yoast_head":"\nSpecial Values - 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\/business-rules-1\/language-description-1\/special-values-1\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Special Values - Product Documentation\" \/>\n<meta property=\"og:description\" content=\"Special values are used within rules to reference values outside the issue, or to set specific values to aid in manipulating the issue. EMAIL_IGNORE_GROUP This allows you to check or uncheck the checkbox that sends notification with the EMAIL_CUSTOMER field on the add and the edit screens. Normally this is the Guest or Customer Role....\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/special-values-1\/\" \/>\n<meta property=\"og:site_name\" content=\"Product Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2025-02-13T19:43:03+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=\"3 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\/business-rules-1\/language-description-1\/special-values-1\/\",\"url\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/special-values-1\/\",\"name\":\"Special Values - Product Documentation\",\"isPartOf\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\"},\"datePublished\":\"2024-02-15T22:53:34+00:00\",\"dateModified\":\"2025-02-13T19:43:03+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/special-values-1\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/special-values-1\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/special-values-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\":\"Site Configuration Menu\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"Business Rules\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/\"},{\"@type\":\"ListItem\",\"position\":6,\"name\":\"Language Description\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/\"},{\"@type\":\"ListItem\",\"position\":7,\"name\":\"Special Values\"}]},{\"@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":"Special Values - 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\/business-rules-1\/language-description-1\/special-values-1\/","og_locale":"en_US","og_type":"article","og_title":"Special Values - Product Documentation","og_description":"Special values are used within rules to reference values outside the issue, or to set specific values to aid in manipulating the issue. EMAIL_IGNORE_GROUP This allows you to check or uncheck the checkbox that sends notification with the EMAIL_CUSTOMER field on the add and the edit screens. Normally this is the Guest or Customer Role....","og_url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/special-values-1\/","og_site_name":"Product Documentation","article_modified_time":"2025-02-13T19:43:03+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/special-values-1\/","url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/special-values-1\/","name":"Special Values - Product Documentation","isPartOf":{"@id":"https:\/\/docs.extraview.com\/v25\/#website"},"datePublished":"2024-02-15T22:53:34+00:00","dateModified":"2025-02-13T19:43:03+00:00","breadcrumb":{"@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/special-values-1\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/special-values-1\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/special-values-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":"Site Configuration Menu","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/"},{"@type":"ListItem","position":5,"name":"Business Rules","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/"},{"@type":"ListItem","position":6,"name":"Language Description","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/"},{"@type":"ListItem","position":7,"name":"Special Values"}]},{"@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\/24070","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=24070"}],"version-history":[{"count":0,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24070\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24034"}],"wp:attachment":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/media?parent=24070"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}