KArm, like KOrganizer and Apple's iCal, uses the industry standard iCalendar format for its data. KArm can read and write the to do lists created by these two applications.
If both KArm and KOrganizer have the same file open, if you edit the file with KOrganizer, you risk losing data. To be safe, only edit the file with one application or the other.
As a typical usecase, you might want to plan a project with the project management tool Imendio Planner (from planner.imendio.org) and import its tasks to KArm, to have them in the industry standard iCalendar format. Having done so, you are able to schedule the tasks in KOrganizer, and account your time to them in KArm. That's one way to help ensure your project stays on time and under budget.
DCOP is the mechanism KDE programs use to communicate with each other. A KDE program provides a list of functions that other programs (a Bash script, for example) can use.
Example 2.1. Bash script that echo's KArm's version
DCOPID=`dcop | grep karm` if [ $DCOPID ] then VERS=`dcop $DCOPID KarmDCOPIface version` echo "KArm version is $VERS" else echo "KArm not running" fi
KArm's current DCOP interface is currently used mainly for automated testing, so it is very limited. For the full interface definition, see DCOP Interface Appendix.
To see the full DCOP interface of the KArm version installed on your system, run the following Bash script:
KArm can export both totals and history to a comma-delimited file format. To export totals, select ->-> and KArm displays the following export dialog:
Enter the file you would like to export the data to, and modify the other dialog defaults if necessary. Note that the date range control is disabled since you are exporting time totals, not the history data. Click and KArm exports the totals for all tasks to the file you selected.
Here is an example of the output format:
"kde",,,,,0.00,0.00,6.88,9.83
,"karm",,,,6.88,8.70,6.88,9.83
,,"3.2 feature plan",,,0.00,0.00,0.00,0.00
,,"bugs",,,0.00,1.13,0.00,1.13
,,"checkin changes - translation strings",,,0.00,0.00,0.00,0.00
,,"time card report",,,0.00,0.00,0.00,0.00
,"kopete",,,,0.00,0.00,0.00,0.00
,"promo",,,,0.00,0.00,0.00,0.00
,"web stuff",,,,0.00,0.00,0.00,0.00
Top-level tasks are output in the first column, sub-tasks in the second, and so on. The time data is output after the maximum task depth (five in this example). The first time column is Session Time, the second is Time, the third is Total Session Time and the fourth is the Total Time.
To export task history, select ->-> and KArm displays the same export dialog as shown above.
Enter the file you would like to export the data to, and select a date range that you want the task history. Modify the other dialog defaults if necessary. Click and KArm exports the task history for all tasks to the file you selected.
Here is an example of the output format:
Task History
From Tuesday 06 July 2004 to Tuesday 13 July 2004
Printed on: 2004-07-13 18:10
2004-07-06,2004-07-07,2004-07-08,2004-07-09,2004-07-10,2004-07-11,2004-07-12,2004-07-13,
,,,,,,,,0.00,"kde"
,,1.77,3.23,1.73,,1.37,0.82,8.95,,"karm"
,,,,,,,,0.00,,,"3.2 feature plan"
,1.13,,,,,,,1.13,,,"bugs"
,,,,,,,,0.00,,,"checkin changes - translation strings"
,,,,,,,,0.00,,,"time card report"
,,,,,,,,0.00,,"kopete"
,,,,,,,,0.00,,"promo"
,,,,,,,,0.00,,"web stuff"
The three lines identify when the report was generated and for which date range. The fourth row is a comma-delimited list of the dates in the date range, in ISO 8601 format (YYYY-MM-DD). All subsequent rows list the time logged against each task. The last numeric column is the row total across all days. The task name prints after the total column, and is indented to indicate the task/sub-task relationship. Top level task names appear in the first column after the total.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team