Ankündigung: Update der mite.api

[Update 1.3.] Wie angekündigt wurde die aktualisierte mite.api heute veröffentlicht. Bitte hier entlang zur neuen Dokumentation.

Am kommenden Sonntag, den 1. März wird unsere offene Datenschnittstelle, die mite.api, aktualisiert werden. Frische, zusätzliche Funktionen werden bald bereitstehen. Eure Wünsche, die uns seit der Veröffentlichung der API im August vergangenen Jahres erreichten, sollen Eingang finden – vorneweg das ausführliche Feedback von Billomat (merci!).

Werte Entwickler: bitte werft einen Blick auf die nachfolgend detailliert erläuterten Änderungen. Kleinere Umbauten auch auf eurer Seite können notwendig werden.

/times wird zu /daily

Die alte URI wird allerdings weiterhin funktionieren.

/timesheets wird zu /time_entries

Die alte URI wird weiterhin funktionieren. Die Root-Tags der ausgegebenen XML-Daten verändern sich jedoch dauerhaft von timesheets zu time_entries bzw. von timesheet zu time_entry.

/time_entries erlaubt vollen Zugriff

Im Gegensatz zur alten Ressource /timesheets kann nun über /time_entries auf alle Zeiten aller Benutzer zugegriffen werden. WICHTIG: Bei einem normalen GET auf /time_entries.xml werden nun alle Zeiteneinträge aller Benutzer angezeigt. Diese Liste kann jedoch nun gefiltert werden (s.u.).

/time_entries mit Filter- und Gruppierungkriterien

Filtern nach:

  • customer_id
  • project_id
  • service_id
  • user_id
  • billable: »true« oder »false«
  • note (Freitextsuche)
  • at: today, yesterday, this_week, last_week, this_month, last_month oder einzelner Tag (im Format YYYY-MM-DD)
  • from, to (beide im Format YYYY-MM-DD)

Gruppieren mit »group_by« Parameter nach:

  • customer
  • project
  • service
  • user
  • day
  • week
  • month
  • year

Mehre Parameter werden mit Komma getrennt (bspw.: »user, service«). Die Reihenfolge ist entscheidend für die Sortierung der Ausgabe.

/time_entries und /projects mit Namen der verbundenen Ressourcen

Für Zeiteinträge und Projekte wird für alle verbundenen Ressourcen nicht nur die ID, sondern auch der Name ausgeben. Beispielsweise wird unter /projects zusätzlich das Attribut »customer_name« ausgegeben, unter /time_entries »customer_name«, »project_name«, »service_name« und »user_name«.

JSON

Die API unterstützt neben XML nun auch das JSON-Format.

Einfachere Authentifizierung

Neben der Authentifizierung über den API-Schlüssel unterstützt die mite.api nun auch die Benutzung der normalen Anmeldedaten E-Mail und Passwort.

Die Dokumentation der neuen, ab kommendem Sonntag gültigen Version steht ab sofort bereit. Gut Code, ihr Tüftler!

Julia in Neue Features, Maschinenraum

Ankündigung von Wartungsarbeiten

Diesen Samstag, den 31. Januar, wird mite für etwa 15 Minuten ab etwa 20 Uhr deutscher Zeit (andere Zeitzone?) nicht erreichbar sein.

Unsere Hardware wird aufgestockt: doppelt so viel Arbeitsspeicher wird der Anwendung nach dieser kurzen Nicht-Erreichbarkeit zur Verfügung stehen. Auf ein weiterhin fixes & stabiles mite, ihr Vielen.

[Update 31.1. 20:18] Pünktlicher Start, pünktliches Ende, der Server nun mit doppeltem Arbeitsspeicher. So soll es sein. Dank an unsere zuverlässigen Helfer im Rechenzentrum wie an Euch für Eure Geduld.

Julia in Maschinenraum

Temporär überlasteter Anwendungsserver

Zwischen 18:07 und 19:01 Uhr des heutigen Abends war mite leider immer wieder nicht erreichbar. Ein überlasteter Anwendungsserver blockierte den Zugriff. Aktuell können wir die Ursache dieser fehlerhaften Reaktion noch nicht ausmachen, setzen jedoch alles an eine so fix als mögliche detaillierte Klärung und Behebung. Nach 3 Monaten regulären Betriebs ist uns diese Störung ein besonderer Dorn im Auge: eine stabil erreichbare Anwendung hat höchste Priorität. Unsere Entschuldigung.

[Update 19:44] Die Ursache ist gefunden, dieser Fehler soll nicht wieder auftreten. Nichtsdestotrotz werden wir ein überaus waches Auge auf den Server behalten, darauf könnt ihr stets vertrauen.

[Update 16.1. 12:26] Unseren Störungen gestern folgte heute leider ein technischer Defekt im Rechenzentrum. Binnen 9 Minuten wurde der fehlerhafte Switch dank Technikern vor Ort ausgetauscht. Die Störungen standen nicht in Zusammenhang. Erneut und hoffentlich ein letztes Mal möchten wir uns von Herzen entschuldigen.

Julia in Maschinenraum

DataLog: der Kalender, der vor- und zurückblickt

»Schick!« – die erste Reaktion nach Öffnen der mächtigen Posterrolle, die uns zu Weihnachten überraschte, wurde Momente später noch durch begeistertes Staunen abgelöst. Dank dem Berliner Designstudio Codeluxe haben mite.daten unserer Kenntnis nach das erste Mal ihren Weg in die physische Welt geschafft. Und dies in überaus ästhetischer Form.

DataLog: Jahresplaner von Codeluxe

DataLog ist ein Jahresplaner, ein beidseitig auf transparentem Papier gedrucktes A1-Poster. Während sich auf der Vorderseite das Kalendarium für 2009 findet, verschafft die Rückseite einen Einblick in die Arbeitsmethodiken und Prozesse des prämierten Gestalterduos: In 2008 mit mite erfasste Daten und daraus extrahierte statistische Kennzahlen werden dort visualisiert.

»While complementing each other, both sides are interdependent: In the way the future relates to the past, one side is the substructure for the other.«

An Kunden ging DataLog als Weihnachtsaufmerksamkeit, doch auch wer noch nicht mit Martin Christel & Hugo Goeldner zusammenarbeitet, kann den Kalender direkt bei Codeluxe bestellen. Falls sich genügend Interessenten finden sollten, bestünde eventuell sogar die Möglichkeit, sich von den Zwei einen auf eigenen mite.daten basierenden Planer entwerfen zu lassen. Fragt an!

(Foto: Codeluxe)

Julia in Tricks & Tipps, In eigener Sache

2 Jahre mite

Jubiläum! Exakt heute vor zwei Jahren öffneten wir die Tore und baten Happy Birthday (Photo by Cond Nast Archive/CORBIS) 50 Freunde & Bekannte, doch einmal einen kritisch-konstruktiven Blick auf unsere kleine Zeiterfassung zu werfen. 5 dieser Mails wurden noch am selben Tag beantwortet, 3 der Antwortenden testeten tatsächlich sofort. Genau einer dieser am 18.12.2006 erstellten Accounts ist heute noch aktiv im Einsatz.

Frau Seltsam! Statt mite gratulieren wir heute lieber dir: zur beeindruckenden Disziplin. Und sagen dankeschön: Ohne dein antreibendes Feedback wäre mite zwar sicher nicht wenige Wochen später eingeschlafen, doch zumindest öfter an den Bedürfnissen vieler vorbeigeschlittert.

Dir sagen wir dankeschön, und euch mehreren Tausend jüngeren mite.nutzern natürlich ebenso. Einmal ab vom überaus guten Gefühl, dank entsprechender Resonanz Tag für Tag an diesem Werkzeug weiterentwickeln zu dürfen, bereitet uns der Austausch mit euch wirkliches Vergnügen. Auf die nächsten zwei Jahre, werte Nutzer & Nutzerinnen!

Julia in In eigener Sache

Zeiteinträge auf ein anderes Datum verschieben

Gerade wenn man nicht täglich seine Zeiten erfasst, vertut man sich ab und an im Datum. Ein Alltagsproblem. Einige von euch meldeten sich bei uns und wünschten sich eine einfachere Möglichkeit, das Datum eines falsch erstellten Eintrags nachträglich zu ändern. Eine einfacherere Möglichkeit als das bisherige – zugegeben leicht nervende – Löschen-und-Neuanlegen.

Zeiteinträge auf ein anderes Datum verschieben / duplizieren

Gewünscht, getan! Per Drag & Drop lassen sich ab sofort Zeiteinträge auf ein anderes Datum verschieben. Wie das geht? Zeigen wir euch in unserem ersten kleinen Video-Screencast nach dem Klick.


mite. Mini-Screencast 01. from Yolk on Vimeo.

Julia in Neue Features

Politurarbeiten im Maschinenraum

Seit wenigen Minuten läuft mite auf neuester Version des zugrundeliegenden Frameworks. Solltest du nichts von dieser Aktualisierung bemerken, strecken wir die Daumen nach oben – denn die geschmeidiger aufeinander abgestimmten Rädchen im Maschinenraum sollten zwar mit einer Spur erhöhter Geschwindigkeit, doch mit keinen funktionalen Veränderungen einhergehen.

Falls dir wider Erwarten ein Fehler auffallen sollte, hilf uns bitte, diesen fix auszumerzen: Sende uns eine den »Tatbestand« möglichst genau beschreibende Mail; Browser & Betriebssystem nicht vergessen. Danke!

Julia in Maschinenraum

Startschuss: Zeiterfassung auf dem iPhone

Auf dem Weg vom Büro nach Hause, und vergessen, die Stoppuhr anzuhalten? Im Meeting beim Kunden, und kein Notebook dabei? Fünf Minuten abends in der S-Bahn über, die eigentlich dafür prädestiniert wären, die heutigen Arbeitszeiten nachzutragen? Diese drei Verflixts – und sicherlich einige weitere mehr – sind seit dem heutigen Tag passé. Denn mite kannst du ab sofort stets in die Hosentasche packen. Und bequem unterwegs deine Arbeitszeiten erfassen. Auf dem iPhone.

Zeiterfassung auf dem iPhone

Zeiten können mit der fürs iPhone und den iPod touch optimierten Version manuell eingegeben oder direkt gestoppt werden. Großzügig bemessene touchsensitive Flächen erleichtern das Umschalten der Stoppuhr vom einen auf den anderen Eintrag. Einmal erfasste Zeiten lassen sich jederzeit editieren, löschen oder auf einen anderen Tag verschieben.

In gewohnter Browser-Darstellung stehen weiterhin der Reportsbereich sowie alle anderen weniger intensiv genutzten Funktionen von mite zur Verfügung. Steuere hierfür bitte einfach den Link »Zur Hauptwebsite« im Fuß der Webapp an.

Los geht’s.

Um mite auf dem iPhone oder iPod touch zu nutzen, ist kein zusätzlicher Download notwendig. Einfach den Safari starten und deine gewohnte Login-Adresse aufrufen (http://deinteam.mite.de) – fertig. mite erkennt automatisch dein Gerät und serviert dir die fürs iPhone optimierte mobile Version.

Für ein Quentchen mehr Geschwindigkeit beim Start empfehlen wir, das mite.icon dem Home-Bildschirm hinzuzufügen. Dieser einmalige Vorgang ist fix erledigt: Drücke, sobald du deine Login-Adresse aufgerufen hast, zuerst das »+«-Symbol des Browsers, welches du mittig in der Fußleiste positioniert findest. Bestätige dann den aufklappenden Menüpunkt »Zum Home-Bildschirm«. Wähle im letzten Schritt eine knappe Bezeichnung für die Verknüpfung, bspw. schlicht »mite«. Das war es schon: ab sofort lässt sich die Zeiterfassung mit einem Fingertipp vom Home-Bildschirm aus aufrufen. Die Verknüpfung lässt sich jederzeit wieder löschen.

Gute Zeiterfassung unterwegs wünschen wir! Lass uns wissen, wie du zurechtkommst, wir freuen uns über Feedback.

Julia in Neue Features

Dreimal: Augenmerk aufs Detail

Bevor wir in Kürze einen größeren Vorstoß für unsere Unterwegs-Nutzer veröffentlichen werden, wandten wir uns nocheinmal drei kleineren Baustellen zu. Detailverbesserungen, die mite ein Quentchen geschwindter machen.

Vom Detailreport zum Projekt mit einem Klick

Gerade bei der Analyse des Detailreports eines Projekts fallen manchmal fehlende oder ungenaue Projektnotizen ins Auge. Mit einem Klick kann nun rechterhand über den Menüpunkt »Projekt bearbeiten« direkt der Editormodus des entsprechenden Projekts aufgerufen werden. Der Umweg über den Menüpunkt »Projekte« samt eventueller Suche des Projekts in langen Listen: passé.

Vom Reportsbereich aus Zeiteinträge fixer editieren

Schon vor dem heutigen Update konnte von allen Reports aus über das verlinkte Datum eines eigenen Zeiteintrags zügig der entsprechende Tag aufgerufen werden. Doch gerade bei detaillierter Erfassung der einzelnen Tagestätigkeiten und folglich zahlreichen Einträgen auf dem entsprechenden Tag startete danach die Sucherei. Eine unnötige Sucherei, wie Nutzer fanden. Ab sofort springt nun unter »Zeiten« der ausgewählte Zeiteintrag direkt in den Editormodus.

Donut-Diagramme & negative Zeiteinträge

Nicht jede Funktionalität lässt sich vorab auf Herz & Nieren testen – denn nicht einmal auf die Idee würden wir manchmal kommen, auf welche Art sich mite nutzen lässt. So auch in diesem Falle: Ein Nutzer ließ uns seinen smarten Kniff zukommen (merci!), wie er die chronologische, teilweise bereits erfolgte Abrechnungen von Projekten visualisiert.

Nach Rechnungsstellung erstellt er einen einzelnen Zeiteintrag mit der Leistung »Abrechnung« und genau der bereits abgerechneten Stundenanzahl im Negativ. Sowohl die noch offene Zeitensumme sieht er so auf einen Blick als auch den Zeitpunkt, an welchem die Abrechnung erfolgte.

Nur die Donut-Charts kamen mit den negativen Blöcken nicht zurecht. Ein Darstellungsfehler, der ab sofort gefixt ist. Der Flexibilität zuliebe.

Gutes Arbeiten & bis auf bald mit Unterwegs-Updates!

Julia in Neue Features

Zahlungen via Kreditkarte

Hello World! Alternativ zum Elektronischen Lastschriftverfahren von deutschen Konten akzeptiert mite nun auch Zahlungen via Visa oder MasterCard. Zahlungsdaten können vom Besitzer des Accounts unter dem Menüpunkt »Account => Zahlungen« eingegeben werden.

Julia in Neue Features