Difference between revisions of "Inbound Routing Rules"
Jump to navigation
Jump to search
(9 intermediate revisions by 6 users not shown) | |||
Line 1: | Line 1: | ||
+ | This document can now be found at its new location in the [https://docs.hornbill.com/esp-config/email/using-email-routing-rules/ Hornbill Document Library]. | ||
+ | |||
+ | [[file:hornbill-document-library.png|Hornbill Cloud|link=https://docs.hornbill.com/esp-config/email/using-email-routing-rules/]] | ||
+ | <!-- | ||
+ | |||
<div style="border:1px solid #90C0FF; background:#D0E0FF; width:99%; padding:4px; margin-bottom:10px;"> | <div style="border:1px solid #90C0FF; background:#D0E0FF; width:99%; padding:4px; margin-bottom:10px;"> | ||
__NOTOC__[[Main Page|Home]] > [[Administration]] > [[System Administration|System]] > [[Email_Administration|Email]] > Email Routing Rules | __NOTOC__[[Main Page|Home]] > [[Administration]] > [[System Administration|System]] > [[Email_Administration|Email]] > Email Routing Rules | ||
Line 34: | Line 39: | ||
:* toAddress | :* toAddress | ||
:* toDomain | :* toDomain | ||
+ | :* ccAddress | ||
+ | :* ccDomain | ||
:* fromAddress | :* fromAddress | ||
:* fromDomain | :* fromDomain | ||
Line 93: | Line 100: | ||
− | LEFT('The Dog', 3) = | + | LEFT('The Dog', 3) = 'The' |
|- | |- | ||
Line 112: | Line 119: | ||
− | SUBSTRING( | + | SUBSTRING('The Dog', 5) = 'Dog' |
− | SUBSTRING( | + | SUBSTRING('The Dog', 5, 2) = 'Do' |
|- | |- | ||
Line 127: | Line 134: | ||
− | RIGHT( | + | RIGHT('The Dog', 2) = 'og' |
|- | |- | ||
Line 144: | Line 151: | ||
− | CONCAT(‘The’, ‘ ‘, 'Dog') = | + | CONCAT(‘The’, ‘ ‘, 'Dog') = 'The Dog' |
|- | |- | ||
Line 151: | Line 158: | ||
− | REGEX_MATCH( | + | REGEX_MATCH('String to match', 'regex to test') |
− | This function is based on | + | This function is based on Perl compatible regular expressions. Please see the following URL: - |
Line 169: | Line 176: | ||
− | This function is based on | + | This function is based on Perl compatible regular expressions. Please see the following URL: - |
Line 180: | Line 187: | ||
STRING_REPLACE(''needle'', ''haystack'', ''string'') | STRING_REPLACE(''needle'', ''haystack'', ''string'') | ||
+ | |||
+ | |- | ||
+ | | MESSAGE_HEADER | ||
+ | | Return the value of one message header present in the email message being evaluated. If header is not present this will return NULL. Available in platform build 3801 onwards | ||
+ | |||
+ | |||
+ | MESSAGE_HEADER('X-Header-Name') | ||
+ | |||
+ | |||
+ | For example: | ||
+ | |||
+ | MESSAGE_HEADER('Message-ID') LIKE '%some.domain.com%' | ||
|} | |} | ||
Line 202: | Line 221: | ||
:*'''Target Folder Failure''' | :*'''Target Folder Failure''' | ||
::In the case of a rule match but action failure the folder you would like the email routed to | ::In the case of a rule match but action failure the folder you would like the email routed to | ||
+ | :::In order to aid troubleshooting it is recommended that this is not set to "Inbox" as this will make it easier to distinguish between emails that were not picked up by a Rule (which will remain in the Inbox) and emails that were picked up but failed to process correctly (which will move to the Failure Folder) | ||
:*'''Reference''' | :*'''Reference''' | ||
:: This field can be used by the selected operation in order to correctly process the selected Operation. Refer to the application specific documentation to determine if this is required. | :: This field can be used by the selected operation in order to correctly process the selected Operation. Refer to the application specific documentation to determine if this is required. | ||
Line 241: | Line 261: | ||
:*Update an existing Service Request | :*Update an existing Service Request | ||
− | Note: For ''logOrUpdateIncident'', ''logOrUpdateServiceRequest'' and ''updateRequest'' operations the '''Reference''' field is a mandatory parameter. You will need to specify the Regex Syntax that matches your call reference. E.g. for the standard out-of-the-box reference use: '''[a-zA-Z]{2}[0-9]{8}''' | + | Note: For ''logOrUpdateIncident'', ''logOrUpdateServiceRequest'' and ''updateRequest'' operations the '''Reference''' field is a mandatory parameter. You will need to specify the Regex Syntax that matches your (call) reference in the email's '''Subject'''. E.g. for the standard out-of-the-box reference use: '''[a-zA-Z]{2}[0-9]{8}'''. |
+ | |||
+ | To match the same Reference format in the Rule Expression use the following: '''REGEX_MATCH(subject, '.*\b[a-zA-Z]{2}[0-9]{8}\b.*')''' | ||
[[Category:Administration]] | [[Category:Administration]] | ||
+ | --> | ||
+ | [[Category:HDOC]] |
Latest revision as of 19:56, 11 April 2024
This document can now be found at its new location in the Hornbill Document Library.