# Manual do &ktimetracker;

## Introdução

O &ktimetracker; registra o tempo dispendido em várias tarefas. É útil para registrar as horas para faturação e poderá apresentar as horas registradas por tarefa e por dia.

Nesta altura, o histórico poderá ser exportado como um arquivo de texto separado por vírgulas para poder ser importado em outras ferramentas de faturação e/ou gerenciamento de projetos.

O &ktimetracker; detecta quando o seu teclado e mouse ficam inativos e poderá associar várias tarefas com áreas de trabalho diferentes, ou seja, duas ferramentas que poderão ajudar a manter o relógio em funcionamento na tarefa correta.

O &ktimetracker; foi escrito originalmente por &Sirtaj.Singh.Kang;. Seu site é https://userbase.kde.org/KTimeTracker.

## Usando o &ktimetracker;

### Iniciando o &ktimetracker;

Digite `ktimetracker` numa linha de comando ou selecione a opção Registro pessoal do tempo do menu Utilitários do Lançador de aplicativos do Plasma. As opções genéricas da linha de comando do &Qt; e do &kf5-full; estão disponíveis, veja as páginas de manual qt5options and kf5options.

O &ktimetracker; oferece uma opção adicional da linha de comando que lhe permite indicar o nome do arquivo iCalendar que é usado para guardar o seu histórico de trabalho. Você poderá indicar um arquivo iCalendar remoto se usar o '&HTTP; ou o &FTP; como parte do nome do arquivo, como por exemplo https://www.exemplo.com/meus_dados/meu_trabalho.ics.

### Tarefas

Problema: Você é um consultor de software independente com muitos clientes, sendo que alguns deles possuem vários projetos. Ao longo do dia você alterna entre diferentes projetos. Você precisa controlar o seu tempo para gerar faturas mensais.

Solução: Crie uma tarefa de topo para cada cliente e uma subtarefa para cada projeto do cliente. Para os projetos que necessitem de um registro mais detalhado, crie uma lista de subtarefas do projeto. Registre o tempo com um clique duplo na tarefa em que está trabalhando no momento.

O &ktimetracker; oferece uma grande flexibilidade ao registrar o seu tempo, permitindo quantidades e profundidades de tarefas ilimitadas. O tempo poderá ser registrado para qualquer tarefa e poderá existir mais de uma tarefa ativa a qualquer momento.

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, selecione &Ctrl;T Tarefa Nova tarefa... Para criar uma subtarefa, destaque a tarefa-mãe e selecione &Ctrl;B Tarefa Nova subtarefa... .

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

O &ktimetracker; pode importar e exportar as tarefas para minimizar o seu trabalho. Veja interfaces.

### Cronômetros

Problema: Para se manter rentável, você precisa faturar uma média de cinco horas por dia. Para manter a o controle, 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 registro do tempo simples. Para começar a registrar o tempo relacionado com uma tarefa, faça um duplo-clique nela. Para parar o tempo do registro, volte a fazer duplo-clique na tarefa. As tarefas ativas mostram um pequeno relógio na coluna do Tempo de Sessão.

Outra pista visual da atividade de registro é o ícone do &ktimetracker; na área de notificação. Quando uma tarefa ficar ativa, o segundo ponteiro do ícone começa a mover-se. Se você deixar ficar o cursor do mouse sobre este ícone, o nome da tarefa ativa irá aparecer numa dica. Se mais de uma tarefa estiver ativa, os nomes das tarefas na dica ficam separados por vírgulas.

O &ktimetracker; mantém dois temporizadores para cada tarefa: um para o tempo da sessão e outro para o tempo total. Na configuração padrão, o &ktimetracker; mostra duas colunas para 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.

Tempo

- 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 subtarefas, desde que a sessão começou.

Tempo Acumulado

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

Para iniciar uma nova sessão, selecione Arquivo Iniciar Nova Sessão

Para reiniciar todos os tempos, selecione Arquivo Reiniciar Todos os Tempos

#### Registro da Área de Trabalho

Problema: Você possui dois projetos principais nos quais alterna em cada dia. Para ajudá-lo a organizar o seu trabalho, você mantém os seus arquivos do projeto 1 na Área de Trabalho 1 e os arquivos do projeto 2 no Área de Trabalho 2.

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

Para associar uma tarefa com uma ou mais áreas de trabalho, selecione a opção &Ctrl;E Tarefa Propriedades . Ative o Registro automático e selecione a área ou áreas de trabalho a associar com esta tarefa. Quando qualquer uma das áreas de trabalho selecionadas ficar ativa, o &ktimetracker; irá automaticamente começar o registro para esta tarefa.

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

Problema: Você sai do trabalho cedo na sexta-feira e se esquece de parar o temporizador. Quando você voltar na segunda-feira, o relógio ainda está trabalhando.

Solução: Ative a detecção de inatividade na página Comportamento da caixa de diálogo de configuração.

O &ktimetracker; pode ser configurado para detectar quando o mouse e o teclado ficam inativos. Se o mouse e o teclado ficarem inativos durante mais do que o número de minutos indicado, o &ktimetracker; mostra a seguinte janela:

Detecção de inatividade do &ktimetracker; Diálogo de detecção de inatividade do &ktimetracker;

Continuar a cronometragem

- Aplicar o tempo de inatividade a todos os temporizadores ativos e mantêm-os rodando.

  Você estava trabalhando nas tarefas enquanto o seu computador estava ativo e ainda continua.

Reverter a cronometragem

- Subtrai a quantidade de tempo inativo de todos os temporizadores ativos e interrompe-os.

  Você não estava trabalhando na(s) tarefa(s) enquanto o seu computador estava inativo e você continua a não estar.

### Outros Sistemas

#### &korganizer;

O &ktimetracker;, como o &korganizer; e o iCal da Apple, usa o padrão da indústria iCalendar para os seus dados. O &ktimetracker; pode ler e gravar as listas de tarefas criadas por estes dois aplicativos.

Você pode até mesmo trabalhar de maneira sincronizada em um arquivo com o &korganizer; e o &ktimetracker;. Se um programa mudar o arquivo, as atualizações serão propagadas para o outro aplicativo automaticamente.

#### Planner

Como caso de uso típico, você poderá querer planejar um projeto com a ferramenta de gerenciamento de projetos &Planner; e importar as suas tarefas para o &ktimetracker;, com a opçãoArquivo Importar Importar as Tarefas do Planner..., de modo a tê-las no formato da norma da indústria iCalendar. Depois de fazer isso, você poderá então agendar as tarefas no &korganizer; e contabilizar o seu tempo para elas no &ktimetracker;. Esta é uma forma de controlar se o seu projeto se mantém no seu orçamento e nos seus limites de tempo.

#### &DBus;

O &ktimetracker; suporta vários métodos que podem ser usados com &DBus;.

Existem duas formas de usar a interface do &DBus;: &GUI; do &Qt; qdbusviewer e a linha de comando qdbus.

##### Script de linha de comando que mostra a versão do &ktimetracker;

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

A interface atual &DBus; do &ktimetracker; é usada principalmente para testes automatizados, sendo assim bastante limitada. Para a definição completa da interface, veja o dbusappendix.

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

##### Listar a interface &DBus; do &ktimetracker; no console

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

#### Exportar os Totais para CSV

O &ktimetracker; pode exportar tanto os totais como o histórico para um formato de arquivo separado por vírgulas. Para exportar os totais, selecione Arquivo Exportar... e o &ktimetracker; mostra a janela de exportação.

Selecione a opção Tempos como CSV no grupo Tipo de relatório. A janela terá a seguinte aparência:

Exportar tempos como CSV Exportar tempos como CSV

Modifique as outras opções da janela, se for necessário. Você pode pré-visualizar a saída CSV no lado direito da janela. Clique em Salvar como... e o &ktimetracker; exporta os totais de todas as tarefas para o arquivoinserido em na janela de arquivo.

Use o botão Copiar para a área de transferência para exportar os tempos para a área de transferência

Aqui está um outro exemplo do formato do resultado:

    "kde",,,,,0.00,0.00,6.88,9.83
    ,"ktimetracker",,,,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 fatura 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 subtarefas 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, selecione Arquivo Exportar Exportar... para o &ktimetracker; mostrar a mesma janela de exportação que foi apresentada acima. Selecione a opção Histórico como CSV no grupo Tipo de relatório.

Selecione um intervalo de datas que você quer que o histórico de tarefas cubra. Modifique as outras opções da janela, se for necessário. Você pode pré-visualizar a saída CSV no lado direito da janela. Clique em Salvar como... e o &ktimetracker; exporta os totais de todas as tarefas para o arquivoinserido em na janela de arquivo.

Use o botão Copiar para a área de transferência para exportar os tempos 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,,"ktimetracker"
    ,,,,,,,,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 fatura de tempo"
    ,,,,,,,,0.00,,"kopete"
    ,,,,,,,,0.00,,"promoção"
    ,,,,,,,,0.00,,"coisas na Web"

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

## A interface do &ktimetracker;

A janela principal do &ktimetracker; possui os seguintes componentes: o menu, a barra de ferramentas, barra de pesquisa, a janela de tarefas/tempos e a barra de status.

A barra de pesquisa é um campo combinado. Se você não pressionar &Enter;, ela funcionará como um filtro. Então, somente as tarefas que correspondem a sua entrada serão exibidas. Assim que pressionar &Enter;, sua entrada é usada como nome para criar uma nova tarefa.

Selecione Configuração por PDA na página Aparência da caixa de diálogo de configurações se você possui uma tela sensível ao toque e o estado real de sua tela é importante. Isto irá desativar a barra de pesquisa e cada clique exibirá um menu de contexto.

Tela do &ktimetracker; Tela do &ktimetracker;

### A janela das Tarefas/Tempos

As várias tarefas são apresentadas nesta janela, juntamente com o tempo acumulado para cada uma na sessão atual e no total. As tarefas que estiverem para ser temporizadas possuem um pequeno ícone de relógio ao lado do tempo de sessão.

Podem ser criadas subtarefas para cada tarefa. Clicar no sinal de mais/menos ao lado da tarefa principal, ativa ou desativa a visualização das suas subtarefas associadas. O tempo total atingido para uma determinada tarefa inclui os tempos das suas subtarefas, 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 subtarefa

- Iniciar

- Parar

- Excluir

- Editar

- Abrir

- Salvar

A barra de estado reporta o nome do arquivo em que foram guardados os dados.

## Créditos e licença

&ktimetracker;

Direitos autorais 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

- 2004-2011 Thorsten Stärk dev@staerk.de

- 2019 Alexander Potashev aspotashev@gmail.com

Contribuidores (em ordem alfabética)

- Alexander Potashev aspotashev@gmail.com

- 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 por Harald Tveit Alvestrand que era o titrax, sendo o único problema dele o fato de 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 Marcus Gama marcus.gama@gmail.com

&underFDL; &underGPL;

## Glossário

## A

tarefa ativa

Uma tarefa com um cronômetro rodando.

## D

&DBus;

Um protocolo de comunicação entre processos. É uma abreviatura de Desktop Bus.

área de trabalho

O &GNU;/&Linux;, o FreeBSD e os outros sistemas que rodam o servidor X.Org possuem várias áreas de trabalho virtuais. Você possui, tipicamente, quatro áreas de trabalho diferentes instalados por padrão. Cada área poderá mostrar o seu conjunto próprio de programas e arquivos. Quando o &kde; &plasma; inicializa pela primeira vez, a área de trabalho que você vê é a de número 1. Clicando em &Ctrl;F2, você verá a Área de trabalho 2. Clicar em &Ctrl;F1 irá voltar à Área de trabalho 1.

## H

histórico

Se o &ktimetracker; estiver configurado para registrar o histórico, ele irá guardar todos os eventos de início/parada dos temporizadores. Este histórico nunca é apagado quando os tempos são reiniciados e continua no arquivo até que a tarefa seja excluída.

## S

sessão

Um ponto de referência definido pelo usuário para os temporizadores de sessão. É iniciada uma nova sessão quando você selecionar a opção Arquivo Iniciar Nova Sessão . Os dados da sessão não são salvos quando você cria uma nova.

Tempo da Sessão

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

área de notificação

A área de notificação é a barra que aparece (por padrão no &kde; &plasma;) na base do tela. Nesta área de notificação , 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 subtarefas, desde que a sessão começou.

Tempo

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

Tempo Acumulado

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

## Interface &DBus;

version

version

Retorna 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.correção.

quit

quit

Sair do &ktimetracker;'.

    QString quit()

#### Descrição

O `quit()` é uma chamada de &DBus; que oferece a possibilidade a um programa externo fazer com que o &ktimetracker; termine 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 arquivo atual. É devolvido o UID da nova tarefa.

&documentation.index;