[Back] [Return to Main Page]

PrjPlanner - XML Datafile Format Description


PrjPlanner's datafile format is XML. It is simple with 5 tags.

Tag Description/Example
project Main tag. Appears only once per file. Contains only task tags and possibly one backlog tag. The project tag alone is sufficient to begin managing a project. Attributes:
  • title - The project's title
<project title="Example">
. . .
</project>
task A task. Visible as a sphere in the information radiator in the main window. Contains only todo tags or is a singleton if no ToDos associated. Attributes:
  • title - The task's description
  • completeness - Amount completed from developer
  • correctness - Amount correct from developer
  • sizeMeaning - Meaning of the task's size from developer
  • size - Size of the sphere
  • tags - Tags placed on the task by the developer. Main methodology for Task management. Unique list of all Task's tags is visible in the Tags list in the main window.
<task title="do now" completeness="50" correctness="50" sizeMeaning="Risk" size="50" tags="" >
. . .
</task>
todo A ToDo. Visible as a row in the ToDo table in the main window. Contains only history tags. Attributes:
  • title - The ToDo's description
  • assignedBy - Usually the task's owner; userids or email addresses are recommended
  • owner - The user to resolve the ToDo; userids or email addresses are recommended
  • requiredBy - Date the assigner needs the ToDo resolved
  • state - ToDo's state: Open, Resolved, Rejected
<todo title="help" assignedBy="qcrain" owner="qcrain" requiredBy="20070201-120000" state="Open" >
. . .
</todo>
history The history of updates to a ToDo. May contain character data. Attributes:
  • user - The user who updated the ToDo
  • date - When the user updated the ToDo
<history user="jdoe" date="20070110-143510" >
jane, can you help me? thanks!!
</history>
backlog Tasks to be done later; are not visible on the information radiator, but in the Backlog list in the main window. Contains only task tags.
<backlog>
. . .
</backlog>

DTD:

<!DOCTYPE project [
  <!ELEMENT project (task*|backlog?)>
    <!ATTLIST project title CDATA #REQUIRED>
  <!ELEMENT task (todo*)>
    <!ATTLIST task title CDATA #REQUIRED>
    <!ATTLIST task completeness CDATA #REQUIRED>
    <!ATTLIST task correctness CDATA #REQUIRED>
    <!ATTLIST task sizeMeaning CDATA #REQUIRED>
    <!ATTLIST task size CDATA #REQUIRED>
    <!ATTLIST task tags CDATA #REQUIRED>
    <!ELEMENT todo (history*)>
      <!ATTLIST todo title CDATA #REQUIRED>
      <!ATTLIST todo assignedBy CDATA #REQUIRED>
      <!ATTLIST todo owner CDATA #REQUIRED>
      <!ATTLIST todo requiredBy CDATA #REQUIRED>
      <!ATTLIST todo state CDATA #REQUIRED>
      <!ELEMENT history (CDATA)>
        <!ATTLIST history user CDATA #REQUIRED>
        <!ATTLIST history date CDATA #REQUIRED>
  <!ELEMENT backlog (task*)>
]>

Complete example:

<project title="Example">
    <task title="do now" completeness="50" correctness="50" sizeMeaning="Risk" size="50" tags="" >
      <todo title="help" assignedBy="qcrain" owner="qcrain" requiredBy="20070201-120000" state="Open" >
        <history user="jdoe" date="20070110-143510" >
jane, can you help me? thanks!!
        </history>
      </todo>
    </task>
    <task title="do real soon" completeness="20" correctness="20" sizeMeaning="Priority" size="11" tags="one; two" />
    <task title="do soon" completeness="0" correctness="0" sizeMeaning="None" size="20" tags="" />
  <backlog>
    <task title="do next week" completeness="0" correctness="0" sizeMeaning="None" size="20" tags="" />
    <task title="do next month" completeness="0" correctness="0" sizeMeaning="None" size="20" tags="" />
    <task title="do next year" completeness="0" correctness="0" sizeMeaning="None" size="20" tags="" />
    <task title="do next decade" completeness="0" correctness="0" sizeMeaning="None" size="20" tags="" />
    <task title="do next century" completeness="0" correctness="0" sizeMeaning="None" size="20" tags="" />
  </backlog>
</project>



SourceForge.net Logo
[Back] [Return to Main Page]