Wir haben mit timrLink ein ausführbares Programm mit dem Aufgaben sowie Projektzeiten aus einem csv/Excel File importiert werden können.

1. CSV-File Aufbau/Struktur

Das File Encoding muss in beiden Fällen UTF-8 entsprechen.

1.1. Aufgaben Import aus csv File

Das csv File muss dazu folgende Struktur haben:

Task;Buchbar;Verrechenbar;Interne Bemerkungen;Start;End

Beispiel:

Das File beinhaltet dann...
Kunde A|Projekt1|AufgabeA1;true;true;;;
Kunde A|Projekt1|AufgabeA2;true;true;;;

Details:

Die Aufgaben AufgabeA1 und A2 werden mit Verrechenbar=True erstellt. Weiters werden auf Basis dieses Importfiles nur AufgabeA1 und A2 mit Buchbar=true erstellt.

Hinweis: Unter 3.1 finden Sie noch weitere Möglichkeiten um zb auch fixe Unteraufgaben oder kundenspezifische Felder importieren zu können.

1.2. Projektzeiten Import aus csv File

Das csv File für den Import von Projektzeiten erfordert folgende Struktur:

User;Task;StartDateTime;EndDateTime;Break;Notes;Billable

User referenziert einen Benutzer über die in timr beim Benutzer als "ExterneID" hinterlegte Referenz (s. 2.3).

Task referenziert eine timr Aufgabe über den Namen und die Struktur. 

Beispiel:

User;Task;StartDateTime;EndDateTime;Break;Notes;Billable
John1;Kunde A|Projekt1|AufgabeA1;01.12.15 8:00;01.12.15 16:30;0:30;;false

In timr muss bei einem Benutzer als ExterneID=John1 eingetragen sein. Die Projektzeit wird für diesen Benutzer importiert. Falls kein Benutzer mit ExterneID=John1 existiert wird die Projektzeit nicht importiert.

Die Projektzeit wird in timr auf folgende Aufgabe gebucht:

Kunde A

  Projekt 1

    AufgabeA1 

Achtung: Falls die Aufgabe in timr noch nicht existiert wird diese erstellt.

2. timrLink verwenden:

2.1 timrLink herunterladen

Die aktuelle Version von timrLink für unterschiedliche Plattformen (Windows, Mac, Linux) finden Sie zum Download:

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

Weitere Informationen zu timrLink finden Sie hier.

2.2 Nach dem Download muss die zip Datei entpackt werden.

2.3 Sync Token erstellen, ExterneID hinterlegen:

Der Import mittels timrLink erfolgt über die timrAPI. Dafür ist ein Zugriffs Token für Ihr Konto erforderlich. Diesen Token können Sie in timr unter Verwaltung/Einstellungen/Allgemein/API generieren:

Achtung: Diesen Token nicht weitergeben, er ermöglicht den Zugriff auf alle Daten in Ihrem Konto!

Hier können Sie auch eine "ExterneID" einblenden. Damit können Sie beispielsweise für Benutzer eine ID hinterlegen mit der dieser Benutzer in Ihrem System geführt wird, zb Mitarbeiternummer.

Sobald Sie "Externe ID anzeigen" = Ja wählen wird in den Benutzereigenschaften (und auch Aufgaben) ein zusätzliches Feld "ExterneID" angezeigt:

2.4 timrLink Konfigurationsdatei anpassen:

In dem unter 2.2. entpackten timrLink Verzeichnis finden Sie die Konfigurationsdatei config.json mit folgendem Inhalt:

{
"timrSync": {
"identifier": "<identifier>",
"token": "<Authentication Token>"
}
}

Als <identifier> setzten Sie Ihre timr URL ein. Als Token verwenden Sie den unter 2.3 erstellten API Token.

Beispiel:

Sie besitzen das Konto mustermann.timr.com:

{
"timrSync": {
"identifier": "mustermann",
"token": "abce123332abc"
}
}

2.5 Import ausführen

Sie können nun im entpackten Verzeichnis die Datei timrlink wie folgt ausführen:

2.5.1 Aufgaben Import:

timrlink t <file> 

2.5.2 Projektzeiten Import:

timrlink pt <file> 

3. Weitere Informationen

3.1 Erweiterte Struktur für Aufgaben csv File

Beim Import ist es auch möglich kundenspezifische Felder für die Aufgaben mit zu importieren. Dafür verwenden Sie folgendes Import-Fomat:

Task;Bookable;Billable;Description;Start;End;CustomField1;CustomField2;CustomField3

Beispiel:

Customer A|Project1|Task1;True;False;Awesome;;Field1;Field2;Field3
Customer A|Project1;True;True;;;;;;
Customer A|Project2;false;true;;2019-05-16;;;;

Ebenso ist es möglich dass Sie beim Import fixe Unteraufgaben mit importieren lassen. Dies ist dann praktisch wenn Sie beispielsweise die Kunden aus einem CRM auslesen und dann einfach unter jedem Kunden eine fixe Aufgabenliste erstellen möchten:

Task;Bookable;Billable;Description;Start;End;Subtasks

Beispiel:
Customer A;True;False;Awesome;;;Support,Sales
Customer B;True;True;;;;Support,Sales
Customer C;false;true;;2019-05-16;;Development,Testing

Dies erzeugt zb:

CustomerA

  Support

  Sales

...