{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"maxLevel":{"value":"3"}},"macroMetadata":{"macroId":{"value":"50bdc3f1-3d6d-42a9-b58b-3ed414de9193"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"aad78804-736d-4189-b4c8-7d6b055de223"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"For a streamlined guide on setting up JEMH for issue creation via email in JSD 3 onwards, see ","type":"text"},{"text":"Create Issues (Jira Service Desk 3)","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/JEMH/pages/83918961"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Setting the Customer Request Type","type":"text"}]},{"type":"paragraph","content":[{"text":"In order for email (a.k.a Non-Jira) users to create fully functional requests in Jira, the Service Desk custom field ","type":"text"},{"text":"Customer Request Type","type":"text","marks":[{"type":"strong"}]},{"text":" must be set with a specific value","type":"text"},{"text":".","type":"text","marks":[{"type":"em"}]},{"text":" This value has the format ","type":"text"},{"text":"projectkey/requestid","type":"text","marks":[{"type":"code"}]},{"text":". By default this field is not visible on edit screens.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Locating the Request Type (pre JSD 3.1)","type":"text"}]},{"type":"paragraph","content":[{"text":"If your version of Service Desk doesn't expose the field value in this way (recent version don't as of DEC 2014), you can access the data using REST with a URL similar to:","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"

","block-inline":true,"nestedContent":{"type":"doc","content":[{"type":"codeBlock","content":[{"text":"https://yourserver/rest/api/latest/issue/SER-24","type":"text"}]}],"version":1}}}}]},{"type":"paragraph","content":[{"text":"Once on the page, the content you are looking for will be of format:","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"

","block-inline":true,"nestedContent":{"type":"doc","content":[{"type":"codeBlock","content":[{"text":"customfield_10022: \"ser/get-it-help\"","type":"text"}]}],"version":1}}}}]},{"type":"paragraph","content":[{"text":"From JSD 3.1 onwards, this way of finding the request type no longer works. Please see the common problems wiki page here for the solution: ","type":"text"},{"text":"Common Problems - Locating Customer Request Type","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/JEMH/pages/2850943#CommonProblems-LocatingCustomerRequestType"}}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"All Emails to a single Request Type","type":"text"}]},{"type":"paragraph","content":[{"text":"Setting a JEMH Default Custom Field value to Default Project Mapping will cause all issues being created to have that custom field value, so setting ","type":"text"},{"text":"Customer Request Type ","type":"text","marks":[{"type":"em"}]},{"text":"to ","type":"text"},{"text":"default001","type":"text","marks":[{"type":"em"}]},{"text":" will do that, see the ","type":"text"},{"text":"JEMH Profile > Default Project Mapping > Custom Field Defaults","type":"text","marks":[{"type":"em"}]},{"text":" section:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"width":1226,"id":"69af2b20-63b7-490e-a672-2f215ff59735","collection":"contentId-17104912","type":"file","height":377}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Request Type defined through Project Mappings","type":"text"}]},{"type":"paragraph","content":[{"text":"JEMH ","type":"text"},{"text":"Project Mappings","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/JEMH/pages/2850927"}}]},{"text":" allow routing of emails to projects. With Service Desk this method also gives you the opportunity to route incoming email into a defined Service Desk queue. Defining the ","type":"text"},{"text":"Customer Request Type","type":"text","marks":[{"type":"em"}]},{"text":" can be done at the per-Project Mapping level which then becomes the default for all ","type":"text"},{"text":"Mapping Rules","type":"text","marks":[{"type":"em"}]},{"text":" unless overridden:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"width":1220,"id":"b608bd1a-3672-43c6-9317-cbe4fa7d3dd5","collection":"contentId-17104912","type":"file","height":517}}]},{"type":"paragraph","content":[{"text":"Each Mapping Rule could then provide a different value, for example:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"width":1223,"id":"e70426dc-d14e-450b-9bdb-a08517439821","collection":"contentId-17104912","type":"file","height":383}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Use of Directives","type":"text"}]},{"type":"paragraph","content":[{"text":"JEMH Directives can also be used to set the field remotely, JEMH Aliases can be used to simplify this to #servicedesk or similar.","type":"text"}]},{"type":"codeBlock","content":[{"text":"@project=SD\n@Customer Request Type=sd/bug\n\nhello world","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Example: Email only (no account)","type":"text"}]},{"type":"paragraph","content":[{"text":"Here is a JEMH Test Case, it has no special directives defined, the project mapping above will be used (with serv/default003 as a value):","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"width":1131,"id":"3c7a101f-9ed2-4da4-8ae3-4226e39b2dbd","collection":"contentId-17104912","type":"file","height":109}}]},{"type":"paragraph","content":[{"text":"The post-execution screen shows which Domain Rule fired:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"width":1184,"id":"52f5405b-7e05-4ecf-857d-d727fd4c5753","collection":"contentId-17104912","type":"file","height":733}}]},{"type":"paragraph","content":[{"text":"Going to the created issue (with the ","type":"text"},{"text":"Customer Request Type","type":"text","marks":[{"type":"em"}]},{"text":" field visible):","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"width":1458,"id":"8f7355f4-2883-4551-9d0f-313b4e1b5bef","collection":"contentId-17104912","type":"file","height":762}}]},{"type":"paragraph","content":[{"text":"As 'admin' switching views to the Service Desk, the new issue is present, and can be managed through the Service Desk UI:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"width":1503,"id":"f689adc4-3817-4dd2-8413-1ef16040051c","collection":"contentId-17104912","type":"file","height":242}}]},{"type":"paragraph","content":[{"text":"The Edit option allows new columns to be added:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":668,"id":"b4c05145-5bf9-4147-8101-8bd665fb5920","collection":"contentId-17104912","type":"file","height":193}}]},{"type":"paragraph","content":[{"text":"So, adding the ","type":"text"},{"text":"Email Users","type":"text","marks":[{"type":"em"}]},{"text":" custom field allows you to see who the email came from, even including the 'personal' part of the email address if stored:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"width":1498,"id":"e42f5410-7775-43d6-8301-ea320ea7b4ef","collection":"contentId-17104912","type":"file","height":241}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Notifications","type":"text"}]},{"type":"paragraph","content":[{"text":"Where email users are concerned, the JEMH Default User is used as the context for the operation, this is the user who will receive email notifications via Service Desk. With JEMH configured for non-JIRA support already, nothing changes, and standard IssueEvent notifications occur:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"b8a10548-5f37-4633-808e-b18e42e7bda7"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Issue Created Example","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[569.0]},"content":[{"type":"paragraph","content":[{"text":"Issue Updated Example","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":35.0},"content":[{"type":"media","attrs":{"width":827,"id":"663d7420-3228-43ac-aeb4-50388fa75934","collection":"contentId-17104912","type":"file","height":583}}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[569.0]},"content":[{"type":"paragraph","content":[{"text":"Here, a \"Start Progress\" transition has been triggered which results in:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":35.0},"content":[{"type":"media","attrs":{"width":827,"id":"1e771df1-fbd5-4c46-8002-1f2c98175ca6","collection":"contentId-17104912","type":"file","height":537}}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Duplicate Notifications?","type":"text"}]},{"type":"paragraph","content":[{"text":"By default, JIRA Service Desk is set to create its own notifications, which are independent of the standard JIRA notification scheme. You may see duplicate notifications being sent if you also have JEMH sending them. To stop JSD from sending notifications, go to Project Administrator > Notifications > Actions > Use a different scheme. Here you are able to set Scheme to None.","type":"text"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"To configure the content of the notifications, see ","type":"text"},{"text":"Use Template Sets (Custom Templates)","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/JEMH/pages/2850840"}}]},{"text":".","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Example with Service Desk User (with account) by email","type":"text"}]},{"type":"paragraph","content":[{"text":"The Portal Access user that came in with JSD 2.2 introduces some problems:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"atlassian-warning","text":":warning:","shortName":":warning:"}},{"text":" ","type":"text"},{"text":"https://jira.atlassian.com/browse/JSD-1473","type":"text","marks":[{"type":"link","attrs":{"href":"https://jira.atlassian.com/browse/JSD-1473"}}]},{"text":" Issue Creation for Portal Users fails through the API, this requires the workaround below","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"atlassian-minus","text":":minus:","shortName":":minus:"}},{"text":" Using this workaround, it is possible for any user to send an email into an issue with an issue key, and have that added as a comment. ","type":"text"},{"text":"Issue Security Schemes don't appear to help.","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"paragraph","content":[{"text":"The following is the current workaround configuration:","type":"text"}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"atlassian-info","text":":info:","shortName":":info:"}},{"text":" ","type":"text"},{"text":"JEMH v 1.6.49+ required","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Process","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create an auto-join group, e.g. ","type":"text"},{"text":"servicedesk-customers","type":"text","marks":[{"type":"strong"}]},{"text":" which is not used elsewhere","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":60.0},"content":[{"type":"media","attrs":{"width":1595,"id":"26a1a9ba-a3be-4c62-91ce-a1e3a3e3ecf0","collection":"contentId-17104912","type":"file","height":293}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Modify JEMH Profile set set the ","type":"text"},{"text":"Customer Request Type","type":"text","marks":[{"type":"strong"}]},{"text":" custom field (described in the first section)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Modify JEMH Profile","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"set ","type":"text"},{"text":"User > Create users : ","type":"text","marks":[{"type":"em"}]},{"text":"ON","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If your users all exist externally, not in a common LDAP repository set User > Create UserID from: ","type":"text"},{"text":"email","type":"text","marks":[{"type":"strong"}]},{"text":". Users in LDAP wont be created as they exist already, the next step will do what remains","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"set ","type":"text"},{"text":"User > Auto Join Group(s)","type":"text","marks":[{"type":"em"}]},{"text":" to refer to ","type":"text"},{"text":"servicedesk-customers","type":"text","marks":[{"type":"strong"}]},{"text":" and set the ","type":"text"},{"text":"User > Auto Join Group Condition","type":"text","marks":[{"type":"em"}]},{"text":" to be \"For All JIRA Users\"","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":38.0},"content":[{"type":"media","attrs":{"width":928,"id":"bf3da2d6-4eb3-441f-ac36-16df65ab54da","collection":"contentId-17104912","type":"file","height":936}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Modify Project Role","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to your service desk project and then edit Users and Roles in Project settings","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select Add users to a role and select the JEMH auto-join group, so that users who create issues by email without first subscribing, automatically get allocated that group, this role, and are therefore able to create issues etc.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":577,"id":"7a5ef403-edb4-4177-8613-0f461cf72a6a","collection":"contentId-17104912","type":"file","height":274}}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1186,"id":"8e61c7e3-bcf7-4510-82f3-24795f60ba0a","collection":"contentId-17104912","type":"file","height":330}}]},{"type":"paragraph"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Modify the Permission Scheme, granting the ","type":"text"},{"text":"servicedesk-customers","type":"text","marks":[{"type":"strong"}]},{"text":" group the below permissions. If you give \"Project Role (Customer)\" permissions in the scheme instead, public sign-up will be disabled by JSD.","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"

Permissions	Add them via the "Grant Permissions" link
Add Comments Assign Issues Browse Projects Close Issues Create Attachments Create Issues Delete Own Attachments Delete Own Comments Delete Issues Edit Issues Edit Own Comments Link Issues Manage Watchers Modify Reporter Move Issues Resolve Issues Schedule Issues Set Issue Security Transition Issues View Voters and Watchers

","block-inline":true,"nestedContent":{"type":"doc","content":[{"type":"table","content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Permissions","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Add them via the \"Grant Permissions\" link","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add Comments","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Assign Issues","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Browse Projects","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Close Issues","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create Attachments","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create Issues","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete Own Attachments","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete Own Comments","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete Issues","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit Issues","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit Own Comments","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Link Issues","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Manage Watchers","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Modify Reporter","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Move Issues","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Resolve Issues","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Schedule Issues","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set Issue Security","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Transition Issues","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"View Voters and Watchers","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":73.0},"content":[{"type":"media","attrs":{"width":901,"id":"f01cd5ed-6752-4767-a0ea-949fadd3baa9","collection":"contentId-17104912","type":"file","height":732}}]}]}]}]}],"version":1},"reason":"A table in list item can't be created or edited in the new editor."}}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Commenting","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Who gets internal notifications?","type":"text"}]},{"type":"paragraph","content":[{"text":"Any comment that is marked as internal will not be sent to Non-Jira users, achieving the intent of the JSD internal comment function. JIRA account holders found to be in the ","type":"text"},{"text":"Service Desk Customer","type":"text","marks":[{"type":"em"}]},{"text":" role will not be notified of internal JSD comments. Users who are designated as Service Desk Agents, or authorized Software/Core users will also get notified of internal comments.","type":"text"}]},{"type":"paragraph","content":[{"text":"Before version 1.6.50, JEMH would not be able to detect that an internal comment was made via Service Desk and therefore the above did not apply.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Controlling visibility of comments","type":"text"}]},{"type":"paragraph","content":[{"text":"Comments made by Service Desk Agents via JEMH are internal by default. However, this behaviour can be changed on a per-project basis by changing the setting ","type":"text"},{"text":"Profile > Project > Project Mapping > Comment > Agent comment visibility","type":"text","marks":[{"type":"strong"}]},{"text":". If ","type":"text"},{"text":"Directives","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/JEMH/pages/2850920"}}]},{"text":" are enabled for comments and a suitable ","type":"text"},{"text":"Field Processor","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/JEMH/pages/2850867"}}]},{"text":" is also enabled, then agents can set the visibility of their comment from the email itself during its composition.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, with the @Prefix field processor enabled the following would set the comment to be public:","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"@ Prefix Field Processor example","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"@internalComment=false\n\nThis is the body of my email, which is to become a comment.\n","type":"text"}]},{"type":"paragraph","content":[{"text":"In your profile, you could ","type":"text"},{"text":"create aliases for the directive","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/JEMH/pages/2850836"}}]},{"text":" to allow simpler usage by agents:","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"table","attrs":{"layout":"default","localId":"a5b079a9-528b-4670-b0af-f2456303e0fe"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[199.0]},"content":[{"type":"paragraph","content":[{"text":"Alias","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[560.0]},"content":[{"type":"paragraph","content":[{"text":"Value","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[199.0]},"content":[{"type":"paragraph","content":[{"text":"internal","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[560.0]},"content":[{"type":"paragraph","content":[{"text":"internalComment=true","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[199.0]},"content":[{"type":"paragraph","content":[{"text":"public","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[560.0]},"content":[{"type":"paragraph","content":[{"text":"internalComment=false","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"The above 2 alias configurations (with the @prefix field processor enabled) would allow agents to then use @internal or @public in their email body to set their comment as internal or public respectively.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Including email recipients","type":"text"}]},{"type":"paragraph","content":[{"text":"terminology recap:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"“email user” or “non-jira user”","type":"text","marks":[{"type":"strong"}]},{"text":" : have no account at all, who cannot login to Jira or the JSM portal","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"“Jira user”","type":"text","marks":[{"type":"strong"}]},{"text":" : have accounts, of some kind in the instance, whether they are portal users or interactive Jira users.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"When a user emails into a JEMH managed mailbox, additional recipients of the message can be added to the created issue (or on update, if the sender is already involved), exactly ","type":"text"},{"text":"how","type":"text","marks":[{"type":"em"}]},{"text":" additional recipients are managed is controlled through the ","type":"text"},{"text":"Profile > Email > Addressee Processing","type":"text","marks":[{"type":"em"}]},{"text":" section, shown below:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":978,"id":"d63e5deb-1e9d-4456-a195-2482b2a97ec1","collection":"contentId-17104912","type":"file","height":353}}]},{"type":"paragraph","content":[{"text":"Addressee Handling ","type":"text","marks":[{"type":"strong"}]},{"text":"is the primary driver to describe how email addressees are handled. In JSM, two fields are usually involved:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Selecting ","type":"text"},{"text":"toCustomField ","type":"text","marks":[{"type":"em"}]},{"text":"will enable support for email-only non-Jira user support (email notification of updates but no ability to access the portal), where recipients are automatically merged into a text multi-line custom field (","type":"text"},{"text":"3,","type":"text","marks":[{"type":"strong"}]},{"text":" above).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Selecting ","type":"text"},{"text":"toJSDRequestParticipants ","type":"text","marks":[{"type":"em"}]},{"text":"will enable support for Request Participants, the addition of users here is subject to the filter (","type":"text"},{"text":"2","type":"text","marks":[{"type":"strong"}]},{"text":", above).","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Request Participants","type":"text"}]},{"type":"paragraph","content":[{"text":"The Service Desk project admin can set 'customer permissions (screenshot below), this security setting affects JEMH.","type":"text"}]},{"type":"paragraph","content":[{"text":"Jira is the gatekeeper of security and will reject issue update requests (by JEMH) if they violate security choices. Settings are found within the ","type":"text"},{"text":"JSM Project > Customer permissions","type":"text","marks":[{"type":"em"}]},{"text":" section.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"“Customers who are added to the project”","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"When set, Jira will deny any Jira user that may exist in your site but are not actually added as customer to this particular Service Desk:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":723,"id":"78681122-1425-4a7c-83d6-71376f5a9b79","collection":"contentId-17104912","type":"file","height":278}}]},{"type":"paragraph","content":[{"text":"Prior to 3.3.63 Jira would reject attempts by JEMH to set customers who were not authorized, resulting in emails being Forwarded.","type":"text"}]},{"type":"paragraph","content":[{"type":"status","attrs":{"color":"green","style":"bold","text":"since 3.3.63","localId":"4224c33b-f7b2-4fa2-b48f-1f1296325e59"}},{"text":" JEMH can be configured to react to such users, allowing exclusion (registered customers only) or partial inclusion (treating such customers as non-jira) - enabling this support does mean ‘email user support’ is also enabled.","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"97aea66d-94a2-40f9-8485-b6f55f8d565a"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[211.0]},"content":[{"type":"paragraph","content":[{"text":"jira-user without current portal access handling","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"paragraph","content":[{"text":"Configuration Required","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[211.0]},"content":[{"type":"paragraph","content":[{"text":"Drop","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Profile > Email > Addressee Processing > Request Participant Filter ","type":"text","marks":[{"type":"em"}]},{"text":": ","type":"text"},{"text":"requireCustomerRole","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Profile > Email > Addressee Processing > Addressee Handling","type":"text","marks":[{"type":"em"}]},{"text":" : includes ","type":"text"},{"text":"toJSDRequestParticipants","type":"text","marks":[{"type":"strong"}]}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[211.0]},"content":[{"type":"paragraph","content":[{"text":"Treat as non-Jira","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Profile > Email > Addressee Processing > Request Participant Filter ","type":"text","marks":[{"type":"em"}]},{"text":": ","type":"text"},{"text":"none","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Profile > Email > Addressee Processing > Addressee Handling","type":"text","marks":[{"type":"em"}]},{"text":" : includes ","type":"text"},{"text":"toCustomField, toJSDRequestParticipants","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Profile > Email > Addressee Processing > Assign non jira-user Email to Text CustomField","type":"text","marks":[{"type":"em"}]},{"text":" : ","type":"text"},{"text":"set to a text multi-line field","type":"text","marks":[{"type":"strong"}]}]}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"“Customers who have an account on this Jira site”","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"When set, Jira will allow any Jira user to be added as a request participant. If addressees are found that do not have accounts, they will simply be ","type":"text"},{"text":"excluded","type":"text","marks":[{"type":"strong"}]},{"text":". Only when non-Jira support is enabled would they become involved as email only.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":704,"id":"8a1d9a2f-2538-4f8f-ba78-4641d97f5f06","collection":"contentId-17104912","type":"file","height":283}}]},{"type":"paragraph","content":[{"text":"This is historic behaviour:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"ffc51ef3-8b3d-43b2-bded-261a19355aca"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[211.0]},"content":[{"type":"paragraph","content":[{"text":"jira-user without current portal access handling","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"paragraph","content":[{"text":"Configuration Required","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[211.0]},"content":[{"type":"paragraph","content":[{"text":"Drop","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"paragraph","content":[{"text":"n/a, default behaviour","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[211.0]},"content":[{"type":"paragraph","content":[{"text":"Treat as non-Jira","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Profile > Email > Addressee Processing > Addressee Handling","type":"text","marks":[{"type":"em"}]},{"text":" : includes ","type":"text"},{"text":"toCustomField, toJSDRequestParticipants","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Profile > Email > Addressee Processing > Assign non jira-user Email to Text CustomField","type":"text","marks":[{"type":"em"}]},{"text":" : ","type":"text"},{"text":"set to a text multi-line field","type":"text","marks":[{"type":"strong"}]}]}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Email Processing Report Messages","type":"text"}]},{"type":"paragraph","content":[{"type":"status","attrs":{"color":"green","style":"bold","text":"since 3.3.63","localId":"962e7181-c7d5-4f0e-8695-7086cbe482d5"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"When users are ","type":"text"},{"text":"added as Request Participants","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"Adding request participant: csdcustomer@blah.com","type":"text"}]},{"type":"paragraph","content":[{"text":"When a user is not authorized and is ","type":"text"},{"text":"added as a non-jira email user","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"User treated as non-jira [csdcustomer@blah.com], is not authorized for closed-access portal [SD]","type":"text"}]},{"type":"paragraph","content":[{"text":"When a non-customer user is ","type":"text"},{"text":"excluded ","type":"text","marks":[{"type":"strong"}]},{"text":"when either ","type":"text"},{"text":"toCustomField","type":"text","marks":[{"type":"em"}]},{"text":" is not enabled or a custom field is not defined for “Assign non jira-user Email to Text Custom Field”:","type":"text"}]},{"type":"codeBlock","content":[{"text":"User excluded [csdcustomer@blah.com], not authorized for closed-access portal [SD]. Cannot treat as non-jira (not enabled)","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Related articles","type":"text"}]},{"type":"paragraph","content":[{"type":"placeholder","attrs":{"text":"Related articles appear here based on the labels you select. Click to edit the macro and add or change labels."}}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"contentbylabel","parameters":{"macroParams":{"showLabels":{"value":"false"},"max":{"value":"5"},"spaces":{"value":"JEMH"},"sort":{"value":"modified"},"showSpace":{"value":"false"},"reverse":{"value":"true"},"type":{"value":"page"},"cql":{"value":"label in ( \"service-desk\" , \"servicedesk\" , \"integration\" , \"configuration\" , \"notifcations\" , \"jsd\" ) and space = \"JEMH\""},"labels":{"value":"event listener jemh issue notification"}},"macroMetadata":{"macroId":{"value":"3c681662-6dcc-454a-8d31-a5b4cffec042"},"schemaVersion":{"value":"4"},"title":"Content by Label"}},"localId":"86c3065f-ee58-401d-acb0-ac76d352a1f2"}},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"details","parameters":{"macroParams":{"hidden":{"value":"true"}},"macroMetadata":{"macroId":{"value":"8a94f6e3-3bc0-45b9-8b38-2ff1a1a0c8d9"},"schemaVersion":{"value":"1"},"title":"Page Properties"}},"localId":"a8f696cd-5a96-40c2-a1fd-00da37f1ea64"},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"table","attrs":{"layout":"default","localId":"b2069a8e-1e5b-4762-a865-255a2243c1ad"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[1201.0]},"content":[{"type":"paragraph","content":[{"text":"Related issues","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[565.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported