# O Manual do &ktimetracker;

## Introdução

O &ktimetracker; regista o tempo dispendido em várias tarefas. É útil para registar as horas para facturação e poderá apresentar as horas registadas por tarefa e por dia.

Nesta altura, o histórico poderá ser exportado como um ficheiro de texto separado por vírgulas para poder ser importado noutras ferramentas de facturação e/ou gestão de projectos.

O &ktimetracker; detecta quando o seu teclado e rato ficam inactivos e poderá associar várias tarefas com ecrãs diferentes, ou seja, duas tarefas que poderão ajudar a manter o relógio em funcionamento na tarefa correcta.

O &ktimetracker; foi criado originalmente por &Sirtaj.Singh.Kang;. A sua página pessoal está em http://userbase.kde.org/KTimeTracker.

## Utilizar o &ktimetracker;

### Iniciar o &ktimetracker;

Escreva `ktimetracker` numa linha de comandos ou seleccione a opção Registo Pessoal do Tempo do menu Utilitários do menu inicial do KDE. As opções normais da linha de comandos do &Qt; e do &kde; estão disponíveis e poderão ser listadas se escrever ``ktimetracker` `--help`` na linha de comandos.

O &ktimetracker; oferece uma opção adicional da linha de comandos que lhe permite indicar o nome do ficheiro iCalendar que é usado para guardar o seu histórico de trabalho. Poderá indicar um ficheiro iCalendar remoto se usar o 'http' ou o 'ftp' como parte do nome do ficheiro, como por exemplo http://www.exemplo.com/os_meus_dados/o_meu_trabalho.ics.

### Tarefas

Problema: Você é um consultor com vários clientes. Alguns dos clientes têm vários projectos. Ao longo do dia, você alterna entre diferentes projectos. Você precisa de registar o seu tempo para gerar facturas mensais.

Solução: Crie uma tarefa de topo para cada cliente e uma sub-tarefa para cada projecto do cliente. Para os projectos que necessitem de um registo mais detalhado, crie uma lista de sub-tarefas do projecto. Registe o tempo, fazendo duplo-click na tarefa em que está a trabalhar de momento.

O &ktimetracker; oferece uma grande flexibilidade a registar o seu tempo, permitindo quantidades e profundidades de tarefas ilimitadas. O tempo poderá ser registado para qualquer tarefa e poderá estar mais do que uma tarefa activa em qualquer altura.

O &ktimetracker; permite-lhe editar o histórico da sua tarefa e colocar um comentário para cada evento em que tenha parado.

Para criar uma tarefa de topo, seleccione &Ctrl;T Tarefa Nova Tarefa... Para criar uma sub-tarefa, seleccione a tarefa-mãe e seleccione &Ctrl;&Alt;N Tarefa Nova Sub-Tarefa... .

Quando o &ktimetracker; sair, a lista de tarefas é gravada num ficheiro do seu disco. Quando ele for iniciado a seguir, carrega de novo a lista de tarefas do mesmo ficheiro.

O &ktimetracker; poderá importar e exportar as tarefas para minimizar o seu trabalho. Veja os Outros Sistemas.

### Cronómetros

Problema: Para se manter resolúvel, você precisa de facturar uma média de cinco horas por dia. Para se manter a par, você vigia os seus totais diários e semanais.

Solução: Reinicie o temporizador da sessão no início de cada dia de trabalho e reinicie todos os temporizadores no início de cada semana.

o &ktimetracker; torna o registo do tempo simples. Para começar a registar o tempo relacionado com uma tarefa, faça duplo-click nela. Para parar o tempo do registo, volte a fazer duplo-click na tarefa. As tarefas activas mostram um pequeno relógio na coluna do Tempo de Sessão.

Outra pista visual da actividade de registo é o ícone do &ktimetracker; na bandeja do sistema. Quando uma tarefa ficar activa, o segundo ponteiro do ícone começa a mover-se. Se você deixar ficar o cursor do rato sobre este ícone, o nome da tarefa activa irá aparecer numa dica. Se estiver mais do que uma tarefa activa, os nomes das tarefas na dica ficam separados por vírgulas.

O &ktimetracker; mantém dois temporizadores por cada tarefa: um para o tempo da sessão e outro para o tempo total. Na configuração por omissão, o &ktimetracker; mostra duas colunas por cada temporizador, resultando num total de quatro colunas por cada tarefa:

Tempo da Sessão

- O tempo gasto na tarefa desde que a sessão começou.

Hora

- O tempo gasto na tarefa desde que os tempos foram reiniciados.

Tempo Total da Sessão

- O tempo gasto na tarefa, e em todas as suas sub-tarefas, desde que a sessão começou.

Tempo Acumulado

- O tempo gasto na tarefa, e em todas as suas sub-tarefas, desde que os tempos foram reiniciados.

Para iniciar uma nova sessão, escolha Ficheiro Iniciar Nova Sessão

Para iniciar todos os tempos, seleccione Ficheiro Reiniciar Todos os Tempos

#### Registo do Ecrã

Problema: Você tem dois projectos principais nos quais alterna em cada dia. Para o ajudar a organizar o seu trabalho, você mantém os seus ficheiros do projecto 1 no Ecrã 1 e os ficheiros do projecto 2 no Ecrã 2.

Solução: Associe a tarefa do projecto 1 com o Ecrã 1 e a tarefa do projecto 2 com o Ecrã 2. Quando você mudar do Ecrã 2 para o Ecrã 1, o &ktimetracker; pára automaticamente a tarefa do projecto 2 e começa a tarefa do projecto 1.

Para associar uma tarefa com um ou mais ecrãs, seleccione a opção &Ctrl;E Tarefa Editar... . 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 &ktimetracker; irá começar o registo automático, ao fim de algum tempo, para esta tarefa.

#### Detecção de Ausência de Actividade

Problema: Você sai do trabalho cedo na Sexta e esquece-se de parar o temporizador. Quando você voltar na Segunda-Feira, o relógio continuou a trabalhar.

Solução: Active a detecção de inactividade.

O &ktimetracker; 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 &ktimetracker; mostra a seguinte janela:

Detecção de Inactividade do &ktimetracker; Janela de Detecção de Inactividade do &ktimetracker;

Continuar a contagem do tempo

- Aplicar o tempo de inactividade a todos os temporizadores activos e mantêm-nos a correr.

  Você estava a trabalhar nas tarefas enquanto o seu computador estava activo e ainda continua.

Reverter a cronometragem

- Subtrai a quantidade de tempo inactivo de todos os temporizadores activos e pára-os.

  Você não estava a trabalhar nas tarefas enquanto o seu computador estava inactivo e continua a não estar.

### Outros Sistemas

#### &korganizer;

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

Pode até trabalhar de forma síncrona num ficheiro com o &korganizer; e o &ktimetracker;. Se um programa alterar o ficheiro, as actualizações serão propagadas automaticamente para a outra aplicação.

#### Planner

Como caso de uso típico, poderá querer planear um projecto com a ferramenta de gestão de projectos Imendio Planner (from live.gnome.org/Planner) e importar as suas tarefas para o &ktimetracker;, com a opção Ficheiro Importar Importar as Tarefas do Planner..., 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 &ktimetracker;. Esta é uma forma de controlar se o seu projecto se mantém no seu orçamento e nos seus limites de tempo.

#### &DBus;

O &DBus; é 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.

##### Um programa da Bash que mostra a versão do &ktimetracker;

    qdbus org.kde.ktimetracker /KTimeTracker version 2
    >/dev/null || echo "o ktimetracker não está a correr"

A interface actual de &DBus; do &ktimetracker; é 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 &DBus;.

Para ver a interface completa de &DBus; da versão do &ktimetracker; instalada no seu sistema, corra o seguinte programa em Bash:

##### Listar a interface de &DBus; do &ktimetracker; na consola

    qdbus org.kde.ktimetracker /KTimeTracker 2
    >/dev/null || echo "o ktimetracker não está a correr"

#### Exportar os Totais para CSV

O &ktimetracker; 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 Exportar Exportar os Tempos... para que o &ktimetracker; mostre a seguinte janela de exportação:

&ktimetracker; Janela de Exportação para CSV &ktimetracker; Janela de Exportação para CSV

Indique o nome do ficheiro para o qual deseja exportar os dados e modifique as outras opções da janela, se necessário. Carregue em Exportar, para o &ktimetracker; exportar o histórico de todas as tarefas para o ficheiro que seleccionou.

Use o botão Exportar para a Área de Transferência para exportar os tempos para a área de transferência

Aqui está um exemplo do formato do resultado:

    "kde",,,,,0.00,0.00,6.88,9.83
    ,"karm",,,,6.88,8.70,6.88,9.83
    ,,"plano de funcionalidades do 3.2",,,0.00,0.00,0.00,0.00
    ,,"erros",,,0.00,1.13,0.00,1.13
    ,,"enviar alterações - textos de traduções",,,0.00,0.00,0.00,0.00
    ,,"relatório da factura de tempo",,,0.00,0.00,0.00,0.00
    ,"kopete",,,,0.00,0.00,0.00,0.00
    ,"promoção",,,,0.00,0.00,0.00,0.00
    ,"coisas na Web",,,,0.00,0.00,0.00,0.00

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.

#### Exportar o Histórico para CSV

Para exportar o histórico de tarefas, seleccione Ficheiro Exportar Exportar o Histórico... para o &ktimetracker; 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 &ktimetracker; exportar o histórico de todas as tarefas para o ficheiro que seleccionou.

Use o botão Exportar para a Área de Transferência para exportar o histórico para a área de transferência.

Aqui está um exemplo do formato do resultado:

    Histórico de Tarefas
    De Terça 06 de Julho de 2004 até Terça 13 de Julho de 2004
    Impresso a: 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,,,"plano de funcionalidades do 3.2"
    ,1.13,,,,,,,1.13,,,"erros"
    ,,,,,,,,0.00,,,"enviar alterações - textos de traduções"
    ,,,,,,,,0.00,,,"relatório da factura de tempo"
    ,,,,,,,,0.00,,"kopete"
    ,,,,,,,,0.00,,"promoção"
    ,,,,,,,,0.00,,"coisas na Web"

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.

## A interface do &ktimetracker;

A janela principal do &ktimetracker; tem as seguintes componentes: o menu, a barra de ferramentas, a barra de pesquisa, a janela de tarefas/tempos e a barra de estado.

A barra de pesquisa é um campo combinado. Enquanto não carregar em &Enter;, funciona como um filtro. A partir daí, só as tarefas que corresponderem aos dados introduzidos por si é que aparecem. Assim que carregar no &Enter;, os seus dados introduzidos são usados como o nome para criar uma nova tarefa.

Escolha a Configuração para o PDA na janela de configuração se tiver um ecrã por toque e se o espaço livre no mesmo for precioso. Irá desactivar a barra de pesquisa e, sempre que carregar no ecrã, irá despoletar um menu de contexto.

Ecrã do &ktimetracker; Ecrã do &ktimetracker;

### A janela das Tarefas/Tempos

As várias tarefas são apresentadas nesta janela, em conjunto com o tempo acumulado para cada uma na sessão actual e no tal. As tarefas que estiverem a ser temporizadas têm um pequeno ícone de relógio ao lado do tempo de sessão.

Podem ser criadas sub-tarefas para cada tarefa. Se carregar no sinal de mais/menos ao lado da tarefa principal, activa ou desactiva a visualização das suas sub-tarefas associadas. O tempo total atingido para uma dada tarefa inclui os tempos das suas sub-tarefas, assim como o seu tempo acumulado.

### A Barra de Estado e de Ferramentas

A barra de ferramentas contém ícones para os seguintes comandos:

Todos se comportam de forma idêntica ao comando respectivo no menu.

- Nova Tarefa

- Nova Sub-Tarefa

- Iniciar

- Parar

- Apagar

- Editar

- Abrir

- Gravar

A barra de estado devolve o nome do ficheiro em que foram guardados os dados.

## Créditos e Licença

&ktimetracker;

Copyright do programa:

- 1997-2000 &Sirtaj.Singh.Kang; &Sirtaj.Singh.Kang.mail;.

- 2001-2002 Tomas Pospisek tpo_deb@sourcepole.ch

- 2003-2004 Mark Bucciarelli mark@hubcapconsulting.com

Contributos (em ordem alfabética)

- Allen Winter winter@kde.org

- &David.Faure; &David.Faure.mail;

- &Espen.Sand; espen@kde.org

- Gioele Barabucci gioele@gioelebarabucci.com

- Jan Schaumann jschauma@netmeister.org

- &Jesper.Pedersen; blackie@ifad.dk

- Kalle Dalheimer &Matthias.Kalle.Dalheimer.mail;

- Klarälvdalens Datakonsult AB

- Mark Bucciarelli mark@hubcapconsulting.com

- Thorsten Stärk dev@staerk.de

- Tomas Pospisek tpo_deb@sourcepole.ch

- Willi Richert w.richert@cox.net

O &ktimetracker; foi inspirado pelo utilitário criado pelo Harald Tveit Alvestrand que era o titrax, em que o único problema dele era ser baseado na plataforma do Xt.

Documentação com 'copyright' 2000-2004 de &Jonathan.Singer; &Jonathan.Singer.mail; e &Sirtaj.Singh.Kang; &Sirtaj.Singh.Kang.mail;.

Tradução de José Nuno Pires zepires@gmail.com

&underFDL; &underGPL;

## Glossário

## A

tarefa activa

Uma tarefa com um cronómetro a correr.

## D

&DBus;

O protocolo de comunicação entre processos usado no &kde;. É uma abreviatura de Desktop Bus.

ecrã

O &GNU;/&Linux;, o FreeBSD e os outros sistemas que correm o X-Windows têm vários ecrãs virtuais. Você tem, tipicamente, quatro ecrãs diferentes instalados por omissão. Cada ecrã poderá mostrar o seu conjunto próprio de programas e ficheiros. Quando o &kde; arranca pela primeira vez, o ecrã que você vê é o Ecrã 1. Se carregar em &Ctrl;F2, irá ver o Ecrã 2. Se carregar em &Ctrl;F1 irá voltar ao Ecrã 1.

## H

histórico

Se o &ktimetracker; estiver configurado para registar o histórico, ele irá guardar todos os eventos de arranque/paragem dos temporizadores. Este histórico nunca é limpo quando os tempos são reiniciados e continua no ficheiro até que a tarefa seja removida.

## S

sessão

Um ponto de referência definido pelo utilizador para os temporizadores de sessão. É iniciada uma nova sessão quando você seleccionar a opção Ficheiro Iniciar Nova Sessão . Os dados da sessão não são gravados quando você criar uma nova.

Tempo da Sessão

O tempo gasto na tarefa desde que a sessão começou.

bandeja do sistema

A bandeja do sistema é a barra que aparece (por omissão) no fundo do ecrã. Nesta bandeja do sistema , o ícone do &ktimetracker; está mais à direita.

## T

tarefa de topo

Uma tarefa sem tarefa-mãe.

Tempo Total da Sessão

O tempo gasto na tarefa, e em todas as suas sub-tarefas, desde que a sessão começou.

Hora

O tempo gasto na tarefa desde que os tempos foram reiniciados.

Tempo Acumulado

O tempo gasto na tarefa, e em todas as suas sub-tarefas, desde que os tempos foram reiniciados.

## Instalação

### Como obter o &ktimetracker;

&install.intro.documentation; &install.compile.documentation;

## A Interface de &DBus;

version

version

Devolve a versão do &ktimetracker;.

    QString version()

#### Descrição

O `version()` é uma chamada de &DBus; que devolve o número de versão do &ktimetracker;, como por exemplo 4.3.1. O número de versão é devolvido como um texto no formato típico da &GNU; maior.menor.correcção.

quit

quit

Sai do &ktimetracker;.

    QString quit()

#### Descrição

O `quit()` é uma chamada de &DBus; que oferece a possibilidade a um programa externo de fazer o &ktimetracker; sair em segurança.

addTask

addTask

Adiciona uma nova tarefa.

    QString addTask(QString nomeTarefa)

#### Parâmetros

`nomeTarefa`

- O nome da nova tarefa.

#### Descrição

O `addTask(QString nomeTarefa)` é uma chamada de &DBus; que adiciona um item por-fazer de topo novo ao ficheiro actual. É devolvido o UID da nova tarefa.

&documentation.index;