{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"outline":{"value":"true"},"style":{"value":"none"}},"macroMetadata":{"macroId":{"value":"f57f5c1f-8971-47be-97e3-e1dadf48283c"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"a55d93e0-e0ab-44ff-b427-e2f8a144363f"},"marks":[{"type":"fragment","attrs":{"name":"Extension 1","localId":"3941db0a-c71e-4e22-9b60-e244390cb015"}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Quick Start Guide","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Jira Plugin","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Download the following files","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"user-profiles-external-api-1.1.0.jar","type":"text","marks":[{"type":"link","attrs":{"href":"https://communardo-products.atlassian.net/wiki/download/attachments/9798347/user-profiles-external-api-1.1.0.jar?api=v2"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Documentation:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"user-profiles-external-api-1.1.0-javadoc.jar","type":"text","marks":[{"type":"link","attrs":{"href":"https://communardo-products.atlassian.net/wiki/download/attachments/9798347/user-profiles-external-api-1.1.0-javadoc.jar?api=v2"}}]}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Add the files to your Maven repository","type":"text"}]},{"type":"paragraph","content":[{"text":"There are two possibilities to install the library files. Either install them in a local Maven repository or deploy them to a hosted Maven repository.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Install in the local Maven repository","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn install:install-file -Dfile=user-profiles-external-api-1.1.0.jar -DgroupId=de.communardo.atlassian.plugins.userprofile.external.api -DartifactId=user-profiles-external-api -Dversion=1.1.0 -Dpackaging=jar -Djavadoc=user-profiles-external-api-1.1.0-javadoc.jar","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Deploy to a hosted Maven repository","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn deploy:deploy-file -Dfile=user-profiles-external-api-1.1.0.jar -DgroupId=de.communardo.atlassian.plugins.userprofile.external.api -DartifactId=user-profiles-external-api -Dversion=1.1.0 -Dpackaging=jar -Djavadoc=user-profiles-external-api-1.1.0-javadoc.jar -DrepositoryId= -Durl=","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Include the UPJ Java API in your Add-On pom.xml","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n de.communardo.atlassian.plugins.userprofile.external.api\n user-profiles-external-api\n 1.1.0\n provided\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Import UPJ components to your atlassian-plugin.xml","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Make sure the User Profiles for Jira Add-on is already installed on your Jira system.","type":"text"}]},{"type":"paragraph","content":[{"text":"Check ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://communardo-products.atlassian.net/wiki/spaces/UPJ/pages/9797988"}},{"text":" for further information.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Scriptrunner","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"General","type":"text"}]},{"type":"paragraph","content":[{"text":"Our Java API may also be accessed via Scriptrunner. To be able to do that you have to follow the steps which are described in the official Scriptrunner documentation, which can be found here: ","type":"text"},{"text":"https://scriptrunner.adaptavist.com/latest/jira/scripting-other-plugins.html","type":"text","marks":[{"type":"link","attrs":{"href":"https://scriptrunner.adaptavist.com/latest/jira/scripting-other-plugins.html"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Make sure the User Profiles for Jira Add-on is already installed on your Jira system.","type":"text"}]},{"type":"paragraph","content":[{"text":"Check ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://communardo-products.atlassian.net/wiki/spaces/UPJ/pages/9797988"}},{"text":" for further information.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"To provide you a more easy way to start developing scripts with Scriptrunner, we prepared a minimal example, which provides you our API managers with whom you can access profile elements and their data:","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example 1","type":"text"}]},{"type":"paragraph","content":[{"text":"Example that prints all profile elements and the available element data for the current user in the log (log-level INFO, which may prevent you from seeing anything per default, so maybe use log-level ERROR instead if you want to directly see something in the log).","type":"text"}]},{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"import com.onresolve.scriptrunner.runner.customisers.PluginModule\nimport com.onresolve.scriptrunner.runner.customisers.WithPlugin\nimport com.atlassian.jira.component.ComponentAccessor\nimport com.atlassian.sal.api.user.UserKey\nimport de.communardo.atlassian.plugins.userprofile.external.api.service.UppProfileElementManager\nimport de.communardo.atlassian.plugins.userprofile.external.api.service.UppProfileElementDataManager\n\n@WithPlugin(\"de.communardo.jira.plugins.userprofile\")\n\n@PluginModule\nUppProfileElementManager uppProfileElementManager\n@PluginModule\nUppProfileElementDataManager uppProfileElementDataManager\n\nlog.info(uppProfileElementManager.getProfileElements())\nlog.info(uppProfileElementDataManager.getProfileElementData(new UserKey(ComponentAccessor.getJiraAuthenticationContext().getLoggedInUser().getKey())))","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example 2","type":"text"}]},{"type":"paragraph","content":[{"text":"Example that shows the data in a given profile element for a given user:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"// sample script for app \"User Profiles for Jira\", showing how to diplay profile data of a user\n// config variables:\ndef userName = \"admin\" // or leave empty to use currently logged-in user instead\ndef profileElementId = 1 // ID can be found in URL of profile-element's \"Edit\"-link\n// end config\n\n// start code\nimport com.onresolve.scriptrunner.runner.customisers.PluginModule\nimport com.onresolve.scriptrunner.runner.customisers.WithPlugin\nimport com.atlassian.jira.component.ComponentAccessor\nimport com.atlassian.sal.api.user.UserKey\nimport de.communardo.atlassian.plugins.userprofile.external.api.service.UppProfileElementManager\nimport de.communardo.atlassian.plugins.userprofile.external.api.service.UppProfileElementDataManager\nimport de.communardo.atlassian.plugins.userprofile.external.api.model.elements.*\n\n@WithPlugin(\"de.communardo.jira.plugins.userprofile\")\n@PluginModule\nUppProfileElementManager uppProfileElementManager\n@PluginModule\nUppProfileElementDataManager uppProfileElementDataManager\n\n// get user\ndef user = userName\n ? ComponentAccessor.userManager.getUserByName(userName)\n : ComponentAccessor.jiraAuthenticationContext.loggedInUser\n\n// get Profile Element by ID \ndef profileElement = uppProfileElementManager.getProfileElement(profileElementId)\n\n// get data object in given profile element of given user\ndef profileData = uppProfileElementDataManager.getProfileElementData(new UserKey(user.getKey()), profileElement)\n\n// get human readable version of data object, depending on data type, see docu: https://communardo-products.atlassian.net/wiki/spaces/UPJ/pages/9798347/Java+API+Documentation+v+2.5#Profile-element-and-data-types\ndef humanReadableValue\nif (profileElement instanceof MultiSelectProfileElement) {\n humanReadableValue = profileData.getOptions()*.getName()\n}\nelse if (profileElement instanceof SingleSelectProfileElement) {\n humanReadableValue = profileData.getOption()?.getName()\n}\nelse if (profileElement instanceof TextBasedProfileElement) {\n humanReadableValue = profileData.getText()\n}\nelse if (profileElement instanceof UserProfileElement) {\n // value is a userKey -> 1) get referenced user \n def referencedUser = ComponentAccessor.userManager.getUserByKey(profileData.getUserKey()?.getStringValue())\n // 2) get displayName of referenced user\n humanReadableValue = referencedUser?.getDisplayName()\n}\n\n\"\"\"\nShowing data of user ${user.getDisplayName()}\nin profile element ${profileElement.getName()} (ID ${profileElement.getId()}, type ${profileElement.class.simpleName}):
\n${humanReadableValue}\n\"\"\"","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Internal structure and basic usage","type":"text"}]},{"type":"paragraph","content":[{"text":"The UPJ Java API consists out of two basic elements: the profile element and the profile element data. Profile elements can be added and removed in the UPJ administration (check ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://communardo-products.atlassian.net/wiki/spaces/UPJ/pages/9797939"}},{"text":" for further information). Values may afterwards be added for every user via an LDAP sync or by manually editing user profiles (in the administration or the user does it on his own) or even by using our new Java API.","type":"text"}]},{"type":"paragraph","content":[{"text":"To interact with profile elements, just inject and use the provided UppProfileElementManager. With this manager you will be able to load the available profile elements. Afterwards you may want to access some data which is related to a user. To achieve that, just inject and use the provided UppProfileElementDataManager. ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Profile element and data types","type":"text"}]},{"type":"paragraph","content":[{"text":"There are several profile element and data types which are used to work with the API. To provide you a better start, we are going to list all currently available profile elements and their matching data models in the following table:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1404.0,"localId":"e1df87d8-5de9-4ed0-9da7-496d7cd03088"},"marks":[{"type":"fragment","attrs":{"name":"Table 1","localId":"6200febd-58d4-4994-9e2e-a29403ded6bd"}}],"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"Profile Element Models","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[257.0]},"content":[{"type":"paragraph","content":[{"text":"Profile Element Data Models","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[424.0]},"content":[{"type":"paragraph","content":[{"text":"getter Method","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[497.0]},"content":[{"type":"paragraph","content":[{"text":"setter Method(s)","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"MultiSelectProfileElement","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[257.0]},"content":[{"type":"paragraph","content":[{"text":"MultiSelectProfileElementData","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[424.0]},"content":[{"type":"paragraph","content":[{"text":"Set getOptions()","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[497.0]},"content":[{"type":"paragraph","content":[{"text":"setOptions(Set options)","type":"text"}]},{"type":"nestedExpand","attrs":{"title":"Show additional methods..."},"content":[{"type":"paragraph","content":[{"text":"addOption(OptionedProfileElement.Option option)","type":"text"},{"type":"hardBreak"},{"text":"addOptions(Set options)","type":"text"},{"type":"hardBreak"},{"text":"removeOption(OptionedProfileElement.Option option)","type":"text"},{"type":"hardBreak"},{"text":"removeOptions(Set options)","type":"text"},{"type":"hardBreak"},{"text":"removeAllOptions()","type":"text"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"SingleSelectProfileElement","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[257.0]},"content":[{"type":"paragraph","content":[{"text":"SingleSelectProfileElementData","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[424.0]},"content":[{"type":"paragraph","content":[{"text":"OptionedProfileElement.Option getOption()","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[497.0]},"content":[{"type":"paragraph","content":[{"text":"setOption(OptionedProfileElement.Option option)","type":"text"}]},{"type":"nestedExpand","attrs":{"title":"Show additional methods..."},"content":[{"type":"paragraph","content":[{"text":"removeOption()","type":"text"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"TextBasedProfileElement","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[257.0]},"content":[{"type":"paragraph","content":[{"text":"TextBasedProfileElementData","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[424.0]},"content":[{"type":"paragraph","content":[{"text":"String getText()","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[497.0]},"content":[{"type":"paragraph","content":[{"text":"setText(String text)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"UserProfileElement","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[257.0]},"content":[{"type":"paragraph","content":[{"text":"UserProfileElementData","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[424.0]},"content":[{"type":"paragraph","content":[{"text":"UserKey getUserKey()","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[497.0]},"content":[{"type":"paragraph","content":[{"text":"setUserKey(UserKey userKey)","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"You have to use matching profile element and data types to be able to interact with the API. Furthermore, the specialized data objects make an interaction with a specific data type more easy.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Event publication","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"ProfileElementDataChangedEvent","type":"text"}]},{"type":"paragraph","content":[{"text":"The User Profiles for Jira App publishes events every minute, which contain all changes that are taken since the last publication. One event contains a maximum of 1000 changes as a collection of updates. Each update contains a key of an user, a profile element and the new data. The following table shows the models of the change sets:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"c33efc90-2cbb-4e75-9ce2-843f5350abbd"},"marks":[{"type":"fragment","attrs":{"name":"Table 2","localId":"48afa339-d38d-4b75-a574-677aff856ac7"}}],"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Profile Element Change Set Models","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Profile Element Models","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Data Models","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"AutocompleteProfileElementDataUpdate","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"AutocompleteProfileElement","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Set","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"MultiSelectProfileElementDataUpdate","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"MultiSelectProfileElement","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Set","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"SingleSelectProfileElementDataUpdate","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"SingleSelectProfileElement","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"OptionedProfileElement.Option","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"TextBasedProfileElementDataUpdate","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"TextBasedProfileElement","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"UserProfileElementDataUpdate","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"UserProfileElement","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"UserKey","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"ProfileElementNameChangedEvent","type":"text"}]},{"type":"paragraph","content":[{"text":"This event is published when the default name of a profile element is changed. It contains the updated profile element.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"ProfileElementRemovedEvent","type":"text"}]},{"type":"paragraph","content":[{"text":"This event is published when a profile element is removed. It contains the removed profile element.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"ProfileElementOptionNameChangedEvent","type":"text"}]},{"type":"paragraph","content":[{"text":"This event is published when the default name of an option of a profile element is changed. It contains the updated profile element and the updated option.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"ProfileElementOptionRemovedEvent","type":"text"}]},{"type":"paragraph","content":[{"text":"This event is published when an option of a profile element is removed. It contains the updated profile element and the removed option.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"To kickstart you a little bit more, we want to provide you with a few examples on what you can currently do with our Java API:","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"UppProfileElementManager","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Loading all profile elements","type":"text"}]},{"type":"codeBlock","content":[{"text":"Collection profileElements = uppProfileElementManager.getProfileElements();","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Loading a specific profile element with a specific id (for example 1)","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"ProfileElement profileElement = uppProfileElementManager.getProfileElement(1);\n//or if you know the type of the profileElement (in this example it is a TextBasedProfileElement)\nTextBasedProfileElement textbasedProfileElement = uppProfileElementManager.getProfileElement(1);","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"UppProfileElementDataManager","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Loading profile element data for a profile element and an user","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"ProfileElementData data = uppProfileElementDataManager.getProfileElementData(userKey, profileElement);\n//or if you know the type of the profileElement or the data (in this example it is a TextBasedProfileElementData)\nTextBasedProfileElementData data = uppProfileElementDataManager.getProfileElementData(userKey, profileElement);","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Loading all profile elements for an user","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"Map data = uppProfileElementDataManager.getProfileElementData(userKey);","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Storing profile element data for a profile element and an user","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"uppProfileElementDataManager.storeProfileElementData(userKey, profileElement, data);","type":"text"}]},{"type":"paragraph","content":[{"text":"To be able to store data, the type of the profile Element must match the type of the data.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"ProfileElementDataChangedEvent","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Event Listener example","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n ","type":"text"}]},{"type":"codeBlock","content":[{"text":"public class ProfileElementDataChangeEventListener {\n\n public ProfileElementDataChangeEventListener(EventPublisher eventPublisher) {\n // register the event listener class in the event publisher\n eventPublisher.register(this);\n }\n\n @EventListener\n public void onProfileElementDataChange(ProfileElementDataChangedEvent profileElementDataChangedEvent) {\n // get all change sets in the event (the number of elements are not limited)\n Collection changeSets = profileElementDataChangedEvent.getChangeSets();\n \n // iterates over all change sets\n for(ProfileElementDataChangeSet profileElementDataChangeSet : changeSets ) {\n if (profileElementDataChangeSet instanceof TextBasedProfileElementDataChangeSet) {\n // do some stuff for a change of a TextBasedProfileElement\n } else if (profileElementDataChangeSet instanceof AutocompleteProfileElementDataChangeSet) {\n // do some stuff for a change of a AutocompleteProfileElement\n } else if (profileElementDataChangeSet instanceof MultiSelectProfileElementDataChangeSet) {\n // do some stuff for a change of a MultiSelectProfileElement\n } else if (profileElementDataChangeSet instanceof SingleSelectProfileElementDataChangeSet) {\n // do some stuff for a change of a SingleSelectProfileElement\n } else if (profileElementDataChangeSet instanceof UserProfileElementDataChangeSet) {\n // do some stuff for a change of a UserProfileProfileElement\n }\n }\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"You can also follow the instructions on ","type":"text"},{"text":"https://developer.atlassian.com/server/jira/platform/writing-jira-event-listeners-with-the-atlassian-event-library/","type":"text","marks":[{"type":"link","attrs":{"href":"https://developer.atlassian.com/server/jira/platform/writing-jira-event-listeners-with-the-atlassian-event-library/"}}]},{"text":" .","type":"text"}]},{"type":"paragraph"}],"version":1}