Administrator Guide

Project import

How to import existing tinyPM project?

If you want to switch from tinyPM 2.x to tinyPM 3, you can migrate your existing project using XML import feature:

  • upgrade your tinypm to 2.6.6
  • sign in to tinyPM 2.6.6, select your project, go to Backlog->Actions->Export the entire project XML, you will receive XML file as shown below
  • sign in to tinyPM 3, go to (gear icon in right upper corner) and click Import project button, upload your XML file
  • after import your project is inactive - you'll have to activate it on Projects page

Sample project XML

<project>
  <!-- project team -->
  <users>
    <user>
      <id>1</id>
      <name>Administrator</name>
      <login>admin</login>
      <email>admin@example.com</email>
    </user>
  </users>

<!-- project details --> <code>tpm</code> <name>tinyPM</name> <description>demo project</description> <!-- short date format: yyyy-MM-dd --> <startDate>2012-08-08</startDate> <targetFinishDate>2012-11-08</targetFinishDate>

<!-- project settings --> <iterationLength>10</iterationLength> <iterationNameTemplate>Iteration {0}</iterationNameTemplate> <budget>120.0</budget> <usingBudgetTracking>true</usingBudgetTracking> <usingDefaultTasks>true</usingDefaultTasks>

<defaultTasks> <template>Implement and test user story "{0}".</template> </defaultTasks> <estimates> <value>0.0</value> <value>0.5</value> <value>3.0</value> </estimates>

<taskEstimates> <value>0.0</value> <value>1.0</value> </taskEstimates>

<daysOff> <date>2012-03-05</date> <date>2012-03-12</date> </daysOff>

<!-- task statuses --> <taskStatuses> <status><name>PENDING</name></status> <status><name>IN PROGRESS</name></status> <status><name>COMPLETED</name></status> </taskStatuses>

<!-- iterations --> <iterations> <iteration> <id>1</id> <name>Iteration 1</name> <goal>Goal 1</goal> <plannedVelocity>20.0</plannedVelocity> <position>1</position> <startDate>2012-08-01</startDate> <duration>7</duration> </iteration> <iteration> <id>2</id> <name>Iteration 2</name> <goal>Goal 2</goal> <plannedVelocity>20.0</plannedVelocity> <position>2</position> <startDate>2012-08-08</startDate> <duration>7</duration> </iteration> </iterations>

<!-- releases --> <releases> <release> <id>2</id> <releaseDate>2012-08-22</releaseDate> <name>version 1.0</name> <plannedVelocity>12.5</plannedVelocity> <editable>true</editable> </release> <release> <id>1</id> <releaseDate/> <name>label.unplanned</name> <plannedVelocity/> <editable>false</editable> </release> </releases>

<!-- user stories --> <userStories> <userStory> <position>2</position> <name>Story 1</name> <description>description</description> <priority> <name>MUST_HAVE</name> </priority> <tags> <tag>old</tag> <tag>new</tag> </tags> <!-- color: WHITE, YELLOW, ORANGE, RED, GREEN, BLUE --> <color>GREEN</color> <estimatedEffort>3.0</estimatedEffort> <iteration> <id>1</id> </iteration> <release> <id>2</id> </release> <owner> <id>1</id> </owner> <acceptingUser> <id>1</id> </acceptingUser> <!-- acceptanceStatus: PENDING, ACCEPTED, REJECTED --> <acceptanceStatus>PENDING</acceptanceStatus> <!-- long date format: yyyy-MM-dd' 'HH:mm:ss.SSS --> <createdAt>2012-08-10 15:18:29.000</createdAt> <comments> <comment> <authorId>1</authorId> <author>Demo User</author> <date>2011-08-24 13:17:23.000</date> <body>This story should probably include all kinds of users?</body> </comment> </comments> <attachments> <attachment>http://your-domain/tinypm/api/attachment/1?token=t</attachment> </attachments> <tasks> <task> <name>Write decent documentation</name> <description>Request-response samples.</description> <!-- status: one of listed in taskStatuses --> <status><name>COMPLETED</name></status> <estimatedEffort>1.0</estimatedEffort> <assignedUsers> <user><id>1</id></user> </assignedUsers> <comments> <comment> <authorId>1</authorId> <author>Demo User</author> <date>2011-08-24 13:18:15.000</date> <body>We need more details...</body> </comment> </comments> <statusUpdates> <update> <date>2009-07-27 20:11:08.581</date> <status><name>PENDING</name></status> </update> <update> <date>2009-07-28 20:11:08.581</date> <status><name>IN PROGRESS</name></status> </update> <update> <date>2009-07-29 20:11:08.581</date> <status><name>COMPLETED</name></status> </update> </statusUpdates> <timeRecords> <timeRecord> <user> <id>1</id> </user> <date>2012-08-22</date> <timeSpent>22.0</timeSpent> </timeRecord> </timeRecords> <timeEstimates> <timeEstimate> <user> <id>1</id> </user> <date>2012-08-22</date> <timeLeft>12.0</timeLeft> </timeEstimate> </timeEstimates> <attachments> <attachment>http://your-domain/tinypm/api/attachment/2?token=t</attachment> </attachments> </task> </tasks> </userStory> </userStories>

</project>

Wiki import

How to import existing wiki pages?

If you want to switch from tinyPM 2.x to tinyPM 3, you can migrate your existing wiki pages using XML import feature:
  • upgrade your tinypm to 2.6.6
  • sign in to tinyPM 2.6.6, go to Wiki->Actions->Export all wiki pages, you will obtain XML file as shown below
  • sign in to tinyPM 3, go to Wiki->Import wiki

Sample XML

<wiki>
  <page>
    <code>start</code>
    <title>start</title>
    <!-- dialect: CONFLUENCE, MEDIAWIKI, TEXTILE, TRAC, DOKUWIKI -->
    <dialect>DOKUWIKI</dialect>
    <!-- special: whether page is starred or not -->
    <special>true</special>
    <project>
      <code>tpm</code>
    </project>
    <body>page text</body>
    <attachments>
      <attachment>http://your-domain/tinypm/api/attachment/1?token=t</attachment>
    </attachments>
  </page>
</wiki>