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. 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. 

Falls keine Pause gemacht wurde, tragen Sie bei Break 0:00 ein.

 

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 Csv-File Aufgaben Import inkl. kundenspezifischer Felder

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;;;;

 

3.2 Csv-File Aufgaben Import inkl. Erstellung von Subaufgaben

Beim csv-File import ist es möglich fixe Unteraufgaben zu erstellen. 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

...

3.3 Csv-File Aufgaben Import inkl. Adressinformation für Aufgaben

Beim Import von Aufgaben via csv File können Sie auch Adressinformationen importieren. Dafür verwenden Sie folgende Datenstruktur im csv-File:

Task;Bookable;Billable;Description;Start;End;DescriptionRequired;Address;City;ZipCode;State;Country;Latitude;Longitude

Beispiel:

Orts basiert;True;True;;;;True;Martinistraße 8/2;Leonding;4060;;AT;48,246461;14,261041
Orts basiert|Poolhall;True;True;;;;True;Wattstraße 6;Linz;4030;;AT;48,24676258791299;14,265460834572343
Orts basiert|Burgerking;false;true;;2019-05-16;;true;Martinistraße 8/2;Leonding;4060;Oberösterreich;AT;48,246955491407704;

 

3.4 Csv-File Aufgaben Import inkl. kundenspezifischer Felder

Beim Import von Aufgaben via csv-File ist es auch möglich Budget-Informationen zu importieren. Dafür verwenden sie die folgende Struktur im csv-File:

Task;Bookable;Billable;Description;Start;End;DescriptionRequired;BudgetPlanningType;BudgetPlanningTypeInherited;HoursPlanned;HourlyRate;BudgetPlanned

Für die jeweils gewünschte Planungsart übergeben Sie folgenden Parameter:

Keine Planung: NONE

Benutzer Stundensatz: USER_HOURLY_RATE

Aufgaben Stundensatz: TASK_HOURLY_RATE

Fixpreis: FIXED_PRICE

 

Beispiel:

BudgetTasks;True;True;;;;True;TASK_HOURLY_RATE;False;2,00;8,00;32,00
BudgetTasks|Budget Task 1;True;False;Awesome;;;False;NONE;True;;;
BudgetTasks|Budget Task 2;false;true;;2019-05-16;;true;USER_HOURLY_RATE;False;3,00;;48,00
BudgetTasks|Budget Task 3;false;true;;2019-05-16;;true;FIXED_PRICE;False;4,00;16,00;64,00