App Builder-Fehlerbehebung

Diese Anleitung behandelt häufige Fehler und Probleme bei der Installation, Konfiguration und Verwendung von Jitterbit App Builder. Beginnen Sie mit den Diagnoseschritten unten und suchen Sie dann Ihr spezifisches Problem im relevanten Abschnitt.

Eine einheitliche Referenz, die Integrations-, Automatisierungs-, API-Management-, EDI- und App-Entwicklungsprobleme an einem Ort abdeckt, finden Sie im Harmony-Fehlerbehebungsleitfaden.

Diagnoseschritte

Überprüfen Sie Ihren Build anhand der Versionshinweise

App Builder wird als diskrete On-Premises-Versionen bereitgestellt (App Builder 4.0 und später; die 3.x und frühere Linie war unter dem Namen Vinyl bekannt, dessen Dokumentation separat gepflegt wird), und jede Version enthält angesammelte Fixes. Das Symptom, das Sie verfolgen, kann bereits in einem neueren Build behoben sein. Notieren Sie daher den Build, den Sie ausführen, und durchsuchen Sie die App Builder-Versionshinweise nach einem entsprechenden Fix, bevor Sie weitere Untersuchungen durchführen. Ein Upgrade auf die neueste verfügbare Version ist die schnellste Möglichkeit, dies auszuschließen.

Bestimmen Sie, ob der Fehler client-seitig oder server-seitig ist

Client-seitige und server-seitige Fehler werden an verschiedenen Stellen diagnostiziert, und nur server-seitige Fehler werden in den App Builder-Protokollen erfasst:

• Server-seitige Fehler treten in App Builder selbst auf und werden fast immer in den Anwendungsprotokollen erfasst. Sie können die Details später abrufen, auch wenn der Benutzer die Meldung bei ihrer Anzeige nicht kopiert hat.
• Client-seitige Fehler treten im Browser auf dem eigenen Computer des Benutzers auf und werden von App Builder nicht erfasst. Um die Details anzuzeigen, öffnen Sie die Entwicklertools des Browsers (F12 in Chrome oder Edge) und überprüfen Sie das Panel Konsole, während Sie den Fehler reproduzieren.

Ein Fehler, der einen Url-Wert meldet und auf eine JavaScript-Datei (.js) verweist, ist client-seitig. Häufige Ursachen sind das Design der Seite, ein Problem in der App-Vorlage oder einem Widget oder eine langsame oder unterbrochene Netzwerkverbindung.

Das Panel Netzwerk des Browsers zeigt auch den HTTP-Statuscode an, der für jede Anfrage zurückgegeben wird. Dies unterscheidet einen Client-Fehler (z. B. 401 oder 404) von einem Server-Fehler (z. B. 500 oder 504). Siehe HTTP-Fehlercodes identifizieren.

Überprüfen Sie die Anwendungsprotokolle

App Builder erfasst Protokolle sowohl im Produkt als auch als Dateien auf dem Server. Von IDE > Überwachung können Sie mehrere Protokolltypen anzeigen, die jeweils für eine andere Art von Problem geeignet sind:

• Datenbankprotokolle und Speicherprotokolle: Anwendungsfehler- und Ereigniseinträge, einschließlich Stack-Traces. Beginnen Sie hier bei den meisten Fehlern. Einträge werden nach LogId sortiert. Sortieren Sie daher in absteigender Reihenfolge, um den neuesten Fehler nach oben zu bringen.
• Ereignisprotokolle und Systemereignisse: Hintergrund-Ereignis- und Systemaktivität.

Um mehr Details zu erfassen, wählen Sie einen Protokolleintrag aus, klicken Sie auf Konfiguration bearbeiten, und erhöhen Sie die Protokollausführlichkeit (z. B. auf Trace). Um auch die Anwendungsdaten einzubeziehen, die App Builder normalerweise in Protokollen maskiert, aktivieren Sie Sichere Daten protokollieren. Siehe Sichere Daten protokollieren.

Verwenden Sie im selben Dialog Disk-Protokolle herunterladen, um die Disk-Protokolle von allen Servern in der Umgebung herunterzuladen. Die Dateien werden auch in das Verzeichnis logs unter dem App Builder-Installationsstamm geschrieben. Alle Überwachungsoptionen finden Sie unter IDE-Überwachungsseite.

Aktivieren Sie die CData-Datenbankserver-Protokollierung

Viele App Builder-Konnektoren basieren auf CData. Wenn ein Problem einen dieser Datenbankserver betrifft, aktivieren Sie die Protokollierung dafür und laden Sie die Protokolldatei herunter, um die Details auf Konnektor-Ebene zu überprüfen. Siehe CData-Datenbankserver-Protokollierung aktivieren.

Überprüfen Sie Sitzungs-, Seitenaufrufs- und REST-Protokolle

Je nach Problem können andere Protokolle nützlicher sein als die Anwendungsprotokolle:

• Sitzungs- und Seitenaufrufs-Protokolle: Sitzungsprotokolle helfen bei Authentifizierungs-, Autorisierungs- und Identitätsproblemen. Seitenaufrufs-Protokolle zeigen, welche Seiten ein Benutzer besucht hat. Siehe Seitenaufrufs- und Sitzungsaktivitätsprotokollierung.
• Registerkarte „Sitzungen": Von Überwachung > Sitzungen aus sehen Sie, wer derzeit angemeldet ist, die letzte Aktivität jeder Sitzung und die Seitenaufrufs-Anzahl.
• REST-Protokolle: Beheben Sie Probleme bei eingehenden und ausgehenden API-Aufrufen und Webhooks. Siehe REST-Protokollierung konfigurieren.

Kopieren Sie Fehlermeldungen aus der Benutzeroberfläche

Wenn eine Fehlermeldung in der App Builder-Benutzeroberfläche angezeigt wird, verwenden Sie die Schaltfläche Kopieren im Fehlerbereich, um den vollständigen Fehlertext in die Zwischenablage zu kopieren. Fügen Sie ihn in einen Text-Editor oder einen Support-Fall ein, um ihn leichter überprüfen zu können. Scrollen Sie im kopierten Protokoll zu den Ausnahmedaten, normalerweise der aussagekräftigste Teil und oft ausreichend, um den Fehler selbst zu beheben. Wenn Sichere Daten protokollieren aktiviert ist, werden die SQL-Abfragemetadaten darunter angezeigt.

Netzwerkverbindungsprobleme diagnostizieren

Verbindungsfehler treten auf einem von zwei Pfaden auf: vom Browser eines Benutzers zum App Builder-Server oder vom App Builder-Server zu einem anderen Server wie einer Datenbank, einer API oder einem SMTP-Host. Führen Sie diese Befehle auf dem Computer am Anfang des fehlerhaften Pfads aus, damit ein Test vom App Builder-Server auf diesem Server und nicht auf einer Arbeitsstation ausgeführt wird:

• telnet <hostname> <port> oder in PowerShell Test-NetConnection <hostname> -Port <port>: bestätigt, dass eine TCP-Verbindung zum Port geöffnet werden kann. Ein Fehler deutet auf eine Firewall-Regel, einen falschen Port oder einen nicht lauschenden Dienst hin.
• nslookup <hostname>: bestätigt, dass der Hostname in die erwartete Adresse aufgelöst wird.
• ping <hostname> und tracert <hostname>: zeigen, ob der Host erreichbar ist und welche Route genommen wird, in Netzwerken, die ICMP-Datenverkehr zulassen.
• ipconfig /displaydns: listet zwischengespeicherte DNS-Einträge auf, was nach einer DNS-Änderung nützlich ist.

Häufige Ursachen für Verbindungsfehler sind ein falscher Hostname oder Port, DNS-Auflösung, eine Firewall oder Allowlist, die einige IP-Adressen des Remote-Dienstes auslässt (einige Dienste veröffentlichen einen großen Bereich), IIS-Konfiguration und ein überladener oder falsch konfigurierter Server zwischen den beiden Endpunkten.

HAR-Datei erfassen

Eine HAR-Datei (HTTP Archive) zeichnet jeden Netzwerkantrag auf, den ein Browser beim Laden einer Seite oder beim Ausführen einer Aktion gestellt hat. Sie ist nützlich, wenn eine Seite langsam lädt, nie fertig lädt oder fehlschlägt, ohne einen protokollierten Fehler zu erzeugen, und der Jitterbit-Support kann Sie auffordern, eine bereitzustellen. Für das Verfahren siehe .har-Datei generieren.

Prozess-Dump abrufen

Wenn App Builder langsam reagiert oder nicht reagiert, kann das Abrufen eines Prozess-Dumps aus dem w3wp.exe IIS-Arbeitsprozess dem Support helfen, die Ursache zu diagnostizieren. Siehe Dump-Datei abrufen für Anweisungen.

Installation und Start

App Builder startet nicht mit einem 500-Fehler

• Symptom: App Builder startet nicht auf IIS und gibt einen HTTP 500-Fehler zurück.
• Mögliche Ursache: Das ASP.NET Core Runtime Hosting Bundle, das App Builder benötigt, ist nicht auf dem Windows-Server installiert, daher kann IIS die Anwendung nicht starten.
• Lösung:
  1. Installieren Sie das von App Builder benötigte ASP.NET Core Runtime Hosting Bundle, wie in den Systemanforderungen aufgeführt.
  2. Starten Sie IIS neu und überprüfen Sie, ob App Builder korrekt geladen wird.

App Builder startet nicht mit einem HTTP 500.30-Fehler

• Symptom: App Builder startet nicht und gibt Folgendes zurück:

  HTTP Error 500.30 - ASP.NET Core app failed to start
  

• Mögliche Ursache: Die Identität des IIS-Anwendungspools hat keinen vollständigen Zugriff auf den App Builder-Stammordner, daher kann die Anwendung nicht starten.

• Lösung:

  1. Gewähren Sie der Identität des App Builder-Anwendungspools (standardmäßig IIS AppPool\Vinyl) Vollzugriff auf den App Builder-Stammordner. Siehe Berechtigungen festlegen.
  2. Starten Sie den Anwendungspool neu und laden Sie App Builder dann neu.

App Builder gibt einen HTTP 503-Fehler zurück

• Symptom: Das Öffnen von App Builder gibt folgende Meldung zurück:

  HTTP Error 503. The service is unavailable.
  

• Mögliche Ursache: Der IIS-Anwendungspool für App Builder ist beendet.

• Lösung:

  1. Öffnen Sie IIS Manager und wählen Sie Application Pools aus.
  2. Wählen Sie den App Builder-Anwendungspool aus (standardmäßig Vinyl), und wählen Sie dann Start aus.

  Hinweis

  Wenn der Anwendungspool unmittelbar nach dem Start erneut beendet wird, schlägt App Builder wahrscheinlich beim Start fehl. Überprüfen Sie die Anwendungsprotokolle und die Windows-Ereignisanzeige auf den zugrunde liegenden Fehler.

App Builder startet, erstellt aber keine Datenbanken

• Symptom: App Builder startet erfolgreich, aber es werden keine Datenbanken auf dem SQL Server erstellt.
• Mögliche Ursache: Die Verbindungsdatei hat eine falsche Erweiterung (z. B. .txt statt .xml).
• Lösung: Suchen Sie die App Builder-Verbindungsdatei und bestätigen Sie, dass sie die Erweiterung .xml verwendet. Benennen Sie die Datei um, wenn die Erweiterung falsch ist, und starten Sie App Builder neu. Wenn App Builder startet, aber einen Verbindungsfehler zurückgibt, anstatt stillschweigend keine Datenbanken zu erstellen, siehe Fehler beim Laden der Datenbankverbindungsinformationen.

Fehler beim Laden der Datenbankverbindungsinformationen

• Symptom: App Builder gibt den folgenden Fehler zurück:

  An error occurred while attempting to load the database connection information.
  

• Mögliche Ursache: Die Datei Connection.xml fehlt oder enthält falsche Verbindungsdaten.

• Lösung:

  • Ersetzen oder aktualisieren Sie Connection.xml mit den korrekten Verbindungsdaten, und starten Sie App Builder neu. Siehe Verbindungsdatei erstellen.
  • Wenn App Builder ohne Fehler startet, aber keine Datenbanken erstellt, siehe App Builder startet, erstellt aber keine Datenbanken.

App Builder wird mit fehlenden oder beschädigten Stilen geladen

• Symptom: App Builder startet, aber Seiten werden mit fehlenden oder beschädigten Stilen (CSS) angezeigt.
• Mögliche Ursache: Die Installations-ZIP-Datei wurde nicht entsperrt, bevor sie extrahiert wurde. Windows kennzeichnet Dateien, die von einem anderen Computer heruntergeladen wurden, als blockiert (das „Mark of the Web"), und das Extrahieren eines noch blockierten Archivs überträgt diese Kennzeichnung auf die extrahierten Dateien, was verhindern kann, dass die Style-Assets von App Builder korrekt geladen werden.
• Lösung:
  1. Löschen Sie die extrahierten Dateien.
  2. Entsperren Sie die ursprüngliche ZIP-Datei: Klicken Sie mit der rechten Maustaste darauf, wählen Sie Eigenschaften aus, öffnen Sie die Registerkarte Sicherheit, und wählen Sie Entsperren aus. Siehe Software abrufen und entpacken.
  3. Extrahieren Sie die ZIP-Datei erneut, und starten Sie dann die Installation oder das Upgrade neu.

Lizenzupload schlägt fehl

• Symptom: Das Hochladen einer Lizenzdatei schlägt mit einem der folgenden Fehler fehl:

  An unknown error occurred.
  

  405 POST Method not allowed
  

  Failed to deserialize license (d3fc6d4e835e)
  

• Mögliche Ursache: WebDAV ist auf IIS installiert oder aktiviert und kann die POST-Anfrage beeinträchtigen, die zum Hochladen der Lizenz verwendet wird.

• Lösung:
  1. Deinstallieren oder deaktivieren Sie das WebDAV-Modul in IIS.
  2. Versuchen Sie, die Lizenz erneut hochzuladen.
  3. Wenn WebDAV für andere Anwendungen auf dem Server erforderlich ist, wenden Sie sich an den Jitterbit-Support, um Anleitung zur Konfiguration beider Dienste für die Koexistenz zu erhalten.

App Builder startet nach einem Neustart des Servers nicht automatisch

• Symptom: App Builder wird nach einem Neustart des Windows-Servers nicht automatisch verfügbar und erfordert eine manuelle erste Anfrage zum Initialisieren der Anwendung.
• Lösung: Weitere Schritte finden Sie unter Troubleshoot auto start behavior.

Docker-Bereitstellung: App Builder 4.x-Lizenz kann nicht in der Benutzeroberfläche hochgeladen werden

• Symptom: Nach dem Upgrade von Vinyl 3.3 auf App Builder 4.x auf Docker schlägt das Hochladen der App Builder-Lizenz über die App Builder-Benutzeroberfläche fehl oder die Option ist nicht verfügbar.
• Mögliche Ursache: App Builder 4.x Docker-Bereitstellungen unterstützen das Hochladen von Lizenzen über die Benutzeroberfläche nicht.
• Lösung: Stellen Sie die Lizenz mit einer der folgenden Methoden bereit:
  • Legen Sie in der Datei docker-compose.yml die Umgebungsvariable License__LicenseKey auf den base64-codierten App Builder 4.x-Lizenzschlüssel fest.
  • Fügen Sie den Lizenzschlüssel zur Datei appsettings.json im Unterverzeichnis data des Docker Compose-Verzeichnisses hinzu.

Hochverfügbarkeit: Alle Instanzen müssen die gleiche appsettings.json verwenden

• Symptom: Bei einer Hochverfügbarkeits-Bereitstellung verhalten sich einige App Builder-Knoten anders als andere (z. B. funktioniert die Authentifizierung auf einigen Knoten, aber nicht auf anderen, oder die Datenverschlüsselungsschlüssel sind über Knoten hinweg inkonsistent).
• Mögliche Ursache: Jede Instanz von App Builder in einer Hochverfügbarkeitsbereitstellung muss eine identische appsettings.json-Konfigurationsdatei verwenden. Wenn sich die Dateien zwischen Instanzen unterscheiden, ist das Verhalten über Knoten hinweg inkonsistent.
• Lösung:
  • Bestätigen Sie, dass alle App Builder-Instanzen in der HA-Bereitstellung identische appsettings.json-Dateien haben.
  • Wenden Sie nach einer Konfigurationsänderung auf einer Instanz die gleiche Änderung auf alle anderen Instanzen an und starten Sie jede neu.

Authentifizierungsfehler

SSO-Anmeldung schlägt fehl oder leitet zu einer falschen URL um

• Symptom: Benutzer, die sich über Single Sign-On (SSO) anmelden möchten, erhalten einen Umleitungsfehler oder werden zu einer unerwarteten URL weitergeleitet.
• Mögliche Ursachen:
  • Der im Identity Provider (IdP) konfigurierte Redirect URI stimmt nicht mit der URL überein, die App Builder verwendet.
  • Ein Reverse Proxy oder Load Balancer vor App Builder (z. B. IIS hinter einem F5) beendet TLS, sodass App Builder http sieht, während die öffentliche URL https verwendet. Der Redirect URI verwendet dann das falsche Protokoll und stimmt nicht mit dem im IdP registrierten Wert überein.
  • Die SSO-Integrations-URL in App Builder verweist auf eine veraltete oder falsche Adresse.
  • Der OpenID Connect-Sicherheitsanbieter in App Builder ist falsch konfiguriert.
• Lösung:
  • Bestätigen Sie im IdP (z. B. Okta oder Azure AD), dass der Redirect URI genau mit der App Builder-Anwendungs-URL übereinstimmt, einschließlich des Protokolls (https://) und aller Pfade.
  • Überprüfen Sie in App Builder die Konfiguration des Sicherheitsanbieters in IDE > Security Providers und stellen Sie sicher, dass die OpenID Connect-Einstellungen mit den erwarteten Werten des IdP übereinstimmen.
  • Wenn sich die App Builder-URL geändert hat (z. B. nach einer Migration oder Domänenaktualisierung), aktualisieren Sie den Redirect URI sowohl in App Builder als auch im IdP.

Die Basis-URL leitet nicht zur Anmeldeseite um

• Symptom: Das Öffnen der Basis-URL einer App Builder-Umgebung (z. B. https://example.com/) leitet nicht zur Anmeldeseite um. Nicht authentifizierte Besucher werden direkt zu einer App weitergeleitet.
• Mögliche Ursache: Der integrierte Benutzer anonymous hat Zugriff auf die Startseite einer App. App Builder leitet jeden Benutzer automatisch zu einer Startseite um, auf die er zugreifen kann. Wenn der Benutzer anonymous die Startseite einer App erreichen kann, werden alle nicht authentifizierten Besucher stattdessen dorthin umgeleitet, anstatt zur Anmeldeseite.
• Lösung: Entfernen Sie den Zugriff des Benutzers anonymous auf die Startseite der App, damit nicht authentifizierte Besucher zur Anmeldeseite weitergeleitet werden.

Lokale Benutzer können ein vergessenes Passwort nicht zurücksetzen

• Symptom: Lokale Benutzer können ein vergessenes Passwort nicht zurücksetzen. Der Link Passwort vergessen auf dem Anmeldebildschirm fehlt oder das Zurücksetzen wird nicht abgeschlossen.
• Mögliche Ursache: Der Gruppe Anonyme Benutzer wurde kein Zugriff auf die Passwort-Zurücksetzen-Anwendung gewährt, daher können nicht authentifizierte Benutzer den Passwort-Zurücksetzen-Workflow nicht erreichen.
• Lösung: Gewähren Sie der Gruppe Anonyme Benutzer Zugriff auf die Anwendung App Builder - Passwort zurücksetzen und fügen Sie sie zur Rolle Passwort zurücksetzen hinzu. Weitere Informationen finden Sie unter Passwort zurücksetzen mit den vollständigen Konfigurationsschritten, einschließlich der erforderlichen SMTP-Einrichtung.

Salesforce OAuth-Authentifizierung schlägt fehl oder authentifiziert mit der falschen Instanz

• Symptom: Benutzer, die sich mit Salesforce SSO anmelden, werden unerwartet mit der falschen Salesforce-Instanz authentifiziert, oder Salesforce-Token funktionieren nicht mehr und Benutzer werden wiederholt zur erneuten Authentifizierung aufgefordert.
• Mögliche Ursachen:
  • Mehrere App Builder-Instanzen nutzen die gleiche Salesforce Connected App. Salesforce speichert nur die vier neuesten Aktualisierungstoken pro Connected App. Wenn ein fünftes Token ausgestellt wird, wird das älteste ungültig, wodurch die Instanz, die dieses Token hält, die Authentifizierung verliert.
  • Mehrere Salesforce-Instanzen sind in App Builder konfiguriert, und der Browser des Benutzers hat bereits eine aktive Sitzung mit einer Salesforce-Instanz. Wenn der Benutzer versucht, sich bei einer zweiten Instanz anzumelden, verwendet Salesforce die vorhandene Sitzung erneut und meldet den Benutzer stattdessen bei der ersten Instanz an.
• Lösung:
  • Weisen Sie jeder App Builder-Instanz eine separate Salesforce Connected App zu, um Aktualisierungstokenkonfikte zu vermeiden. Weitere Informationen finden Sie in der Dokumentation zum Salesforce-Sicherheitsanbieter.
  • Wenn ein Benutzer mit der falschen Salesforce-Instanz authentifiziert wird, melden Sie den Benutzer von allen aktiven Salesforce-Sitzungen im Browser ab, bevor Sie sich erneut anmelden.

Leistung

App Builder ist langsam oder reagiert nicht

• Symptom: App Builder reagiert langsam auf Benutzerinteraktionen, oder Seitenladezeiten und Abfragen überschreiten das Zeitlimit.
• Mögliche Ursachen:
  • Der App Builder-Server verfügt nicht über ausreichende CPU- oder Speicherressourcen für die aktuelle Last.
  • Ein Netzwerkproblem zwischen dem Benutzer und dem App Builder-Server, z. B. begrenzte Bandbreite, Paketverlust oder eine Firewall, verlangsamt die Datenübertragung.
  • Nicht optimierte Abfragen oder Anwendungslogik führen zu langsamen Seiten, oder ein Hintergrunddienst verbraucht übermäßig viele Ressourcen.
  • Der IIS-Arbeitsprozess hat einen fehlerhaften Zustand erreicht.
  • Ein lang laufender Vorgang hat das Zeitlimit eines Proxys, eines Load Balancers oder eines anderen Netzwerkgeräts zwischen dem Browser und App Builder überschritten, das dann die Verbindung zum Browser getrennt hat. Der Browser meldet einen Fehler wie 504 Gateway Timeout, aber der Vorgang wird weiterhin auf dem Server ausgeführt und kann nach dem Trennen des Browsers noch erfolgreich sein oder fehlschlagen.
• Lösung:
  • Überprüfen Sie die Ressourcenauslastung des Servers (CPU, Speicher, Festplatten-E/A), um eine Ressourcenauslastung zu ermitteln.
  • Um ein Netzwerkproblem auszuschließen, stellen Sie eine Verbindung von einem anderen Netzwerk her (z. B. ein anderes WLAN oder ein Mobilgerät mit Mobilfunkverbindung) und führen Sie einen Internetgeschwindigkeitstest durch. Wenn sich die Leistung in einem anderen Netzwerk verbessert, ist die Ursache wahrscheinlich begrenzte Bandbreite, ein ISP-Problem oder eine Firewall und nicht App Builder selbst.
  • Überprüfen Sie die Anwendungsprotokolle auf wiederkehrende Fehler, Zeitüberschreitungen oder Warnungen, die auf die Ursache hindeuten können.
  • Wenn der Browser ein Gateway-Timeout gemeldet hat, verwenden Sie die Ereignisverlauf, um zu ermitteln, ob der Vorgang auf dem Server abgeschlossen wurde, bevor Sie ihn erneut versuchen. Da der Vorgang nach dem Trennen des Browsers weiterhin ausgeführt wird, kann ein erneuter Versuch die Arbeit duplizieren.
  • Überprüfen Sie aktive Hintergrunddienste und den Ereignisverlauf auf lang laufende oder hängende Aufträge. Um langsame SQL-Abfragen speziell zu identifizieren, siehe Langsame Abfragen erfassen und analysieren.
  • Bei langsamen Seiten, die durch nicht optimierte Abfragen oder Anwendungslogik verursacht werden, siehe App Builder-Leistungsoptimierung für Abfrageoptimierung, Indizierung und Anwendungsdesign-Richtlinien.
  • Wenn der Server fehlerfrei aussieht, aber App Builder nicht reagiert, recyceln Sie den IIS-Anwendungspool für App Builder.
  • Wenn das Problem zeitweilig auftritt und schwer zu diagnostizieren ist, rufen Sie einen Prozess-Dump zur weiteren Analyse ab. Siehe Dump-Datei abrufen.

Daten und Integrationen

Verschlüsselte Spaltenwerte erscheinen nach Neukonfiguration der Datenquelle leer

• Symptom: Werte in einer verschlüsselten Spalte erscheinen in der Anwendung leer (null), nachdem eine Datenquelle, Tabelle oder Spalte gelöscht und neu erstellt wurde oder nachdem die App Builder-Umgebung aktualisiert oder migriert wurde.
• Mögliche Ursachen:
  • App Builder leitet den Verschlüsselungsschlüssel jeder Spalte aus den Werten DataSourceId, TableId und ColumnId im logischen Modell ab. Wenn sich einer dieser Identifizierer ändert (z. B. nach dem Löschen und Neuerstellen einer Datenquelle, Tabelle oder Spalte), können vorhandene verschlüsselte Werte nicht mehr entschlüsselt werden. Es wird kein Fehler angezeigt: Der Wert erscheint stillschweigend als null.
  • Bei einer Aktualisierung oder Migration wurde der Ordner keys aus der vorherigen Installation nicht in den neuen Installationsordner kopiert, sodass App Builder nicht auf das Schlüsselmaterial zugreifen kann, das zum Entschlüsseln vorhandener Werte erforderlich ist.
• Lösung:
  • Wenn verschlüsselte Werte nach einer Aktualisierung oder Migration leer erscheinen, bestätigen Sie, dass der Inhalt des Ordners keys aus dem vorherigen Installationsordner in den neuen kopiert wurde. Siehe Schritt 5 von Einstellungen wiederherstellen.
  • Um Datenverluste durch Identifiziereränderungen zu vermeiden, vermeiden Sie das Löschen und Neuerstellen von Datenquellen, Tabellen oder verschlüsselten Spalten, die Daten enthalten. Eine vollständige Liste der Verschlüsselungsbeschränkungen finden Sie unter Verschlüsselung auf Anwendungsebene.
  • Exportieren oder sichern Sie vor strukturellen Änderungen alle verschlüsselten Spaltenwerte.
  • Wenn sich die Identifizierer bereits geändert haben und die Daten nicht aus einer Sicherung wiederhergestellt werden können, kontaktieren Sie den Jitterbit-Support mit Details der ursprünglichen Konfiguration.

Audit-Log-Baseline wird nicht gefüllt

• Symptom: Das Füllen der Vollständigen Audit-Baseline wirft einen Fehler aus und die Baseline wird nicht erstellt.
• Mögliche Ursache: Die Tabelle hat keinen einteiligen UUID-Primärschlüssel. Vollständiges Audit erfordert eine eindeutige UUID für jeden Datensatz, daher werden Tabellen mit einem zusammengesetzten (mehrteiligen) Primärschlüssel standardmäßig nicht überwacht. Um eine solche Tabelle zu überwachen, müssen Sie zunächst eine UUID-Auditspalte hinzufügen.
• Lösung:
  1. Fügen Sie der Tabelle eine UUID-Spalte hinzu und legen Sie ihren Spaltennutzungstyp auf Audit fest. Füllen Sie sie dann für vorhandene Datensätze auf. Das vollständige Verfahren finden Sie unter Andere Primärschlüsselkonfigurationen.
  2. Navigieren Sie zu Aktionsleiste > IDE > Zusätzliche Einstellungen und klicken Sie auf die Schaltfläche Audit-Datensätze füllen.
  3. Suchen Sie die Datenquelle der App, klicken Sie auf Alle füllen (oder Füllen bei einzelnen Tabellen) und klicken Sie dann auf Fortfahren, um es erneut zu versuchen.

SharePoint-Dateisystem: OAuth-Authentifizierung erforderlich ab April 2026

• Symptom: SharePoint-Dateisystem-Verbindungen können sich nicht authentifizieren oder lassen sich nicht erstellen.
• Mögliche Ursache: Ab dem 30. April 2026 erfordern SharePoint-Dateisystem-Verbindungen OAuth-Authentifizierung. Verbindungen mit Legacy-Authentifizierung funktionieren nicht mehr.
• Lösung:
  1. Aktualisieren Sie auf App Builder 4.61 oder später.
  2. Folgen Sie dem Microsoft SharePoint OAuth-Verbindungsleitfaden, um einen OAuth-Sicherheitsanbieter zu konfigurieren, bevor Sie den Datenserver erstellen oder aktualisieren.

SharePoint-Dateisystem: Dateien werden nicht angezeigt oder Pfade geben Fehler zurück

• Symptom: Eine SharePoint-Dateisystem-Datenquelle ist erfolgreich verbunden, aber Dateien werden nicht angezeigt, Inhalte werden nicht gerendert, oder ein Verzeichnispfad verursacht einen Fehler.
• Mögliche Ursachen:
  • App Builder kann nur auf Dateien zugreifen, die im Verzeichnis Dokumente gespeichert sind. Dateien in anderen SharePoint-Verzeichnissen sind nicht zugänglich.
  • Dateinamen unterscheiden zwischen Groß- und Kleinschreibung beim Binden zwischen Datenquellen. Eine Abweichung in der Schreibweise zwischen dem SharePoint-Dateinamen und dem in einer anderen Datenquelle verwendeten Namen verhindert das Rendern von Inhalten.
  • Die Verwendung eines Schrägstrichs (/) in einem Verzeichnispfad in einem Geschäftsobjekt verursacht einen Fehler.
• Lösung:
  • Bestätigen Sie, dass die Dateien im Verzeichnis Dokumente in SharePoint gespeichert sind.
  • Überprüfen Sie, dass Dateinamen, die in Geschäftsobjekten und Datenquellenbindungen verwendet werden, exakt der Schreibweise der SharePoint-Dateinamen entsprechen.
  • Verwenden Sie beim Angeben eines Verzeichnispfads in einem Geschäftsobjekt Backslashes (\\) statt Schrägstriche (/). Verwenden Sie beispielsweise \documents\employees statt /documents/employees.

App Builder Connector: Generierter API-Schlüssel kann nach Verlassen des Bildschirms nicht abgerufen werden

• Symptom: Ein Connector-Benutzer hat den App Builder Connector eingerichtet, aber der API-Schlüsselwert ist nach dem Navigieren weg vom Bildschirm zur Schlüsselerzeugung nicht mehr verfügbar.
• Mögliche Ursache: Der generierte API-Schlüssel wird nur einmal auf dem Bildschirm Schlüssel generieren angezeigt. Nach dem Verlassen des Bildschirms kann der Wert nicht abgerufen werden.
• Lösung:
  • Kopieren Sie den Schlüsselwert sofort nach der Generierung in die Zwischenablage, bevor Sie navigieren.
  • Wenn der Schlüssel nicht kopiert wurde, generieren Sie einen neuen Schlüssel.

App Builder Connector: Fehler 403 Forbidden

• Symptom: Die Verbindung zu einer Remote-App Builder-Umgebung mit dem App Builder Connector gibt einen Fehler 403 Forbidden zurück.
• Mögliche Ursache: Das für den Connector konfigurierte Benutzerkonto wurde in der Quell-App Builder-Umgebung nicht die Rolle App Builder Remote Connector zugewiesen.
• Lösung:
  1. Öffnen Sie in der Quell-App Builder-Umgebung das vom Connector verwendete Benutzerkonto.
  2. Weisen Sie diesem Benutzer die Rolle App Builder Remote Connector zu.

Webhook: HTTP Basic Auth erfordert den Authorization-Header in der Payload

• Symptom: Ein Webhook mit HTTP Basic Auth verarbeitet eingehende Payloads nicht korrekt.
• Mögliche Ursache: Die HTTP Basic Auth-Methode erfordert, dass der Authorization-Header in der empfangenen Payload vorhanden ist. Systeme von Drittanbietern, die diesen Header weglassen, authentifizieren sich nicht korrekt.
• Lösung: Verwenden Sie stattdessen die API Key-Authentifizierungsmethode für den Webhook-Sicherheitsanbieter. Die API Key-Methode erfordert den Authorization-Header nicht und ist breiter kompatibel mit externen Webhook-Sendern.

Datenmigration bei großen Datenmengen läuft ab

• Symptom: Ein Datenmigrations-Vorgang wird nicht abgeschlossen und schlägt mit einem Timeout-Fehler fehl.
• Mögliche Ursache: Datenmigrationen werden während eines App- oder Datenquellen-Upgrades als einzelne Datenbanktransaktion ausgeführt. Bei großen Datenmengen kann die Transaktion das Standard-Befehlstimeout der Datenbank überschreiten.
• Lösung: Erhöhen Sie in der App Builder-Datei Connection.xml den Wert CommandTimeOut, um mehr Zeit für die Migrationstransaktion zu ermöglichen.

Zeitzonenkonfiguration

App Builder-Anwendungsserver und Datenbankserver müssen die gleiche Zeitzone verwenden

• Symptom: DateTime-Werte in der Anwendung sind um unerwartete Offsets verschoben, oder in App Builder angezeigte Zeiten unterscheiden sich von denen in der Datenbank.
• Mögliche Ursache: Der App Builder-Anwendungsserver und der Datenbankserver sind mit unterschiedlichen Zeitzonen konfiguriert. Diese Server müssen synchronisiert sein, damit DateTime-Werte korrekt angezeigt werden.
• Lösung:
  1. Bestätigen Sie, dass der App Builder-Anwendungsserver und alle Datenbankserver auf die gleiche Zeitzone eingestellt sind.
  2. Legen Sie in App Builder die Default Data Source Time Zone auf jedem Datenbankserver und die Time Zone auf jeder Datenquelle fest, um die Zeitzone des Datenbankservers zu entsprechen. Siehe Zeitzonen für Konfigurationsschritte.

E-Mail-Benachrichtigungen

SMTP-Konfigurationsfehler

• Symptom: App Builder kann E-Mail-Benachrichtigungen nicht senden, und die Anwendungsprotokolle oder die Ausgabe von Test Email zeigen einen der folgenden Fehler:

  Argument passed in is not serializable. Parameter name: value
  

  Value cannot be null. ParameterName: From Address
  

  Unknown URI scheme. Parameter name: uri
  

  Authentication required
  

• Mögliche Ursachen:

  • Das Feld From Address des SMTP-Benachrichtigungsservers ist leer, null oder verwendet eine ungültige E-Mail-Adresse (erzeugt die ersten beiden oben genannten Fehler).
  • Das Feld URI verwendet ein ungültiges Format oder ein nicht unterstütztes Schema (erzeugt den Fehler „Unknown URI scheme"). Der URI muss das Schema smtp:// oder smtps:// verwenden, z. B. smtp://mail.example.com:587.
  • Die Felder UserName oder Password enthalten falsche Anmeldedaten (erzeugt den Fehler „Authentication required").

• Lösung: Öffnen Sie in der IDE aus den Connect-Optionen Notification Servers, öffnen Sie dann den SMTP-Serverdatensatz und überprüfen Sie das Feld, das dem erhaltenen Fehler entspricht:

  • Überprüfen Sie, dass die From Address eine gültige E-Mail-Adresse ist, die zum Versenden von E-Mails über den konfigurierten SMTP-Host berechtigt ist.
  • Überprüfen Sie, dass der URI das Format smtp://<hostname>:<port> oder smtps://<hostname>:<port> verwendet. Siehe SMTP konfigurieren für unterstützte Protokolle und Format.
  • Überprüfen Sie, dass UserName und Password den SMTP-Serveranmeldedaten entsprechen.
  • Verwenden Sie nach einer Änderung die Funktion Test Email im Benachrichtigungsserver-Popup, um die Einstellungen zu bestätigen, bevor Sie sie in einem Workflow bereitstellen.

Seiten und Anwendungsverhalten

Deep Links funktionieren nach dem Umbenennen einer App oder Seite nicht mehr

• Symptom: Ein Deep Link, der Benutzer zuvor zu einer bestimmten Anwendung oder Seite geleitet hat, funktioniert nicht mehr.
• Mögliche Ursache: Das Umbenennen einer Anwendung oder Seite im App Builder ändert den URL-Pfad, der in Deep Links verwendet wird. Alle vorhandenen Links, die den alten Anwendungs- oder Seitennamen enthalten, sind nicht mehr gültig.
• Lösung:
  • Aktualisieren Sie alle externen Systeme, E-Mails, Portale oder Lesezeichen, die die alte Deep-Link-URL enthalten, um den neuen Anwendungs- oder Seitennamen zu verwenden.
  • Erstellen Sie den neuen Deep Link, indem Sie im App Builder zur Zielseite navigieren, die URL aus der Adressleiste des Browsers kopieren und dann die Abfragezeichenfolge (alles ab ? an) entfernen, um die kanonische URL zu erhalten.
  • Um dieses Problem in Zukunft zu vermeiden, verwenden Sie das Feld Label für Anzeigenamen und halten Sie das Feld Name (das den URL-Pfad bestimmt) kurz und stabil.

Ein Ereignis wird beim Speichern, Einfügen, Aktualisieren oder Löschen mehrmals ausgelöst

• Symptom: Ein Ereignis, das einmal ausgelöst werden sollte, wird bei derselben Benutzeraktion mehrmals ausgelöst, was zu doppelten Datensätzen, doppelten Benachrichtigungen oder anderen wiederholten Nebenwirkungen führt.
• Mögliche Ursachen:
  • Die Aktion oder Validierung des Ereignisses ist gleichzeitig in der Datenschicht und der Geschäftslogikschicht registriert. Der App Builder erlaubt diese Konfiguration, löst das Ereignis aber einmal pro Schichtregistrierung aus.
  • Die Bindung der Aktion ist ungebunden oder an mehr als einen Datensatz gebunden. Die Aktion wird einmal für jeden Datensatz im Gültigkeitsbereich ausgelöst.
• Lösung: Öffnen Sie die App Workbench, suchen Sie die Konfiguration des Ereignisses und beheben Sie die zutreffende Ursache:
  • Bestimmen Sie, ob die Logik in der Datenschicht (für tabellenweites Verhalten) oder in der Geschäftslogikschicht (für seitenbezogenes Verhalten) gehört. Weitere Informationen finden Sie unter Ereignisse konfigurieren, und entfernen Sie die doppelte Registrierung aus der Schicht, zu der sie nicht gehört.
  • Überprüfen Sie die Bindung der Aktion. Wenn sie ungebunden oder an mehr als einen Datensatz gebunden ist, beschränken Sie sie auf den einzelnen beabsichtigten Datensatz. Siehe Implizite und explizite Bindung.

HTML-Icon-Steuerelemente respektieren Rollenberechtigung nicht

• Symptom: Ein HTML-Icon-Steuerelement auf einer Seite respektiert die Rollenberechtigung eines Benutzers nicht. Beispielsweise bleibt ein Symbol, das für Benutzer ohne Berechtigung deaktiviert sein sollte, aktiv.
• Mögliche Ursache: HTML-Icons verhalten sich wie Schaltflächen. Ohne ein zugeordnetes Ereignis gelten rollenbasierte Berechtigungen nicht für das Symbol, daher bleibt es unabhängig von der Benutzerrolle sichtbar und aktiv.
• Lösung:
  1. Ordnen Sie dem HTML-Icon-Steuerelement ein leeres Ereignis zu, damit die rollenbasierte Sichtbarkeit gilt.
  2. Geben Sie die entsprechende Zugriffsberechtigung (beispielsweise Aktualisieren) in der Rolle für die Benutzer an, die das Symbol sehen sollen.

Audit-Symbol wird auf einer Seite nicht angezeigt

• Symptom: Die Schaltfläche oder das Symbol „Audit" zum Anzeigen von Vollständigen Audit-Protokollen ist auf einem Formular- oder Raster-Panel nicht sichtbar.
• Mögliche Ursachen:
  • Der Benutzer gehört nicht zur Rolle App Builder - Administratoren oder App Builder - Audit an.
  • Das Seiten-Panel hat Audit anzeigen nicht aktiviert, oder das Panel ist kein Formular- oder Raster-Panel.
• Lösung:
  • Bestätigen Sie, dass der Benutzer zur Rolle App Builder - Administratoren oder App Builder - Audit gehört. Siehe Sicherheit.
  • Aktivieren Sie auf einem Formular- oder Raster-Panel die Option Audit anzeigen für das Seiten-Panel. Siehe Vollständiges Audit auf einer Seite aktivieren.

Mobile und Offline-Apps

Informationen zu Problemen mit der App Builder Mobile App (einschließlich Einfrierungen, Abstürze, blockierte Links und Probleme beim Speichern von Bildern) finden Sie unter Fehlerbehebung für Mobile Apps.

Offline-App: Lokale Datenbank wird beim Upgrade der App gelöscht

• Symptom: Nach dem Upgrade einer Offline-App sind alle lokal gespeicherten Daten auf dem Mobilgerät weg.
• Mögliche Ursache: Die lokale Datenbank einer Offline-App wird bei jedem App-Upgrade gelöscht. Dies ist eine bekannte Einschränkung von Offline-Apps.
• Lösung:
  • Stellen Sie sicher, dass alle lokal erfassten Daten vollständig mit dem Server synchronisiert werden, bevor ein App-Upgrade bereitgestellt wird.
  • Informieren Sie Benutzer im Voraus über geplante Upgrades, damit diese vor dem Upgrade synchronisieren können.

Offline-App: Hintergrundpläne werden nicht ausgeführt, wenn die App geschlossen ist

• Symptom: Geplante Aufgaben oder Hintergrundprozesse in einer Offline-App werden auf einem Mobilgerät nicht wie erwartet ausgeführt.
• Mögliche Ursache: Hintergrundpläne werden nicht ausgeführt, wenn die App Builder App auf dem Mobilgerät geschlossen ist. Pläne werden nur ausgeführt, während die App offen ist.
• Lösung:
  • Informieren Sie Benutzer, dass die geplante Hintergrundverarbeitung erfordert, dass die App offen bleibt.
  • Gestalten Sie Workflows, die von Hintergrundplänen abhängen, so um, dass sie durch Benutzerinteraktion ausgelöst werden, oder verschieben Sie die geplante Verarbeitung auf die Serverseite.

Widgets

Informationen zu Problemen mit Widgets, die nicht aktiviert werden, nicht korrekt geladen werden oder eine Widget-ZIP-Datei nicht lesen können, finden Sie unter Widget-Fehlerbehebung.