Probleme mit agorum core client und Doppelklick beheben

Diese Dokumentation hilft Ihnen als Administrator, wenn sich Dokumente aus der Weboberfläche von agorum core per Doppelklick nicht im lokalen Programm öffnen oder der agorum core client keine Verbindung zu agorum core aufbaut. Wie der Doppelklick grundsätzlich funktioniert, beschreibt die Dokumentation agorum core client.

Ablauf des Doppelklicks prüfen

Ein Doppelklick auf ein Dokument in der Weboberfläche von agorum core durchläuft mehrere Stationen. Prüfen Sie sie der Reihe nach, um die Stelle zu finden, an der der Ablauf abbricht:

Die Weboberfläche führt für das Dokument die Aktion zum Öffnen aus. Übernimmt eine Integration oder eine eigene Aktion den Doppelklick, endet der Ablauf hier.
Der Browser übergibt einen Link mit dem Protokoll agorum: an den agorum core client und fragt je nach Einstellung vorher nach.
Der agorum core client liest im Stammverzeichnis der verbundenen Freigabe die Verbindungsdatei .$CONN_INFO$.$$$ und meldet sich bei agorum core an.
Der agorum core client öffnet die Datei über den UNC-Pfad der Freigabe, bei SMB etwa \\server\dms\..., bei WebDAV \\server@SSL\webdav\dms\....
Das Betriebssystem startet das Programm, das mit der Dateiendung verknüpft ist.

Protokoll des agorum core clients auswerten

Der agorum core client schreibt ein Protokoll, an dem Sie erkennen, mit welchem Laufwerk und Server er sich verbindet und ob ein Doppelklick bei ihm ankommt. Die Protokolldatei liegt im Profil des angemeldeten Windows-Benutzers:

%LOCALAPPDATA%\agorum Software GmbH\AgorumClient\<Version>\client.log

Gehen Sie wie folgt vor, um ein ausführliches Protokoll zu erstellen:

Beenden Sie den agorum core client über sein Symbol im Infobereich der Taskleiste mit Beenden.
Starten Sie den agorum core client mit dem Parameter -d, siehe Verbindung des agorum core clients festlegen. Beispiel für das Standard-Installationsverzeichnis:
```
"C:\Program Files (x86)\agorum\agorum core Client\AgorumClient.exe" -d
```
Führen Sie den Doppelklick in der Weboberfläche erneut aus.
Öffnen Sie die Datei client.log und werten Sie die letzten Einträge aus.

Ergebnis: Die Einträge zeigen, wie weit der Ablauf gekommen ist.

Eintrag im Protokoll	Bedeutung
`GetConnectionInfo(): considering X, DriveFormat: ...`	Der agorum core client prüft das Laufwerk X: auf eine Verbindung zu agorum core.
`GetConnectionInfo(): using explicit drive letter` oder `using explicit UNC path`	Der agorum core client wurde mit `-l` oder `-u` gestartet.
`Using protocol: https, host: ...`	Protokoll und Server, mit denen sich der agorum core client verbindet.
`Invoking Open(\\...)`	Der Doppelklick ist beim agorum core client angekommen. Er öffnet die Datei über den angegebenen Pfad.
`NotSupportedException` mit dem Text Das angegebene Pfadformat wird nicht unterstützt	Der agorum core client wurde mit `-u` und einer URL statt eines UNC-Pfads gestartet.

Bekannte Probleme beim Doppelklick und ihre Lösungen

Die folgenden Abschnitte beschreiben typische Fehlerbilder beim Öffnen von Dokumenten per Doppelklick mit dem agorum core client, ihre Ursachen und Lösungen.

Nach dem Doppelklick passiert nichts

Symptom	Der Browser zeigt keine Nachfrage, kein Programm startet und im Protokoll des agorum core clients steht kein Eintrag `Invoking Open`.
Typische Ursache	Der Doppelklick wird für diese Dateiformate nicht an den agorum core client übergeben. Das ist der Fall, wenn eine Integration den Doppelklick übernimmt, etwa Integration \| ONLYOFFICE für Office-Dokumente, oder wenn eine eigene Aktion über einen Selektor für diese Dateien greift. Ist Integration \| ONLYOFFICE installiert, aber nicht eingerichtet, erscheint beim Doppelklick eine Fehlermeldung zum Widget `agorum.onlyoffice.editor`.
Lösung	Prüfen Sie, welche Integrationen den Doppelklick verwenden, siehe Integration \| ONLYOFFICE. Prüfen Sie eigene Aktionen der Befehlsgruppe Öffnen und ihre Selektoren, siehe Selektoren.

Der Browser fragt bei jedem Doppelklick nach

Symptom	Der Browser zeigt bei jedem Doppelklick eine Nachfrage, etwa AgorumClient öffnen in Chrome.
Typische Ursache	Die Auswahl für `agorum:`-Links ist im Browser nicht gespeichert, oder die Freigabe per Richtlinie fehlt. In Chrome wirkt nur der Eintrag `URLAllowlist`. Der ältere Eintrag `URLWhitelist` wirkt in aktuellen Chrome-Versionen nicht mehr.
Lösung	Geben Sie `agorum:`-Links im Browser frei, siehe Clientprogramme per Doppelklick öffnen.

Der Browser fragt nach, aber das Dokument öffnet sich nicht

Symptom	Nach der Bestätigung im Browser öffnet sich kein Programm.
Typische Ursache	Der agorum core client ist nicht installiert, nicht als Programm für `agorum:`-Links registriert oder findet keine Verbindung zu agorum core.
Lösung	Prüfen Sie in der Registry von Windows, dass der folgende Schlüssel auf `AgorumClient.exe` zeigt: HKEY_CLASSES_ROOT\agorum\shell\open\command Installieren Sie andernfalls den agorum core client neu, siehe agorum core client auf Windows installieren. Werten Sie danach das Protokoll des agorum core clients aus.

Der agorum core client baut keine Verbindung auf

Symptom	Das Symbol des agorum core clients bleibt grau, oder das Protokoll enthält keinen Eintrag `Using protocol`.
Typische Ursache	Beim Start des agorum core clients war kein Netzlaufwerk zu agorum core verbunden. Der agorum core client wurde mit `-u` und einer URL wie `https://server/webdav/dms` gestartet statt mit einem UNC-Pfad. Der Server ist unter dem Hostnamen aus dem Pfad der Freigabe nicht über Protocol und Port aus der MetaDB erreichbar, etwa weil ein Reverse Proxy nur WebDAV weiterleitet oder einen anderen Port verwendet.
Lösung	Verbinden Sie das Netzlaufwerk vor dem Start des agorum core clients, verwenden Sie bei `-u` die UNC-Schreibweise und prüfen Sie die Verbindungseinstellungen, siehe Verbindung des agorum core clients festlegen.

Das WebDAV-Laufwerk lässt sich nicht verbinden

Symptom	Die Verbindung eines agorum core cloud shares unter Windows scheitert, etwa mit Systemfehler 1244, obwohl Benutzername und Passwort stimmen. Ohne Laufwerk kann auch der agorum core client keine Verbindung über WebDAV aufbauen.
Typische Ursache	Windows vertraut dem SSL-Zertifikat des Servers nicht, etwa bei einem selbstsignierten Zertifikat. Der Windows-Dienst WebClient baut WebDAV-Verbindungen über HTTPS nur zu Servern mit vertrauenswürdigem Zertifikat auf.
Lösung	Verwenden Sie ein gültiges Zertifikat oder installieren Sie das Zertifikat auf dem Client als vertrauenswürdig. Weitere Hinweise finden Sie unter agorum core cloud shares (WebDAV) unter Windows verbinden und WebDAV-Probleme unter Windows beheben.

Dokumente eines anderen Systems öffnen sich nicht

Symptom	Sind Netzlaufwerke zu mehreren agorum core Systemen verbunden, funktioniert der Doppelklick nur in einem der Systeme.
Typische Ursache	Der agorum core client verbindet sich nur mit einem agorum core System. Ohne Parameter wählt er das Laufwerk mit dem alphabetisch ersten Buchstaben.
Lösung	Legen Sie das System mit `-l` oder `-u` fest, siehe Laufwerk automatisch wählen.

Dokumente ohne agorum core client lokal öffnen

Soll auf einem Arbeitsplatz kein agorum core client installiert werden, gibt es zwei Alternativen:

Microsoft Office-Dokumente öffnen Sie über WebDAV direkt in Microsoft Office, siehe MS Office Dokumente direkt über WebDAV öffnen.
Office-Dokumente bearbeiten Sie im Browser mit Integration | ONLYOFFICE.