where can we find documentation about SMALL_PROFILE, MEDIUM_PROFILE, LARGE_PROFILE, DEFAULT_PROFILE, FULL_PROFILE ?
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.
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
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
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
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
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
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
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
- 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
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
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