It's all about the answers!

Ask a question

where can we find documentation about SMALL_PROFILE, MEDIUM_PROFILE, LARGE_PROFILE, DEFAULT_PROFILE, FULL_PROFILE ?


Isabel Murakami (3811414) | asked Feb 21 '14, 4:55 p.m.
Hi RTC community,

Using Java API, we want to get some attributes, for instance, Subscribers:
IWorkItem workingCopy = (IWorkItem) fWorkItemServer.getAuditableCommon().resolveAuditable(workItem, IWorkItem.FULL_PROFILE, monitor).getWorkingCopy();
ISubscriptions subscriptions = workingCopy.getSubscriptions();
for (IContributorHandle subscriberHandle : subscribers) {
      subscriptions.add(subscriberHandle);
}
IStatus saveStatus = fWorkItemServer.saveWorkItem2(workingCopy, null, null);

- in the first line, we have the profile as we get the working copy of the work item
- then we get the Subscriptions, and for each of the subscriberHandles that are passed it, we add a subscription for that person
-then save the work item
if we change FULL_PROFILE to anything else (SMALL, MEDIUN, LARGE or DEFAULT), we get an Exception.

we were programmatically adding a subscriber but we really don't want to have to do that for  everything we need to do

==> what is the difference between DEFAULT and FULL? or LARGE and FULL? or MEDIUM and FULL?
==> What are the attributes returned/available when using IWorkItem.SMALL_PROFILE,  IWorkItem.MEDIUM_PROFILE, IWorkItem.LARGE_PROFILE, IWorkItem.DEFAULT_PROFILE ?
==> where can we find documentation on which PROFILE is the MINIMUM required based on what they need to read or modify ?   

We don't want to load more than we need to as that would impact the system
so if we can use just SMALL_PROFILE, then we should do that instead of just using FULL_PROFILE for everything

since we (extenders) need to use this all of the time, we need somewhere that gives us enough info to properly make a determination of which profile is needed

- Same question here:
https://jazz.net/jazz/web/projects/Rational%20Team%20Concert#action=com.ibm.team.workitem.viewWorkItem&id=9328
However it does not fully explain the content of each Profile, as Customer is complaining.


3 answers



permanent link
Arne Bister (2.6k12732) | answered Feb 22 '14, 9:25 a.m.
JAZZ DEVELOPER
edited Feb 23 '14, 1:33 a.m.
Susan,
currently it seems that this information is not documented outside of the actual source. I personally think it is a very valid request to have it documented so I took the liberty of opening the following Enhancement Request 304610.
Until that is resolved, here are the results from RTC SDK source code (thanks to contribution of Ralph Schoon):

SMALL_PROFILE loads PROJECT_AREA_PROPERTY, ID_PROPERTY, TYPE_PROPERTY, SUMMARY_PROPERTY, OWNER_PROPERTY

DEFAULT_PROFILE = SMALL_PROFILE + (STATE, PRIORITY, SEVERITY, CREATOR, WORKFLOW_SURROGATE, DESCRIPTION)

MEDIUM_PROFILE = DEFAULT_PROFILE + (RESOLUTION, CREATION_DATE, CATEGORY, DUE_DATE, DURATION)

LARGE_PROFILE = MEDIUM_PROFILE + (COMMENTS)

FULL_PROFILE = everything

If this is useful, please mark the answer as accepted.
Thanks,

Arne

Comments
sam detweiler commented Feb 22 '14, 7:52 p.m.

thanks Arne, great post..    


could I ask a favor, could you merge the small profile info from above into your answer, so that is all in one posting.. 

thank you..


permanent link
Susan Hanson (1.6k2192194) | answered Feb 23 '14, 4:21 a.m.
I pulled the SDK source code for 4.0.0.1 and here is what I found:

SMALL_PROFILE: PROJECT_AREA_PROPERTY, ID_PROPERTY, TYPE_PROPERTY, SUMMARY_PROPERTY, OWNER_PROPERTY

DEFAULT_PROFILE: SMALL_PROFILE + STATE_PROPERTY, PRIORITY_PROPERTY, SEVERITY_PROPERTY, CREATOR_PROPERTY, WORKFLOW_SURROGATE_PROPERTY, DESCRIPTION_PROPERTY

MEDIUM_PROFILE: DEFAULT_PROFILE  + RESOLUTION_PROPERTY, CREATION_DATE_PROPERTY, CATEGORY_PROPERTY, DUE_DATE_PROPERTY, DURATION_PROPERTY

LARGE_PROFILE= MEDIUM_PROFILE + (CUSTOM_ATTRIBUTE_PROPERTIES) + COMMENTS_PROPERTY

Susan

permanent link
Arne Bister (2.6k12732) | answered Feb 21 '14, 6:05 p.m.
JAZZ DEVELOPER
Isabel,

while I completely concur that it would be useful to have this described in detail in the documentation, field lore as persisted in Ralph Schoons blog will at least tell you that:

- SMALL_PROFILE loads PROJECT_AREA_PROPERTY, ID_PROPERTY, TYPE_PROPERTY, SUMMARY_PROPERTY, OWNER_PROPERTY

- You can create your own custom profile by using e.g. IWorkItem.SMALL_PROFILE.createExtension(Arrays.asList(new String[] { STATE_PROPERTY, PRIORITY_PROPERTY, SEVERITY_PROPERTY, CREATOR_PROPERTY, WORKFLOW_SURROGATE_PROPERTY, DESCRIPTION_PROPERTY, }));

- All profiles you mention are defined in com.ibm.team.workitem.common.model.IWorkItem

If this helps you please mark the answer as accepted.

Thanks,
Arne


Comments
Susan Hanson commented Feb 21 '14, 8:14 p.m.

I opened a PMR to get this information.  I don't want to create my own profile and I saw in Ralph's post that he tells what is in the SMALL_PROFILE.  What I am looking for is the same list of what the profile loads for MEDIUM_PROFILE, LARGE_PROFILE, and DEFAULT_PROFILE. 

I assume I am not alone as an extender which uses these PROFILEs.  Are you saying that I have to go get the actual source of IWORKITEM and look?

Susan

Your answer


Register or to post your answer.