{"type":"doc","content":[{"type":"paragraph","content":[{"type":"status","attrs":{"color":"green","style":"bold","text":"Since v 2.4","localId":"1be2cd1f-c364-4df7-958f-fcc55e0da4fa"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"TemplateMe! allows you to obtain Insight custom field values and use it in the notification templates.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Integrations test were made for Insight versions 8.3.X","type":"text"}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":1},"content":[{"text":"How to add an Insight custom field in a template?","type":"text"}]},{"type":"paragraph","content":[{"text":"Let’s begin with this issue with these two insight custom fields (Operating system and CPU):","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":985,"id":"c80b4900-f938-44b0-b9c7-1d19175b9ec3","collection":"contentId-697466895","type":"file","height":423}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"If you want just to use the label value of these custom fields you can directly use the usual ","type":"text"},{"text":"$customfield_xxxxx","type":"text","marks":[{"type":"strong"}]},{"text":" tag in a template. For example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html"},"content":[{"text":"

CPU: $!customfield_10202

Operating system: $!customfield_10203

","type":"text"}]},{"type":"paragraph","content":[{"text":"Will render this email:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":263,"id":"0920dbbe-454d-4cb9-ae8f-8a0af2cd3df6","collection":"contentId-697466895","type":"file","height":102}}]},{"type":"paragraph","content":[{"text":"Easy peasy!","type":"text"}]},{"type":"paragraph","content":[{"text":"But let’s say I would like to also get the number of cores of the CPU:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":585,"id":"73a2eaf7-bab4-4957-81ed-a436f62e912a","collection":"contentId-697466895","type":"file","height":293}}]},{"type":"paragraph","content":[{"text":"We will need to access the Cores per processor attribute and we can do it using the ","type":"text"},{"text":"$insightcf","type":"text","marks":[{"type":"strong"}]},{"text":" tag in the template:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html"},"content":[{"text":"

CPU: $!customfield_10202

Number of cores: $!nsightcf.getObject(\"customfield_10202\",133).getValue()

Operating system: $!customfield_10203

","type":"text"}]},{"type":"paragraph","content":[{"text":"for the $insightcf we need two values: The first one is the customfield id – in our example, CPU is the customfield_10202. The second one if the attribute id value. We could get this value from the attributes page of the object type we want to use:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":957,"id":"cddbe46d-918b-4a57-babf-0e7077b5e9b3","collection":"contentId-697466895","type":"file","height":316}}]},{"type":"paragraph","content":[{"text":"In the case of the CPU’s Cores Per Processor the attribute ID is 133.","type":"text"}]},{"type":"paragraph","content":[{"text":"The previous template will be rendered this way:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":265,"id":"1a92bd24-0d59-47f5-83c2-cca6a01163e8","collection":"contentId-697466895","type":"file","height":128}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Linked objects","type":"text"}]},{"type":"paragraph","content":[{"text":"In the case the attribute you want to obtain is actually a link to another Insight object you have to proceed as follow:","type":"text"}]},{"type":"paragraph","content":[{"text":"Let’s say for the sake of the example that our CPU has a license attribute that directs to another Insight object:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":456,"id":"a3a03d72-d7c1-47f2-8412-63b5d425e46d","collection":"contentId-697466895","type":"file","height":267}}]},{"type":"paragraph","content":[{"text":"We want to get the license name and also the license expiration date in our email template:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":879,"id":"76a23741-0d60-45c1-a4d7-b7d9f64ffca2","collection":"contentId-697466895","type":"file","height":223}}]},{"type":"paragraph","content":[{"text":"We modify our template like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html"},"content":[{"text":"

CPU: $!customfield_10202

Number of cores: $!insightcf.getObject(\"customfield_10202\",133).getValue()

\n#set ($related_lincese = $!insightcf.getObject(\"customfield_10202\",193))\n

CPU License: $!insightcf.getRelatedObjectLabel($related_lincese)

CPU License end date: $!insightcf.getRelatedObjectAttribute($related_lincese,148).getValue()

Operating system: $!customfield_10203

","type":"text"}]},{"type":"paragraph","content":[{"text":"The key parts are these ones:","type":"text"}]},{"type":"paragraph","content":[{"text":"First of all we want to isolate the license and we do it in this line","type":"text"}]},{"type":"paragraph","content":[{"text":"#set ($related_lincese = $!insightcf.getObject(\"customfield_10202\",193))","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"We have the licensed assigned to the $related_license tag.","type":"text"}]},{"type":"paragraph","content":[{"text":"Now we want the label of the license and do it by calling this method:","type":"text"}]},{"type":"paragraph","content":[{"text":"$!insightcf.getRelatedObjectLabel($related_lincese)","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Also we can access the license attributes. Since the end date is the attribute 148 (you can get this info in the attribute view of the object type), we use this code to get that value:","type":"text"}]},{"type":"paragraph","content":[{"text":"

CPU License end date: $!insightcf.getRelatedObjectAttribute($related_lincese,148).getValue()

","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The previous template will render this way:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":421,"id":"324e7702-9ca5-482c-b5eb-90145eaf2df1","collection":"contentId-697466895","type":"file","height":189}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"An attribute is a list of insight objects","type":"text"}]},{"type":"paragraph","content":[{"text":"In all the previous examples we have seen single values. But your Insight object could have a list of values in an attribute.","type":"text"}]},{"type":"paragraph","content":[{"text":"Let’s say our CPU is related somewhat to some Operating systems:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":550,"id":"43a6976b-65a7-40b4-a0e3-e4b45e42bde0","collection":"contentId-697466895","type":"file","height":352}}]},{"type":"paragraph","content":[{"text":"We would like to print that in our template:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html"},"content":[{"text":"

CPU: $!customfield_10202

Number of cores: $!insightcf.getObject(\"customfield_10202\",133).getValue()

\n#set ($related_lincese = $!insightcf.getObject(\"customfield_10202\",193))\n

CPU License: $!insightcf.getRelatedObjectLabel($related_lincese)

CPU License end date: $!insightcf.getRelatedObjectAttribute($related_lincese,148).getValue()

Operating systems:

\n#set ($sos = $insightcf.getObjects(\"customfield_10202\",177))\n\n

$insightcf.getRelatedObjectLabel($so)

\n\n

Operating system: $!customfield_10203

","type":"text"}]},{"type":"paragraph","content":[{"text":"As we did before we want to isolate the value of the attribute SO (id 177)","type":"text"}]},{"type":"paragraph","content":[{"text":"#set ($sos = $insightcf.getObjects(\"customfield_10202\",177))","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Please mind the ","type":"text"},{"text":"s ","type":"text","marks":[{"type":"strong"}]},{"text":"in getObject","type":"text"},{"text":"s ","type":"text","marks":[{"type":"strong"}]},{"text":"as we are retrieving potencially multiples values.","type":"text"}]},{"type":"paragraph","content":[{"text":"Once we have these values we just print their label:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html"},"content":[{"text":"

$insightcf.getRelatedObjectLabel($so)

","type":"text"}]},{"type":"paragraph","content":[{"text":"This will render this email:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":491,"id":"908abd23-a89f-48b8-802e-86b730fa0179","collection":"contentId-697466895","type":"file","height":276}}]},{"type":"paragraph","content":[{"text":"If instead of related objects they were just simple attributes, the code would be like this:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":537,"id":"84e96cc9-813f-49e9-aa65-6d12a0487b32","collection":"contentId-697466895","type":"file","height":374}}]},{"type":"codeBlock","content":[{"text":"

CPU: $!customfield_10202

Number of cores: $!insightcf.getObject(\"customfield_10202\",133).getValue()

\n#set ($related_lincese = $!insightcf.getObject(\"customfield_10202\",193))\n

CPU License: $!insightcf.getRelatedObjectLabel($related_lincese)

CPU License end date: $!insightcf.getRelatedObjectAttribute($related_lincese,148).getValue()

Operating systems:

\n#set ($sos = $insightcf.getObjects(\"customfield_10202\",177))\n\n

$insightcf.getRelatedObjectLabel($so)

\n\n

Email servers:

\n#set ($email_servers = $insightcf.getObjects(\"customfield_10202\",181))\n

$email_server.getValue()

","type":"text"}]},{"type":"paragraph","content":[{"text":"The rendered email will be this:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":428,"id":"7b25da8f-67d7-493b-8614-04fea6ac1932","collection":"contentId-697466895","type":"file","height":333}}]},{"type":"paragraph","content":[{"text":"If you have any question, ","type":"text"},{"text":"let us know","type":"text","marks":[{"type":"link","attrs":{"href":"https://atsistemas.atlassian.net/servicedesk/customer/portal/2"}}]},{"text":".","type":"text"}]}],"version":1}

Browser not supported