Tharn at 21:18, 17 August 2016

2016-08-17T21:18:19Z

← Older revision		Revision as of 17:18, 17 August 2016
Line 41:		Line 41:
	== The Template ==		== The Template ==

	<~~nowiki~~>To: {		<pre>
			To: {
	my $GroupName = 'IT';		my $GroupName = 'IT';

Line 71:		Line 72:
	{$Transaction->Content()}		{$Transaction->Content()}

	</~~nowiki~~>		</pre>

	'''NOTE:''' Don't add any characters before '{' or after '}'.		'''NOTE:''' Don't add any characters before '{' or after '}'.

Admin: 5 revisions imported

2016-04-06T20:08:52Z

5 revisions imported

← Older revision		Revision as of 16:08, 6 April 2016
(No difference)

92.41.251.241: Added shorter example for template.

2012-07-20T20:20:52Z

Added shorter example for template.

New page

= RT 3.8 =

You can use RT <del>sbin/rt-notify-group-admin</del> <code>rt-email-group-admin</code> to create scrip actions to notify groups and or users.

<del>It looks like the above script no longer exists, and instead was replaced by the concept of 'Queue Watchers' at some point. See the Queue Admin page to select watchers.</del>

The script is in <code>RTHOME/sbin</code> (confirmed in 3.8.6 and up to 3.8.8) and can be used to create new actions that can notify an existing Group or a group of Users. Useful when you need to notify a group only when a special condition is met (i.e. send email to users in the group Dispatchers when a new ticket is created).

The 'Queue Watchers' feature is instead useful when you want a Group (or a User) to automatically be CC or AdminCC of each ticket that belongs to the watched queue.

= RT 3.6 and older =

Above script is part of an extension that has been integrated into RT 3.8. In 3.6 and older versions you can install [http://search.cpan.org/dist/RT-Action-NotifyGroup RT-Action-NotifyGroup] from CPAN.

= Using custom code in Templates =

== Description ==

This [[Template]] will email the members of an RT [[Group]]. The default template code is for when a new ticket is created, but you can change it to include whatever message you would like.

== Author/Contributors ==

Original author: Jeff Hoover (jhoov)

The majority of the perl code was taken from the [[OnCreateAddGroupCc]] [[ScripAction]].

== How To Use ==

These instructions assume you want to be emailed when a new ticket is created:

1. Create a new template with the code below, replacing the $[[GroupName]] variable with the name of the RT group you want to email.

2. Create a scrip that uses the template:

Description: On Create Notify IT
Condition: On Create
Action: Notify Other Recipients
Template: <your template from step 1>
Stage: TransactionCreate

== The Template ==

<nowiki>To: {
my $GroupName = 'IT';

# instantiate a group object
my $addGroupObj = RT::Group->new($RT::SystemUser);
$addGroupObj->LoadUserDefinedGroup($GroupName);
return undef unless $addGroupObj;
my $addGroupMembersObj = $addGroupObj->UserMembersObj;

my $res = '';
# walk through members of group
while ( my $userObj = $addGroupMembersObj->Next) {
my $email = $userObj->EmailAddress;
next unless $email; # email can be empty

$res .= ', ' if $res;
$res .= $email;
}
$res;
}
RT-Attach-Message: yes

A new ticket was created in the {$Ticket->QueueObj->Name} queue.

Subject: {$Transaction->Subject || $Ticket->Subject || "(No subject given)"}
Requestors: {$Ticket->RequestorAddresses}
Ticket <URL: {$RT::WebURL}Ticket/Display.html?id={$Ticket->id} >

{$Transaction->Content()}

</nowiki>

'''NOTE:''' Don't add any characters before '{' or after '}'.

Or, in RT 4 you can just use this:

<nowiki>
To: { my $group = RT::Group->new( $RT::SystemUser ); $group->LoadUserDefinedGroup("group name here"); $group->MemberEmailAddressesAsString; }
...
</nowiki>

EmailGroup - Revision history

Tharn at 21:18, 17 August 2016

Admin: 5 revisions imported

92.41.251.241: Added shorter example for template.