Integration von timr in bestehende Systeme - timrLink

timr kann mittels API in bestehende Systeme integriert werden.

Aus diversen Anfragen unserer Kunden haben wir gelernt, dass die Aufgabenstellungen für die Integration meist ähnlich, die verwendeten Systeme jedoch unterschiedlich sind.

Wir haben daher begonnen mit "timrLink" ein System zu entwickeln, dass diese Integration vereinfacht und damit den Aufwand für die Anbindung reduziert.

Weitere Informationen zur API selbst finden Sie hier.

timrLink:

timrLink ist eine "Ausführbare Datei" (exe) die bei jedem Aufruf bestimmte Sync-Aufgaben ausführt. Der Aufruf kann zb über "Geplante Tasks" periodisch ausgeführt werden.

Technisch ist timrLink eine dotnet core Anwendung die Open Source zur Verfügung gestellt wird. Eine erste Version findet sich auf GitHub: https://github.com/troii/timrlink.net

Auf timr Seite spricht timrLink mit der API, die kundenseitige Anbindung wird vom Kunden ergänzt.

Die Integration auf Ihrer Seite (mit einem ERP, einer Datenbank, ...) würden Sie selbst dann als Projekt hinzufügen und vermutlich nur intern behalten.

Wir sind mit timrLink noch etwas am Anfang und daher gibt es auch noch keine Dokumentation .. daher bei Fragen bitte jederzeit melden!

Aktueller Stand:

Dieses Projekt erstellt eine Anwendung die bei jedem Aufruf einen Sync mit der timr API ausführt.

Bestimmte Standard-Aktionen sind bereits als CLI (Command Line Interface) implementiert (s. https://github.com/troii/timrlink.net/tree/master/timrlink.net.CLI/Actions):

1. Aufgaben Import aus csv

2. Projektzeit Import aus csv und Excel

Eigene Aktionen erweitern:

Analog zur bestehenden Basis-Implementierung können kundenspezifische Aktionen jederzeit selbst erweitert werden. Dazu können Sie das Projekt gerne forken und clonen und die bestehende CLI Anwendung nach eigenen Wünschen anpassen oder ein zusätzliches Projekt anlegen wo Sie Ihre eigene Integrationslogik auf Basis des Core Projekts implementieren.

 Zur Konfiguration müssen Sie https://github.com/troii/timrlink.net/blob/master/timrlink.net.CLI/config.json mit Ihrem timr Identifier und API Token belegen (s. Verwaltung/Einstellungen in timr).

Die dahinterliegende timr API (https://timrsync.timr.com/timr/timrsync.wsdl) unterstützt wesentlich mehr Funktionen. Wir werden Schritt für Schritt auch die weitere timr API Funktionen als Service in timrLink anbieten.

Bereits verfügbare Services:

Bereits verfügbare Services finden Sie hier: https://github.com/troii/timrlink.net/tree/master/timrlink.net.Core/Service

1. Aufgaben Service:
https://github.com/troii/timrlink.net/blob/master/timrlink.net.Core/Service/TaskService.cs

Kann verwendet werden um Aufgaben aus timr abzufragen, zu erstellen sowie zu aktualisieren.

2. Arbeitszeit Service

https://github.com/troii/timrlink.net/blob/master/timrlink.net.Core/Service/IWorkTimeService.cs

Kann verwendet werden um Arbeitszeiten aus timr abzufragen und zu erstellen.

3. Projektzeit Service:
https://github.com/troii/timrlink.net/blob/master/timrlink.net.Core/Service/ProjectTimeService.cs

Kann verwendet werden um Projektzeiten in timr zu erstellen. 

Durch den OpenSource Ansatz kann auch gerne ein Kunde einen noch nicht vorhandenen aber benötigten Service selbst implementieren und (optional) der Allgemeinheit zur Verfügung stellen.