TemplateSnippets - Revision history

Phanousk: /* Tips&Tricks */

2020-03-06T16:26:02Z

Tips&Tricks

← Older revision		Revision as of 12:26, 6 March 2020
Line 142:		Line 142:
	Don't show content if it's empty		Don't show content if it's empty

	{ if( my $tcc = $Ticket->CcAddresses ) { "Ticket Ccs: ". $tcc } }		<pre>{ if( my $tcc = $Ticket->CcAddresses ) { "Ticket Ccs: ". $tcc } }
	{ if( my $qcc = $Ticket->QueueObj->CcAddresses ) { "Queue Ccs: ". $qcc } }		{ if( my $qcc = $Ticket->QueueObj->CcAddresses ) { "Queue Ccs: ". $qcc } }
	{ if( my $tacc = $Ticket->AdminCcAddresses ) { "Ticket AdminCcs: ". $tacc } }		{ if( my $tacc = $Ticket->AdminCcAddresses ) { "Ticket AdminCcs: ". $tacc } }</pre>

	= See also =		= See also =

	[[Template]], [[CodeSnippets]], [[CustomConditionSnippets]]		[[Template]], [[CodeSnippets]], [[CustomConditionSnippets]]

Phanousk: /* Complex */

2020-03-06T16:25:39Z

Complex

← Older revision		Revision as of 12:25, 6 March 2020
Line 132:		Line 132:
	Add the number of tickets in queue:		Add the number of tickets in queue:

	There are currently {		<pre>There are currently {
	my $tickets = RT::Tickets->new( $RT::SystemUser );		my $tickets = RT::Tickets->new( $RT::SystemUser );
	$tickets->FromSQL( "Status = 'new' AND Queue = ". $Ticket->Queue );		$tickets->FromSQL( "Status = 'new' AND Queue = ". $Ticket->Queue );
	$tickets->Count;		$tickets->Count;
	} ticket(s) awaiting processing before yours, please be patient.		} ticket(s) awaiting processing before yours, please be patient.</pre>

	= Tips&Tricks =		= Tips&Tricks =

Phanousk: /* Dates */

2020-03-06T16:24:41Z

Dates

← Older revision		Revision as of 12:24, 6 March 2020
Line 98:		Line 98:
	Ticket creation time as formatted string:		Ticket creation time as formatted string:

	{ $Ticket->CreatedAsString }		<pre>{ $Ticket->CreatedAsString }</pre>

	The same:		The same:

	{ $Ticket->CreatedObj->AsString }		<pre>{ $Ticket->CreatedObj->AsString }</pre>

	The same for Transaction		The same for Transaction
	{ $Transaction->CreatedAsString }		<pre>{ $Transaction->CreatedAsString }</pre>

	<p style="margin-top:1em;margin-bottom:1em;font-size:13.333333015441895px;">Show the first date that is set:</p>		<p style="margin-top:1em;margin-bottom:1em;font-size:13.333333015441895px;">Show the first date that is set:</p>
Line 124:		Line 124:
	You often want to show a ''relative'' ("friendly" or "humanized") date, ie "due in 35 minutes". The same approach will work for any of the $Ticket object's other dates, like Start, too. It and will append "ago" where the date is in the past.		You often want to show a ''relative'' ("friendly" or "humanized") date, ie "due in 35 minutes". The same approach will work for any of the $Ticket object's other dates, like Start, too. It and will append "ago" where the date is in the past.

	{ $Ticket->DueObj->AgeAsString() }		<pre>{ $Ticket->DueObj->AgeAsString() }</pre>

	This will work fine in templates invoked with rt-crontool.		This will work fine in templates invoked with rt-crontool.

Phanousk: /* People */

2020-03-06T16:23:37Z

People

← Older revision		Revision as of 12:23, 6 March 2020
Line 82:		Line 82:
	Requestors' names or other properties		Requestors' names or other properties

	<~~nowiki~~>Requestors: {		<pre>Requestors: {
	# 'Requestors' may be replaced with 'Cc' or 'AdminCc'		# 'Requestors' may be replaced with 'Cc' or 'AdminCc'
	my $users = $Ticket->Requestors->UserMembersObj;		my $users = $Ticket->Requestors->UserMembersObj;
Line 92:		Line 92:
	$output;		$output;
	}		}
	</~~nowiki~~>		</pre>

	== Dates ==		== Dates ==

Phanousk: /* People */

2020-03-06T16:23:00Z

People

Phanousk: /* Basics */

2020-03-06T16:21:23Z

Basics

← Older revision		Revision as of 12:21, 6 March 2020
Line 37:		Line 37:

	Ticket status		Ticket status

	{ $Ticket->Status }		<pre>{ $Ticket->Status }</pre>

	Queue name		Queue name

	{ $Ticket->QueueObj->Name }		<pre>{ $Ticket->QueueObj->Name }</pre>

	Insert Queue email address for correspondence/comment		Insert Queue email address for correspondence/comment

	{ $Ticket->QueueObj->CorrespondAddress; }		<pre>{ $Ticket->QueueObj->CorrespondAddress; }
	{ $Ticket->QueueObj->CommentAddress; }		{ $Ticket->QueueObj->CommentAddress; }</pre>

	Puts content of the first transaction into email		Puts content of the first transaction into email

	{ $Ticket->Transactions->First->Content }		<pre>{ $Ticket->Transactions->First->Content }</pre>

	== People ==		== People ==

Phanousk: /* Dates */

2017-11-15T16:55:40Z

Dates

← Older revision		Revision as of 12:55, 15 November 2017
Line 113:		Line 113:
	my $date;		my $date;
	foreach my $method ( qw(ToldObj LastUpdatedObj CreatedObj) ) {		foreach my $method ( qw(ToldObj LastUpdatedObj CreatedObj) ) {
	$date = $Ticket-~~>~~$method(); # get date		$date = $Ticket->$method(); # get date
	last if $date-~~>~~Unix ~~>~~ 0; # stop on first that is set		last if $date->Unix > 0; # stop on first that is set
	}		}
	$date->AsString;		$date->AsString;

Phanousk: /* Dates */

2017-11-15T16:54:57Z

Dates

← Older revision		Revision as of 12:54, 15 November 2017
Line 116:		Line 116:
	last if $date->Unix > 0; # stop on first that is set		last if $date->Unix > 0; # stop on first that is set
	}		}
	$date-~~>~~AsString;		$date->AsString;
	}		}
	</source>		</source>

Phanousk: /* Dates */

2017-11-15T16:54:27Z

Dates

← Older revision		Revision as of 12:54, 15 November 2017
Line 109:		Line 109:
	<p style="margin-top:1em;margin-bottom:1em;font-size:13.333333015441895px;">Show the first date that is set:</p>		<p style="margin-top:1em;margin-bottom:1em;font-size:13.333333015441895px;">Show the first date that is set:</p>

			<source lang="perl">
	This ticket was last active on {		This ticket was last active on {
	my $date;		my $date;
Line 117:		Line 118:
	$date->AsString;		$date->AsString;
	}		}
			</source>

	=== Relative dates===		=== Relative dates===

Phanousk: /* Notification templates specifics */

2017-11-15T16:43:09Z

Notification templates specifics

← Older revision		Revision as of 12:43, 15 November 2017
Line 19:		Line 19:
	When you put a variable, like the above status example, in a template, it gets printed. If your template had the above snippet, you would see the status of the ticket in the resulting output. However, you can do a lot more than just outputting a variable's contents. Here's how to append a lot of text to a local variable before you print it. Note that here, we use "my" to signify a local variable, as opposed to a variable RT makes available to us.		When you put a variable, like the above status example, in a template, it gets printed. If your template had the above snippet, you would see the status of the ticket in the resulting output. However, you can do a lot more than just outputting a variable's contents. Here's how to append a lot of text to a local variable before you print it. Note that here, we use "my" to signify a local variable, as opposed to a variable RT makes available to us.

	<~~code><pre~~>		<source lang="perl">
	{ my $out = '';		{ my $out = '';
	$out .= "append some text line\n";		$out .= "append some text line\n";
Line 28:		Line 28:
	}		}

	</~~pre></code~~>		</source>

	Please notice that we used straight Perl in the above example. So long as it's within a set of braces ({}), any valid Perl syntax is allowed. Combine this with RT's variables, and you can see how powerful templates can be.		Please notice that we used straight Perl in the above example. So long as it's within a set of braces ({}), any valid Perl syntax is allowed. Combine this with RT's variables, and you can see how powerful templates can be.

← Older revision		Revision as of 12:23, 6 March 2020
Line 57:		Line 57:
	Get the email address of the user who created the ticket		Get the email address of the user who created the ticket

	{ $Ticket->CreatorObj->EmailAddress }		<pre>{ $Ticket->CreatorObj->EmailAddress }</pre>

	Get the email address of the user who created the transaction		Get the email address of the user who created the transaction

	{ $Transaction->CreatorObj->EmailAddress }		<pre>{ $Transaction->CreatorObj->EmailAddress }</pre>

	Get the name of the user who created the transaction		Get the name of the user who created the transaction

	{ $Transaction->CreatorObj->Name }		<pre>{ $Transaction->CreatorObj->Name }</pre>

	Get the name of the user who last updated the ticket		Get the name of the user who last updated the ticket

	{ $Ticket->LastUpdatedByObj->Name }		<pre>{ $Ticket->LastUpdatedByObj->Name }</pre>

	Get the email addresses of the Requestor(s)		Get the email addresses of the Requestor(s)

	{ $Ticket->RequestorAddresses }		<pre>{ $Ticket->RequestorAddresses }</pre>

	Get the email addresses of the users added as CC or AdminCC to the ticket		Get the email addresses of the users added as CC or AdminCC to the ticket

	{ $Ticket->CcAddresses }		<pre>{ $Ticket->CcAddresses }
	{ $Ticket->AdminCcAddresses }		{ $Ticket->AdminCcAddresses }</pre>

	Requestors' names or other properties		Requestors' names or other properties