Core

All projects related information (core & services) are stored in project.xml.

Core information imported as of today:

  • Project metadata: unix name, full name, description, long description, and access (for more information see “Create a new project”)

  • User groups and membership (user are referenced by username or ldapId, and group name can be dynamic group names where applicable)

  • Services to be enabled. If a service is not specified, the enabled status is taken from the template project.

  • Dashboards: create dashboards with widgets. No dashboards are inherited from template starting 9.18 when import of dashboards where introduced. Following widgets can be imported:

    • projectdescription

    • projectmembers

    • projectheartbeat

    • projectlatestfilereleases

    • projectlatestnews

    • projectpublicareas

    • projectlatestsvncommits

    • projectsvnstats

    • projectrss (with ‘rss’ preference: 2 values ‘title’ and ‘url’)

    • projectimageviewer (with ‘image’ preference: 2 values ‘title’ and ‘url’)

    • projectcontacts

    • plugin_agiledashboard_projects_kanban (with ‘kanban’ preference: 1 reference ‘id’ that must refer to a kanban ‘id’)

<?xml version="1.0" encoding="UTF-8"?>
<project
    unix-name="project42"
    full-name="Project 42"
    description="Secret project to find the answer"
    access="public">

  <long-description>
      This is the long description of project 42
  </long-description>

  <ugroups>
    <ugroup name="project_members" description="">
      <members>
        <member format="username">joey_star</member>
        <member format="username">alice</member>
        <member format="username">bob</member>
      </members>
    </ugroup>
    <ugroup name="project_admins" description="">
      <members>
        <member format="username">alice</member>
        <member format="username">bob</member>
      </members>
    </ugroup>
    <ugroup name="Developers" description="">
      <members>
        <member format="username">joey_star</member>
      </members>
    </ugroup>
  </ugroups>

  <services>
    <service shortname="svn" enabled="true" />
    <service shortname="plugin_git" enabled="true" />
    <service shortname="plugin_tracker" enabled="true" />
  </services>

   <dashboards>
     <dashboard name="Dashboard">
       <line layout="two-columns-small-big">
         <column>
           <widget name="projectdescription" />
           <widget name="projectmembers" />
           <widget name="projectheartbeat" />
         </column>
         <column>
           <widget name="plugin_agiledashboard_projects_kanban">
             <preference name="kanban">
               <reference name="id" REF="K01"></reference>
               <value name="title">Todo</value>
             </preference>
           </widget>
         </column>
       </line>
     </dashboard>
     ...
   </dashboards>

  <!-- ... services ... -->

</project>

Note

Users that are suspended won’t be part of the imported project.

All services can then be configured using its own tag.