CONTACT:
This is version 5 of ExtractCustomFieldValue which is a
contribution to the RT System , as
modified by Best Practical for customer use.
All bug reports and support requests should be referred to Best
Practical .
ACKNOWLEDGEMENT:
ExtractCustomFieldValue was originally written by Dirk Pape
.
PURPOSE:
ExtractCustomFieldValue consists of a new ScripAction
"ExtractCustomFieldValue", which can be used to scan incoming requests
to set values of custom fields.
INSTALL:
perl Makefile.PL
make install
make initdb
USE:
To use the ScripAction you have to create a Template and a Scrip in
RT. The Template consists of the lines which control the scanner. All
non comment lines are of the following format:
||||
where
is the name of a custom field (must be created in RT)
is either a Name of an email header or "body" to scan the
body of the email
is a reg. expr. to find a match in the header or body
if the MatchString matches a comma separated list
and the cf is a multi value cf then each item in the
list is added as a separate value
is a perl command to be evaluated on $_, where $_ is either
$1 or $& from the match performed with
is a string of letters which may control some aspects.
In this time the only letter with a meaning is "q":
q - (quiet) do not record a transaction when adding a CFV
you can change the Separator string (initially "\|") during the template with a line
Separator=
e.g. Separator=\|--\|
this may be necessary, if you want to use a "|" in one of the patterns in
the controlling lines.
an example template with some further explanations is installed on
"make install" or "make insert-template".
CHANGES:
Best Practical local:
* Converted to RTx module.
1.2b1
added support for multiple value custom fields (values sep. by ",")
(Thanks to Steven Turner, MIT)
1.1b3
corrected a typo, which reappeared from a temporary version
1.1b2
added Command to change the Separator througout the template
1.1b1
added Option "q" for not recording transactions
1.0b2
fixed a bug, when called for a transaction without Attachment