{"id":24051,"date":"2024-02-15T14:53:34","date_gmt":"2024-02-15T22:53:34","guid":{"rendered":"https:\/\/docs.extraview.com\/v25\/book\/user-mapping-1\/"},"modified":"2025-02-19T17:00:17","modified_gmt":"2025-02-20T01:00:17","slug":"user-mapping-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\/directives-1\/user-mapping-1\/","title":{"rendered":"USER MAPPING"},"content":{"rendered":"

<== user mapping ==><\/h3>\n

This directive allows business rules to be triggered when a user account is modified.\u00a0 This directive is often used as the companion to the action rules of CREATE USER<\/a> and UPDATE USER<\/a>.\u00a0 CREATE USER and UPDATE USER allow users to be managed from add<\/em> and edit<\/em> screens, while the <== user mapping ==><\/code><\/a> directive allows administrative changes to users to be reflected in updates to issues.<\/p>\n

This is significantly different from other directives which are triggered when issues are inserted or updated.\u00a0 This directive is triggered when changes to user information are submitted.<\/p>\n

As an example, the rules within this directive are triggered when an administrator goes to the User Account maintenance screen and edits a user’s account.\u00a0 When the administrator updates the user record, the changes to the account are made in the normal way and the rules in the <== user mapping ==><\/code> rules section are executed.<\/p>\n

This rule provides a means to synchronize the values within a user’s record to issues where the user’s details are stored.<\/p>\n

To facilitate the operation of this directive, there are two session variable fields defined in the Data Dictionary:<\/p>\n

    \n
  1. RULES_MANAGED_USER<\/strong> – this is the user field containing the User ID of the user that was created, modified or deleted by the user transaction that invoked the mapping rule<\/li>\n
  2. RULES_TXN_NAME<\/strong> –\u00a0 this is an option where a text field placed on the layout can contain either a value of ADD<\/em><\/strong>, EDIT<\/strong><\/em> or DELETE.<\/strong><\/em> This signifies which user transaction invoked the mapping rules.\u00a0 An example might be that with a value of\u00a0ADD<\/strong><\/em> you can have further rules within this directive to execute a ADD action rule, or if there is a value of\u00a0EDIT<\/strong><\/em> then you might execute an\u00a0UPDATE action rule.<\/li>\n<\/ol>\n

    Note that there are action rules that permit a user’s account details to be created or updated and synchronized in the opposite direction, i.e. from issues to user accounts.\u00a0 These actions are CREATE USER<\/code> and UPDATE USER<\/code>.<\/p>\n

    The ADD\/UPDATE task must be running for this directive to be operable.<\/p>\n

    Example<\/h4>\n

    <== link vendorContactLink ==> AREA=Vendors, PROJECT=Contacts, CONTACT.{is not null}, NEW_USER_ID.{is not null}, CONTACT=RULES_MANAGED_USER, STATUS='Active'<\/code><\/code><\/p>\n

    <== user mapping ==>
    \nif ((vendorContactLink).ID.{is not null}) {
    \n{ UPDATE: vendorContactLink
    \nVENDOR_FNAME = RULES_MANAGED_USER<\/span>.{first name},
    \nVENDOR_LNAME = RULES_MANAGED_USER<\/span>.{last name},
    \nVENDOR_PHONE = RULES_MANAGED_USER<\/span>.{cell phone}
    \n};<\/code><\/p>\n

      \n
    • The link rule vendorContactLink <\/code>searches for all issues where the AREA equals Vendors<\/em>, the PROJECT equals Contacts<\/em>, there is a value in the CONTACT field, there is a value in the NEW_USER_ID field, and the value of the STATUS field is Active<\/em>.\u00a0 The value in the CONTACT field must be the User ID of the user that caused the rule to execute, i.e. the\u00a0RULES_MANAGED_USER<\/span><\/li>\n
    • The rules within the <== user mapping ==><\/code> directive first check to see if the identified issue or issues exist.\u00a0 Note there may be more than one matching issue<\/li>\n
    • For the matching issues found with the link the current value from the user’s account for the first name, last name and cell phone are then saved into the issue(s) in the VENDOR_FNAME, VENDOR_LNAME and VENDOR_PHONE fields.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"

      <== user mapping ==> This directive allows business rules to be triggered when a user account is modified.\u00a0 This directive is often used as the companion to the action rules of CREATE USER and UPDATE USER.\u00a0 CREATE USER and UPDATE USER allow users to be managed from add and edit screens, while the <== user…<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":24035,"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-24051","page","type-page","status-publish","hentry"],"acf":[],"yoast_head":"\nUSER MAPPING - 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\/directives-1\/user-mapping-1\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"USER MAPPING - Product Documentation\" \/>\n<meta property=\"og:description\" content=\"<== user mapping ==> This directive allows business rules to be triggered when a user account is modified.\u00a0 This directive is often used as the companion to the action rules of CREATE USER and UPDATE USER.\u00a0 CREATE USER and UPDATE USER allow users to be managed from add and edit screens, while the <== user...\" \/>\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\/directives-1\/user-mapping-1\/\" \/>\n<meta property=\"og:site_name\" content=\"Product Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2025-02-20T01:00:17+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=\"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\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/directives-1\/user-mapping-1\/\",\"url\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/directives-1\/user-mapping-1\/\",\"name\":\"USER MAPPING - Product Documentation\",\"isPartOf\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\"},\"datePublished\":\"2024-02-15T22:53:34+00:00\",\"dateModified\":\"2025-02-20T01:00:17+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/directives-1\/user-mapping-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\/directives-1\/user-mapping-1\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/directives-1\/user-mapping-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\":\"Directives\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/directives-1\/\"},{\"@type\":\"ListItem\",\"position\":8,\"name\":\"USER MAPPING\"}]},{\"@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":"USER MAPPING - 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\/directives-1\/user-mapping-1\/","og_locale":"en_US","og_type":"article","og_title":"USER MAPPING - Product Documentation","og_description":"<== user mapping ==> This directive allows business rules to be triggered when a user account is modified.\u00a0 This directive is often used as the companion to the action rules of CREATE USER and UPDATE USER.\u00a0 CREATE USER and UPDATE USER allow users to be managed from add and edit screens, while the <== user...","og_url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/directives-1\/user-mapping-1\/","og_site_name":"Product Documentation","article_modified_time":"2025-02-20T01:00:17+00:00","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\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/directives-1\/user-mapping-1\/","url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/directives-1\/user-mapping-1\/","name":"USER MAPPING - Product Documentation","isPartOf":{"@id":"https:\/\/docs.extraview.com\/v25\/#website"},"datePublished":"2024-02-15T22:53:34+00:00","dateModified":"2025-02-20T01:00:17+00:00","breadcrumb":{"@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/directives-1\/user-mapping-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\/directives-1\/user-mapping-1\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/directives-1\/user-mapping-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":"Directives","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/directives-1\/"},{"@type":"ListItem","position":8,"name":"USER MAPPING"}]},{"@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\/24051","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=24051"}],"version-history":[{"count":0,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24051\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24035"}],"wp:attachment":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/media?parent=24051"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}