From d6bca3825f1eeec1b5458a89927a3a04df6a2f04 Mon Sep 17 00:00:00 2001 From: Justin Bertram Date: Mon, 19 Nov 2018 13:21:51 -0600 Subject: [PATCH] NO-JIRA doc for divert routing-type --- docs/user-manual/en/configuration-index.md | 1 + docs/user-manual/en/diverts.md | 16 +++++++++++++--- 2 files changed, 14 insertions(+), 3 deletions(-) diff --git a/docs/user-manual/en/configuration-index.md b/docs/user-manual/en/configuration-index.md index 22d3c7e455..67b9823661 100644 --- a/docs/user-manual/en/configuration-index.md +++ b/docs/user-manual/en/configuration-index.md @@ -320,6 +320,7 @@ Name | Description [address](diverts.md) | the address this divert will divert from [forwarding-address](diverts.md) | the forwarding address for the divert [filter](diverts.md) | optional core filter expression +[routing-type](diverts.md) | how to set the routing-type on the diverted message. Default=`STRIP` ## address type diff --git a/docs/user-manual/en/diverts.md b/docs/user-manual/en/diverts.md index 5681e96f5c..aa78980b69 100644 --- a/docs/user-manual/en/diverts.md +++ b/docs/user-manual/en/diverts.md @@ -14,13 +14,23 @@ and a *copy* of it is also sent to the new address. Non-exclusive diverts can therefore be used for *splitting* message flows, e.g. there may be a requirement to monitor every order sent to an order queue. -Diverts can also be configured to have an optional message filter. If -specified then only messages that match the filter will be diverted. - When an address has both exclusive and non-exclusive diverts configured, the exclusive ones are processed first. If any of the exclusive diverts diverted the message, the non-exclusive ones are not processed. +Diverts can also be configured to have an optional message filter. If +specified then only messages that match the filter will be diverted. + +Diverts can apply a particular routing-type to the message, strip the +existing routing type, or simply pass the existing routing-type through. +This is useful in situations where the message may have its routing-type +set but you want to divert it to an address using a different routing-type. +It's important to keep in mind that a message with the `anycast` +routing-type will not actually be routed to queues using `multicast` and +vice-versa. By configuring the `routing-type` of the divert you have the +flexibility to deal with any situation. Valid values are `ANYCAST`, +`MULTICAST`, `PASS`, & `STRIP`. The default is `STRIP`. + Diverts can also be configured to apply a `Transformer`. If specified, all diverted messages will have the opportunity of being transformed by the `Transformer`. When an address has multiple diverts configured, all