Lokale Vorschau – Verbindung zu localhost fehlgeschlagen¶

Zeigt eine eingebettete Ansicht im Windows-Client statt des Inhalts einen Verbindungsfehler zu localhost, können Sie testweise die lokale Adresse auf 127.0.0.1 umstellen. Ein mögliches Fehlerbild ist ERR_CONNECTION_REFUSED bei einer Adresse wie http://localhost:9404/localfiles/1.

localhost bezeichnet den Rechner, auf dem der Windows-Client läuft. Bei Citrix/XenApp oder Remotedesktop ist das der Sitzungsserver. Der Hinweis betrifft die lokale Vorschau, nicht die Adresse des zentralen Web-Clients oder Backend-Servers. Die Umstellung ist ein Diagnoseversuch und behebt nicht jede Ursache einer fehlgeschlagenen Verbindung.

Zunächst für einen Benutzer testen¶

Schließen Sie Zeta Test Management in der betroffenen Windows-Sitzung vollständig.
Öffnen Sie auf diesem Rechner den Ordner Applications Ihrer Zeta-Test-Management-Installation. Verwenden Sie den Ordner der tatsächlich gestarteten Anwendung; zum Schreiben können Administratorrechte erforderlich sein.
Sichern Sie eine bereits vorhandene Konfigurationsdatei. Legen Sie für den betroffenen Windows-Anmeldenamen eine Datei config.<Anmeldename>@<Domäne>.json an, beispielsweise config.mueller@FIRMA.json. Die Platzhalter einschließlich der spitzen Klammern werden durch die tatsächlichen Werte ersetzt. Gemeint ist die Windows-Anmeldung, nicht der Benutzername innerhalb eines Testprojekts.
Falls bisher nur eine Datei config.<Anmeldename>.json vorhanden ist, übernehmen Sie deren Einstellungen in die neue Datei: Die Datei mit Domäne ersetzt sie als benutzerbezogene Konfiguration. Tragen Sie anschließend folgende Einstellung ein:

{
  "Settings": [
    {
      "Name": "htmlEditor.localHost.intelligent",
      "Value": "false"
    }
  ]
}

Existiert die Datei bereits, ergänzen Sie nur den Eintrag in der vorhandenen Settings-Liste oder ändern Sie dessen bisherigen Wert. Behalten Sie andere Einstellungen bei. Zwischen mehreren Einträgen steht ein Komma; nach dem letzten Eintrag steht keines. Speichern Sie die Datei als UTF-8 mit der Endung .json, nicht .json.txt.

Starten Sie Zeta Test Management neu und öffnen Sie die betroffene Ansicht erneut.

Mit "false" verwendet die lokale Vorschau 127.0.0.1. Ohne Eintrag oder mit "true" wählt die Anwendung automatisch: Sie verwendet localhost, wenn die Namensauflösung dafür 127.0.0.1 liefert, andernfalls direkt 127.0.0.1.

Einstellung für alle Benutzer¶

Für alle Benutzer dieser Installation kann derselbe Eintrag in der Datei config.json im Applications-Ordner gesetzt werden. Eine benutzerbezogene Einstellung hat Vorrang. Die Anwendung sucht zuerst config.<Anmeldename>@<Domäne>.json; nur wenn diese Datei fehlt, verwendet sie config.<Anmeldename>.json.

Bei mehreren Sitzungsservern muss die Einstellung in der jeweils verwendeten Installation liegen. Bereits laufende Clients übernehmen sie erst nach einem Neustart.

Ergebnis prüfen und Änderung zurücknehmen¶

Bei aktivierter Protokollierung sollte die Startmeldung des lokalen Webservers nach der Umstellung eine Adresse mit http://127.0.0.1: enthalten. Die Portnummer wird automatisch gewählt und kann sich beim nächsten Start ändern; 9404 ist nur ein Beispiel.

Bleibt der Fehler bestehen, notieren Sie die betroffene Ansicht, den Rechnernamen und die Uhrzeit und geben Sie das neue ztm.log an den Support weiter. Deaktivieren Sie die Protokollierung nach der Diagnose wieder.

Zum Zurücknehmen stellen Sie den vorherigen Wert wieder her oder entfernen nur den neu ergänzten Eintrag und starten den Client neu. Wurde die Datei ausschließlich für diesen Test angelegt, können Sie sie entfernen. Ohne benutzerbezogenen Eintrag gilt gegebenenfalls wieder die Einstellung aus config.json.