Jazz Forum Welcome to the Jazz Community Forum Connect and collaborate with IBM Engineering experts and users

Workitem customization - Best Practices??

I'm looking for advice on workitem customization best practices and what to do to "future proof" my changes.

For example, what should I use as a naming convention to avoid potential collisions with updates to the out of box definitions in future upgrades?

I've copied and tweaked the default editor presentation (com.ibm.team.workitem.editor.default) to create a custom presentation for Defect work items, so that I can show different attributes for Severity and Priority than Tasks, which uses the same default editor. Initially I duplicated the editor and called it com.ibm.team.workitem.editor.defect, but realized this could easily be used as the name for a future standard defect editor... so would my custom editor get lost? Is there a good convention for naming the new items I create for my customized editors and enumerations?

I came across a few good articles, but can't find the "Best Practices" Tech Note referenced in Work Item Customization in Rational Team Concert

http://jazz.net/library/article/130 - Work Item Editor Presentations

http://jazz.net/library/article/129 - Work Item Customization in Rational Team Concert ... "Safe customizations" are customizations that either add new elements (e.g. work item types) or only change UI related features like display names or editor layouts. The Tech Note "Work Item Customization - Best Practices" explains in more detail how to customize in a safe way.

1 vote



2 answers

Permanent link
Hi Chris,

in trying to avoid potential conflicts I typically try to make sure NOT to use the ID prefixes used in the products.

Customizing for a customer I use their domain name e.g. com.customer..... if customizing for general usage I modify the prefix e.g. using com.ibm.field.....

Please note, that is just my personal "Best Practice". It worked for me in the past also when creating Eclipse extensions.

Ralph

I'm looking for advice on workitem customization best practices and what to do to "future proof" my changes.

For example, what should I use as a naming convention to avoid potential collisions with updates to the out of box definitions in future upgrades?

I've copied and tweaked the default editor presentation (com.ibm.team.workitem.editor.default) to create a custom presentation for Defect work items, so that I can show different attributes for Severity and Priority than Tasks, which uses the same default editor. Initially I duplicated the editor and called it com.ibm.team.workitem.editor.defect, but realized this could easily be used as the name for a future standard defect editor... so would my custom editor get lost? Is there a good convention for naming the new items I create for my customized editors and enumerations?

I came across a few good articles, but can't find the "Best Practices" Tech Note referenced in Work Item Customization in Rational Team Concert

http://jazz.net/library/article/130 - Work Item Editor Presentations

http://jazz.net/library/article/129 - Work Item Customization in Rational Team Concert ... "Safe customizations" are customizations that either add new elements (e.g. work item types) or only change UI related features like display names or editor layouts. The Tech Note "Work Item Customization - Best Practices" explains in more detail how to customize in a safe way.

0 votes


Permanent link
I'm looking for this "Work Item Customization - Best Practices" article too and can't find it.

Usually in a wiki I'd expect a link, no?

Can a member of the RTC development team add a link to this unknown article in the two articles mentioned above?

Thanks,
Eyal

0 votes

Your answer

Register or log in to post your answer.

Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more here.

Search context
Follow this question

By Email: 

Once you sign in you will be able to subscribe for any updates here.

By RSS:

Answers
Answers and Comments
Question details

Question asked: Jun 21 '10, 4:00 p.m.

Question was seen: 7,243 times

Last updated: Jun 21 '10, 4:00 p.m.

Confirmation Cancel Confirm