ExternalLinks

This rule allows the configuror to define external links to access third-party client applications like Accounting Management Systems, Document Management Systems (DMS) and other External Systems that operate outside and independent of OIPA. The rule overrides at Primary Company Level. The external links can be configured at the main menu level and also at different context levels such as Client, Case, Suspense, Policy and GroupCustomer which can be accessed from the left navigation pane in OIPA.

Allowed List Domains: The ASALLOWEDDOMAIN table contains a list of allowed domains (valid external links) that can be configured in this rule. OIPA implements REST service APIs to add/remove/modify allowed domains in this table. When an ExternalLinks rule is configured, the system validates every configured URL (external link) against the list of allowed domains stored in the ASALLOWEDDOMAIN table and restricts the configuration of any URL outside of these allowed domains at the time of rule check-in.

Allowed List Validation with Examples:

• The system allows to configure the URLs (external links) that are in the HTTP / HTTPS format only.
• The system throws an error if the following type of links are configured in the rule at the time of rule check-in.
  • Links configured using <IFRAME>. Example, <LINK><IFRAME>http://www.oracle.com</IFRAME></LINK>
  • Links configured using javascrip eval function. Example, <LINK>eval('http://www.oracle.com')</LINK> or <LINK>https://www.oracle.com/eval('http:/www.dmv.org')<LINK>
  • Links configured using ftp or file. Example, <LINK>ftp://www.Oracle.com</LINK> or <LINK>file://www.Oracle.com</LINK>

  • If the link configured does not belong to, or if it is not an active record of 'ASALLOWEDDOMAIN' table.

ExternalLinks Elements and Attributes

Element/Tag	Parent Element	Definition	Attribute	Element/Attribute Value and Description
<ExternalLinks>		The opening and closing tags of the ExternalLinks business rule.
<MainMenuLinks>	<ExternalLinks>	optional:  The container element for Main menu links configuration. It contains <Link> element that is Required and Repeatable.  The <Link> element contains <LinkDisplay> and <LinkValue> elements.  Both are Required.
<Case>	<ExternalLinks>	optional: The container element for the Case links configuration. It contains <Link>  element that is Required and Repeatable.  The <Link> element contains <LinkDisplay> and <LinkValue> elements.  Both are Required.
<Client>	<ExternalLinks>	optional: The container element for the Client links configuration. It contains <Link>  element that is Required and Repeatable.  The <Link> element contains <LinkDisplay> and <LinkValue> elements.  Both are Required.
<Suspense>	<ExternalLinks>	optional: The container element for the Suspense links configuration. It contains <Link>  element that is Required and Repeatable.  The <Link> element contains <LinkDisplay> and <LinkValue> elements.  Both are Required.
<GroupCustomer>	<ExternalLinks>	optional: The container element for the Group Customer links configuration. It contains <Link>  element that is Required and Repeatable.  The <Link> element contains <LinkDisplay> and <LinkValue> elements.  Both are Required.
<Policy>	<ExternalLinks>	optional: The container element for the Policy links configuration. It contains <Link>  element that is Required and Repeatable.  The <Link> element contains <LinkDisplay> and <LinkValue> elements.  Both are Required.
<Math>	<Policy>	Optional: This provides a section of configured logic that establishes common variables to be used in the rule.
	<Math>	Required: Provides a name for the Math section.	ID	Literal
<Links>	<Policy>	Required, Repeatable: The element holds the Policy links that shall be populated based on a test condition for a given plan.
<Tests>	<Links>	Optional: The container element for the test expression configuration.
<Test>		Required, Repeatable: This element defines a conditional expression that resolves to TRUE or FALSE.  When evaluation of a test condition is true within a <Tests> element, the external links configured for that PlanName shall be applied.
<Link>	<Links>	Optional: The container element for the external links. Note: The description is same for this element and its child elements when it is used under the parent elements such as <Case>, <Client>, <Suspense>, <GroupCustomer>, <Policy>
<LinkDisplay>	<Link>	Required: This element allows to define a display name for the link.
<LinkValue>	<Link>	Required: This element allows to place a URL of the link.

XML Schema

<ExternalLinks>
     <MainMenuLinks>
         <Link>
             <LinkDisplay>[name]</LinkDisplay>
             <LinkValue>[url]</LinkValue>
         </Link>
         <Link>...</Link>
     </MainMenuLinks>
     <Client>
         <Link>
             <LinkDisplay>[name]</LinkDisplay>
             <LinkValue>[url]</LinkValue>
         </Link>
         <Link>...</Link>
     </Client>
     <Case>
         <Link>
             <LinkDisplay>[name]</LinkDisplay>
             <LinkValue>[url]</LinkValue>
         </Link>
         <Link>...</Link>
     </Case>
     <Suspense>
         <Link>
             <LinkDisplay>[name]</LinkDisplay>
             <LinkValue>[url]</LinkValue>
         </Link>
         <Link>...</Link>
     </Suspense>
     <GroupCustomer>
         <Link>
             <LinkDisplay>[name]</LinkDisplay>
             <LinkValue>[url]</LinkValue>
         </Link>
         <Link>...</Link>
     </GroupCustomer>
    <Policy>
         <Math ID="[name]">
            <MathVariables>
                <MathVariable DATATYPE="TEXT" TYPE="SQL" VARIABLENAME="PlanNameMV">SELECT PlanName FROM AsPlan WHERE PlanGUID ='[Policy:PlanGUID]'
                </MathVariable>
            </MathVariables>
        </Math>
   <Links>       
        <Tests>
             <Test>[mathIDName]:PlanNameMV = 'Plan1' </Test>   
        </Tests>
        <Link>
            <LinkDisplay>[name]</LinkDisplay>
            <LinkValue>[url]</LinkValue>
        </Link>
        <Link> .. </Link>
    </Links>
    <Links>
        <Tests>
             <Test> [mathIDName]:PlanNameMV = 'Plan2' </Test>      
        </Tests>
        <Link>
            <LinkDisplay>[name]</LinkDisplay>
            <LinkValue>[url]</LinkValue>
        </Link>
        <Link>...</Link>
     </Links>
    </Policy>
 </ExternalLinks>

XML Example

<ExternalLinks>
    <MainMenuLinks>   
        <Link>
            <LinkDisplay>Oracle</LinkDisplay>
            <LinkValue>http://www.oracle.com</LinkValue>
        </Link>     
        <Link>
            <LinkDisplay>Metlife</LinkDisplay>
            <LinkValue>https://www.metlife.com</LinkValue>
         </Link>
         <Link>...</Link>
    </MainMenuLinks>
    <Client>
        <Link>
            <LinkDisplay>Oracle</LinkDisplay>
            <LinkValue>http://www.oracle.com</LinkValue>
        </Link>
        <Link>...</Link>
    </Client>
    <Case>
        <Link>
           <LinkDisplay>Oracle</LinkDisplay>
           <LinkValue>http://www.oracle.com</LinkValue>
        </Link>
        <Link>...</Link>
      </Case>
    <Suspense>
        <Link>
            <LinkDisplay>Oracle</LinkDisplay>
            <LinkValue>http://www.oracle.com</LinkValue>
        </Link>
        <Link>...</Link>
    </Suspense>
    <GroupCustomer>
        <Link>
            <LinkDisplay>Oracle</LinkDisplay>
            <LinkValue>http://www.oracle.com</LinkValue>
        </Link>
        <Link>...</Link>
    </GroupCustomer>
     <Policy>
         <Math ID="[name]">
            <MathVariables>
                <MathVariable DATATYPE="TEXT" TYPE="SQL" VARIABLENAME="PlanNameMV">SELECT PlanName FROM AsPlan WHERE PlanGUID ='[Policy:PlanGUID]'
                </MathVariable>
            </MathVariables>
        </Math>
   <Links>       
        <Tests>
             <Test>LinkGlobal:PlanNameMV = 'Functional Prototype' </Test>   
        </Tests>
        <Link>
            <LinkDisplay>Oracle</LinkDisplay>
            <LinkValue>Oracle.com</LinkValue>
        </Link>
        <Link>
            <LinkDisplay>WestPac</LinkDisplay>
            <LinkValue>Westpac.com</LinkValue>
        </Link>
    </Links>
    <Links>
        <Tests>
             <Test> LinkGlobal:PlanNameMV = 'Dynamic Prototype' </Test>      
        </Tests>
        <Link>
            <LinkDisplay>SCB</LinkDisplay>
            <LinkValue>SCB.com</LinkValue>
        </Link>
        <Link>...</Link>
     </Links>
    </Policy>
</ExternalLinks>