{"id":24041,"date":"2024-02-15T14:53:34","date_gmt":"2024-02-15T22:53:34","guid":{"rendered":"https:\/\/docs.extraview.com\/v25\/book\/link-1\/"},"modified":"2025-02-13T11:56:29","modified_gmt":"2025-02-13T19:56:29","slug":"link-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\/link-1\/","title":{"rendered":"LINK"},"content":{"rendered":"

\n\t<== link link_name<\/em> ==><\/h3>\n

\n\tLinking Issues between Business Areas<\/h3>\n

This directive is used to specify how to connect linked issues from one business area to a different one, thereby creating a relationship between two business areas.<\/p>\n

For example, you can find one or more related issues in a different business area, from which a value is to be retrieved:<\/p>\n

<== link customer ==> AREA=\u2019Customer\u2019, CUSTOMER=CUSTOMER<\/code><\/p>\n

is interpreted that a rule action like:<\/p>\n

ASSIGNED_TO=(customer).OWNER<\/code><\/p>\n

which is used to set the Assigned To field in an Issue record to the OWNER field in a Customer record. If the link returns many records, and you only want to return a specific one, you can use a subscript as follows:<\/p>\n

ASSIGNED_TO=(customer[nn]).OWNER<\/code><\/p>\n

where nn<\/code> is an integer which refers to the number of the record you want returned, starting with zero.<\/p>\n

The more generalized description is that link rules have the form:<\/p>\n

<== link link_name<\/em> ==> link_condition1<\/em>[, link_condition2<\/em>]…[, link_conditionn<\/em>]<\/span><\/p>\n

The link_condition parameters may use the =<\/code> operator to provide an exact match with the link, or may use one of the following operators:<\/p>\n

    \n
  • \n\t\tcontains value-list<\/em> <\/code>or contains all <\/code>value-list<\/em><\/li>\n
  • \n\t\tcontains any <\/code>value-list<\/em><\/li>\n
  • \n\t\tcontains none <\/code>value-list<\/em><\/li>\n<\/ul>\n

    where value-list <\/em><\/code>is of the form:<\/p>\n

    value1<\/em>[; value2<\/em>] ... [;valuen<\/em>]<\/code><\/p>\n

    Note<\/strong>: contains value-list<\/em> <\/code>and contains all <\/code>value-list <\/em>are equivalent, namely, contains <\/span>value-list<\/em> <\/span>has the same meaning as contains all <\/code>value-list<\/em>.<\/p>\n

    Examples<\/strong>:<\/p>\n

    <== link AREA='Licenses<\/em>', LICENSE_TYPE='License<\/em>', COMPONENT='ABC<\/em>' ==><\/code><\/p>\n

    <== link AREA='Licenses<\/em>', MULTI_VALUED_UDF contains \u2018MV1<\/em>\u2019;\u2019MV2<\/em>\u2019 ==><\/code><\/p>\n

    \n\tLinking Relationship Groups<\/h3>\n

    The link directive can also be used to link related issue groups. For example:<\/p>\n

    <== link rglink ==> RG(RG_NAME = MY_RG, RG_TYPE = PARENTS)<\/code><\/p>\n

    where MY_RG is the name of an existing relationship group and RG_TYPE is one of PARENTS, CHILDREN, MEMBERS. If multiple records are referenced by the link, only the first one returned will be used for data assignments. For operations such as UPDATE all records will be processed. You may add an expression to the related issue link to form the link. For example:<\/p>\n

    <== link rglink ==> RG(RG_NAME = MY_RG, RG_TYPE = PARENTS), STATUS != Closed<\/code><\/p>\n

    will only form the relationship for issues that are not in the Closed<\/strong> status.<\/p>\n

    Relationship Group links are not order dependent; the type and name may appear in either order, and the RG_ may be omitted, so RG(TYPE=CHILDREN, NAME=xxxx)<\/code> will work identically to RG(RG_NAME=xxx, RG_TYPE=CHILDREN)<\/code>. Also, the keywords may be eliminated entirely, giving RG(xxxx, CHILDREN)<\/code> as a valid link. Note that GREATGRANDCHILDREN and GREAT-GRANDCHILDREN are only supported in links, and are not supported at this time by RelationshipGroup code.<\/p>\n

    {NULL}<\/code> and {NOT NULL}<\/code> may also be used within link conditions. For example:<\/p>\n

    <== link AREA='Licenses', LICENSE_TYPE='License', COMPONENT={NULL} ==><\/code><\/p>\n

    You may also add the {EXISTS}<\/code> as a qualifier to a clause in a link directive. This will check the link, before execution, to find whether the value is present, or is a null value. For example, consider:<\/p>\n

    <== link cousinLink ==>AREA='Functionality', BROTHER_ID = PARENT_ID.{EXISTS}<\/code><\/p>\n

    If the .{EXISTS}<\/code> was not present, all records with no value for the BROTHER_ID will be selected if the PARENT_ID is null.<\/p>\n

    You may also add a parameter of DISABLE_LINK<\/code> to a LINK directive. This has the effect of suppressing the drilldown into the issue on the link. For example, the following is correct syntax.<\/p>\n

    <LINK AREA='Bugs' DISABLE_LINK><\/code><\/p>\n

    If the value of the behavior setting named ITEM_ID_DISPLAY is ID, then the link uses the ID field to connect the linked issues.  If the value is ALT_ID, then the ALT_ID field value is used in the links.<\/p>\n

    Link directives may also utilise a contains <\/code>clause on a multi-valued field filter.  For example, a rule like:<\/p>\n

    <== link idTextFieldLink ==>ID != TEXTFIELD_1, TEXTFIELD_2 contains TEXTFIELD_2 <\/code><\/p>\n

    will retrieve all the issues where all the values in the UDF field TEXTFIELD_2<\/code> exist in the issue’s values for TEXTFIELD_2<\/code>.<\/p>\n

    \n\tLinking with Wildcards<\/h3>\n

    By default, reference to a link value returns the first value in the result list for an assignment statement.  However, a subscripted value (such as (linkname[n]).ID<\/code> may be specified, returning the n<\/code>th value in the result list for an assignment statement.  With this feature, all values in the list can be returned by specifying a wildcard subscript such as (linkname[*]).ID<\/code>. This convention will return all values in the result list separated by semicolons.<\/p>\n

    \n\tLink Rules with Multi-Valued Field Filters<\/h3>\n
    \n\tLink rules may use a contains<\/code> clause on multi-valued field filters.<\/div>\n
    \n\t <\/div>\n
    \n\tThus, a link rule like:<\/div>\n
    \n\t <\/div>\n
    \n\t<== link idTextfieldLink==> ID != MY_TEXTFIELD,MULTI_MAIN contains MULTI_MAIN <\/code><\/div>\n
    \n\t <\/div>\n
    \n\tcan be written to retrieve the items where any of the values in the MULTI_MAIN<\/code> UDF exist in the issue’s values for MULTI_MAIN<\/code>.<\/div>\n
    \n\t <\/div>\n
    \n\tYou can use any of the following where MVA<\/code> is a multi-valued field and <values><\/code> is a collection of potential values for MVA<\/code>.<\/div>\n
      \n
    • \n\t\tMVA.{contains any <values>}MVA.{contains all <values>}<\/code><\/li>\n
    • \n\t\tMVA.{contains none <values>}<\/code><\/li>\n
    • \n\t\tMVA.{contains <values>}<\/code><\/li>\n
    • \n\t\tMVA.{excludes <values>}<\/code><\/li>\n<\/ul>\n
      \n\tThe same operators also work with link rules as follows.<\/div>\n
        \n
      • \n\t\t<== link mva1Link ==> AREA='Simpsons',MVA = MVA<\/code><\/li>\n
      • \n\t\t<== link mva2Link ==> AREA='Simpsons',MVA contains MVA<\/code><\/li>\n
      • \n\t\t<== link mva3Link ==> AREA='Simpsons',MVA excludes MVA<\/code><\/li>\n
      • \n\t\t<== link mva4Link ==> AREA='Simpsons',MVA contains any MVA<\/code><\/li>\n
      • \n\t\t<== link mva5Link ==> AREA='Simpsons',MVA contains all MVA<\/code><\/li>\n
      • \n\t\t<== link mva6Link ==> AREA='Simpsons',MVA contains none MVA<\/code><\/li>\n<\/ul>\n

        \n\tRelationship Group Reference ID Feature<\/h3>\n

        The RG link references currently permit the specification of RG_NAME<\/code> and RG_TYPE<\/code>. With this feature, you can specify RG_REF_ID<\/code>, which specifies a field name containing the ID <\/code>(or ALT_ID<\/code>) of the relationship.  For example, the following rules:<\/p>\n

        <== link rgParentIssueLink ==> RG(RG_NAME=MY_GROUP, RG_TYPE=PARENTS, RG_REF_ID=MY_TEXTFIELD)
        \n\t<== load ==>
        \n\tMY_TEXTFIELD = 12345;
        \n\tMY_TEXTAREA = (rgParentIssueLink[*]).ID;<\/code><\/p>\n

        populate a semicolon-separated list of the parents of issue 12345 from MY_GROUP<\/code> into the MY_TEXTAREA<\/code> field.<\/p>\n

        \n\tLinking Issues using ID’s Stored within a Text Field<\/h3>\n

        It can be useful to link issues stored with a delimited list of ID’s to the current issue.  Let’s say that you have a text field named ISSUES_TO_LINK<\/code>.  This may have a content such as 123;456;789<\/code>.  You might want to perform an update operation on all issues linked together.  The syntax of the link rule would be:<\/p>\n

        <== link linkFieldIDs ==> ID = RELATED_ISSUES_TO_LINK
        \n\t    ISSUES_TO_LINK = '123;456;789';
        \n\t    {UPDATE: linkFieldIDs <\/code>STATUS='Approved'};<\/code><\/p>\n

        As a result of executing the link directive, the issues with IDs of 123<\/code>, 456 <\/code>and 789 <\/code>will be updated with a STATUS<\/code> of Approved<\/code>.<\/p>\n

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

        <== link link_name ==> Linking Issues between Business Areas This directive is used to specify how to connect linked issues from one business area to a different one, thereby creating a relationship between two business areas. For example, you can find one or more related issues in a different business area, from which a value…<\/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-24041","page","type-page","status-publish","hentry"],"acf":[],"yoast_head":"\nLINK - 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\/link-1\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"LINK - Product Documentation\" \/>\n<meta property=\"og:description\" content=\"<== link link_name ==> Linking Issues between Business Areas This directive is used to specify how to connect linked issues from one business area to a different one, thereby creating a relationship between two business areas. For example, you can find one or more related issues in a different business area, from which a value...\" \/>\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\/link-1\/\" \/>\n<meta property=\"og:site_name\" content=\"Product Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2025-02-13T19:56:29+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=\"6 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\/link-1\/\",\"url\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/directives-1\/link-1\/\",\"name\":\"LINK - Product Documentation\",\"isPartOf\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\"},\"datePublished\":\"2024-02-15T22:53:34+00:00\",\"dateModified\":\"2025-02-13T19:56:29+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\/link-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\/link-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\/link-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\":\"LINK\"}]},{\"@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":"LINK - 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\/link-1\/","og_locale":"en_US","og_type":"article","og_title":"LINK - Product Documentation","og_description":"<== link link_name ==> Linking Issues between Business Areas This directive is used to specify how to connect linked issues from one business area to a different one, thereby creating a relationship between two business areas. For example, you can find one or more related issues in a different business area, from which a value...","og_url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/directives-1\/link-1\/","og_site_name":"Product Documentation","article_modified_time":"2025-02-13T19:56:29+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"6 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\/link-1\/","url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/site-configuration-menu-1\/business-rules-1\/language-description-1\/directives-1\/link-1\/","name":"LINK - Product Documentation","isPartOf":{"@id":"https:\/\/docs.extraview.com\/v25\/#website"},"datePublished":"2024-02-15T22:53:34+00:00","dateModified":"2025-02-13T19:56:29+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\/link-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\/link-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\/link-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":"LINK"}]},{"@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\/24041","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=24041"}],"version-history":[{"count":0,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24041\/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=24041"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}