Importación de tareas o tiempos de proyectos

Con timrLink tenemos un programa con el que se pueden importar las tareas y los tiempos del proyecto desde un archivo csv/Excel.

1 Estructura del archivo CSV

La codificación del archivo debe ser UTF-8 en ambos casos.

1.1 Importar tareas desde un archivo csv

El archivo csv debe tener la siguiente estructura:

Tarea;Registrable;Fcturable;Observaciones internas;Inicio;Fin.

Ejemplo:

El archivo contiene entonces...
Cliente|Proyecto1|Tarea1;true;true;;
Cliente|Proyecto1|Tarea2;true;true;;;

Detalles:

Las tareas Tarea1 y 2 se crean como Facturable=True. Por otro lado, sólo las tareas1 y 2 se crean con Registrable=true.

Nota: En el apartado 3.1 encontrará más posibilidades para importar, por ejemplo, subtareas o campos específicos de clientes.

1.2 Importación de tiempos del proyecto desde un archivo csv

El archivo csv para importar los tiempos del proyecto requiere la siguiente estructura:

Usuario;Tarea;StartDateTime;EndDateTime;Pausa;Notas;Facturable.

El usuario hace referencia a un usuario a través de la referencia almacenada en timr como "IDExterna" (ver 2.3).

La tarea hace referencia a una tarea en timr a partir del nombre y la estructura.

Ejemplo:

Usuario;Tarea;StartDateTime;EndDateTime;Pausa;Notas;Facturable
Juan1;Cliente A|Proyecto1|TareaA1;01.12.15 8:00;01.12.15 16:30;0:30;;falso

En timr, un usuario debe ser introducido como IDExterna=Juan1. El tiempo del proyecto se importa para este usuario. Si no existe un usuario con IDExterna=Juan1, el tiempo del proyecto no se importará.

El tiempo del proyecto se registra en la siguiente tarea:

Cliente A

   Proyecto 1

      TareaA1

Atención: Si la tarea aún no existe en timr, se creará una nueva.

2. Utilizar timrLink:

2.1 Descargar timrLink

Puede descargar la versión actual de timrLink para diferentes plataformas (Windows, Mac, Linux):

https://github.com/troii/timrlink.net/releases

Puede encontrar más información sobre timrLink aquí.

2.2 Tras la descarga, hay que descomprimir el archivo zip.

2.3 Crear un Token de sincronización, introducir el ID externo:

La importación con timrLink se realiza a través de timrAPI. Esto requiere un token de acceso para su cuenta. Puede generar este token en timr en Administración/Configuración/General/API:

Atención: No comparta este token con nadie, ¡permite el acceso a todos los datos de su cuenta!

Aquí también puede mostrar un "ID externo". Esto le permite, por ejemplo, almacenar un ID para un usuario con el que se gestiona este usuario en su sistema, por ejemplo, el número de empleado.

En cuanto seleccione "Mostrar ID externo" = Sí, se mostrará un campo adicional "ID externo" en las propiedades del usuario (y también en las tareas):

2.4 Adaptar el archivo de configuración de timrLink:

En el directorio de timrLink de la versión 2.2. encontrará el archivo de configuración config.json con el siguiente contenido:

{
"timrSync": {
"identificador": "<identificador>",
"token": "<token de autenticación>"
}
}

Para el <identificador> utilice la URL su de timr. Para el token, utilice el token de la API creado en el punto 2.3.

Ejemplo:

Usted es el propietario de la cuenta indrola.timr.com:

{
"timrSync": {
"identificador": "indrola",
"token": "abce123332abc"
}
}

2.5 Ejecutar la importación

Ahora puede ejecutar el archivo timrlink en el directorio de la siguiente manera:

2.5.1 Importación de tareas:
timrlink t <fichero>

2.5.2 Importación de tiempos del proyecto:
timrlink pt <fichero>

3 Más información

3.1 Estructura ampliada del fichero csv de tareas

Al importar, también es posible importar campos específicos para las tareas. Para ello, utilice el siguiente formato de importación:

Tarea;Registrable;Facturable;Descripción;Inicio;Fin;CustomField1;CustomField2;CustomField3

Ejemplo:

Cliente A|Proyecto1|Tarea1;True;False;Genial;;Campo1;Campo2;Campo3
Cliente A|Proyecto1;True;True;;;;;;
Cliente A|Proyecto2;false;true;;2019-05-16;;;;

También es posible importar subtareas durante la importación. Esto es práctico si, por ejemplo, quiere consultar los clientes desde un CRM y luego simplemente crear una lista de tareas para cada cliente:

Tarea;Registrable;Facturable;Descripción;Inicio;Fin;Subtareas.

Ejemplo:
Cliente A;True;Falso;Genial;;Soporte,Ventas
Cliente B;True;True;;;;Soporte,Ventas
Cliente C;false;true;;2019-05-16;;Desarrollo,Pruebas

Así se crea, por ejemplo, el

ClienteA

    Soporte

    Ventas