home *** CD-ROM | disk | FTP | other *** search
/ DOS/V Power Report 2004 March / VPR0403.ISO / talks / 036 / paper.dkb < prev    next >
Encoding:
Extensible Markup Language  |  2003-09-18  |  16.4 KB  |  378 lines
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2.  
  3. <article id="paper">
  4. <articleinfo>
  5.   <title>PHProjekt - an open source groupware suite</title>
  6.   <author>
  7.     <firstname>Albrecht</firstname>
  8.     <surname>Guenther</surname>
  9.   </author>
  10. </articleinfo>
  11.  
  12. <section>
  13.   <title>
  14.     Introduction
  15.   </title>
  16.   <para>
  17.     PHProjekt is one of the most popular web-based groupware suites on the internet. This talk 
  18.     will explain how teams and organisations as well as small or medium sized companies 
  19.     can take advantage of this open source tool for their daily work.
  20.     To understand the entire functionality of the application here is a short tutorial on the 
  21.     project management part:
  22.   </para>
  23. </section>
  24.  
  25. <section>
  26.   <title>
  27.      Project management with PHProjekt
  28.   </title>
  29.   <para>
  30.     Preliminary remarks:
  31.     You have to be aware that with PHProjekt only users with chief status can start a new 
  32.     project tree. This fact often confuses system administrators who install this application 
  33.     for the first time. They login in as root (root serves as a super administrator between 
  34.     groups) and wonder why they cannot find the button 'new project'. The reason is simple: 
  35.     PHProjekt is a business application and the status of an administrator within a group is to 
  36.     administer the group for technical problems but not to interfere with daily business.
  37.   </para>
  38.  
  39.   <section>
  40.     <title>
  41.       GETTING STARTED
  42.     </title>
  43.     <para>
  44.       At first you have to go into the module 'projects' and click the button 'new'. You will get to 
  45.       the default form to view and modify project properties. Only very few elements of a project 
  46.       are required to fill in: the name of the project and the start and end dates. Please enter the 
  47.       two dates in the ISO form - yyyy-mm-dd, each other format will be complained about. 
  48.       Attention: the start and end date of a subproject must not exceed the respective values of 
  49.       the parent project. Doing so will result in an error message of the script.
  50.     </para>
  51.     <para>
  52.       The category represents the status of a project - offered, working, closed etc. Besides 
  53.       filtering the project list with a category it has an impact on the following functions:
  54.     </para>
  55.       <itemizedlist>
  56.         <listitem><para>
  57.           Users are able to book work time on projects only if they have the category 'working'
  58.         </para></listitem>
  59.         <listitem><para>
  60.           Current Projects with the category 'working' appear on the summary page.
  61.         </para></listitem>
  62.       </itemizedlist>
  63.     <para>
  64.       Once there are other subprojects in your level you are able to set:
  65.     </para>
  66.       <itemizedlist>
  67.         <listitem><para>
  68.       a record which will show up above or below this record in the list view (applies 
  69.           only to the gantt chart) and
  70.         </para></listitem>
  71.         <listitem><para>
  72.       dependencies to other projects which apply to the category of this     project 
  73.           (see below in section 'dependencies').
  74.         </para></listitem>
  75.       </itemizedlist>
  76.     <para>
  77.       You can assign a contact from the contact manager of your group to this project (i.e. as 
  78.       the customer) and appoint a user from your group as the project leader for this project. 
  79.       The project leader is the only person who can define the status of the project (given as the 
  80.       progress in %) and is able to create new subprojects below his own project.
  81.     </para>
  82.     <para>
  83.       For an explanation of the fields budget and the hourly  rate please read section 'budget' 
  84.       below.   
  85.       The priority rating only works as a sorting element in the list view and does not have any 
  86.       further impact, as well as the fields 'aim' and 'remark'. 
  87.     </para>
  88.     <para>
  89.       Finally you can assign participants to this project by selecting the users concerned in the 
  90.       multiple select box (select several entries while holding down the ctrl-key). Participants are 
  91.       able to:
  92.     </para>
  93.       <itemizedlist>
  94.         <listitem><para>
  95.           write work time on this project
  96.         </para></listitem>
  97.         <listitem><para>
  98.           assign objects from other modules to this project
  99.         </para></listitem>
  100.         <listitem><para>
  101.           view this project on the summary page
  102.         </para></listitem>
  103.       </itemizedlist>
  104.     <para>
  105.       As action buttons in this form you have:
  106.     </para>
  107.       <itemizedlist>
  108.         <listitem><para>
  109.           'new' to create the database record or to 'modify' an existing record, 
  110.         </para></listitem>
  111.         <listitem><para>
  112.           'back' which brings you back to list view, 
  113.         </para></listitem>
  114.         <listitem><para>
  115.           'new subproject' to create a new project which adopts the values of the former record 
  116.            and takes this as the parent object, 
  117.         </para></listitem>
  118.         <listitem><para>
  119.           'print' to show a print view of all project details, 
  120.         </para></listitem>
  121.         <listitem><para>
  122.           'delete' only shows up if there is no subproject assigned to this project. So if you want to 
  123.            delete a complete project branch you have to begin from the bottom. 
  124.         </para></listitem>
  125.       </itemizedlist>
  126.   </section>
  127.   <section>
  128.   <title>
  129.     THE LIST VIEW
  130.   </title>   
  131.   <para>
  132.     Once you have created several projects with their sub projects the list view gives you a 
  133.     good overview about the activities of your group. As a normal user you only see a part of 
  134.     the information. The budget, hourly rate and the amount of already booked amounts 
  135.     doesn't show up.
  136.   </para>
  137.   <para>
  138.     As in all other modules of PHProjekt there is a navigation bar for this list view with the 
  139.     following elements:
  140.   </para>
  141.     <itemizedlist>
  142.       <listitem><para>
  143.         the name of the module. To reach the online help you have to click on it.
  144.       </para></listitem>
  145.       <listitem><para>
  146.         a filter mode to limit the number of records shown. You can enter a keyword and select 
  147.         the field where this keyword should match.
  148.       </para></listitem>
  149.       <listitem><para>
  150.         Additionally you can limit the search to a certain category of projects
  151.         Please remark: once you have set a filter the tree view is removed and all projects 
  152.         regardless their position in a project tree appear.
  153.       </para></listitem>
  154.       <listitem><para>
  155.         With the radio buttons 'open' and close' you can decide whether you want to see the 
  156.         whole project tree or just the root projects.
  157.       </para></listitem>
  158.       <listitem><para>
  159.         In the select box 'x elements/page' you can select how many records per page are 
  160.         shown. If there are more than x records to be displayed, a link 'next page' will appear in the 
  161.         second line of the navigation bar (and of course a link 'previous page' if you turn to the 
  162.         next page)
  163.       </para></listitem>
  164.       <listitem><para>
  165.         The last checkbox 'sum' will sum up the values of 'budget' and 'already booked' of this 
  166.         project and all subprojects.
  167.       </para></listitem>
  168.     </itemizedlist>
  169.    <para>
  170.      Like in all other modules one click on the header of a column will sort the list according to 
  171.      this field - alternating ascending and descending. One click on the name of the project or a 
  172.      double click somewhere in the row brings you to the detailed view of a record. If you are 
  173.      not entitled to modify a record all fields will be greyed out.   
  174.    </para>
  175.   </section>
  176.   <section>
  177.     <title>
  178.       THE GANTT DIAGRAM
  179.     </title>
  180.     <para>
  181.       For those of you who are not familiar with a gantt diagram: this kind of business chart is a 
  182.       kind of calendar based grid and shows all projects from start to end on a timeline. With a 
  183.       gantt diagram you get an overview which projects are active at what time.
  184.       You can create such a gantt diagram with a click on the link 'Gantt' in the navigation bar.
  185.       By default the given timeframe is set by the start date of the earliest project and the end of 
  186.       the latest project. If you want to do a manual timeframe selection you have to select the 
  187.       radio button on the left side in the first line and select a month and year for the start and 
  188.       end date. 
  189.     </para>
  190.     <para>
  191.       Further options are:
  192.     </para>
  193.       <itemizedlist>
  194.         <listitem><para>
  195.           If you just limit the view to a branch of a project select the mentioned record in the select 
  196.           box of the second row of the navigation bar.
  197.         </para></listitem>
  198.         <listitem><para>
  199.           To simply view the root projects click on the checkbox 'only root projects' next to the 
  200.           select box.
  201.         </para></listitem>
  202.       </itemizedlist>
  203.     <para>
  204.       Each colour of a bar reflects the status of a project, a legend for the colours is given below 
  205.       the chart.    
  206.     </para>
  207.   </section>
  208.   <section>
  209.     <title>
  210.       RELATED OBJECTS
  211.     </title>
  212.     <para>
  213.       One of the advantages of PHProjekt is the tight interaction of the different modules. Many 
  214.       elements of other modules can be related to a project:
  215.     </para>
  216.       <itemizedlist>
  217.         <listitem><para>
  218.           contacts
  219.         </para></listitem>
  220.         <listitem><para>
  221.           notes
  222.         </para></listitem>
  223.         <listitem><para>
  224.           todos
  225.         </para></listitem>
  226.         <listitem><para>
  227.           files 
  228.         </para></listitem>
  229.         <listitem><para>
  230.           events of the calendar
  231.         </para></listitem>
  232.         <listitem><para>
  233.           timecard entries
  234.         </para></listitem>
  235.         <listitem><para>
  236.           helpdesk requests
  237.         </para></listitem>
  238.       </itemizedlist>
  239.     <para>
  240.       Of course this is only possible if these modules are acitvated in your installation.
  241.       All related items will be listed below the detailed view of a project and are linked to the 
  242.       specific record. 
  243.     </para>
  244.   </section>
  245.   <section>
  246.     <title>
  247.       DEPENDENCIES
  248.     </title>
  249.     <para>
  250.       Related on other subprojects on this level you can set dependencies. There are four types 
  251.       of rules given:
  252.     </para>
  253.       <itemizedlist>
  254.         <listitem><para>
  255.           This project cannot start before the other project ends.
  256.         </para></listitem>
  257.         <listitem><para>
  258.           This project cannot start before the other project starts.
  259.         </para></listitem>
  260.         <listitem><para>
  261.           This project cannot end before the other project ends.
  262.         </para></listitem>
  263.         <listitem><para>
  264.           This project cannot end before the other project starts.
  265.         </para></listitem>
  266.       </itemizedlist>
  267.     <para>
  268.       Setting such a dependency has the following impacts which will be checked immediately 
  269.       when the modified record will be stored in the database:
  270.     </para>
  271.       <itemizedlist>
  272.         <listitem><para>
  273.           date level: If the start and end date of the concerned projects break the given rule a 
  274.           warning message will be shown and the record will be stored.
  275.         </para></listitem>
  276.         <listitem><para>
  277.           category level: if the current categories of the two projects concerned break the given 
  278.           rule a warning message will be shown and the modifications will NOT be stored. The 'start' 
  279.           mode comprises the following categories: offered, ordered and waiting, the 'end' refers to 
  280.           the categories 'ended' and 'stopped'.   
  281.         </para></listitem>
  282.       </itemizedlist>
  283.     <para>
  284.       Attention: once you select another parent object for this record, all dependencies will be 
  285.       deleted since the dependency has been valid only for a given branch. 
  286.     </para>
  287.   </section>
  288.   <section>
  289.     <title>
  290.       WORKING WITH THE TIMECARD
  291.     </title>
  292.     <para>
  293.       One powerful feature of the project management module is the ability to analyze the 
  294.       booked work time of the timecard module. Please make sure that this feature is enabled in 
  295.       your installation (see the installation FAQ on the homepage).
  296.       You can decide whether the timecard as such has to be filled out by the users or not, both 
  297.       modes are possible. The latter option is interesting for teams where the time sheet will be 
  298.       controlled by another system or not at all.
  299.       A user can assign work time to a project when the following conditions are fullfilled:
  300.     </para>
  301.       <itemizedlist>
  302.         <listitem><para>
  303.           the start and end date of a project have to include the given day
  304.         </para></listitem>
  305.         <listitem><para>
  306.           the project must be active
  307.         </para></listitem>
  308.         <listitem><para>
  309.           the user has to be a participant of this project
  310.         </para></listitem>
  311.       </itemizedlist>
  312.     <para>
  313.       All projects which fullfill these conditions will appear on the left side in the timecard and 
  314.       the user can freely assign any amount of time to a project. A field on the end of the project 
  315.       list indicates whether the sum of booked time exceeds the work time on this day or 
  316.       whether there is still some time unassigned. For each record the user can enter a short 
  317.       notice about the work time or task he has done. 
  318.       The work time assigned to projects is the base for the analysis done in the statistics, see 
  319.       below.
  320.     </para>
  321.   </section>
  322.   <section>
  323.     <title>
  324.       THE STATISTICS
  325.     </title>
  326.     <para>
  327.       While the general statistic is only visible to users with chief status, each user has the 
  328.       option to review its 'own statistics'.
  329.       The general statistic shows the booked work for selected users and selected projects over 
  330.       a given period. The usage is simple: Insert the start and end date of your period and select 
  331.       the projects as well as the users to be shown. Users with chief status are able to select 
  332.       'all' projects and users while project leaders can only view "their" projects. The result will be a 
  333.       matrix with the sum of all bookings within the chosen timeframe. At the end of each row 
  334.       and column the values will be summed up. If you want to view the single bookings as well 
  335.       or even the comments by the users you have to click on the checkboxes 'bookings' and 
  336.       'comments' on the form page. If you return to this form page you will see that your 
  337.       selection of projects and users have been stored.
  338.       The matrix can be exported into several formats like csv, xls, rtf, doc, xml, pdf, print and 
  339.       html.
  340.     </para>
  341.     <para>     
  342.       Please note that the general statistics is limited to projects which are located in this group. 
  343.       In contrast to this the 'my statistics' shows all projects where the user is a participant, 
  344.       independent from the group. Thus the user can view his project statistics in all groups for 
  345.       his full work time.
  346.     </para>
  347.   </section>
  348.   <section>
  349.     <title>
  350.       THE BUDGET
  351.     </title>
  352.     <para> 
  353.       The budget represents the amount of money which is planned to be spent for this project.
  354.       If the budget is set into relation to the booked work time it will give an information whether 
  355.       the advancement of this project is in a good shape or not. The formula is given as: 
  356.       budget[$]*progress[%] - spent_hours[h]*hourly rate[$/h]
  357.       If this value is below zero then you have to spend more time on the project than you have 
  358.       calculated. In this case the values in the last field in the list view will turn red.
  359.       Attention: At the moment it is only possible to have one general rate for the whole 
  360.       subproject. In the future there will be the option to take the default hourly rate of a user or 
  361.       to assign an hourly rate for each todo related to this project.
  362.     </para>
  363.   </section>
  364.   <section>
  365.     <title>
  366.       FUTURE PLANS
  367.     </title>
  368.     <para>
  369.       There are several features on the todo list which are waiting to be implemented. Probably 
  370.       one interesting feature is the introduction of resource management which enables a 
  371.       project leader to assign the work time of his colleagues into several projects, monitor any 
  372.       upcoming bottlenecks and to make up the balance of the booked time versus the planned 
  373.       time in a project. 
  374.     </para>
  375.   </section>
  376. </section>
  377. </article>
  378.