JDisc Connector Add-on: Bekannte Probleme und Lösungen

Das JDisc Connector Add-on (verfügbar seit i-doit v36) ersetzt die klassische JDisc-Integration. Dieser Artikel dokumentiert bekannte Probleme und deren Lösungen.

Sync Profile werden nicht angezeigt / Fehlermeldung

Symptom: Unter "Sync Profiles" erscheint eine rote Fehlermeldung statt der Profile, oder die Liste ist leer.

Mögliche Ursachen:

• GraphQL nicht aktiviert: Das JDisc Connector Add-on erfordert eine aktive GraphQL-Verbindung zum JDisc-Server. Prüfen Sie unter Discovery Server die GraphQL-Konfiguration (Port 443, Protokoll HTTPS).
• Falsche Credentials: Die WebService/GraphQL-Zugangsdaten stimmen nicht. Über den Button "Check GraphQL" die Verbindung testen.
• Browser-Fehler: Mit F12 die Entwicklerkonsole öffnen und auf dem "Console"-Tab nach JavaScript-Fehlern suchen. Diese Informationen helfen dem Support bei der Diagnose.

Sync Profile lassen sich anlegen, aber nicht öffnen (json_decode-Fehler)

Symptom: Ein Sync Profile lässt sich anlegen, beim Aufruf der Profilliste oder beim Öffnen des Profils erscheint jedoch die Meldung "Seems like something went wrong - Please try again by reloading the page." Beim Synchronisieren eines Objekts bleibt das Profil weiterhin auswählbar. Im Apache-Errorlog steht ein Eintrag der Form:

PHP Fatal error: Uncaught TypeError: json_decode(): Argument #1 ($json) must be of type string, null given in .../synetics_jdisc/src/Model/JDiscProfileDao.php

Ursache: Wird in einem Profil eine Objekttyp-Zuordnung ohne Port-Filter gespeichert, bleiben die zugehörigen Datenbankfelder leer (NULL). Beim Anzeigen der Profilliste werden diese Felder gelesen und lösen den Fehler aus.

Lösung: Die leeren Port-Filter-Felder auf einen leeren Wert setzen. Bitte erstellen Sie vorab ein Backup. Die Datenbankzugangsdaten (Benutzer, Datenbankname) finden Sie in der config.inc.php Ihrer i-doit-Installation; passen Sie Benutzer und Datenbanknamen in den folgenden Befehlen entsprechend an.

mysql -u idoit -p idoit_data -e "UPDATE isys_jdisc_object_type_assignment SET isys_jdisc_object_type_assignment__port_filter_type = '[]' WHERE isys_jdisc_object_type_assignment__port_filter_type IS NULL;"

mysql -u idoit -p idoit_data -e "UPDATE isys_jdisc_object_type_assignment SET isys_jdisc_object_type_assignment__port_filter = '[]' WHERE isys_jdisc_object_type_assignment__port_filter IS NULL;"

Nach dem Ausführen lassen sich die betroffenen Profile wieder öffnen und bearbeiten. Eine dauerhafte Behebung ist für eine kommende Version des JDisc Connector Add-ons vorgesehen.

JDisc Connector Add-on nicht sichtbar im Menü

Symptom: Nach der Installation des Add-ons erscheint kein Menüpunkt.

Lösung: Der betroffene Benutzer benötigt Rechte für das JDisc Connector Add-on. Unter Verwaltung > Berechtigungen gibt es einen eigenen Abschnitt für das JDisc Connector Add-on mit granularen Rechten (Dashboard, Geräteliste, Sync Profile, Discovery Server, Logs, Console Commands).

Import-Einstellungen werden überschrieben

Symptom: Konfigurierte Einstellungen im Sync Profile werden nach dem Speichern auf Standardwerte zurückgesetzt.

Status: Bekanntes Problem, an die Entwicklung übergeben. Als Workaround das Profil exportieren und die Konfiguration lokal sichern.

Profil-Filter gehen verloren

Symptom: In Sync Profiles konfigurierte Filter werden nach dem Speichern nicht korrekt übernommen.

Status: Bekanntes Problem, an die Entwicklung übergeben.

Geräteliste zeigt keine Geräte

Symptom: Die Geräteliste im JDisc Connector Add-on ist leer.

Mögliche Ursachen:

• Keine GraphQL-Verbindung: Die Geräteliste erfordert eine aktive GraphQL-Verbindung. Unter "Discovery Server" den Button "Check GraphQL" verwenden.
• JDisc Discovery nicht ausgeführt: Es wurden noch keine Geräte gescannt. Einen Discovery-Lauf starten oder prüfen, ob der JDisc-Server Geräte enthält.

Migration von der klassischen Integration

Beim Installieren des JDisc Connector Add-ons werden vorhandene JDisc-Profile automatisch zu Sync Profiles migriert. Dieser Vorgang ist nicht umkehrbar. Die klassische JDisc-Integration bleibt noch für bis zu 2 Versionen nach v36 verfügbar, wenn das Add-on nicht installiert wird.

Ausführliche Dokumentation: JDisc Connector Add-on in der Knowledge Base