Other Systems
Prev
Next

Other Systems

KOrganizer

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.

Warning

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.

Planner

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

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:

Example 2.2. List KArm's DCOP interface to console

	DCOPID=`dcop | grep karm`
	if [ $DCOPID ]
	then
		dcop $DCOPID KarmDCOPIface
	else
		echo "KArm not running"
	fi

Export Totals to CSV

KArm can export both totals and history to a comma-delimited file format. To export totals, select File->Import/Export->Export to CSV file... and KArm displays the following export dialog:


KArm CSV 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 Export 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.

Export History to CSV

To export task history, select File->Import/Export->Export History to CSV file... 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 Export 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.

Prev
Next
Home


Would you like to comment or contribute an update to this page?
Send feedback to the TDE Development Team