{"id":24047,"date":"2024-02-15T14:53:34","date_gmt":"2024-02-15T22:53:34","guid":{"rendered":"https:\/\/docs.extraview.com\/v25\/book\/object-1\/"},"modified":"2025-02-13T12:02:14","modified_gmt":"2025-02-13T20:02:14","slug":"object-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\/object-1\/","title":{"rendered":"OBJECT"},"content":{"rendered":"

\n\t<== object object_name<\/em> ==> [field1 operator value1<\/em>] [field2<\/em> operator value2<\/em>] … [fieldn<\/em> operator<\/em> valuen<\/em>]<\/h3>\n

This directive is used to define an object to be used as a link between two fields of different types. The most common purpose for this directive is to use it to enter a value into a text field, and have this value added to an existing field with a display type of list or pop-up.<\/p>\n

Use the object directive to use a value entered in a text field to be inserted as a new value in a list field.<\/p>\n

The most common operator to use within the syntax for each expression is the equal sign (=), but others may be used according to this table:<\/p>\n\n\n\n\n\n\n\n\n\n
\n\t\t\t\tField Display Type<\/strong><\/td>\n\n\t\t\t\tMulti-Value Field Support<\/strong><\/td>\n\n\t\t\t\tValid Operators<\/strong><\/td>\n<\/tr>\n
\n\t\t\t\tEnumerated list fields
\n\t\t\t\tUser Fields<\/td>\n		\n\t\t\t\tY<\/td>\n\n\t\t\t\t=, !=, <>, contains, contains any, contains all, contains none, excludes<\/td>\n<\/tr>\n
\n\t\t\t\tEnumerated list fields
\n\t\t\t\tUser Fields<\/td>\n		\n\t\t\t\tN<\/td>\n\n\t\t\t\t=, !=, <><\/td>\n<\/tr>\n
\n\t\t\t\tText Fields
\n\t\t\t\tText Area Fields
\n\t\t\t\tHTML Area Fields<\/td>\n		\n\t\t\t\tN<\/td>\n\n\t\t\t\t=, !=, <><\/td>\n<\/tr>\n
\n\t\t\t\tNumeric Fields<\/td>\n\n\t\t\t\tN<\/td>\n\n\t\t\t\t=, !=, <>, >, <, >=, <=<\/td>\n<\/tr>\n
\n\t\t\t\tDate & Day Fields<\/td>\n\n\t\t\t\t <\/td>\n\n\t\t\t\tNot supported<\/td>\n<\/tr>\n
\n\t\t\t\tImage & Document Fields<\/td>\n\n\t\t\t\t <\/td>\n\n\t\t\t\tNot supported<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

The list of filters that you enter are all ANDed together to evaluate the expression<\/p>\n

As an example, you may create directive rules similar to:<\/p>\n

<== object cust ==> AREA='Customers', LINK=CUST_LIST, TITLE=SHORT_DESCR, PRIVACY=false<\/code><\/p>\n

<== object cust.{guarantee} ==> AREA='Customers', LINK=CUST_LIST, TITLE=SHORT_DESCR, PRIVACY=false<\/code><\/p>\n

<== object custpopup ==> AREA='Customers', PROJECT='Contacts', LINK=CUST_POPUP, TITLE=SHORT_DESCR, PRIVACY=false, DO_NOT_MIGRATE=true<\/code><\/p>\n

This link may be used in a rule similar to:<\/p>\n

if (CUST_LIST.{changed}) {
\n\t  CUST_CONTACT = (cust).CUST_CONTACT;
\n\t  EMAIL_ADDRESS = (cust).EMAIL_ADDRESS;
\n\t}<\/code><\/p>\n

A multi-valued expression filter may look like each of the two following examples:<\/p>\n

MULTI_VALUE_FIELD contains x;y;z
\n\tNUMERIC_VALUE_FIELD <= 1.9<\/code><\/p>\n

When the directive is followed by one or more name operator value <\/em>combinations, the object rule will only be triggered when all the filter expressions match the values.<\/p>\n

This is a list of all the parameters that may be used with the object directive:<\/p>\n

LINK=<LIST or POPUP field name><\/strong><\/p>\n

Required – contains the name of the field with the list entry to be added, modified, or deleted<\/p>\n

TITLE=<TEXTFIELD field name><\/strong><\/p>\n

Required – contains the name of the field containing the title or text to be added to the list entry<\/p>\n

PARENT=<field name><\/strong><\/p>\n

Optional – contains the name of the parent field of the LINK field in an allowed value relationship<\/p>\n

AREA=<area title><\/strong><\/p>\n

Required – specifies the area of the issue where the object rule is executed<\/p>\n

PROJECT=<project title><\/strong><\/p>\n

Optional – specifies the project within the AREA where the object rule is executed. If this is not defined, then the object directive is executed for all PROJECTS within the defined AREA<\/p>\n

RG_NAME=<relationship group name><\/strong><\/p>\n

Unused at present<\/p>\n

PRIVACY=TRUE | FALSE <\/strong><\/p>\n

Optional – the option to add PRIVACY=true<\/code> will add the customer to a privacy group with the same title, and add the current user to that privacy group.<\/p>\n

DO_NOT_MIGRATE=TRUE|FALSE<\/strong><\/p>\n

Optional – The default is FALSE<\/strong>, indicating that the values will be migrated with the XML Export \/ Import utility.  If the value is provided and has a value of TRUE<\/strong>, then all User Defined Field values created with the OBJECT rule are not migrated from one ExtraView instance to another via the XML Export \/ XML Import utilities.  This allows the addition of test data values within one instance using the OBJECT rule, but ensures the data is not migrated to the target instance.  Note that the UDF list utility will show which values were added with this parameter.<\/p>\n

\n\tNote: All object rules must reside in the global area, not in the rules sections within each business area<\/div>\n

In summary, the link causes a value entered into the CUSTOMER field in the Customers<\/strong> business area to be automatically added to the list named CUST_LIST. This list is available in any other business area and is used in the rule to bring the values associated with the customer into the current screen, when a customer is chosen from its list.<\/p>\n

The {guarantee} <\/code>qualifier to the object <\/code>rule allows an issue to be created when the rule is executed, but prevents the value to the title being added as a duplicate to the list.  If the value does not exist, it will be created but if the value exists, that will be used.<\/p>\n","protected":false},"excerpt":{"rendered":"

<== object object_name ==> [field1 operator value1] [field2 operator value2] … [fieldn operator valuen] This directive is used to define an object to be used as a link between two fields of different types. The most common purpose for this directive is to use it to enter a value into a text field, and have this value added…<\/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-24047","page","type-page","status-publish","hentry"],"acf":[],"yoast_head":"\nOBJECT - 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\/object-1\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"OBJECT - Product Documentation\" \/>\n<meta property=\"og:description\" content=\"<== object object_name ==> [field1 operator value1] [field2 operator value2] … [fieldn operator valuen] This directive is used to define an object to be used as a link between two fields of different types. The most common purpose for this directive is to use it to enter a value into a text field, and have this value added...\" \/>\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\/object-1\/\" \/>\n<meta property=\"og:site_name\" content=\"Product Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2025-02-13T20:02:14+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\/site-configuration-menu-1\/business-rules-1\/language-description-1\/directives-1\/object-1\/\",\"url\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/directives-1\/object-1\/\",\"name\":\"OBJECT - Product Documentation\",\"isPartOf\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\"},\"datePublished\":\"2024-02-15T22:53:34+00:00\",\"dateModified\":\"2025-02-13T20:02:14+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\/object-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\/object-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\/object-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\":\"OBJECT\"}]},{\"@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":"OBJECT - 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\/object-1\/","og_locale":"en_US","og_type":"article","og_title":"OBJECT - Product Documentation","og_description":"<== object object_name ==> [field1 operator value1] [field2 operator value2] … [fieldn operator valuen] This directive is used to define an object to be used as a link between two fields of different types. The most common purpose for this directive is to use it to enter a value into a text field, and have this value added...","og_url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/directives-1\/object-1\/","og_site_name":"Product Documentation","article_modified_time":"2025-02-13T20:02:14+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\/site-configuration-menu-1\/business-rules-1\/language-description-1\/directives-1\/object-1\/","url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/directives-1\/object-1\/","name":"OBJECT - Product Documentation","isPartOf":{"@id":"https:\/\/docs.extraview.com\/v25\/#website"},"datePublished":"2024-02-15T22:53:34+00:00","dateModified":"2025-02-13T20:02:14+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\/object-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\/object-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\/object-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":"OBJECT"}]},{"@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\/24047","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=24047"}],"version-history":[{"count":0,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24047\/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=24047"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}