O Manual do KArm

Para associar uma tarefa com um ou mais ecrãs, seleccione a opção Tarefa->Editar (Ctrl+E). Active o Registo automático e seleccione o ecrã ou ecrãs a associar com esta tarefa. Quando qualquer um dos ecrãs seleccionados ficar activo, o KArm irá começar o registo automático, ao fim de algum tempo, para esta tarefa.

O KArm pode ser configurado para detectar quando o rato e o teclado ficam inactivos. Se o rato e o teclado ficarem inactivos durante mais do que o número de minutos indicado, o KArm mostra a seguinte janela:

---

---

Para gerar o relatório dos totais para a impressora, seleccione a opção Ficheiro->Imprimir (Ctrl+P). Isto gera um relatório de três colunas com a lista completa das tarefas. A primeira coluna é o nome da tarefa, a segunda é o Tempo Total da Sessão e a terceira é o Tempo Total.

Para gerar o relatório dos totais para a área de transferência, seleccione a opção Ficheiro->Copiar os Totais para a Área de Transferência (Ctrl+C).

Este relatório é gerado para a tarefa seleccionada de momento e para todas as suas sub-tarefas. Se a tarefa for de topo, o KArm pergunta-lhe se deseja gerar o relatório para a tarefa actual e para as suas sub-tarefas ou para toda a lista de tarefas.

---

---

Logo que o relatório seja gerado, abra o KEdit ou outro editor de texto e cole os dados do relatório.

A primeira coluna é o Tempo Total e está indentado (como os nomes das tarefas) para indicar as relações de tarefas/sub-tarefas. Os tempos indicados incluem os tempos das sub-tarefas.

Para gerar os relatórios dos totais para a área de transferência, seleccione a opção Ficheiro->Copiar o Histórico para a Área de Transferência (Ctrl+Alt+C).

Este relatório é gerado para a tarefa seleccionada de momento e para as suas sub-tarefas. Ao contrário do relatório dos totais, este relatório não lhe dá a opção para relatar a lista de tarefas completas. Você só poderá fazer um relatório da tarefa actual e das suas sub-tarefas.

Quando você seleccionar o relatório do histórico, o KArm perguntar-lhe-á primeiro para indicar o intervalo de datas do relatório:

---

---

Depois de indicar um intervalo de datas, abra o KEdit ou outro editor de texto e cole os dados dos relatórios.

O histórico de tarefas é totalizado para cada dia e tarefa e agrupado por semanas. As primeiras sete colunas vão de Segunda até Domingo. A oitava coluna é o total da semana e a nona coluna é o nome da tarefa. Os nomes das tarefas estão indentados para indicar as relações de tarefas/sub-tarefas.

O KArm, como o KOrganizer e o iCal da Apple, usa a norma da indústria iCalendar para os seus dados. O KArm pode ler e gravar as listas de pendências criadas por estas duas aplicações.

Como caso de uso típico, poderá querer planear um projecto com a ferramenta de gestão de projectos Imendio Planner (from planner.imendio.org) e importar as suas tarefas para o KArm, de modo a tê-las no formato da norma da indústria iCalendar. Depois de o fazer, poderá então escalonar as tarefas no KOrganizer e contabilizar o seu tempo para elas no KArm. Esta é uma forma de controlar se o seu projecto se mantém no seu orçamento e nos seus limites de tempo.

O DCOP é o mecanismo que os programas do KDE usam para comunicar uns com os outros. Um programa do KDE oferece uma lista de funções que os outros programas (um programa da Bash, por exemplo) poderão usar.

ID_DCOP=`dcop | grep karm`
        if [ $ID_DCOP ]
        then
                VERSAO=`dcop $ID_DCOP KarmDCOPIface version`
                echo "A versão do KArm é a $VERS"
        else
                echo "O KArm não está a correr"
        fi

A interface actual de DCOP do KArm é usada principalmente de momento apenas para testes automatizados, pelo que é bastante limitada. Para a definição completa da interface, veja o Apêndice da Interface de DCOP.

Para ver a interface completa de DCOP da versão do KArm instalada no seu sistema, corra o seguinte programa em Bash:

ID_DCOP=`dcop | grep karm`
        if [ $ID_DCOP ]
        then
                dcop $ID_DCOP KarmDCOPIface
        else
                echo "O KArm não está a correr"
        fi

O KArm pode exportar tanto os totais como o histórico para um formato de ficheiro separado por vírgulas. Para exportar os totais, seleccione a opção Ficheiro->Importar/Exportar->Exportar para um ficheiro CSV... para que o KArm mostre a seguinte janela de exportação:

---

---

Indique o ficheiro para o qual desejaria exportar os dados e modifique as outras opções da janela, se necessário. Repare que o intervalo de datas está desactivado, dado que você vai exportar os tempos totais, não os dados históricos. Carregue em Exportar, para o KArm exportar os totais de todas as tarefas para o ficheiro que seleccionou.

Aqui está um exemplo do formato do resultado:

As tarefas de topo são colocadas na primeira coluna, as sub-tarefas na segunda e assim por diante. Os dados dos tempos são apresentados a seguir à profundidade de tarefas máxima (cinco, neste exemplo). A coluna do primeiro tempo é o Tempo de Sessão, a segunda é o Tempo, a terceira é o Tempo Total da Sessão e a quarta é o Tempo Total.

Para exportar o histórico de tarefas, seleccione Ficheiro->Importar/Exportar->Exportar o Histórico para um ficheiro CSV... para o KArm mostrar a mesma janela de exportação que foi apresentada acima.

Indique o nome do ficheiro para o qual deseja exportar os dados e seleccione o intervalo de datas para o qual deseja o histórico de tarefas. Modifique as outras opções da janela, se necessário e carregue em Exportar, para o KArm exportar o histórico de todas as tarefas para o ficheiro que seleccionou.

Aqui está um exemplo do formato do resultado:

As três linhas identificam quando é que o relatório foi gerado e para que intervalo de datas. A quarta linha é uma lista separada por vírgulas das datas no intervalo definido, no formato ISO 8601 (AAAA-MM-DD). Todas as linhas subsequentes indicam o tempo registado para cada tarefa. A última coluna numérica é o total da linha ao longo de todos os dias. O nome da tarefa aparece a seguir à coluna dos totais e está indentado para indicar a relação de tarefas/sub-tarefas. Os nomes das tarefas de topo aparecem na primeira coluna a seguir ao total.