<Links> element

The <Links> element is a subelement of <Zone>. This element defines one or more <Link> elements, each of which defines a connection—a link—between one zone type and another. For example, in the base configuration, Guidewire provides a <Link> element that defines a link between a county and a ZIP code in the United States. You can also use a link to define a lookup order to speed up searches.

Note: An address-config.xml file can define auto-fill elements that use these links. See Configuring autofill and autocompletion in address-config.xml.

The <Link> element has the following attributes:

Attribute

Description

lookupOrder

This optional attribute specifies the order in which to apply this value while performing a lookup. Specifying a lookup order can increase performance somewhat. If you do not specify a lookupOrder value, PolicyCenter uses the order that appears in the file.

toZone

This required attribute defines a relationship to another zone for PolicyCenter to use if the value of the <Zone> attribute code is not available for lookup.

For example, the following code defines a relationship between one zone type, county, and several other zone types. PolicyCenter uses these other zone types to look up an address if the address does not contain a county value.

<Zone code="county" fileColumn="4"  regionMatchOrder="2">
  ...
  <Links>
    <Link toZone="zip" lookupOrder="1"/>
    <Link toZone="city" lookupOrder="2"/>
  </Links>
</Zone>

This code has the following meaning:

  • The first <Link> definition, <Link toZone="zip" lookupOrder="1"/>, creates a link from county to zip. If PolicyCenter cannot look up the address by its county value, then PolicyCenter attempts to look up the address first by zip value.
  • The second <Link> definition, <Link toZone="city" lookupOrder="2"/>, creates a link from county to city. If PolicyCenter cannot look up the address by its county value or its zip value, it looks up the address by its city value.

See also