Is the help documentation correct for Formal Project Planning with Planned Snapshots?
Michael Prentice (62●2●9●13)
| asked Jun 17 '13, 7:04 p.m.
retagged Jun 18 '13, 11:53 a.m. by Amy Laird (165●1●4)
In the following two help files, there seems to be inaccurate information for RTC 4.0.1:
clmhelp/index.jsp?topic=%2Fcom.ibm.team.apt.doc%2Ftopics%2Fc_snapshots.html
"The work item dates that are saved in the Proposed and Planned snapshots are referred to as the Proposed and Planned dates for work items. The dates in the Proposed and Planned snapshots populate the Proposed and Planned start and end date columns in the Schedule Variance view of the plan. The Planned start and end dates for each work item are also displayed in the work item editor."
clmhelp/index.jsp?topic=%2Fcom.ibm.team.apt.doc%2Ftopics%2Ft_save_plan_snapshot.html
"The work item dates that are saved in the Proposed and Planned snapshots are referred to as the Proposed and Planned dates for work items. The dates in the Proposed and Planned snapshots populate the Proposed and Planned start and end date columns in the Schedule Variance view of the plan. The Planned start and end dates for each work item are also displayed in the work item editor."
As far as my team has been able to determine after almost a month of investigation, the Planned Start Date and Planned End Date values are stored only in the Plan (APT table) and not in the work items table. This means that we are unable to query against Planned Start/End Date in our project. Thus the interface and workflow of the Eclipse and VS studio client are broken and we must force our developers to browse around in the Plan views to find their work. In our case, this means that some developers have to check 4 different plans to find their work, instead of running a single query to show all of their work for the next week.
But then when checking these help topics, it claims that "The Planned start and end dates for each work item are also displayed in the work item editor." This is what we've been trying to make work for a long time! But it does not work. The help appears to be wrong unless someone out there has a solution for us?
Thank you.
|
Accepted answer
Ralph Schoon (63.1k●3●36●46)
| answered Jun 18 '13, 6:02 a.m.
FORUM ADMINISTRATOR / FORUM MODERATOR / JAZZ DEVELOPER edited Jun 18 '13, 6:23 a.m.
Michael,
for all I know, the planned start and end times as well as the proposed start and end times are, as described above, created and stored using the planned and the proposed plan snapshot. They are stored in the plan and they are only available in Plan UI's. they are especially not surfaced as a work item attribute and can therefore not be provided in queries and the like. You can get these if you export a plan. This is my current knowledge and I have tried - again - with 4.0.1 to my contentment that this is the case. *Fix to my statement*: as described below there is a non attribute based presentation "Planned Time" available that shows the planned time in the work item editor, if configured. To do so, it pulls the data from the plan snapshot. Since there is no corresponding attribute and the said presentation needs to dynamically ask the plan for the data, you can not display these derived and calculated values in Work Item Queries or in Not Plan based Dashboards as far as I can tell. Michael Prentice selected this answer as the correct answer
Comments There are numerous other posts that say this on Jazz.net e.g. some listed as related to the right
1
I was about to write a work item against documentation and I stopped doing it, because the documentation is correct.
The Documentation does not mention a requirement to do custom configuration for these Planned Times to show up in the Work Item Editor. This should be added to the documentation.
I have added Planned Time to my work item presentations and it does indeed display. This is very helpful! Thank you.
1
Ralph Schoon
commented Jun 18 '13, 10:39 a.m.
FORUM ADMINISTRATOR / FORUM MODERATOR / JAZZ DEVELOPER
Michael, please don't hesitate to create a work item in https://jazz.net/jazz/web/projects/Rational%20Team%20Concert#action=com.ibm.team.workitem.viewWelcome select documentation as filed against.
That is great information. Thank you very much. |
One other answer
Jennifer Cianchetta-Riordan (251●2)
| answered Jun 19 '13, 3:47 p.m.
FORUM MODERATOR / JAZZ DEVELOPER
Michael: I opened an enhancement for you https://jazz.net/jazz/web/projects/Rational%20Team%20Concert#action=com.ibm.team.workitem.viewWorkItem&id=269757 and will add that to the documentation.
|
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.