Manuel de KArm

Pour associer une tâche à un ou plusieurs bureaux, faites Tâche->Modifier (Ctrl+E). Activez Suivi automatique et sélectionnez le ou les bureaux à associer. Lorsqu'un de ces bureaux deviendra actif, KArm déclenchera automatiquement (après un court délai) le chronomètre correspondant à la tâche.

KArm peut être configuré pour détecter l'inactivité de vos clavier et souris. Si cela ce produit pour une durée plus longue que celle définie, KArm affiche la boîte de dialogue suivante :

---

---

Pour imprimer un rapport sur les totaux, faites Fichier->Imprimer (Ctrl+P). Ceci génère un compte rendu sur trois colonnes pour la liste complète des tâches. La première colonne contient le nom de la tâche, la seconde colonne contient la Durée totale de la session et la troisième colonne, la Durée Totale.

Pour envoyer le rapport des totaux dans le presse-papiers, faites Fichier->Copier les totaux dans le presse-papiers (Ctrl+C).

Le rapport est généré pour la tâche actuellement sélectionnée ainsi que pour toutes ses sous-tâches. S'il s'agit d'une tâche principale, KArm demandera si vous souhaitez obtenir un compte rendu pour la tâche actuelle et ses sous-tâches ou pour toute les tâches de la liste.

---

---

Une fois le rapport créé, ouvrez Kate ou n'importe quel autre éditeur de texte et collez les données.

La première colonne contient la Durée totale et elle est indentée (tout comme les noms) pour indiquer les relations entre les tâches et sous-tâches. Les durées indiquées incluent celles des sous-tâches.

Pour envoyer l'historique des totaux dans le presse-papiers, faites Fichier->Copier l'historique dans le presse-papiers (Ctrl+Alt+C).

Le rapport est crée pour la tâche actuellement sélectionnée et toutes ses sous-tâches. Contrairement au rapport sur les totaux, celui-ci ne vous donne pas la possibilité d'avoir la liste complète des tâches. Vous pouvez seulement faire un rapport sur la tâche actuelle et ses sous-tâches.

La première chose que KArm vous demande est de saisir une gamme de dates :

---

---

Après avoir saisi ces dates, ouvrez Kate ou un autre éditeur de texte et collez les données.

L'historique, groupé par semaine, inclut le total pour chaque jour et tâche. Les sept premières colonnes vont du lundi au dimanche. La huitième contient le total pour la semaine et la neuvième colonne, le nom de la tâche. Les noms sont indentés pour indiquer les relations entre les tâches et sous-tâches.

KArm, comme KOrganizer et iCal d'Apple, utilise le format industriel standard iCalendar pour ses données. KArm peut lire et écrire les listes générées par ces deux applications.

Une utilisation typique serait de planifier un projet avec l'outil de gestion de projets Planner et d'importer ses tâches dans KArm pour les avoir au format industriel standard iCalendar. Après cela, vous pourrez programmer les tâches dans KOrganizer et compté le temps passé sur celle-ci avec KArm. C'est une manière de s'assurer que votre projet sera dans les temps et ne dépassera pas le budget.

DCOP est un mécanisme utilisé par les programmes KDE pour communiquer entre eux. Un programme KDE fournit une liste de fonctions que les autres programmes (un script Bash, par exemple) peuvent utiliser.

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

L'interface DCOP de KArm et actuellement utilisée principalement pour automatiser des tests, ce qui la rend plutôt limitée. Pour une définition complète de l'interface voyez l'annexe Interface DCOP.

Pour voir l'interface DCOP complète de la version de KArm installée sur votre système, lancez le script Bash suivant :

DCOPID=`dcop | grep karm`
        if [ $DCOPID ]
        then
                dcop $DCOPID KarmDCOPIface
        else
                echo "KArm n'est pas lancé"
        fi

KArm peut exporter les totaux et l'historique dans un format de fichier dont les données sont séparées par des virgules. Pour exporter les totaux, faites Fichier->Importer / exporter->Exporter dans un fichier CSV... et KArm affiche la boîte de dialogue d'exportation suivante :

---

---

Saisissez le fichier vers lequel vous souhaitez exporter les données, et modifiez les autres options si nécessaire. Notez que la gamme de dates n'est pas disponible puisque vous exportez les totaux de durées, pas l'historique. Cliquez sur Exporter afin que KArm exporte les totaux de toutes les tâches.

Voici un exemple de sortie de ce format :

Les tâches principales se trouvent dans la première colonne, les sous-tâches dans la seconde et ainsi de suite. Les durées s'affichent après la profondeur maximale de tâches (cinq dans cet exemple). La première colonne de temps contient la Durée de la session, la seconde : la Durée, la troisième : la Durée totale de la session et la quatrième : la Durée totale.

Pour exporter l'historique de la tâche, faites Fichier->Importer / exporter->Exporter l'historique dans un fichier CSV... et KArm affiche la même boîte de dialogue d'exportation que ci-dessus.

Saisissez le fichier vers lequel vous souhaitez exporter les données, et sélectionnez une gamme de dates pour l'historique. Modifiez les autres options si nécessaire. Cliquez sur Exporter pour que KArm exporte l'historique de toutes les tâches vers le fichier que vous avez sélectionné.

Voici un exemple de sortie de ce format :

Les trois premières lignes indiquent quand le rapport a été généré et pour quelle intervalle. La quatrième ligne contient une liste de dates de la gamme séparé par des virgules, au format ISO 8601 (AAAA-MM-JJ). Les autres lignes listent les durées de chaque tâche. La dernière colonne des nombres représente le total de tous les jours. Le nom de la tâche s'affiche après le total et le nombre de colonnes indique les relations entre les tâches et sous-tâches. Les tâches principales apparaissent dans la première colonne après le total.