{"type":"doc","content":[{"type":"heading","attrs":{"level":1,"localId":null},"content":[{"text":"Introduction","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"Template values allow you to dynamically populate templates with contextual data when being used.","type":"text"},{"type":"hardBreak","attrs":{"text":"\n"}},{"text":"The contextual data are mainly the issue for which a template is being used as well as the user using the template.","type":"text"},{"type":"hardBreak","attrs":{"text":"\n"}},{"text":"Template values therefore make it possible to create templates that are flexible, especially when adding logic via ","type":"text"},{"text":"Template Functions","type":"text","marks":[{"type":"link","attrs":{"href":"https://yasoon.atlassian.net/wiki/spaces/M365fJ/pages/3043295246","__confluenceMetadata":null}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3,"localId":null},"content":[{"text":"How to access and use","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"You can simply access any value by wrapping it within ","type":"text"},{"text":"{{ }}","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"},{"type":"hardBreak","attrs":{"text":"\n"}},{"text":"So if you wanted to show an issue’s summary you can do so by writing ","type":"text"},{"text":"{{issue.summary}}","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"},{"type":"hardBreak","attrs":{"text":"\n"}},{"text":"When using a value as an argument in a ","type":"text"},{"text":"Template Function","type":"text","marks":[{"type":"link","attrs":{"href":"https://yasoon.atlassian.net/wiki/spaces/M365fJ/pages/3043295246","__confluenceMetadata":null}}]},{"text":", you must not wrap it. e.g. ","type":"text"},{"text":"{{capitalize issue.summary}}","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"},{"type":"hardBreak","attrs":{"text":"\n"}},{"text":"When accessing a field that doesn’t exist it will return an empty string. ","type":"text"}]},{"type":"heading","attrs":{"level":1,"localId":null},"content":[{"text":"Fields","type":"text"}]},{"type":"heading","attrs":{"level":3,"localId":null},"content":[{"text":"Simplified structure","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"The following shows the outline of the available fields. Please see the following sections for more details.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"typescript","uniqueId":null},"content":[{"text":"{\n issue: {\n id: string,\n key: string,\n url: { // can be accesses directly to print browse url\n browseUrl: string, // prints the browse url\n customer: string, // prints the portal url if available\n smart: string // prints the portal url if available, otherwise it will fallback to the browse url\n }\n // ... the issue's fields\n }\n issues: Issue[],\n baseUrl: string,\n label: {\n : string\n },\n currentUser: User,\n userTimezone: string,\n userLocale: string,\n now: ISO-Date,\n customData: { any }\n}","type":"text"}]},{"type":"heading","attrs":{"level":3,"localId":null},"content":[{"text":"Issue","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"You have access to all fields/renderdFields values of an issue. ","type":"text"},{"type":"hardBreak","attrs":{"text":"\n"}},{"text":"By default we prioritize populating a field with the renderedField’s value. ","type":"text"},{"type":"hardBreak","attrs":{"text":"\n"}},{"text":"For some field types this might not always satisfy all your needs which is why we add ","type":"text"},{"text":"Additional processing","type":"text","marks":[{"type":"link","attrs":{"href":"#additional-processing","__confluenceMetadata":null}}]},{"text":" for those.","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"Here are some examples for often used fields:","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"issue.id","type":"text","marks":[{"type":"code"}]},{"text":" the issue's technical id","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"issue.key","type":"text","marks":[{"type":"code"}]},{"text":" the issue's key (e.g. \"TEST-123\")","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"issue.assignee","type":"text","marks":[{"type":"code"}]},{"text":" the displayname of the assignee (e.g. \"Jane Doe\")","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"issue.duedate","type":"text","marks":[{"type":"code"}]},{"text":" the duedate formatted in the user locale (e.g. \"Jan 18, 2024, 3:00 PM\")","type":"text"}]},{"type":"paragraph","attrs":{"localId":null}},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"Additionally we provide the following non-standard fields:","type":"text","marks":[{"type":"underline"}]}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"issue.url","type":"text","marks":[{"type":"code"}]},{"text":" the browse url to this issue (e.g. \"https://.atlassian.net/browse/\")","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"issue.url.browseUrl","type":"text","marks":[{"type":"code"}]},{"text":" direct access to the browse url to this issue (e.g. \"https://.atlassian.net/browse/\")","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"issue.url.customer","type":"text","marks":[{"type":"code"}]},{"text":" the servicedesk url for issues in a JSM project (e.g. \"https://.atlassian.net/servicedesk/customer/portal/\")","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"issue.url.smart","type":"text","marks":[{"type":"code"}]},{"text":" either the browse or servicedesk url depending on the issue's type","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"issue.comment","type":"text","marks":[{"type":"code"}]},{"text":" comments have a different structure for easier access","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"issue.watchers","type":"text","marks":[{"type":"code"}]},{"text":" array of users watching this issue","type":"text"}]},{"type":"heading","attrs":{"level":4,"localId":null},"content":[{"text":"Assets","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"issue.customfield_xxxxx","type":"text","marks":[{"type":"code"}]},{"text":" (e.g. customfield_10001) array of assets","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"issue.customfield_xxxxx.[n].label","type":"text","marks":[{"type":"code"}]},{"text":" the label of the selected assets","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"issue.customfield_xxxxx.[n].attributes","type":"text","marks":[{"type":"code"}]},{"text":" data of the asset","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"issue.customfield_xxxxx.[n].attributes.attributeName","type":"text","marks":[{"type":"code"}]},{"text":" the value of one of the asset’s attributes. Please make sure the attributes are visible on the issue view within the asset object when trying to pull information from them.","type":"text"}]},{"type":"expand","attrs":{"title":"Trimmed Example of issue data","__expanded":true},"content":[{"type":"codeBlock","attrs":{"language":"json","uniqueId":null},"content":[{"text":"\"issue\": {\n \"id\": \"10010\",\n \"key\": \"TEST-2\",\n \"lastViewed\": {\n \"rendered\": \"Nov 30, 2022, 12:01 PM\",\n \"raw\": \"2022-11-30T12:01:31.221+0100\"\n },\n \"priority\": {\n \"self\": \"https://.atlassian.net/rest/api/2/priority/3\",\n \"iconUrl\": \"https://.atlassian.net/images/icons/priorities/medium.svg\",\n \"name\": \"Medium\",\n \"id\": \"3\"\n },\n \"assignee\": {\n \"self\": \"https://.atlassian.net/rest/api/2/user?accountId=a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"accountId\": \"a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"avatarUrls\": {\n \"48x48\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"24x24\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"16x16\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"32x32\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\"\n },\n \"displayName\": \"Test User\",\n \"active\": true,\n \"timeZone\": \"Europe/Berlin\",\n \"accountType\": \"atlassian\"\n },\n \"status\": {\n \"self\": \"https://.atlassian.net/rest/api/2/status/10027\",\n \"description\": \"This issue is being actively worked on at the moment by the assignee.\",\n \"iconUrl\": \"https://.atlassian.net/\",\n \"name\": \"In Progress\",\n \"id\": \"10027\",\n \"statusCategory\": {\n \"self\": \"https://.atlassian.net/rest/api/2/statuscategory/4\",\n \"id\": 4,\n \"key\": \"indeterminate\",\n \"colorName\": \"yellow\",\n \"name\": \"In Progress\"\n }\n },\n \"reporter\": {\n \"self\": \"https://.atlassian.net/rest/api/2/user?accountId=a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"accountId\": \"a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"avatarUrls\": {\n \"48x48\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"24x24\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"16x16\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"32x32\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\"\n },\n \"displayName\": \"Test User\",\n \"active\": true,\n \"timeZone\": \"Europe/Berlin\",\n \"accountType\": \"atlassian\"\n },\n \"project\": {\n \"self\": \"https://.atlassian.net/rest/api/2/project/10003\",\n \"id\": \"10003\",\n \"key\": \"TEST\",\n \"name\": \"Test\",\n \"projectTypeKey\": \"software\",\n \"simplified\": true,\n \"avatarUrls\": {\n \"48x48\": \"https://.atlassian.net/rest/api/2/universal_avatar/view/type/project/avatar/10406\",\n \"24x24\": \"https://.atlassian.net/rest/api/2/universal_avatar/view/type/project/avatar/10406?size=small\",\n \"16x16\": \"https://.atlassian.net/rest/api/2/universal_avatar/view/type/project/avatar/10406?size=xsmall\",\n \"32x32\": \"https://.atlassian.net/rest/api/2/universal_avatar/view/type/project/avatar/10406?size=medium\"\n }\n },\n \"watches\": {\n \"self\": \"https://.atlassian.net/rest/api/2/issue/TEST-2/watchers\",\n \"watchCount\": 1,\n \"isWatching\": true\n },\n \"created\": {\n \"rendered\": \"Nov 23, 2022, 11:41 AM\",\n \"raw\": \"2022-11-23T11:41:00.004+0100\"\n },\n \"customfield_10017\": {\n \"rendered\": \"purple\"\n },\n \"updated\": {\n \"rendered\": \"23/Nov/22 11:44 AM\",\n \"raw\": \"2022-11-23T11:44:10.088+0100\"\n },\n \"description\": {\n \"rendered\": \"\\n\\tUse handlebars-kit repo\\n\\tImplement datetime helpers\\n\\n\"\n },\n \"summary\": {\n \"rendered\": \"Implement handlebars helpers\"\n },\n \"customfield_10001\": [\n {\n \"workspaceId\": \"2d6e93a7-a467-45e2-9229-65a9aa89c1d1\",\n \"id\": \"2d6e93a7-a467-45e2-9229-65a9aa89c1d1:2\",\n \"objectId\": \"2\",\n \"label\": \"Laptop\",\n \"objectKey\": \"IT-1\",\n \"avatar\": {\n \"url16\": \"https://.atlassian.net/gateway/api/jsm/insight/workspace/2d6e93a7-a467-45e2-9229-65a9aa89c1d1/v1/objecttype/11/icon.png?size=16\",\n \"url48\": \"https://.atlassian.net/gateway/api/jsm/insight/workspace/2d6e93a7-a467-45e2-9229-65a9aa89c1d1/v1/objecttype/11/icon.png?size=48\",\n \"url72\": \"https://.atlassian.net/gateway/api/jsm/insight/workspace/2d6e93a7-a467-45e2-9229-65a9aa89c1d1/v1/objecttype/11/icon.png?size=72\",\n \"url144\": \"https://.atlassian.net/gateway/api/jsm/insight/workspace/2d6e93a7-a467-45e2-9229-65a9aa89c1d1/v1/objecttype/11/icon.png?size=144\",\n \"url288\": \"https://.atlassian.net/gateway/api/jsm/insight/workspace/2d6e93a7-a467-45e2-9229-65a9aa89c1d1/v1/objecttype/11/icon.png?size=288\",\n \"#defaultValue\": \"https://.atlassian.net/gateway/api/jsm/insight/workspace/2d6e93a7-a467-45e2-9229-65a9aa89c1d1/v1/objecttype/11/icon.png?size=144\"\n },\n \"objectType\": {\n \"workspaceId\": \"2d6e93a7-a467-45e2-9229-65a9aa89c1d1\",\n \"objectTypeId\": \"11\",\n \"id\": \"2d6e93a7-a467-45e2-9229-65a9aa89c1d1:11\",\n \"name\": \"Laptops\",\n \"icon\": {\n \"id\": \"62\",\n \"name\": \"Laptop\",\n \"url16\": \"https://.atlassian.net/gateway/api/jsm/insight/workspace/2d6e93a7-a467-45e2-9229-65a9aa89c1d1/v1/objecttype/11/icon.png?size=16\",\n \"url48\": \"https://.atlassian.net/gateway/api/jsm/insight/workspace/2d6e93a7-a467-45e2-9229-65a9aa89c1d1/v1/objecttype/11/icon.png?size=48\"\n },\n \"objectSchemaId\": \"3\"\n },\n \"attributes\": {\n \"Name\": \"Customer Laptop\",\n \"Serial Number\": \"1234567890\"\n },\n \"links\": {\n \"self\": \"https://.atlassian.net/gateway/api/jsm/insight/workspace/2d6e93a7-a467-45e2-9229-65a9aa89c1d1/v1/object/2\"\n }\n }\n ],\n \"customfield_10002\": null,\n \"customfield_10003\": null,\n \"comments\": [{\n \"self\": \"https://.atlassian.net/rest/api/2/issue/10010/comment/10063\",\n \"id\": \"10063\",\n \"author\": {\n \"self\": \"https://.atlassian.net/rest/api/2/user?accountId=a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"accountId\": \"a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"avatarUrls\": {\n \"48x48\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"24x24\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"16x16\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"32x32\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\"\n },\n \"displayName\": \"Test User\",\n \"active\": true,\n \"timeZone\": \"Europe/Berlin\",\n \"accountType\": \"atlassian\"\n },\n \"body\": {\n \"rendered\": \"Also add possibility to set own variables.\"\n },\n \"updateAuthor\": {\n \"self\": \"https://.atlassian.net/rest/api/2/user?accountId=a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"accountId\": \"a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"avatarUrls\": {\n \"48x48\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"24x24\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"16x16\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"32x32\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\"\n },\n \"displayName\": \"Test User\",\n \"active\": true,\n \"timeZone\": \"Europe/Berlin\",\n \"accountType\": \"atlassian\"\n },\n \"created\": {\n \"rendered\": \"Nov 23, 2022, 11:42 AM\",\n \"raw\": \"2022-11-23T11:42:38.166+0100\"\n },\n \"updated\": {\n \"rendered\": \"Nov 23, 2022, 11:42 AM\",\n \"raw\": \"2022-11-23T11:42:38.166+0100\"\n },\n \"jsdPublic\": true\n }\n ],\n \"url\": {\n \"browseUrl\": \"https://.atlassian.net/browse/TEST-2\",\n \"customer\": \"https://.atlassian.net/servicedesk/customer/portal/\",\n \"smart\": \"https://.atlassian.net/servicedesk/customer/portal/\"\n },\n \"watchers\": [{\n \"self\": \"https://.atlassian.net/rest/api/2/user?accountId=a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"accountId\": \"a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"avatarUrls\": {\n \"48x48\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"24x24\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"16x16\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"32x32\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\"\n },\n \"displayName\": \"Test User\",\n \"active\": true,\n \"timeZone\": \"Europe/Berlin\",\n \"accountType\": \"atlassian\"\n }\n ]\n}","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"info","panelIcon":null,"panelIconId":null,"panelIconText":null,"panelColor":null},"content":[{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"You can access all custom fields.","type":"text"},{"type":"hardBreak","attrs":{"text":"\n"}},{"text":"We are working on an UI to show available data live and specific to your issues.","type":"text"},{"type":"hardBreak","attrs":{"text":"\n"}},{"text":"In the meantime, if you are looking for information how an field looks like, you can use the following Jira API: (make sure to replace Issue key and instance url )","type":"text"},{"type":"hardBreak","attrs":{"text":"\n"}},{"text":"https://.atlassian.net/rest/api/2/issue/?fields=*all&expand=renderedFields","type":"text","marks":[{"type":"code"}]}]}]},{"type":"heading","attrs":{"level":3,"localId":null},"content":[{"text":"Issues","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"issues","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"In automation this may be populated by passing issueIds via custom data. See the ","type":"text"},{"text":"Custom data example","type":"text","marks":[{"type":"link","attrs":{"href":"#custom-data","__confluenceMetadata":null}}]},{"text":" below.","type":"text"},{"type":"hardBreak","attrs":{"text":"\n"}},{"text":"Outside of automation this will remain unused.","type":"text"}]},{"type":"heading","attrs":{"level":3,"localId":null},"content":[{"text":"Current user","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"currentUser","type":"text","marks":[{"type":"code"}]},{"text":" The current Atlassian Jira user. In automation context the actor of an action.","type":"text"}]},{"type":"expand","attrs":{"title":"Example representation of currentUser","__expanded":true},"content":[{"type":"codeBlock","attrs":{"language":"json","uniqueId":null},"content":[{"text":"\"currentUser\": {\n \"self\": \"https://.atlassian.net/rest/api/3/user?accountId=a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"accountId\": \"a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"accountType\": \"atlassian\",\n \"avatarUrls\": {\n \"48x48\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"24x24\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"16x16\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"32x32\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\"\n },\n \"displayName\": \"Test User\",\n \"active\": true,\n \"timeZone\": \"Europe/Berlin\",\n \"locale\": \"en-GB\",\n \"groups\": {\n \"size\": 1,\n \"items\": []\n },\n \"applicationRoles\": {\n \"size\": 3,\n \"items\": []\n },\n \"expand\": \"groups,applicationRoles\",\n \"emailAddress\": \"contact@yasoon.com\"\n}","type":"text"}]}]},{"type":"heading","attrs":{"level":3,"localId":null},"content":[{"text":"Label","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"label","type":"text","marks":[{"type":"code"}]},{"text":" key-value list of all fields to access a field's name in the users current locale. ","type":"text"},{"type":"hardBreak","attrs":{"text":"\n"}},{"text":"Using this ensures your template adjust to the correct naming if you change a label in Jira.","type":"text"},{"type":"hardBreak","attrs":{"text":"\n"}},{"text":"It also takes different, context-sensitive configurations into account (e.g. the duedate could be renamed to Escalation Date for a specific project)","type":"text"}]},{"type":"expand","attrs":{"title":"Partial representation of label","__expanded":true},"content":[{"type":"codeBlock","attrs":{"language":"json","uniqueId":null},"content":[{"text":"\"label\": {\n ...\n \"fixVersions\": \"Fix versions\",\n \"resolution\": \"Resolution\",\n \"versions\": \"Affects versions\",\n \"issuelinks\": \"Linked Issues\",\n \"assignee\": \"Assignee\",\n \"status\": \"Status\",\n \"creator\": \"Creator\",\n \"project\": \"Project\",\n \"created\": \"Created\",\n \"updated\": \"Updated\",\n \"environment\": \"Environment\",\n \"duedate\": \"Due date\",\n \"comment\": \"Comment\"\n ...\n}","type":"text"}]}]},{"type":"heading","attrs":{"level":3,"localId":null},"content":[{"type":"inlineExtension","attrs":{"extensionKey":"anchor","extensionType":"com.atlassian.confluence.macro.core","parameters":{"macroParams":{"":{"value":"custom-data"},"legacyAnchorId":{"value":"TemplateValues-custom-data"}},"macroMetadata":{"macroId":{"value":"b9c6e0d0fe415ef1caaf67dee30de7e0a1f4a0ac80a4daa9cbf97295982fa5b5"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"text":null,"localId":"18a485d1-6491-4506-baf9-0688aa507a5c"}},{"text":"Custom data","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"customData","type":"text","marks":[{"type":"code"}]},{"text":" Only present when used in automation. 1:1 representation of what has been configured to be passed on as custom data to an action. ","type":"text"},{"type":"hardBreak","attrs":{"text":"\n"}},{"text":"Always empty when used outside automation.","type":"text"}]},{"type":"expand","attrs":{"title":"Example of passing custom data to be used in templates","__expanded":true},"content":[{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"Content of the “custom data” field in an automation action.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json","uniqueId":null},"content":[{"text":"{\n \"issueIds\": [ // will populate issues with the corresponding issues\n \"10000\", \n \"10007\", \n \"10015\"\n ], \n \"customData\" : {\n myCustomValue1\": \"Any other value you might find useful\"\n // you can define and pass on whichever keys and values you like\n }\n}","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"Will result in the following representation to be used in templates.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json","uniqueId":null},"content":[{"text":"\"customData\": {\n \"issueIds\": [\"10000\", \"10007\", \"10015\"],\n \"myCustomValue1\": \"Any other value you might find useful\"\n},\n\"issues\": [\n {Issue with ID 10000},\n {Issue with ID 10007},\n {Issue with ID 10015}\n]","type":"text"}]}]},{"type":"heading","attrs":{"level":3,"localId":null},"content":[{"text":"Other values","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"baseUrl","type":"text","marks":[{"type":"code"}]},{"text":" e.g. \"https://.atlassian.net\"","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"userTimezone","type":"text","marks":[{"type":"code"}]},{"text":" Time zone to be used for dates. If present, it will contain a ","type":"text"},{"text":"currentUser","type":"text","marks":[{"type":"code"}]},{"text":"'s time zone based on their Atlassian settings - else it defaults to \"Europe/Berlin\".","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"userLocale","type":"text","marks":[{"type":"code"}]},{"text":" Locale to be used for dates. If present, it will contain a ","type":"text"},{"text":"currentUser","type":"text","marks":[{"type":"code"}]},{"text":"'s locale based on their Atlassian settings - else it defaults to \"en-US\".","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"now","type":"text","marks":[{"type":"code"}]},{"text":" A full ISO-Date of the current date and time. It will be converted automatically to the time zone in ","type":"text"},{"text":"timezone","type":"text","marks":[{"type":"code"}]},{"text":" (e.g. \"2022-11-15T14:15:42.000+01:00\").","type":"text"}]},{"type":"expand","attrs":{"title":"","__expanded":true},"content":[{"type":"codeBlock","attrs":{"language":"json","uniqueId":null},"content":[{"text":"\"baseUrl\": \"https://.atlassian.net\",\n\"userTimezone\": \"Europe/Berlin\",\n\"userLocale\": \"en-GB\",\n\"now\": \"2022-11-30T12:03:39.771+01:00\"","type":"text"}]}]},{"type":"heading","attrs":{"level":1,"localId":null},"content":[{"type":"inlineExtension","attrs":{"extensionKey":"anchor","extensionType":"com.atlassian.confluence.macro.core","parameters":{"macroParams":{"":{"value":"additional-processing"},"legacyAnchorId":{"value":"TemplateValues-additional-processing"}},"macroMetadata":{"macroId":{"value":"6e683328ba13d37a714bec836735868ed8f91be35b9ccbb7fdf0f34ca95ca728"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"text":null,"localId":"887cdc5b-b038-4892-8d32-53daa05c8214"}},{"text":"Additional processing","type":"text"},{"type":"inlineExtension","attrs":{"extensionKey":"anchor","extensionType":"com.atlassian.confluence.macro.core","parameters":{"macroParams":{"":{"value":"additional-processing"},"legacyAnchorId":{"value":"TemplateValues-additional-processing"}},"macroMetadata":{"macroId":{"value":"89525732d6726219fe8081cec0f00369"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"text":null,"localId":"cc923e3c-531b-4994-90d9-35fdd0e0c5b3"}}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"For all fields that contain one or multiple users you can simply write ","type":"text"},{"text":"issue.myUserField","type":"text","marks":[{"type":"code"}]},{"text":" instead of ","type":"text"},{"text":"issue.myUserField.displayName","type":"text","marks":[{"type":"code"}]},{"text":" to print out the user’s name.","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"This also applies for any option field, for which it will print out the ","type":"text"},{"text":"value","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"We enrich string and date(time) with additional properties.","type":"text"},{"type":"hardBreak","attrs":{"text":"\n"}},{"text":"This is necessary as Atlassian renders these fields to contain a readable value which may make them unusable in ","type":"text"},{"text":"Template Functions","type":"text","marks":[{"type":"link","attrs":{"href":"https://yasoon.atlassian.net/wiki/spaces/M365fJ/pages/3043295246","__confluenceMetadata":null}}]},{"text":".","type":"text"}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"For date(time) fields we add","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"isoString","type":"text","marks":[{"type":"code"}]},{"text":" containing the ISO-Date","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"rendered","type":"text","marks":[{"type":"code"}]},{"text":" containing the formatted date in the user locale (e.g. Jan 18, 2024, 3:00 PM)","type":"text"}]}]}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"When simply accessing the date(time) field it will print the rendered value.","type":"text"},{"type":"hardBreak","attrs":{"text":"\n"}}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"For string fields we add","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"rendered","type":"text","marks":[{"type":"code"}]},{"text":" containing the field's value","type":"text"}]}]}]},{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"When simply accessing the string field it will print the rendered value.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning","panelIcon":null,"panelIconId":null,"panelIconText":null,"panelColor":null},"content":[{"type":"paragraph","attrs":{"localId":null},"content":[{"text":"Be aware that when using such a field in ","type":"text"},{"text":"Template Functions","type":"text","marks":[{"type":"link","attrs":{"href":"https://yasoon.atlassian.net/wiki/spaces/M365fJ/pages/3043295246","__confluenceMetadata":null}}]},{"text":", it will still access the entire object, even if it prints a specific value.","type":"text"}]}]},{"type":"heading","attrs":{"level":1,"localId":null},"content":[{"text":"Full Example representation","type":"text"}]},{"type":"expand","attrs":{"title":"Everything at one glance","__expanded":true},"content":[{"type":"codeBlock","attrs":{"language":"json","uniqueId":null},"content":[{"text":"\"issue\": {\n \"id\": \"10010\",\n \"key\": \"TEST-2\",\n \"statuscategorychangedate\": {\n \"rendered\": \"Nov 23, 2022, 11:44 AM\",\n \"isoString\": \"2022-11-23T11:44:10.088+0100\"\n },\n \"fixVersions\": [],\n \"resolution\": null,\n \"lastViewed\": {\n \"rendered\": \"Nov 30, 2022, 12:01 PM\",\n \"isoString\": \"2022-11-30T12:01:31.221+0100\"\n },\n \"priority\": {\n \"self\": \"https://.atlassian.net/rest/api/2/priority/3\",\n \"iconUrl\": \"https://.atlassian.net/images/icons/priorities/medium.svg\",\n \"name\": \"Medium\",\n \"id\": \"3\"\n },\n \"labels\": [],\n \"timeestimate\": null,\n \"aggregatetimeoriginalestimate\": null,\n \"versions\": [],\n \"issuelinks\": [],\n \"assignee\": {\n \"self\": \"https://.atlassian.net/rest/api/2/user?accountId=a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"accountId\": \"a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"avatarUrls\": {\n \"48x48\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"24x24\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"16x16\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"32x32\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\"\n },\n \"displayName\": \"Test User\",\n \"active\": true,\n \"timeZone\": \"Europe/Berlin\",\n \"accountType\": \"atlassian\"\n },\n \"status\": {\n \"self\": \"https://.atlassian.net/rest/api/2/status/10027\",\n \"description\": \"This issue is being actively worked on at the moment by the assignee.\",\n \"iconUrl\": \"https://.atlassian.net/\",\n \"name\": \"In Progress\",\n \"id\": \"10027\",\n \"statusCategory\": {\n \"self\": \"https://.atlassian.net/rest/api/2/statuscategory/4\",\n \"id\": 4,\n \"key\": \"indeterminate\",\n \"colorName\": \"yellow\",\n \"name\": \"In Progress\"\n }\n },\n \"components\": [],\n \"aggregatetimeestimate\": null,\n \"creator\": {\n \"self\": \"https://.atlassian.net/rest/api/2/user?accountId=a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"accountId\": \"a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"avatarUrls\": {\n \"48x48\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"24x24\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"16x16\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"32x32\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\"\n },\n \"displayName\": \"Test User\",\n \"active\": true,\n \"timeZone\": \"Europe/Berlin\",\n \"accountType\": \"atlassian\"\n },\n \"subtasks\": [],\n \"reporter\": {\n \"self\": \"https://.atlassian.net/rest/api/2/user?accountId=a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"accountId\": \"a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"avatarUrls\": {\n \"48x48\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"24x24\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"16x16\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"32x32\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\"\n },\n \"displayName\": \"Test User\",\n \"active\": true,\n \"timeZone\": \"Europe/Berlin\",\n \"accountType\": \"atlassian\"\n },\n \"aggregateprogress\": {\n \"progress\": 0,\n \"total\": 0\n },\n \"progress\": {\n \"progress\": 0,\n \"total\": 0\n },\n \"votes\": {\n \"self\": \"https://.atlassian.net/rest/api/2/issue/TEST-2/votes\",\n \"votes\": 0,\n \"hasVoted\": false\n },\n \"worklogs\": [],\n \"issuetype\": {\n \"self\": \"https://.atlassian.net/rest/api/2/issuetype/10015\",\n \"id\": \"10015\",\n \"description\": \"A collection of related bugs, stories, and tasks.\",\n \"iconUrl\": \"https://.atlassian.net/rest/api/2/universal_avatar/view/type/issuetype/avatar/10307?size=medium\",\n \"name\": \"Epic\",\n \"subtask\": false,\n \"avatarId\": 10307,\n \"entityId\": \"687f10a6-02c9-4a4d-86b3-cc7df4f01f51\",\n \"hierarchyLevel\": 1\n },\n \"timespent\": null,\n \"project\": {\n \"self\": \"https://.atlassian.net/rest/api/2/project/10003\",\n \"id\": \"10003\",\n \"key\": \"TEST\",\n \"name\": \"Test\",\n \"projectTypeKey\": \"software\",\n \"simplified\": true,\n \"avatarUrls\": {\n \"48x48\": \"https://.atlassian.net/rest/api/2/universal_avatar/view/type/project/avatar/10406\",\n \"24x24\": \"https://.atlassian.net/rest/api/2/universal_avatar/view/type/project/avatar/10406?size=small\",\n \"16x16\": \"https://.atlassian.net/rest/api/2/universal_avatar/view/type/project/avatar/10406?size=xsmall\",\n \"32x32\": \"https://.atlassian.net/rest/api/2/universal_avatar/view/type/project/avatar/10406?size=medium\"\n }\n },\n \"aggregatetimespent\": null,\n \"resolutiondate\": {\n \"rendered\": \"\",\n \"raw\": \"\"\n },\n \"workratio\": -1,\n \"issuerestriction\": {\n \"issuerestrictions\": {},\n \"shouldDisplay\": true\n },\n \"watches\": {\n \"self\": \"https://.atlassian.net/rest/api/2/issue/TEST-2/watchers\",\n \"watchCount\": 1,\n \"isWatching\": true\n },\n \"created\": {\n \"rendered\": \"Nov 23, 2022, 11:41 AM\",\n \"raw\": \"2022-11-23T11:41:00.004+0100\"\n },\n \"customfield_10017\": {\n \"rendered\": \"purple\",\n },\n \"customfield_10019\": \"0|i00027:\",\n \"updated\": {\n \"rendered\": \"Nov 23, 2022, 11:44 AM\",\n \"isoString\": \"2022-11-23T11:44:10.088+0100\"\n },\n \"timeoriginalestimate\": null,\n \"description\": {\n \"rendered\": \"\\n\\tUse handlebars-kit repo\\n\\tImplement datetime helpers\\n\\n\",\n },\n \"timetracking\": {},\n \"security\": null,\n \"attachment\": [],\n \"summary\": {\n \"rendered\": \"Implement handlebars helpers\"\n },\n \"customfield_10001\": null,\n \"customfield_10002\": null,\n \"customfield_10003\": null,\n \"environment\": {\n \"rendered\": \"\",\n \"raw\": \"\",\n \"plain\": \"\"\n },\n \"duedate\": {\n \"rendered\": \"\",\n \"raw\": \"\"\n },\n \"comment\": [{\n \"self\": \"https://.atlassian.net/rest/api/2/issue/10010/comment/10063\",\n \"id\": \"10063\",\n \"author\": {\n \"self\": \"https://.atlassian.net/rest/api/2/user?accountId=a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"accountId\": \"a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"avatarUrls\": {\n \"48x48\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"24x24\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"16x16\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"32x32\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\"\n },\n \"displayName\": \"Test User\",\n \"active\": true,\n \"timeZone\": \"Europe/Berlin\",\n \"accountType\": \"atlassian\"\n },\n \"body\": {\n \"rendered\": \"Also add possibility to set own variables.\"\n },\n \"updateAuthor\": {\n \"self\": \"https://.atlassian.net/rest/api/2/user?accountId=a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"accountId\": \"a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"avatarUrls\": {\n \"48x48\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"24x24\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"16x16\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"32x32\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\"\n },\n \"displayName\": \"Test User\",\n \"active\": true,\n \"timeZone\": \"Europe/Berlin\",\n \"accountType\": \"atlassian\"\n },\n \"created\": {\n \"rendered\": \"Nov 23, 2022, 11:42 AM\",\n \"isoString\": \"2022-11-23T11:42:38.166+0100\"\n },\n \"updated\": {\n \"rendered\": \"Nov 23, 2022, 11:42 AM\",\n \"isoString\": \"2022-11-23T11:42:38.166+0100\"\n },\n \"jsdPublic\": true\n }\n ],\n \"url\": {\n \"browseUrl\": \"https://.atlassian.net/browse/TEST-2\",\n \"customer\": \"https://.atlassian.net/servicedesk/customer/portal/\",\n \"smart\": \"https://.atlassian.net/servicedesk/customer/portal/\"\n },,\n \"watchers\": [{\n \"self\": \"https://.atlassian.net/rest/api/2/user?accountId=a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"accountId\": \"a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"avatarUrls\": {\n \"48x48\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"24x24\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"16x16\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"32x32\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\"\n },\n \"displayName\": \"Test User\",\n \"active\": true,\n \"timeZone\": \"Europe/Berlin\",\n \"accountType\": \"atlassian\"\n }\n ]\n},\n\"label\": {\n ...\n \"fixVersions\": \"Fix versions\",\n \"resolution\": \"Resolution\",\n \"versions\": \"Affects versions\",\n \"issuelinks\": \"Linked Issues\",\n \"assignee\": \"Assignee\",\n \"status\": \"Status\",\n \"creator\": \"Creator\",\n \"project\": \"Project\",\n \"created\": \"Created\",\n \"updated\": \"Updated\",\n \"environment\": \"Environment\",\n \"duedate\": \"Due date\",\n \"comment\": \"Comment\"\n ...\n},\n\"customData\": {\n \"issueIds\": [\"10000\", \"10007\", \"10015\"], \n \"myCustomValue1\": \"Any other value you might find useful\"\n},\n\"issues\": [\n {Issue with ID 10000},\n {Issue with ID 10007},\n {Issue with ID 10015}\n],\n\"currentUser\": {\n \"self\": \"https://.atlassian.net/rest/api/3/user?accountId=a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"accountId\": \"a1b2c3d4e5f6g7h8i9j0k1l2\",\n \"accountType\": \"atlassian\",\n \"avatarUrls\": {\n \"48x48\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"24x24\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"16x16\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\",\n \"32x32\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/TU-5.png\"\n },\n \"displayName\": \"Test User\",\n \"active\": true,\n \"timeZone\": \"Europe/Berlin\",\n \"locale\": \"en-GB\",\n \"groups\": {\n \"size\": 1,\n \"items\": []\n },\n \"applicationRoles\": {\n \"size\": 3,\n \"items\": []\n },\n \"expand\": \"groups,applicationRoles\",\n \"emailAddress\": \"contact@yasoon.com\"\n},\n\"baseUrl\": \"https://.atlassian.net\",\n\"userTimezone\": \"Europe/Berlin\",\n\"userLocale\": \"en-GB\",\n\"now\": \"2022-11-30T12:03:39.771+01:00\"","type":"text"}]}]}],"version":1}

Browser not supported