WebAkte ist nicht erreichbar

Zuerst prüfen, ob der Windows-Dienst läuft:

Get-Service MCDMS.WebAkte

Erwartet:

Status : Running

Falls der Dienst gestoppt ist:

Start-Service MCDMS.WebAkte

Danach prüfen, ob der HTTPS-Port lauscht:

netstat -ano | findstr ":8443"

Erwartet:

LISTENING

bzw. auf deutschsprachigen Systemen:

ABHÖREN

Status-Endpunkt prüfen

Invoke-WebRequest `
  https://mcdms-webakte.klinik.local:8443/api/status `
  -UseBasicParsing

Erwartet:

StatusCode : 200

Die Antwort enthält unter anderem:

{
  "Status": "ok",
  "Application": "MCDMS WebServer",
  "Version": "1.0.0.0"
}

Dienst startet nicht

Prüfen:

• stimmt der übergebene APPPATH?
• existiert {APPPATH}\Web?
• existiert {APPPATH}\Web\PROGRAM\MCDMS.WebServer.exe?
• ist die MCDMS5API korrekt installiert?
• läuft die WebAkte als x86-Anwendung?
• besitzt das Dienstkonto die notwendigen Rechte?
• ist die WEB.INI gültig?
• liegt ein Fehler im Log vor?

Logverzeichnis:

{APPPATH}\Web\LOGS

HTTPS funktioniert nicht

DNS prüfen:

Resolve-DnsName mcdms-webakte.klinik.local

Port prüfen:

Test-NetConnection mcdms-webakte.klinik.local -Port 8443

Erwartet:

TcpTestSucceeded : True

SSL-Bindung prüfen:

netsh http show sslcert

URLACL prüfen:

netsh http show urlacl

Browser zeigt Zertifikatswarnung

Prüfen:

• stimmt der aufgerufene DNS-Name mit dem Zertifikat überein?
• enthält das Zertifikat den verwendeten Hostnamen?
• ist das Zertifikat noch gültig?
• besitzt das Zertifikat einen privaten Schlüssel?
• vertraut der Arbeitsplatz der ausstellenden Zertifizierungsstelle?

Bei selbstsignierten Testzertifikaten muss das Zertifikat auf den verwendeten Clients als vertrauenswürdig eingerichtet werden.

WEB.INI prüfen

Für den Produktivbetrieb muss unter [SERVER] beispielsweise stehen:

[SERVER]
EnvironmentName=Production
Prefixes=https://mcdms-webakte.klinik.local:8443/
AllowedHosts=mcdms-webakte.klinik.local
MaxRequestBodyBytes=1048576
AllowInsecureHttpDevelopment=FALSE

Wichtig:

EnvironmentName=Production

und:

AllowInsecureHttpDevelopment=FALSE

Login funktioniert nicht

Die Anmeldung erfolgt über die MCDMS5API.

Prüfen:

• funktioniert der Benutzer im normalen MCDMS?
• ist die 32-Bit-MCDMS5API installiert und registriert?
• läuft die WebAkte als x86-Anwendung?
• stimmt der APPPATH?
• gibt es Fehler im WebAkte-Log?

Relevante Logbereiche:

AUTH
COM

Sitzung läuft ab

Die Sitzungsdauer wird in WEB.INI konfiguriert:

[SESSION]
IdleTimeoutMinutes=30
AbsoluteTimeoutHours=8
MaxSessionsPerUser=3

Nach Ablauf der Sitzung wird beim nächsten Zugriff wieder die Loginseite angezeigt.

Patient wird nicht gefunden

Die Patientenauswahl verwendet die bestehende MCDMS-Konfiguration aus:

{APPPATH}\CONFIG\STDConf.INI

Relevant sind insbesondere:

[DATABASE]
StandardDatabase=...
StandardIDField=...
StandardSQL=...

sowie gegebenenfalls:

[SELECTIONS]

Die verwendete SQL-Abfrage kann den angezeigten Patientenbestand bereits einschränken.

Ein zusätzliches festes 200-Patienten-Limit existiert nicht.

Patientenauswahl ist leer

Prüfen:

• ist STAMMDAT.MDB erreichbar?
• stimmt StandardDatabase?
• liefert StandardSQL Datensätze?
• enthält das Ergebnis das konfigurierte StandardIDField?
• besitzt das Dienstkonto Zugriff auf die Datenbank?

Formular erscheint nicht

Prüfen:

• ist das Formular in FORMULARE.INI vorhanden?
• existiert die unter HTML= konfigurierte Datei?
• liegt sie unter {APPPATH}\Web\HTML?
• ist der Benutzer über Roles= berechtigt?
• liegt das Formular im erwarteten Aktenordner?

Beispiel:

HTML=HTML\Therapie\Ergometertraining.HTML

führt zum Aktenbereich:

Therapie

Aktenordner erscheint nicht

Die Aktenbereiche entsprechen den Unterordnern unter:

{APPPATH}\Web\HTML

Die Reihenfolge wird über:

AKTENSTRUKTUR.INI

gesteuert.

Prüfen:

• existiert der Ordner tatsächlich?
• ist der Name korrekt geschrieben?
• ist es ein normaler Ordner?

Ein vorhandener Aktenordner kann auch ohne konfiguriertes Formular angezeigt werden.

Formular kann nicht gespeichert werden

Prüfen:

Edit=TRUE

Zusätzlich:

• Database= korrekt?
• SQL-Tabelle vorhanden?
• SQL-Verbindung erreichbar?
• SQL-Schreibrechte vorhanden?
• HTML-Felder passen zu den SQL-Spalten?
• ScriptSaveHTML erfolgreich, falls konfiguriert?
• passen die eingegebenen Werte zum SQL-Datentyp?

SQL-Fehler erscheinen im Log unter:

SQL

Formular lädt nicht

Prüfen:

• HTML-Datei vorhanden?
• Database= korrekt?
• SQL-Tabelle erreichbar?
• gegebenenfalls ScriptLoadHTML korrekt?
• existiert ein konfiguriertes Script?

Scriptfehler erscheinen unter:

SCRIPT

Löschen funktioniert nicht

Prüfen:

Delete=TRUE

Falls ein Delete-Script konfiguriert ist:

ScriptDelete=CONFIG\Scripts\WEB\delete.mcfscr

muss dieses erfolgreich ausgeführt werden.

Ohne Delete-Script:

ScriptDelete=

erfolgt die Löschung direkt über die generische SQL-Logik.

Duplizieren wird nicht angeboten

Prüfen:

MultiRecord=TRUE
AllowDuplicate=TRUE

AllowDuplicate=TRUE setzt MultiRecord=TRUE voraus.

Script wird nicht ausgeführt

Prüfen:

• ist der Pfad relativ zu {APPPATH}?
• existiert die .MCFSCR-Datei?
• liegt sie innerhalb des APPPATH?
• ist die Dateiendung korrekt?
• enthält der Pfad keine unzulässige Pfadnavigation?

Beispiel:

ScriptLoadHTML=CONFIG\Scripts\WEB\load.mcfscr

Mehrere Scripts:

ScriptLoadHTML=CONFIG\Scripts\a.mcfscr;CONFIG\Scripts\b.mcfscr

werden von links nach rechts ausgeführt.

„Zuletzt“ zeigt keine Patienten

Prüfen:

[RECENT]
Enabled=TRUE

Die Anzahl der im Web angezeigten Patienten wird über:

[PATIENT]
RecentPatientCount=10

gesteuert.

Die vorhandene MCDMS-Datei befindet sich unter:

{APPPATH}\CONFIG\USER\<LOGINNAME>.VRL

Logdateien

Die Logs befinden sich unter:

{APPPATH}\Web\LOGS

Beispiel:

D:\Kliniken\KLINIK\MCDMS\Web\LOGS

Dateiname:

MCDMS-WebAkte-YYYY-MM-DD.log

Typische Bereiche:

AUTH
COM
SCRIPT
SQL
FORM
CONFIG
VRL
HTTP

Es werden nur WARN– und ERROR-Meldungen protokolliert.

Wenn dort keine Logdatei vorhanden ist, ist seit dem letzten Start möglicherweise noch keine protokollierbare Warnung oder kein Fehler aufgetreten.