# El manual de &ktimetracker;

## Introducción

&ktimetracker; registra el tiempo empleado en varias tareas. Es útil para registrar horas para que sean facturadas y para informar de las horas que se pasa registrado por tarea y día.

El historial de tiempos se puede exportar como un archivo de texto separado por comas para importar en otras herramientas de facturación o de gestión de proyectos.

&ktimetracker; detecta si el teclado y el ratón están inactivos y puede asociar diferentes tareas con diferentes escritorios, dos herramientas que pueden ayudarle a conseguir que el temporizador ejecute la tarea correcta.

&ktimetracker; fue escrito originalmente por &Sirtaj.Singh.Kang;. Su página inicial es http://userbase.kde.org/KTimeTracker.

## Usar &ktimetracker;

### Iniciar &ktimetracker;

Teclee `ktimetracker` en la línea de órdenes o seleccione Seguimiento de tiempo personal en el grupo Aplicaciones Utilidades en el Menú inicial de KDE. Están disponibles las opciones de línea de órdenes estándar de &Qt; y &kde; y se puede obtener un listado de las mismas indicando en la línea de órdenes ``ktimetracker` `--help``.

&ktimetracker; proporciona una opción adicional en la orden que le permite indicar el nombre del archivo de iCalendar que se usa para almacenar el histórico de su trabajo. Para indicar un archivo remoto de iCalendar puede usar http o ftp como parte del nombre del archivo. Por ejemplo, http://www.mysite.com/mydata/mylabor.ics.

### Tareas

Problema: Es un consultor de software libre con muchos clientes. Algunos clientes tienen varios proyectos. A lo largo del día, puede cambiar entre varios proyectos. Tiene que seguirle la pista al tiempo empleado para generar los recibos mensuales.

Solución: Cree una tarea de nivel superior para cada cliente y una subtarea para cada proyecto de cada cliente. Para los proyectos que necesiten un seguimiento más detallado, cree una lista de subtareas para el proyecto. Haga el seguimiento mediante un doble clic en la tarea en la que va a trabajar.

&ktimetracker; le proporciona una gran flexibilidad para hacer el seguimiento de su tiempo, permitiendo tareas y profundidad de tareas ilimitadas. El tiempo se puede registrar en cualquier tarea y puede haber más de una tarea activa en cualquier momento.

&ktimetracker; le permite editar su historial de tareas y poner un comentario para cada evento que haya detenido.

Para crear una tarea de nivel superior, seleccione &Ctrl;T Tarea Nueva tarea... . Para crear una subtarea, resalte la tarea padre y seleccione &Ctrl;&Alt;N Tarea Nueva subtarea... .

Cuando salga de &ktimetracker;, la lista de tareas se guardará en un archivo de su disco. La próxima vez que lo abra, recargará la lista de tareas desde el mismo archivo.

&ktimetracker; puede importar y exportar tareas para minimizar su trabajo. Vea Otros sistemas.

### Temporizadores

Problema: Para ser solvente, debe emitir una factura de una media de cinco horas al día. Para seguirle la pista, puede ver los totales diarios y semanales.

Solución: Reinicia el temporizador de la sesión al comienzo de cada día de trabajo y reinicia todos los temporizadores al comienzo de cada semana.

&ktimetracker; hace más sencillo el seguimiento del tiempo. Para comenzar a registrar el tiempo de una tarea, haga doble clic sobre la tarea. Para detener el registro del tiempo, vuelva a hacer doble clic sobre la tarea. Las tareas activas muestran un pequeño reloj en la columna Tiempo de sesión.

Otra pista visual de la actividad de registro de &ktimetracker; en el icono de la bandeja del sistema. Cuando esté activa una tarea, se moverá la mano del icono. Si hace descansar el puntero del ratón sobre el icono, el nombre de la tarea activa se mostrará en un consejo emergente. Si hay más de una tarea activa, los nombres en el consejo estarán separados por comas.

&ktimetracker; mantiene dos temporizadores para cada tarea: uno para el tiempo de la sesión y otro para el tiempo total. En la configuración predeterminada, &ktimetracker;muestra dos columnas por cada temporizador, dando como resultado un total de cuatro columnas para cada tarea:

Tiempo de sesión

- El tiempo empleado en la tarea desde que comenzó la sesión.

Tiempo

- El tiempo empleado en la tarea desde que se reiniciaron todos los tiempos.

Tiempo total de la sesión

- El tiempo empleado en la tarea y en todas las subtareas desde que comenzó la sesión.

Tiempo total

- El tiempo empleado en la tarea y todas sus subtareas desde que se reiniciaron todos los tiempos.

Para iniciar una nueva sesión, seleccione Archivo Iniciar nueva sesión

Para reiniciar todos los tiempos, seleccione Archivo Reiniciar todos los tiempos

#### Seguimiento de escritorio

Problema: Tiene dos proyectos principales entre los que cambia a lo largo del día. Para ayudarle a organizar el trabajo, puede mantener los archivos del proyecto 1 en el escritorio 1 y los del proyecto 2 en el escritorio 2.

Solución: Asocie las tareas del proyecto 1 con el escritorio 1 y las tareas del proyecto 2 con el escritorio 2. Cuando cambie desde el escritorio 2 al escritorio 1, &ktimetracker; detendrá automáticamente la tarea del proyecto 2 e iniciará la tarea del proyecto 1.

Para asociar una tarea con uno o más escritorios, seleccione &Ctrl;E Tarea Editar . Active Seguimiento automático y seleccione el escritorio o escritorios que va a asociar con esta tarea. Cuando se active alguno de los escritorios seleccionados, &ktimetracker;; comenzará a registrar automáticamente el tiempo de esa tarea tras un breve retraso.

#### Detección de inactividad

Problema: Ha dejado el trabajo el viernes por la mañana para ejecutar un mandado y olvidó detener el temporizador. Cuando vuelve el lunes, el temporizador sigue funcionando.

Solución: Active la detección de inactividad en la página de Comportamiento del diálogo de preferencias.

Puede configurar &ktimetracker; para que detecte cuando están inactivos el ratón y el teclado. Si durante un tiempo (los minutos especificados) no se ha producido ninguna acción en el teclado ni en el ratón, &ktimetracker; muestra el siguiente cuadro de diálogo:

Detección de inactividad de &ktimetracker; Cuadro de diálogo de detección de inactividad de &ktimetracker;

Continuar la temporización

- Aplica el tiempo de inactividad a todos los temporizadores activos y los mantiene funcionando.

  Estuvo trabajando en las tareas mientras el equipo estuvo inactivo y ahora va a seguir.

Revertir la temporización

- Resta la cantidad de tiempo de inactividad de todos los temporizadores activos y los detiene.

  No estuvo trabajando en las tareas mientras el equipo estuvo inactivo y no lo va a hacer ahora.

### Otros sistemas

#### &korganizer;

&ktimetracker;, al igual que &korganizer; e iCal de Apple, usa el formato estándar de la industria iCalendar para los datos. &ktimetracker; puede leer y escribir las listas de tareas pendientes que crean esas dos aplicaciones.

Usted incluso puede trabajar de forma sincronizada con &korganizer; y &ktimetracker;. Si uno de los programas cambia el archivo, las actualizaciones se propagan a la otra aplicación automáticamente.

#### Planner

Como caso de uso típico, puede querer planificar un proyecto con la herramienta de gestión de proyectos Imendio Planner (desde live.gnome.org/Planner) e importar sus tareas en &ktimetracker; con Archivo Importar Import tareas desde Planner... , para tenerlos en el formato iCalendar, estándar de la industria. Haciendo esto, podrá planificar las tareas en &korganizer; y contabilizar su tiempo en &ktimetracker;. Es una forma de ayudarle a asegurar que su proyecto está dentro de los límites temporales y de presupuesto.

#### &DBus;

&DBus; es el mecanismo que usan los programas de &kde; para comunicarse entre sí. Un programa de &kde; proporciona una lista de funciones que pueden usar otros programas (por ejemplo, un guion de Bash).

##### Guion de Bash que muestra la versión de &ktimetracker;

    qdbus org.kde.ktimetracker /KTimeTracker version 2
    >/dev/null || echo "ktimetracker not running"

La interfaz &DBus; actual de &ktimetracker; se usa principalmente para comprobaciones automatizadas, por lo que está muy limitado. Puede ver la definición completa de la interfaz en el apéndice &DBus; de la interfaz.

Para ver la interfaz &DBus; completa de la versión de &ktimetracker; que está instalada en su sistema, ejecute el siguiente guion de Bash:

##### Lista la interfaz &DBus; de &ktimetracker; en la consola

    qdbus org.kde.ktimetracker /KTimeTracker 2
    >/dev/null || echo "ktimetracker not running"

#### Exportar los totales como CSV

&ktimetracker; puede exportar tanto los totales como el historial con el formato de archivo separado por comas. Para exportar los totales, seleccione Archivo Exportar Exportar tiempos... y &ktimetracker; muestra el siguiente cuadro de diálogo de exportación:

Diálogo de exportación a CSV de &ktimetracker; Diálogo de exportación a CSV de &ktimetracker;

Introduzca el nombre del archivo al que quiera exportar los datos y modifique las opciones predeterminadas de los cuadros de diálogo si fuera necesario. Haga clic en Exportar y &ktimetracker; exportará el total de las tareas en el archivo que haya seleccionado.

Utilice el botón Exportar al portapapeles para exportar los tiempos al portapapeles

Aquí tiene un ejemplo del formato de la salida:

    «kde»,,,,,0.00,0.00,6.88,9.83
    ,«ktimetracker»,,,,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

Las tareas de nivel superior se muestran en la primera columna, las subtareas en la segunda y así sucesivamente. Los datos del tiempo se muestran tras la profundidad más alta (cinco en este ejemplo). El tiempo de la primera columna en el Tiempo de sesión, el segundo es el Tiempo, el tercero es el Tiempo total de sesión y el cuarto es el Tiempo total.

#### Exportar el historial como CSV

Para exportar el historial de tarea, seleccione Archivo Exportar Exportar historia... y &ktimetracker; muestra el mismo cuadro de diálogo de exportación que se mostró arriba.

Introduzca el nombre del archivo al que quiera exportar los datos y seleccione un intervalo de fechas para las que obtener el historial. Modifique las opciones predeterminadas de los cuadros de diálogo si fuera necesario. Haga clic en Exportar y &ktimetracker; exportará el historial de todas las tareas en el archivo que haya seleccionado.

Utilice el botón Exportar al portapapeles para exportar el historial al portapapeles.

Aquí tiene un ejemplo del formato de la salida:

    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,,«ktimetracker»
    ,,,,,,,,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»

Las primeras tres líneas identifican cuándo se generó el informe y en qué intervalo de fechas. La cuarta fila es una lista separada por comas de las fechas del rango, en formato ISO 8601 (AAAA-MM-DD). Todas las filas siguientes muestran el tiempo registrado para cada tarea. La última columna numérica es la fila de totales para todos los días. El nombre de la tarea se imprime tras la columna de totales y se pretende que indique las relaciones de tareas y subtareas. Los nombres de las tareas de nivel superior aparecen en la primera columna tras el total.

## La interfaz de &ktimetracker;

La ventana principal de &ktimetracker; tiene los siguientes componentes: barra de menú, barra de búsqueda, barra de herramientas, ventana de tarea/tiempo y barra de estado.

La barra de búsquedas es un campo combinado. Mientras usted no pulse &Enter;, actuará como un filtro. Entonces, solo se muestran las tareas coincidentes con su entrada. Tan pronto como usted pulse &Enter;, su entrada se usa como nombre para crear una nueva tarea.

Elija Configuración para PDA en la página Aspecto del diálogo de preferencias si usted dispone de una pantalla sensible al tacto y el estado real de la pantalla es muy valioso. Esto desactivará la barra de búsqueda y cada pulsación desplegará un menú emergente.

Pantalla de &ktimetracker; Pantalla de &ktimetracker;

### La ventana de tarea/tiempo

En esta ventana se muestran las diferentes tareas, junto con el tiempo acumulado para cada uno en la sesión actual y en total. Las tareas de las que se sigue el tiempo tiene un pequeño icono de reloj junto al tiempo de sesión.

Se pueden crear subtareas para cada tarea. Al pulsar sobre los signos más y menos que están delante de las tareas principales, conmuta la vista de las subtareas asociadas. El tiempo total acumulado para una tarea incluye los tiempos para sus subtareas, así como su propio tiempo acumulado.

### La barra de herramientas y la barra de estado

La barra de herramientas contiene iconos para las siguientes órdenes:

Todos los comportamientos son idénticos a la orden menú.

- Nueva tarea

- Nueva subtarea

- Iniciar

- Detener

- Borrar

- Editar

- Abrir

- Guardar

La barra de estado informa del nombre del archivo en el que se guardaron los datos.

## Créditos y licencia

&ktimetracker;

Derechos de autor del 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

Colaboradores (en orden alfabético)

- 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

&ktimetracker; se inspiró en una utilidad muy buena de Harald Tveit Alverstrand llamada titrax. La única pega era que estaba basada en la herramienta Xt.

Derechos de autor de la documentación 2000-2004 &Jonathan.Singer; &Jonathan.Singer.mail; y &Sirtaj.Singh.Kang; &Sirtaj.Singh.Kang.mail;.

Traducido por Juan Manuel García Molinajuanma@superiodico.net y Javier Viñal fjvinal@gmail.com

&underFDL; &underGPL;

## Glosario

## A

tarea activa

Una tarea que tiene un temporizador funcionando.

## D

&DBus;

El protocolo de comunicación entre procesos que se usa en &kde;. Es una abreviatura de Desktop Bus.

escritorio

&GNU;/&Linux;, FreeBSD y otros sistemas que ejecutan X-Windows tienen múltiples escritorios. Normalmente, usted tendrá cuatro escritorios diferentes instalados de forma predeterminada. Cada escritorio puede mostrar su propio conjunto de programas y archivos. Cuando &kde; se inicia por primera vez, el escritorio que ve es el 1. Si presiona &Ctrl;F2, verá el escritorio 2. Si presiona &Ctrl;F1, volverá el escritorio 1.

## H

historial

Si &ktimetracker; está configurado para que registre el historial, grabará cada evento de inicio/parada del temporizador. Este historial no se limpia nunca cuando se reinician los tiempos y permanece en el archivo hasta que se borra la tarea.

## S

sesión

Un punto de inicio definido por el usuario para los temporizadores de la sesión. Una sesión nueva comienza cuando selecciona Archivo Iniciar nueva sesión . Los datos de la sesión no se guardan cuando crea una sesión nueva.

Tiempo de sesión

El tiempo empleado en la tarea desde que comenzó la sesión.

bandeja del sistema

La bandeja del sistema es la barra que aparece (de forma predeterminada) en la parte inferior de la pantalla. En esta bandeja del sistema, el icono de &ktimetracker; está a la derecha.

## T

tarea de nivel superior

Una tarea que no tiene tareas padre.

Tiempo total de la sesión

El tiempo empleado en la tarea y en todas las subtareas desde que comenzó la sesión.

Tiempo

El tiempo empleado en la tarea desde que se reiniciaron todos los tiempos.

Tiempo total

El tiempo empleado en la tarea y todas sus subtareas desde que se reiniciaron todos los tiempos.

## Instalación

### Cómo obtener &ktimetracker;

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

## Interfaz &DBus;

version

version

Devuelve la ejecución de «versión» de &ktimetracker;.

    QString version()

#### Descripción

`version()` es una llamada &DBus; que devuelve el número de versión de &ktimetracker;. Por ejemplo, 4.3.1. El número de versión se devuelve como una cadena con el típico formato de &GNU; de mayor.menor.corrección de fallos.

quit

quit

Devuelve la ejecución de «quit» de &ktimetracker;.

    QString quit()

#### Descripción

`quit()` es una llamada &DBus; que proporciona un medio para que un programa externo pueda apagar de forma elegante &ktimetracker;.

addTask

addTask

Añade una tarea nueva.

    QString addTask(QString taskname)

#### Parámetros

`nombre de tarea`

- El nombre de la tarea nueva.

#### Descripción

`addTask(QString taskname)` es una llamada &DBus; que añade una tarea pendiente de nivel superior al almacenamiento actual. Se devuelve el UID de la nueva tarea pendiente.

&documentation.index;