Dokumentation des Timetask-Connectors
Einrichtung auf dem Server
Nach dem Download speichern Sie den Timetask-Connector auf Ihrem Server unter im Document-Root des Webservers ab, so dass der Pfad zur im Timetask-Connector enthaltenen connectors.php wie folgt aussieht:
/var/www/TimetaskConnector/connectors.php
Nun muss noch ein Cronjob eingerichtet werden. Rufen Sie Crontab mittels
crontab -e
auf. Fügen Sie nun folgende Zeile ein, damit der Cronjob für die Timetask-Anbindung regelmäßig ausgeführt wird:
*/30 * * * * root php5 /var/www/TimetaskConnector/connectors.php > /dev/null
Hierzu eine Erklärung. Hier kann eingestellt werden, wie oft der Timetask-Connector die Daten aktualisieren soll. Die Zahl "30" steht hier für einen Aktualisierungs-Intervall von 30 Minuten. Hier kann natürlich eine beliebige andere Zahl eingetragen werden, z.B. "15" für alle 15 Minuten.
ACHTUNG: Intervals hat ein festgelegtes Limit, wie oft Daten binnen 24 Stunden abgerufen werden können! Am Besten Sie wenden sich hier an den Intervals Support und bitten darum dieses Limit entsprechend zu erhöhen, da sonst keine aktuellen Daten mehr gewährleistet werden können!
Einstellungen im Timetask-Connector
Im Ordner TimetaskConnector befindet sich der Unterordner config. Wechseln Sie nun also mittels
cd /var/www/TimetaskConnector/config
in diesen Unterordner und rufen Sie dort mittels
nano apikey.xml
die Datei apikey.xml auf, in der Ihre persönlichen Zugangsdaten zur Timetask API eingetragen werden. Die Datei hat folgenden Aufbau:
<?xml version="1.0" encoding="UTF-8"?>
<configdata>
<key>APIKEY</key>
<password>PASSWD</password>
</configdate>
In der apikey.xml werden die Werte "APIKEY" durch den Timetask API-Key und "PASSWD" durch ein Passwort eines Intervals-Administrators ersetzt.
Der Timetask API-Key?
Um Ihren Timetask API-Key zu erhalten, melden Sie sich mit Ihrem Benutzernamen und Ihrem Passwort in Ihrer Timetask Installation an (Sie müssen Administratorrechte besitzen). Nun wählen Sie unter Optionen "My Account" aus. Sie sehen jetzt Ihre persönlichen Benutzerdaten von Timetask. Wählen Sie im Untermenü den Punkt "API Access" aus. Hier können Sie nun Ihren API-Key einsehen bzw. wenn Sie noch keinen API-Key besitzen, können Sie diesen hier generieren. Bitte beachten Sie, dass Sie einen bestimmten Projektplan bei Intervals angemietet haben müssen, um Zugriff auf die API zu bekommen.
Einrichtung in GrandTotal
Starten Sie GrandTotal und wählen Sie unter den Einstellungen den Menüpunkt "TimeLog & Co.". Es öffnet sich ein Menü, in dem Sie nun die URL zu Ihrer connectors.php eingeben können.
http(s)://SERVER/connectors.php
In der o.g. URL wird natürlich SERVER durch die Domain oder IP Ihres Servers ersetzt. Bitte beachten Sie, diese URL ist nur ein Beispiel. Je nachdem in welchem Pfad die connectors.php angesprochen wird, kann die URL natürlich varieren, z.B.:
http(s)://SERVER/ORDNER/UNTERORDNER/connectors.php
Das war bereits die komplette Einrichtung des Timetask-Connectors. Nun erhalten Sie regelmäßig (an Ihre gewünschten Zeiten angepasst) aktuelle Zeiten und die dazugehörigen Werte, wie ausführender Mitarbeiter, Stundensatz oder Kunde, die Sie in GrandTotal verarbeiten und Ihren Kunden in Rechnung stellen können.