Desktop-App und Citrix-Client starten

Zweck und Einsatzbereich

NeuraPort enthält zwei unterschiedlich gebaute Desktop-Varianten. Die normale Desktop-App öffnet ein NeuraPort-Fenster und versucht beim Start, ein lokales Backend zu starten. Der Citrix-Client ist ein getrennt gebauter Remote-Client: Er öffnet die zentral bereitgestellte Anwendung und startet kein lokales Backend.

Ob eine Citrix-Veröffentlichung, ein zentraler Dienst oder die dafür erforderliche Zieladresse in Ihrer Umgebung bereitstehen, ist nicht aus dem Projektstand belegbar. Behandeln Sie Citrix daher als IT-konfigurationsabhängige Variante, nicht als automatisch verfügbare Anmeldeoption.

Voraussetzungen und Berechtigungen

Für die normale Desktop-App benötigen Sie eine von Ihrer IT bereitgestellte Installation. Damit sie ein lokales Backend starten kann, muss sie ein passendes Backend-Verzeichnis mit Python-Umgebung finden; außerdem muss der lokale Port 8000 verfügbar sein. Das Startproblem wird nur in der Prozessausgabe protokolliert, nicht als eigener Hinweis in der Oberfläche.

Für den Citrix-Client muss die IT ihn mit Citrix-Modus bauen und veröffentlichen. Er benötigt eine zentral bereitgestellte HTTPS-Adresse. Für den späteren Zugriff gelten die üblichen Anmelde- und Produktberechtigungen; die Citrix-Veröffentlichung selbst ist keine fachliche Rollenberechtigung.

Schritt-für-Schritt-Anleitung

Starten Sie die von Ihrer IT bereitgestellte NeuraPort-Desktop-App.
Warten Sie, bis das NeuraPort-Fenster verfügbar ist, und melden Sie sich mit Ihrem vorgesehenen Zugang an.
Wenn die App keine Verbindung herstellen kann, erfassen Sie Zeitpunkt und beobachtetes Verhalten und geben Sie dies an Ihre IT weiter. Prüfen Sie nicht eigenständig lokale Backend-Dateien oder Ports.
Starten Sie den Citrix-Client nur, wenn Ihre IT ihn veröffentlicht und Ihnen den Zugang bereitgestellt hat.
Wenn Sie Citrix verwenden, arbeitet der Client mit der zentral bereitgestellten Anwendung. Ein lokaler Backend-Start ist dabei nicht vorgesehen.

Feldreferenz

Feld	Pflicht	Bedeutung	Validierung
NEURAPORT_CITRIX_MODE	Ja, für Citrix	IT-Build-Einstellung für den Citrix-Client.	Muss für den Citrix-Build auf `true` gesetzt sein.
VITE_CITRIX_MODE	Ja, für Citrix	Kennzeichnet im Client die Citrix-Variante.	Muss für den Citrix-Build auf `true` gesetzt sein.
CITRIX_API_URL	Ja, für Citrix	Zentrale Zieladresse, die der Citrix-Client lädt.	Muss gesetzt sein und eine absolute HTTPS-Adresse verwenden.
Lokaler Port	Ja, für normale Desktop-App	Port für den lokalen Backend-Start.	Die normale Desktop-App verwendet Port 8000 auf dem lokalen Rechner.

Status und mögliche Übergänge

Auslöser	Ergebnis
Normale Desktop-App startet und findet Backend sowie Python-Umgebung	Sie startet einen lokalen Backend-Prozess und öffnet das NeuraPort-Fenster.
Normale Desktop-App wird geschlossen	Ein von ihr gestarteter lokaler Backend-Prozess wird beendet.
Citrix-Build startet	Der Client fokussiert sein Hauptfenster und startet keinen lokalen Backend-Prozess.
Citrix-Zieladresse ist ungültig	Der Build wird mit einer Konfigurationsmeldung beendet.

Was im Hintergrund passiert

Die normale Desktop-App durchsucht beim Start mehrere mögliche Orte nach einem Backend. Wird dort eine Python-Umgebung gefunden, startet sie den Dienst lokal. Findet sie nichts Passendes oder schlägt der Start fehl, bleibt dies eine Information der Prozessausgabe.

Beim Citrix-Build wird eine gesonderte Konfiguration erzeugt. Sie lädt die zentral angegebene HTTPS-Adresse in einem Fenster. Dadurch besitzt der Citrix-Client keinen zweiten lokalen Datenpfad und startet keinen lokalen Dienst.

Typische Fehler und Lösungen

Beobachtung	Lösung
Die normale Desktop-App öffnet sich, aber eine Verbindung ist nicht möglich.	Geben Sie den Fall an die IT weiter. Dort müssen Backend-Verzeichnis, Python-Umgebung und lokaler Port geprüft werden.
In der Prozessausgabe steht „Failed to start backend: …“.	Die lokale Backend-Umgebung konnte nicht gestartet werden. Lassen Sie die Installation durch die IT prüfen.
Beim Citrix-Build erscheint „CITRIX_API_URL is required“.	Die IT muss die zentrale Zieladresse für den Build festlegen.
Beim Citrix-Build erscheint „CITRIX_API_URL must use HTTPS“.	Verwenden Sie ausschließlich eine absolute HTTPS-Adresse.
Citrix ist nicht verfügbar.	Die Veröffentlichung und die zentrale Zieladresse sind konfigurationsabhängig. Klären Sie die Bereitstellung mit Ihrer IT.