How does automatic linking of work item established when you type "work item type work item id " in the description/comment field of a work item.
We are using CLM 5.0 applications in our environment. I am looking for some help with clarification on Work item link creation.
What I am finding is that auto link expansion only works within the context of ProjA when I type "defect 12345" it creates the link, similarly in ProjB as well. However, in ProjB, for work item "ExtTkt 67890" when I type "defect 12345" in description/comment field it should create a link to work item in ProjA that corresponds to "defect 12345". Also, reverse from ProjA to point to work item in ProjB should work but it does not work as expected. Is this because of ProjA/ProjB are not aware of what those work item types are within the context of their own areas? Is this working as designed?
I am aware that if I want to insert a link to work item I can simply right click in description/comments field and select "Insert Work item link", as well as option to press "CNTRL+SPACEBAR" to select a work item for inserting a link. I am also aware that we can create link by mentioning "work item <ID>", however I want to be able to just type "<work item type> <work item id>" and be able to have link, is that possible?
Can someone confirm the above process and or point to document that clearly explains how this particular feature works and all options associated with it?
Thanks,
Samir
Accepted answer
There's an old document to explain the Link Detection https://jazz.net/wiki/bin/view/Main/LinkDetection.
By my testing,
- if you use the work item type or alias which does not exist in the current project area, the link can not be detected
- you can use "work item <id>" which always works to create a link automatically
Hope it's helpful.
By my testing,
- if you use the work item type or alias which does not exist in the current project area, the link can not be detected
- you can use "work item <id>" which always works to create a link automatically
Hope it's helpful.
One other answer
The current link detection behavior was introduced since v4.0.4:Link detection will only trigger on the aliases and work item type names defined in a project area.
In the past(prior to v4.0.4) the tool used to do it on all types and aliases defined in all project areas, this basically led to two issues:
1) It caused memory issues because imagine there are 1000 project areas and each of them have defined some aliases. The old algorithm would go through all those aliases and provide links which led to the memory issues. The server was under a heavy performance load each time you sent a link detection request.
2) Due to the initial implementation, the algorithm was identifying aliases which were not intended. Say in a particular project area, you had some comments like Department 1 etc. Now if someone defines a Department alias in another project area, that would corrupt the view here because of link detection
there is already an enhancement request which proposes to allow the project admin to define which aliases are recognized as links and thus you could have your comments on that:
https://jazz.net/jazz/web/projects/Rational%20Team%20Concert#action=com.ibm.team.workitem.viewWorkItem&id=204058
In the past(prior to v4.0.4) the tool used to do it on all types and aliases defined in all project areas, this basically led to two issues:
1) It caused memory issues because imagine there are 1000 project areas and each of them have defined some aliases. The old algorithm would go through all those aliases and provide links which led to the memory issues. The server was under a heavy performance load each time you sent a link detection request.
2) Due to the initial implementation, the algorithm was identifying aliases which were not intended. Say in a particular project area, you had some comments like Department 1 etc. Now if someone defines a Department alias in another project area, that would corrupt the view here because of link detection
there is already an enhancement request which proposes to allow the project admin to define which aliases are recognized as links and thus you could have your comments on that:
https://jazz.net/jazz/web/projects/Rational%20Team%20Concert#action=com.ibm.team.workitem.viewWorkItem&id=204058