Source string Read only

type: Content of: <section><section><section><itemizedlist><listitem><para>
29/290
Context English State
Example job for the filter module <literal>Kernel::System::PostMaster::Filter::ExternalTicketNumberRecognition</literal>
# Job Name: ExternalTicketNumberRecognition
# External Ticket Number Reconition, check for Incident-<number> in incoming mails subject and
# body from the addeesses <sender>@externalticket.com, if number is found it will be stored in
# the dynamic field 'ExternalNumber' (that need to be setup in the Admin Panel).
$Self->{'PostMaster::PreFilterModule'}->{'000-ExternalTicketNumberRecognition'} = {
'FromAddressRegExp' => '\\s*@externalticket.com',
'NumberRegExp' => 'Incident-(\\d.*)',
'SearchInSubject' => '1',
'SearchInBody' => '1',
'TicketStateTypes' => 'new;open'
'DynamicFieldName' => 'ExternalNumber',
'Module' => 'Kernel::System::PostMaster::Filter::ExternalTicketNumberRecognition',
'Name' => 'Test External Ticket Number',
'SenderType' => 'system',
};
<emphasis>Configuration Options</emphasis>
<literal>FromAddressRegExp</literal>
This is an optional setting. Only mails matching this <emphasis>From:</emphasis> address will be considered for this filter. You can adjust this setting to the sender address your external system uses for outgoing mails. In case this address can differ, you can set this option to empty. OTRS will in that case not check the sender address.
<literal>NumberRegExp</literal>
This is a mandatory setting. This setting contains the regular expression OTRS will use to extract the ticket number out of the subject and/or ticket body. The default regular expression will match occurrences of for example 'Incident-12354' and will put the part between parentheses in the dynamic field field, in this case '12354'.
<literal>SearchInSubject</literal>
If this is set to '1', the email subject is searched for a ticket number.
<literal>SearchInBody</literal>
If this is set to '1', the email body is searched for a ticket number.
<literal>TicketStateTypes</literal>
This is an optional setting. If given, it will search OTRS only for open external tickets of given state types. The state types are separated with semicolons.
<literal>DynamicField</literal>
This is a required setting. It defines the dynamic filed that is used to store the external number (the field name must exist in the system and has to be valid).
<literal>SenderType</literal>
This defines the sender type used for the articles created in OTRS.
<literal>Kernel::System::PostMaster::Filter::Decrypt</literal> is a default module that is capable to decrypt an encrypted incoming email message (S/MIME or PGP) placing the unencrypted message body in the email header X-OTRS-BodyDecrypted to be processed later. Additionally it can also update the email body to the unencrypted version.
In order to decrypt the emails the system needs to be properly configured for S/MIME and/or PGP and have the needed private keys to decrypt the information.
This module is disabled by default and it can be configured directly in the System Configuration in the Admin Panel.
<literal>StoreDecryptedBody</literal>
Set this option to "1" to update the email body to the unencrypted version if the decryption was successful. Be aware that using this the emails will be stored unencrypted and there is no possible way to revert this action.
Of course it's also possible to develop your own PostMaster filter modules.
Troubleshooting Email Filtering
This section shows some common issues and things to consider when troubleshooting Postmaster filters.
The filters are worked in order of their alphabetically sorted filter names. The last filter wins for a certain field to be set, when the criteria match twice.
<emphasis>Stop After Match</emphasis> can prevent a second match.
Make sure the regular expression is valid.
Headers can be set as to control OTRS, but are not written in the mail itself.
When matching one From, CC, TO, use EMAILADDRESS: &lt;your@address&gt;
The Mailbox must be trusted.

Loading…

User avatar None

New source string

OTRS 6 / Administration ManualEnglish

New source string a year ago
Browse all component changes

Things to check

Multiple failing checks

The translations in several languages have failing checks

Reset

Glossary

English English
No related strings found in the glossary.

Source information

Source string comment
type: Content of: <section><section><section><itemizedlist><listitem><para>
Flags
read-only
Source string location
en/content/administration/email/email.xml:444
String age
a year ago
Source string age
a year ago
Translation file
i18n/doc-admin.pot, string 1809