Die folgenden Informationen sind für EDV-Zuständige gedacht und beziehen sich auf den Windows Desktop-Client von todo.service.
Achtung!
- Seit Update 2.1 nur noch Ausführbar unter Windows 10
- Beachten Sie die neue URI für den Datenbankzugriff ab dem 26.04.2021!
Systemvoraussetzungen
Der Desktop-Client von todo.service verwendet das Microsoft .NET Framework 4.7.2. Die Systemvoraussetzungen sind mit denen des Frameworks identisch. Sie finden diese hier aufgelistet (Änderungen von Seiten Microsoft vorbehalten).
Auf regulär gewarteten Windows 10 Systemen sollte ein kompatibles Framework vorhanden sein.
Weiterhin wird für einige Funktionen der todo.service Desktop Software die Visual C++ Laufzeitbibliothek benötigt. Für 64Bit Systeme ist unbedingt die 64Bit Variante erforderlich! Sie finden die aktuellste Version auf der entsprechenden Seite von Microsoft. Alternativ können Sie hier eine kompatible Version direkt von unseren Servern herunterladen (die 32Bit Variante für x86 Systeme finden Sie hier) .
Zur Installation der oben genannten Systemvoraussetzungen werden Adminstratorrechte benötigt. Ein Neustart kann notwendig sein.
Installation
Zur Installation und Aktualisierung verwenden wir das Installations-Framework „Squirrel for Windows“.
Die Installation ist voll automatisiert und kommt ohne Benutzerinteraktion aus. Es sind keine erhöhten Benutzerrechte („Administratorrechte“) erforderlich und die Installation erfordert keinen Neustart.
Die notwendigen Programmdateien werden im Verzeichnis %localappdata%/todoServiceWin abgelegt. Die dort befindliche todoWPF.exe wird als Desktopverknüpfung aufgerufen und fungiert als „Launcher“ für die jeweils aktuelle Version.
Darüber hinaus werden keine Dateien im angelegt und bis auf einen Registry-Eintrag zur Deinstallation werden keine Veränderungen am System vorgenommen.
Ein MSI-Paket zur verteilten Installation steht unter den Downloads an der rechten Seite zur Verfügung.
Digitale Signatur
Das Setup-Programm, MSI-Installationspaket und alle installierten Binär-Dateien verfügen immer über unsere digitale Sginatur.
Updates
Updates sind obligatorisch und verlaufen ebenfalls vollautomatisch ohne Benutzerinteraktion. Bei einem Update wird die neue Version in ein neues Verzeichnis geladen und der Launcher so aktualisiert, dass ab dem nächsten Aufruf die neue Version gestartet wird. Der Endbenutzer wird über diesen Vorgang informiert, nach Abschluss der Installation startet der Desktop-Client.
Konfiguration
Eine lokale Installation des todo.service Desktop-Clients ist prinzipiell konfigurationsfrei, das heißt die für den angemeldeten Benutzer relevante Service-Konfiguration wird immer aus der online-Datenbank bezogen. Lediglich für eventuelle Proxy-Zugangsdaten wird eine Installationsspezifische Konfigurationsdatei im Verzeichnis %appdata%/todo.service/desktop angelegt. Daneben weitere Verzeichnisse für Protokolldateien und lokale Zwischenspeicher.
Die Konfiguration besteht aus XML-Dateien, die entweder direkt oder über die Client-Software bearbeitet werden können.
Service Zugriff
Für den Zugriff auf den Online-Service benötigt die Client-Software Zugriff auf folgende Adressen, jeweils per HTTPS-Protokoll (Port 443):
- todosl.documents.azure.com (CosmosDB Datenbank – ab dem 26.04.2021)
- tododev.documents.azure.com (CosmosDB Datenbank – nur bis zum 23.04.2021)
- *.todoservice.app
- todo.todoservice.app (Login-Broker)
- download.todoservice.app (Software-Updates)
- storage.todoservice.app (Dateianhänge)
- debug.todoservice.app (Dienste für Beta-Version)
- img.todoservice.app (Bilder für Bedienungsanleitungen etc.)
Verwendung hinter einem Proxy-Server
In der Konfiguration der Client-Software können Proxy-Einstellungen hinterlegt werden. Wir empfehlen jedoch, die oben genannten Adressen zu den Proxy-Ausnahmen hinzuzufügen.