Replace string

Contents

Overview
Configuration

Overview

The String Replace filter enables you to replace all or part of the value of a specified message attribute. You can use this filter to replace any specified string or substring in a message attribute. For example, changing the from attribute in an email, or changing all or part of a URL.

Configuration

To configure the String Replace filter, specify the following fields:

Name Enter the name of the filter to be displayed in a policy.
Message Attribute Select the name of the message attribute to be replaced from the list. This is required. If this is not specified, a MissingPropertyException is thrown, which results in a CircuitAbortException.
Specify Destination Attribute By default, the value of the specified Message Attribute is both the source and destination, and is therefore overwritten. To specify a different destination attribute, select this check box to enable the Destination Attribute field, and select a value from the list.
Replacement String The string used to replace the value of the specified source attribute. You can specify this as a selector, which is expanded to the specified value at runtime (for example, ${http.request.uri}). This is a required field if you specify the Specify Destination Attribute.
Straight A match string used to search the value of the specified source attribute. You can specify this as a selector, which is expanded to the specified value at runtime. If a straight (exact) match is found, it is replaced with the specified Replacement String.
Regexp A match string, specified as a regular expression, used to search the value of the specified source attribute. You can specify this as a selector, which is expanded to the specified attribute value at runtime. If a match is found, it is replaced with the specified Replacement String. For more details on selectors, see Select configuration values at runtime.
First Match If a match is found, only replace the first occurrence.
All Matches If a match is found, replace all occurrences.


[Note] Note

The possible paths available through this filter are True (even if no replacement takes place), and CircuitAbort. Under certain circumstances, if the Replacement String contains a selector, a MissingPropertyException can occur, which results in a CircuitAbortException.

Prev  Up  Next
  Home