Sending out the most recent Analyst Comment from the Action Log in Service Manager 2012

Article
03/21/2013

When an analyst adds a comment to the action log, it may be desirable to send this new comment out to the affected user with a nice email update like this:

This blog post walks through how to do it.

Firstly, in order to get a nicer looking email like the one above, start by creating the email in word how you want it to look:

I use these menu options to get my table:

and when done, save this as an HTML doc:

Open the HTML file in notepad or your text editor of choice.

Then create a notification template based on the class ‘Trouble Ticket Analyst Comments’

Copy the HTML from your text editor into the Service Manager template and don’t forget to click the “send as HTML’ checkbox!!!:

You remembered to check ‘Send as HTML’ right? I always forget that one Smile

And then you can add your values. I came across some slightly bizarre behavior here (if I figure out the ins-and-outs of this, I will blog it, or if you know – please feel free to comment Smile ) in that you had to add the value in a different way depending on if it is a service request or incident being updated. Therefore, in order for this to apply to both incidents and service requests, every value you insert has to be inserted twice using a slightly different format.

Let’s start with the subject line:

To add the ID if it’s an incident, click the Insert button, then’ Has Analyst Comment’, then in Available Properties, type ID, scroll down and choose the ID value shown under Work Item and click the Add button:

The only difference for the SR value, is that you click ‘Work Item has comment log’ rather than ‘Has Analyst Comment’, then in Available Properties, type ID, and then scroll down and choose the ID value shown under work item and click the Add button:

NOTE be sure to have a space between 2 strings, as shown below

$Context/Path[Relationship='CustomSystem_WorkItem_Library!System.WorkItem.TroubleTicketHasAnalystComment' SeedRole='Target' TypeConstraint='CustomSystem_WorkItem_Library!System.WorkItem']/Property[Type='CustomSystem_WorkItem_Library!System.WorkItem']/Id$ $Context/Path[Relationship='CustomSystem_WorkItem_Library!System.WorkItemHasCommentLog' SeedRole='Target' TypeConstraint='CustomSystem_WorkItem_Library!System.WorkItem']/Property[Type='CustomSystem_WorkItem_Library!System.WorkItem']/Id$ Updated with Comment

Next you need to find all the placeholders you put in the word doc, and use the ‘Insert’ button to replace these with the strings that will bring in the actual values from the Incident / SR. In my experience, you always seem to find it about two thirds / three quarters of the way down if you created the HTML using word like I did:

Highlight over the placeholder (placeholderID in this case) and then click the Insert button

(Notice how I’m missing ‘Send as HTML’ above – that’s just me checking you’re paying attention Smile )

Now it’s the same as how you added the ID in the subject line (remember to do once using the ‘Has analyst comment’ related class, and once using the ‘Work Item Has comment Log’ related class, to catch it for both Incidents and service requests.

And then repeat this for the other placeholder fields. So for instance with Title, use the ‘Has Analyst Comment’ title first:

Please don’t forget the space! And then do the same for ‘Work Item Has comment log’:

For My ‘Assigned Analyst’ I use the Entered by value under ‘Trouble Ticket Analyst Comments’ (this only needs to be selected once):

For comment you can use this one and it only needs to be selected once also:

I ended up with this as my body:

<head>
< meta http-equiv=Content-Type content="text/html; charset=windows-1252">
< meta name=ProgId content=Word.Document>
< meta name=Generator content="Microsoft Word 14">
< meta name=Originator content="Microsoft Word 14">
< link rel=File-List href="CommnetUpdate_files/filelist.xml">
< !--[if gte mso 9]><xml>
< o:DocumentProperties>
< o:Author>Administrator</o:Author>
< o:LastAuthor>Administrator</o:LastAuthor>
< o:Revision>1</o:Revision>
< o:TotalTime>11</o:TotalTime>
< o:Created>2013-03-22T04:49:00Z</o:Created>
< o:LastSaved>2013-03-22T05:00:00Z</o:LastSaved>
< o:Pages>1</o:Pages>
< o:Words>31</o:Words>
< o:Characters>178</o:Characters>
< o:Company>Microsoft Corporation</o:Company>
< o:Lines>1</o:Lines>
< o:Paragraphs>1</o:Paragraphs>
< o:CharactersWithSpaces>208</o:CharactersWithSpaces>
< o:Version>14.00</o:Version>
< /o:DocumentProperties>
< o:OfficeDocumentSettings>
< o:AllowPNG/>
< /o:OfficeDocumentSettings>
< /xml><![endif]-->
< link rel=themeData href="CommnetUpdate_files/themedata.thmx">
< link rel=colorSchemeMapping href="CommnetUpdate_files/colorschememapping.xml">
< !--[if gte mso 9]><xml>
< w:WordDocument>
< w:SpellingState>Clean</w:SpellingState>
< w:GrammarState>Clean</w:GrammarState>
< w:TrackMoves>false</w:TrackMoves>
< w:TrackFormatting/>
< w:PunctuationKerning/>
< w:ValidateAgainstSchemas/>
< w:SaveIfXMLInvalid>false</w:SaveIfXMLInvalid>
< w:IgnoreMixedContent>false</w:IgnoreMixedContent>
< w:AlwaysShowPlaceholderText>false</w:AlwaysShowPlaceholderText>
< w:DoNotPromoteQF/>
< w:LidThemeOther>EN-US</w:LidThemeOther>
< w:LidThemeAsian>X-NONE</w:LidThemeAsian>
< w:LidThemeComplexScript>X-NONE</w:LidThemeComplexScript>
< w:Compatibility>
 < w:BreakWrappedTables/>
 < w:SnapToGridInCell/>
 < w:WrapTextWithPunct/>
 < w:UseAsianBreakRules/>
 < w:DontGrowAutofit/>
 < w:SplitPgBreakAndParaMark/>
 < w:EnableOpenTypeKerning/>
 < w:DontFlipMirrorIndents/>
 < w:OverrideTableStyleHps/>
</w:Compatibility>
< m:mathPr>
 < m:mathFont m:val="Cambria Math"/>
 < m:brkBin m:val="before"/>
 < m:brkBinSub m:val="--"/>
 < m:smallFrac m:val="off"/>
 < m:dispDef/>
 < m:lMargin m:val="0"/>
 < m:rMargin m:val="0"/>
 < m:defJc m:val="centerGroup"/>
 < m:wrapIndent m:val="1440"/>
 < m:intLim m:val="subSup"/>
 < m:naryLim m:val="undOvr"/>
</m:mathPr></w:WordDocument>
< /xml><![endif]-->
< style>
< !--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;
mso-font-charset:0;
mso-generic-font-family:roman;
mso-font-pitch:variable;
mso-font-signature:-536870145 1107305727 0 0 415 0;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;
mso-font-charset:0;
mso-generic-font-family:swiss;
mso-font-pitch:variable;
mso-font-signature:-520092929 1073786111 9 0 415 0;}
@font-face
{font-family:Tahoma;
panose-1:2 11 6 4 3 5 4 4 2 4;
mso-font-charset:0;
mso-generic-font-family:swiss;
mso-font-pitch:variable;
mso-font-signature:-520081665 -1073717157 41 0 66047 0;}
@font-face
{font-family:"Segoe UI";
panose-1:2 11 5 2 4 2 4 2 2 3;
mso-font-charset:0;
mso-generic-font-family:swiss;
mso-font-pitch:variable;
mso-font-signature:-520084737 -1073683329 41 0 479 0;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{mso-style-unhide:no;
mso-style-qformat:yes;
mso-style-parent:"";
margin-top:0in;
margin-right:0in;
margin-bottom:10.0pt;
margin-left:0in;
line-height:115%;
mso-pagination:widow-orphan;
font-size:11.0pt;
font-family:"Calibri","sans-serif";
mso-ascii-font-family:Calibri;
mso-ascii-theme-font:minor-latin;
mso-fareast-font-family:Calibri;
mso-fareast-theme-font:minor-latin;
mso-hansi-font-family:Calibri;
mso-hansi-theme-font:minor-latin;
mso-bidi-font-family:"Times New Roman";
mso-bidi-theme-font:minor-bidi;}
p.MsoAcetate, li.MsoAcetate, div.MsoAcetate
{mso-style-noshow:yes;
mso-style-priority:99;
mso-style-link:"Balloon Text Char";
margin:0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
font-size:8.0pt;
font-family:"Tahoma","sans-serif";
mso-fareast-font-family:Calibri;
mso-fareast-theme-font:minor-latin;}
span.BalloonTextChar
{mso-style-name:"Balloon Text Char";
mso-style-noshow:yes;
mso-style-priority:99;
mso-style-unhide:no;
mso-style-locked:yes;
mso-style-link:"Balloon Text";
mso-ansi-font-size:8.0pt;
mso-bidi-font-size:8.0pt;
font-family:"Tahoma","sans-serif";
mso-ascii-font-family:Tahoma;
mso-hansi-font-family:Tahoma;
mso-bidi-font-family:Tahoma;}
span.SpellE
{mso-style-name:"";
mso-spl-e:yes;}
span.GramE
{mso-style-name:"";
mso-gram-e:yes;}
.MsoChpDefault
{mso-style-type:export-only;
mso-default-props:yes;
font-family:"Calibri","sans-serif";
mso-ascii-font-family:Calibri;
mso-ascii-theme-font:minor-latin;
mso-fareast-font-family:Calibri;
mso-fareast-theme-font:minor-latin;
mso-hansi-font-family:Calibri;
mso-hansi-theme-font:minor-latin;
mso-bidi-font-family:"Times New Roman";
mso-bidi-theme-font:minor-bidi;}
.MsoPapDefault
{mso-style-type:export-only;
margin-bottom:10.0pt;
line-height:115%;}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;
mso-header-margin:.5in;
mso-footer-margin:.5in;
mso-paper-source:0;}
div.WordSection1
{page:WordSection1;}
-->
< /style>
< !--[if gte mso 10]>
< style>
/* Style Definitions */
table.MsoNormalTable
{mso-style-name:"Table Normal";
mso-tstyle-rowband-size:0;
mso-tstyle-colband-size:0;
mso-style-noshow:yes;
mso-style-priority:99;
mso-style-parent:"";
mso-padding-alt:0in 5.4pt 0in 5.4pt;
mso-para-margin-top:0in;
mso-para-margin-right:0in;
mso-para-margin-bottom:10.0pt;
mso-para-margin-left:0in;
line-height:115%;
mso-pagination:widow-orphan;
font-size:11.0pt;
font-family:"Calibri","sans-serif";
mso-ascii-font-family:Calibri;
mso-ascii-theme-font:minor-latin;
mso-hansi-font-family:Calibri;
mso-hansi-theme-font:minor-latin;
mso-bidi-font-family:"Times New Roman";
mso-bidi-theme-font:minor-bidi;}
table.MsoTableGrid
{mso-style-name:"Table Grid";
mso-tstyle-rowband-size:0;
mso-tstyle-colband-size:0;
mso-style-priority:59;
mso-style-unhide:no;
border:solid windowtext 1.0pt;
mso-border-alt:solid windowtext .5pt;
mso-padding-alt:0in 5.4pt 0in 5.4pt;
mso-border-insideh:.5pt solid windowtext;
mso-border-insidev:.5pt solid windowtext;
mso-para-margin:0in;
mso-para-margin-bottom:.0001pt;
mso-pagination:widow-orphan;
font-size:11.0pt;
font-family:"Calibri","sans-serif";
mso-ascii-font-family:Calibri;
mso-ascii-theme-font:minor-latin;
mso-hansi-font-family:Calibri;
mso-hansi-theme-font:minor-latin;
mso-bidi-font-family:"Times New Roman";
mso-bidi-theme-font:minor-bidi;}
table.MsoTableMediumGrid1Accent3
{mso-style-name:"Medium Grid 1 - Accent 3";
mso-tstyle-rowband-size:1;
mso-tstyle-colband-size:1;
mso-style-priority:67;
mso-style-unhide:no;
border:solid #B3CC82 1.0pt;
mso-border-themecolor:accent3;
mso-border-themetint:191;
mso-padding-alt:0in 5.4pt 0in 5.4pt;
mso-border-insideh:1.0pt solid #B3CC82;
mso-border-insideh-themecolor:accent3;
mso-border-insideh-themetint:191;
mso-border-insidev:1.0pt solid #B3CC82;
mso-border-insidev-themecolor:accent3;
mso-border-insidev-themetint:191;
mso-tstyle-shading:#E6EED5;
mso-tstyle-shading-themecolor:accent3;
mso-tstyle-shading-themetint:63;
mso-para-margin:0in;
mso-para-margin-bottom:.0001pt;
mso-pagination:widow-orphan;
font-size:11.0pt;
font-family:"Calibri","sans-serif";
mso-ascii-font-family:Calibri;
mso-ascii-theme-font:minor-latin;
mso-hansi-font-family:Calibri;
mso-hansi-theme-font:minor-latin;
mso-bidi-font-family:"Times New Roman";
mso-bidi-theme-font:minor-bidi;}
table.MsoTableMediumGrid1Accent3FirstRow
{mso-style-name:"Medium Grid 1 - Accent 3";
mso-table-condition:first-row;
mso-style-priority:67;
mso-style-unhide:no;
mso-ansi-font-weight:bold;
mso-bidi-font-weight:bold;}
table.MsoTableMediumGrid1Accent3LastRow
{mso-style-name:"Medium Grid 1 - Accent 3";
mso-table-condition:last-row;
mso-style-priority:67;
mso-style-unhide:no;
mso-tstyle-border-top:2.25pt solid #B3CC82;
mso-tstyle-border-top-themecolor:accent3;
mso-tstyle-border-top-themetint:191;
mso-ansi-font-weight:bold;
mso-bidi-font-weight:bold;}
table.MsoTableMediumGrid1Accent3FirstCol
{mso-style-name:"Medium Grid 1 - Accent 3";
mso-table-condition:first-column;
mso-style-priority:67;
mso-style-unhide:no;
mso-ansi-font-weight:bold;
mso-bidi-font-weight:bold;}
table.MsoTableMediumGrid1Accent3LastCol
{mso-style-name:"Medium Grid 1 - Accent 3";
mso-table-condition:last-column;
mso-style-priority:67;
mso-style-unhide:no;
mso-ansi-font-weight:bold;
mso-bidi-font-weight:bold;}
table.MsoTableMediumGrid1Accent3OddColumn
{mso-style-name:"Medium Grid 1 - Accent 3";
mso-table-condition:odd-column;
mso-style-priority:67;
mso-style-unhide:no;
mso-tstyle-shading:#CDDDAC;
mso-tstyle-shading-themecolor:accent3;
mso-tstyle-shading-themetint:127;}
table.MsoTableMediumGrid1Accent3OddRow
{mso-style-name:"Medium Grid 1 - Accent 3";
mso-table-condition:odd-row;
mso-style-priority:67;
mso-style-unhide:no;
mso-tstyle-shading:#CDDDAC;
mso-tstyle-shading-themecolor:accent3;
mso-tstyle-shading-themetint:127;}
< /style>
< ![endif]-->
< /head>

Your Incident / Service Request was just
updated:<o:p></o:p>

<table class=MsoTableMediumGrid1Accent3 border=1 cellspacing=0 cellpadding=0
style='border-collapse:collapse;border:none;mso-border-alt:solid windowtext .25pt;
mso-yfti-tbllook:1184;mso-padding-alt:0in 5.4pt 0in 5.4pt;mso-border-insideh:
.25pt solid windowtext;mso-border-insidev:.25pt solid windowtext'>
< tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes'>
<td width=319 valign=top style='width:239.4pt;border:solid windowtext 1.0pt;
mso-border-alt:solid windowtext .25pt;background:#E6EED5;mso-background-themecolor:
accent3;mso-background-themetint:63;padding:0in 5.4pt 0in 5.4pt'>
ID<o:p></o:p>
</td>
<td width=319 valign=top style='width:239.4pt;border:solid windowtext 1.0pt;
border-left:none;mso-border-left-alt:solid windowtext .25pt;mso-border-alt:
solid windowtext .25pt;background:#E6EED5;mso-background-themecolor:accent3;
mso-background-themetint:63;padding:0in 5.4pt 0in 5.4pt'>
$Context/Path[Relationship='CustomSystem_WorkItem_Library!System.WorkItem.TroubleTicketHasAnalystComment' SeedRole='Target' TypeConstraint='CustomSystem_WorkItem_Library!System.WorkItem']/Property[Type='CustomSystem_WorkItem_Library!System.WorkItem']/Id$ $Context/Path[Relationship='CustomSystem_WorkItem_Library!System.WorkItemHasCommentLog' SeedRole='Target' TypeConstraint='CustomSystem_WorkItem_Library!System.WorkItem']/Property[Type='CustomSystem_WorkItem_Library!System.WorkItem']/Id$<o:p></o:p>
</td>
< /tr>
< tr style='mso-yfti-irow:0'>
<td width=319 valign=top style='width:239.4pt;border:solid windowtext 1.0pt;
border-top:none;mso-border-top-alt:solid windowtext .25pt;mso-border-alt:
solid windowtext .25pt;background:#CDDDAC;mso-background-themecolor:accent3;
mso-background-themetint:127;padding:0in 5.4pt 0in 5.4pt'>
Title<o:p></o:p>
</td>
<td width=319 valign=top style='width:239.4pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
mso-border-top-alt:solid windowtext .25pt;mso-border-left-alt:solid windowtext .25pt;
mso-border-alt:solid windowtext .25pt;background:#CDDDAC;mso-background-themecolor:
accent3;mso-background-themetint:127;padding:0in 5.4pt 0in 5.4pt'>
$Context/Path[Relationship='CustomSystem_WorkItem_Library!System.WorkItem.TroubleTicketHasAnalystComment' SeedRole='Target' TypeConstraint='CustomSystem_WorkItem_Library!System.WorkItem']/Property[Type='CustomSystem_WorkItem_Library!System.WorkItem']/Title$ $Context/Path[Relationship='CustomSystem_WorkItem_Library!System.WorkItemHasCommentLog' SeedRole='Target' TypeConstraint='CustomSystem_WorkItem_Library!System.WorkItem']/Property[Type='CustomSystem_WorkItem_Library!System.WorkItem']/Title$<o:p></o:p>
</td>
< /tr>
< tr style='mso-yfti-irow:1'>
<td width=319 valign=top style='width:239.4pt;border:solid windowtext 1.0pt;
border-top:none;mso-border-top-alt:solid windowtext .25pt;mso-border-alt:
solid windowtext .25pt;background:#E6EED5;mso-background-themecolor:accent3;
mso-background-themetint:63;padding:0in 5.4pt 0in 5.4pt'>
Status<o:p></o:p>
</td>
<td width=319 valign=top style='width:239.4pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
mso-border-top-alt:solid windowtext .25pt;mso-border-left-alt:solid windowtext .25pt;
mso-border-alt:solid windowtext .25pt;background:#E6EED5;mso-background-themecolor:
accent3;mso-background-themetint:63;padding:0in 5.4pt 0in 5.4pt'>
$Context/Path[Relationship='CustomSystem_WorkItem_Library!System.WorkItem.TroubleTicketHasAnalystComment' SeedRole='Target' TypeConstraint='CustomSystem_WorkItem_Incident_Library!System.WorkItem.Incident']/Property[Type='CustomSystem_WorkItem_Incident_Library!System.WorkItem.Incident']/Status$ $Context/Path[Relationship='CustomSystem_WorkItem_Library!System.WorkItemHasCommentLog' SeedRole='Target' TypeConstraint='CustomSystem_WorkItem_ServiceRequest_Library!System.WorkItem.ServiceRequest']/Property[Type='CustomSystem_WorkItem_ServiceRequest_Library!System.WorkItem.ServiceRequest']/Status$<o:p></o:p>
</td>
< /tr>
< tr style='mso-yfti-irow:2'>
<td width=319 valign=top style='width:239.4pt;border:solid windowtext 1.0pt;
border-top:none;mso-border-top-alt:solid windowtext .25pt;mso-border-alt:
solid windowtext .25pt;background:#CDDDAC;mso-background-themecolor:accent3;
mso-background-themetint:127;padding:0in 5.4pt 0in 5.4pt'>
Assigned
Analyst<o:p></o:p>
</td>
<td width=319 valign=top style='width:239.4pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
mso-border-top-alt:solid windowtext .25pt;mso-border-left-alt:solid windowtext .25pt;
mso-border-alt:solid windowtext .25pt;background:#CDDDAC;mso-background-themecolor:
accent3;mso-background-themetint:127;padding:0in 5.4pt 0in 5.4pt'>
$Context/Property[Type='CustomSystem_WorkItem_Library!System.WorkItem.CommentLog']/EnteredBy$<o:p></o:p>
</td>
< /tr>
< tr style='mso-yfti-irow:3;mso-yfti-lastrow:yes'>
<td width=319 valign=top style='width:239.4pt;border:solid windowtext 1.0pt;
border-top:none;mso-border-top-alt:solid windowtext .25pt;mso-border-alt:
solid windowtext .25pt;background:#E6EED5;mso-background-themecolor:accent3;
mso-background-themetint:63;padding:0in 5.4pt 0in 5.4pt'>
Comment<o:p></o:p>
</td>
<td width=319 valign=top style='width:239.4pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
mso-border-top-alt:solid windowtext .25pt;mso-border-left-alt:solid windowtext .25pt;
mso-border-alt:solid windowtext .25pt;background:#E6EED5;mso-background-themecolor:
accent3;mso-background-themetint:63;padding:0in 5.4pt 0in 5.4pt'>
$Context/Property[Type='CustomSystem_WorkItem_Library!System.WorkItem.CommentLog']/Comment$<o:p></o:p>
</td>
< /tr>
< /table>

<o:p> </o:p>

From
the IT ServiceDesk<o:p></o:p>

<o:p> </o:p>

</div>

</body>

</html>

and this was my subject:

And all we need to do now is create the subscription.

Be sure to use ‘When an object of the selected class is created’ (we are keying off a new comment being created – remember the class we picked) and select the same targeted Class we based the notification template on (Trouble Ticket Analyst Comments):

You may also like to add the following clause in ‘Additional Criteria’ so that if the Analyst marks it as Private, it does not get sent out to the Affected User (you might want to test this first Smile ):

In the template page, you will select the template we just put all that fine work into:

We will not select anyone in Recipient as instead we are going to take advantage of ‘Related Recipients’:

In Related Recipients, choose the affected user for both ‘Has Analyst Comment’ and ‘Work Item Has Comment Log’ and then we will send it out to the affected user regardless of if it is an incident or a service request:

and your end result should be:

You could also add the Assigned Analyst also if you wanted to, so they get confirmation via email of the update they made:

And that’s it!! Try updating an Incident / SR, and the end result will look something like this:

Happy Notifying!

Sending out the most recent Analyst Comment from the Action Log in Service Manager 2012

Additional resources