<< Click to Display Table of Contents >> Navigation:  Event and Object Analysis > Capture Results Filtering > Filtration Basics > Rules > Actions > HEADER_EX action

Adds a custom header to the object's metadata or modifies the value of the existing header, except of the From, To, Cc, Bcc, Subject, Date headers.

Description

The action adds a custom header to the message:

If the header with the same name (case-insensitive) already exists in the message, its value is replaced with a new one.

The header name can not be:

From

To

Cc

Bcc

Subject

Date

Format

<action name="header_ex"
       headername="<UserHeader>"
       value="<user header value>" />

The "name" attribute:

The name attribute contains the action name: name="header_ex".

The "headername" attribute:

The headername="..." attribute specifies the name of the string label to be set.

The "value" attribute:

The value="..." attribute specifies the header value.

Example

Adds the following header to the message: X-SomethingElse-UserHeaderEx: user header value.

<?xml version="1.0" encoding="utf-8"?>
<filter name="TEST" version="1.0">
 <comment>This is the comment for the filter.</comment>
 <table name="main">
 
   <rule enabled="true">
     <comment>
       Adds the following header to the message:
       X-SomethingElse-UserHeaderEx: user header value.
     </comment>
     <action name="header_ex"
             headername="X-SomethingElse-UserHeaderEx"
             value="user header value" />
   </rule>
 
   <rule enabled="true">
     <match><c name="all"/></match>
     <action name="accept" />
   </rule>
 
  </table>
</filter>