Dovetail Agent Documentation

Developer Resource - Filter Overrides

Customizing a filter specification doesn't mean you have to write rewrite the existing ones when you take advantage of filter overrides. You can write a config file just describing the customizations you need for each filter specification. These XML config override files live in source\Web\Filters\custom\.

An example overrides file is provided that demonstrates the capabilities of filter overrides. It is located at source\Web\Filters\custom\cases.overrides.example.filter.config

Filter Override File Format

<filter overrides="">>
  <removeFacet key="" />
  <removeField key="" />
  <removeCategory value="" />
  <removeColumn key="" />

  <!-- all inherited attributes are available, here are the additions -->
  <query>
    <addFacet label="" />
    <addField label="" />
  </query>
  <columns>
    <addColumn index="" />
  </columns>
</filter>

Example Filter Config File

<filter overrides="Cases">
  <removeFacet key="priority" />
  <removeColumn key="priority" />
  <removeColumn key="contact" />

  <query>
    <addJoin relationship="case_reporter2contact">
      <addField key="case_reporter2contact" field="objid" dataType="int"/>
    </addJoin>
  </query>

  <columns>
    <addColumn key="contact" template="entityLink" entity="Contact" idField="case_reporter2contact" index="-3" width="200">
      <sorts>
        <addSort key="contactLastName" />
        <addSort key="contactFirstName" />
      </sorts>
    </addColumn>
  </columns>
</filter>

One important thing to note is that when re-adding in columns, facets or fields you must pay attention to whether or not you want to re-implement the child elements of what you've removed. In this example we removed the column key contact and had to re-add the sorts children to maintain our desired functionality.

XML Reference

<filter>

<removeColumn><removeFacet><removeField>

<removeCategory>

<addFacet><addField>

<addColumn>