Rückwärtskompatibilität

Abwärtskompatibilität

Der DMS Mobile DESK kann auch mit älteren Agenten verbunden werden. Dies stellt sicher, dass neue Versionen der App veröffentlicht werden können, ohne dass alle Agenten sofort aktualisiert werden müssen. In diesem Fall zeigt die App einfach eine Warnung an, dass einige Funktionen möglicherweise nicht vollständig verfügbar sind:

Sie sind mit einer veralteten Server-Schnittstelle verbunden. Um sicherzustellen, dass die Anwendung wie erwartet funktioniert, wenden Sie sich bitte an Ihren Administrator, um die Schnittstelle (On-Premise-Agent) auf mindestens Version … zu aktualisieren.

Sobald der Agent aktualisiert ist, verschwindet diese Warnung automatisch.

Bekannte Probleme mit alten Agenten

Leider ist es oft sehr schwierig, 100% Abwärtskompatibilität zu garantieren. Obwohl wir unser Bestes tun, gelingt uns das nicht immer. Nachfolgend sind die Punkte aufgeführt, bei denen uns bekannt ist, dass die Abwärtskompatibilität mit einem alten Agenten nicht gegeben ist.

Agent v1.1.36: Hochladen neuer Dokumentversionen schlägt fehl

Der DMS Mobile DESK verhindert das Hochladen von Dokumenten mit unbekannten Dateierweiterungen. Leider überprüft der On-Premise-Agent in Version 1.1.36 die Dateierweiterung fälschlicherweise basierend auf dem Dokumenttitel anstatt auf dem Dateinamen. In einer neueren Version der App wird der Titel aus dem Dateinamen ohne die Erweiterung ermittelt. Dadurch kann der Agent in Version 1.1.36 die Dateierweiterung nicht mehr überprüfen und erlaubt das Hochladen nicht. Der Benutzer sieht einen Fehler, und im Agentenprotokoll wird eine nicht autorisierte Dateierweiterung erwähnt.
Solange der Agent nicht aktualisiert wurde, kann dieses Problem umgangen werden, indem die Dateierweiterung beim Hochladen in der App manuell zum Dokumenttitel hinzugefügt wird.

Agent v1.5.30: Ladefehler mit DMS 7.5

Der DMS Mobile DESK ist besonders langsam in Verbindung mit DMS 7.5 und zeigt Fehler beim Suchen und Öffnen von Dateien und Dokumenten. Der Grund ist die Verwendung der überlasteten DMS-API-Methode ValueStore.GetKeys(ids) zur Erkennung aktiver Co-Authoring-Sitzungen, die erst mit DMS 7.6.302 eingeführt wurde. Ab Version 1.6 ignoriert der DMS Mobile DESK diese Methode bei der Verwendung von DMS 7.5.

Agent v1.8.10: Verbindung zum SQL Server ohne explizites Zertifikatsvertrauen

Der STP.Documents On-Premise-Agent verbindet sich mit dem SQL Server, um seine Verbindungsdaten zu speichern. Vor Version 1.9 war dies ohne explizites Vertrauen in das Zertifikat des SQL Servers möglich. Da der SQL Server in der Regel mit einem selbstsignierten X.509-Zertifikat installiert wird, muss die ConnectionString des Agenten nach dem Update auf Version 1.9 leicht angepasst werden. Die ConnectionString befindet sich in appsettings.json im Programmverzeichnis (C:Files (x86)AGDocuments OnPremise Agent). Hier muss der zusätzliche Parameter TrustServerCertificate=True angegeben werden. Die ConnectionString sieht dann so aus:

{
    ...
    "ConnectionStrings": {
        "AgentDb": "Server=...;Database=...;User=...;Password=...;TrustServerCertificate=True"
    },
    ...
}

Wenn der Agent neu installiert wird, ist dieser Parameter automatisch enthalten. Nur nach einem Update von einer früheren Version muss er manuell hinzugefügt werden. Nach der Anpassung der ConnectionString muss der Agentendienst einmal neu gestartet werden.
In seltenen Fällen kann es vorkommen, dass der Installer den Aktualisierungsprozess abschließt, aber nicht alle Dateien im Programmverzeichnis aktualisiert. Im Protokoll im Programmdataverzeichnis (C:AGDocuments OnPremise Agent) können dann MissingMethodExceptions zu sehen sein. In diesem Fall muss der Agent neu installiert werden. Zuerst sollte die Konfigurationsdatei appsettings.json gesichert werden. Dann muss der Agent deinstalliert werden. Anschließend sollte das alte Programmverzeichnis entfernt werden, damit keine DLL-Dateien zurückbleiben. Nun kann der Agent neu installiert werden. Schließlich kann die gesicherte Konfigurationsdatei wiederhergestellt und der Agentendienst einmal neu gestartet werden. Der Agent sollte nun mit der bekannten Konfiguration starten und sich wie gewohnt mit der Cloud verbinden.

Weitere bekannte Auswirkungen

In seltenen Fällen wirkt sich die Einführung einer neuen Funktion auf bereits bekannte und vertraute Funktionen aus. Nachfolgend sind die Punkte aufgeführt, bei denen uns bekannt ist, dass die Abwärtskompatibilität nicht gegeben ist.

Herunterladen und Hochladen nicht mehr für alle verfügbar

Das Herunterladen und Hochladen von Dokumenten war in einer früheren Version der App für alle Benutzer verfügbar. In einer neueren Version wurden Funktionsberechtigungen eingeführt, sodass diese Funktionen nur bestimmten Benutzern zur Verfügung gestellt werden können. Zum Schutz von Kanzleidokumenten und im Hinblick auf prominente Datenschutzrichtlinien wurden diese neuen Funktionsberechtigungen nicht automatisch bestehenden Benutzern zugewiesen.
Der Administrator kann diese Berechtigungen jederzeit im Cloud UserManagement erteilen und entziehen.

Aufgaben nicht mehr für alle verfügbar

Das Arbeiten mit Aufgaben war in einer früheren Version der App für alle Benutzer verfügbar. In einer neueren Version wurden Funktionsberechtigungen eingeführt, sodass diese Funktionen nur bestimmten Benutzern zur Verfügung gestellt werden können. Für ein granulareres Rechteprofil wurden diese neuen Funktionsberechtigungen nicht automatisch bestehenden Benutzern zugewiesen. Externe Benutzer sollten beispielsweise diese Rechte nicht automatisch erhalten.
Der Administrator kann diese Berechtigungen jederzeit im Cloud UserManagement erteilen und entziehen.

winsolvenz-Teilnehmer nicht mehr für alle verfügbar

Teilnehmerinformationen aus winsolvenz waren in einer früheren Version der App für alle Benutzer verfügbar, unabhängig davon, ob sie in winsolvenz autorisiert waren. In einer neueren Version wurde eine Funktionsberechtigung eingeführt, sodass diese Funktion nur bestimmten Benutzern zur Verfügung gestellt werden kann. Für ein granulareres Rechteprofil wurde diese neue Funktionsberechtigung nicht automatisch bestehenden Benutzern zugewiesen. Externe Benutzer sollten beispielsweise dieses Recht nicht automatisch erhalten.
Der Administrator kann diese Berechtigung jederzeit im Cloud UserManagement erteilen und entziehen.

Co-Authoring nicht mehr für alle verfügbar

Der Beitritt zu aktiven Co-Autorensitzungen war in einer früheren Version der App für alle Benutzer verfügbar. In einer neueren Version wurde eine Funktionsberechtigung eingeführt, sodass diese Funktion nur bestimmten Benutzern zur Verfügung gestellt werden kann. Für ein detaillierteres Rechteprofil wurde diese neue Funktionsberechtigung nicht automatisch bestehenden Benutzern zugewiesen. Externe Benutzer sollten beispielsweise dieses Recht nicht automatisch erhalten.
Der Administrator kann diese Berechtigung jederzeit im Cloud UserManagement erteilen und entziehen.