Fehlerbehebung in Design Studio

Diese Anleitung behandelt häufige Fehler und Probleme bei der Verwendung von Jitterbit Design Studio. 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.

Wenn ein privater Agent Ihre Design-Studio-Vorgänge ausführt, lesen Sie die Fehlerbehebung für private Agenten für Probleme mit dem Agent selbst. Bei Fehlern, die während der Ausführung von Vorgängen auftreten, behandelt der Fehlerbehebungsleitfaden für Vorgänge eher Studio als Design Studio, aber viele der Einträge (z. B. hängende Vorgänge, Skriptfehler und Verbindungsfehler) gelten auch für Design-Studio-Vorgänge.

Alle Fehlerbehebungseinträge auf dieser Seite

Anmelde- und Verbindungsfehler
- SSL-Zertifikat- oder Proxy-Filterfehler
- SSO-Benutzer außerhalb der Region der Organisation können sich nicht anmelden
Installation und Start
- macOS: Fehler „Client Properties Do Not Exist" beim Start
- Design Studio auf macOS Sequoia als Malware gekennzeichnet
Anzeigeprobleme
- Unscharfe oder kleine Benutzeroberfläche auf Windows 10 mit hoher Pixeldichte
Leistung
- Lange Projektladezeit bei Verwendung eines Proxys
Transformationen
Projektverwaltung
Benachrichtigungen
- SOAP-Fehler kann nicht bereitgestellt werden, wenn er direkt eine E-Mail auslösen soll
Datenbankconnector
- Datenbank: Verbindung durch Sicherheitsrichtlinie blockiert
FTP- und Dateiquellen
HTTP-Quelle
- Verbindungstest schlägt fehl, obwohl der Endpunkt erreichbar ist
NetSuite-Connector

Salesforce-Connector
- OAuth 2.0-Verbindungsänderungen werden in Test Salesforce Login nicht berücksichtigt
SAP-Connector

Diagnoseschritte

Fehlerprotokoll prüfen

Design Studio zeigt Systemfehler in einem integrierten Fehlerbereich an. Wählen Sie Fehlerprotokoll aus dem Menü Ansicht, um es zu öffnen. Jeder Fehler wird als separater Eintrag mit einer Beschreibung angezeigt. Um die Fehlerdetails für einen Support-Fall zu speichern, klicken Sie in der oberen rechten Ecke des Fehlerbereichs auf Speichern.

Seite mit bekannten Problemen prüfen

Lesen Sie die Seite Design Studio – bekannte Probleme durch, um Probleme zu finden, die bei neueren Versionen von Design Studio identifiziert wurden.

SSL-Zertifikat oder Proxy-Filterkonfigurationsfehler

Symptom: Design Studio zeigt einen SSL-Zertifikat- oder Proxy-Filterfehler beim Anmeldeversuch an.
Mögliche Ursachen:
- Ein signiertes SSL- oder CA-Zertifikat, das von Ihrem Netzwerk verwendet wird (z. B. von einem Web-Filter, Proxy oder VPN), ist nicht im Jitterbit Java KeyStore vorhanden.
- Die IP-Zulassungsliste für Ihren Netzwerk-Proxy oder Web-Filter enthält nicht die erforderlichen Jitterbit-Adressen. Siehe Zulassungslisten-Informationen.
Lösung: Vollständige Lösungsschritte, einschließlich Anweisungen zum Hinzufügen von Zertifikaten zum Jitterbit Java KeyStore, finden Sie unter SSL-Zertifikat oder Proxy-Filterkonfigurationsfehler.

SSO-Benutzer außerhalb der Region der Organisation können sich nicht anmelden

Symptom: Nachdem Harmony Single Sign-On (SSO) für die Organisation aktiviert wurde, können Benutzer, deren Harmony-Region sich von der Standardregion unterscheidet, mit der sich das Design Studio-Anmeldedialogfeld verbindet, die SSO-Anmeldung nicht abschließen. Benutzer in der Standardregion melden sich ohne Probleme an.
Mögliche Ursache: Design Studio verbindet sich standardmäßig mit einer einzelnen Harmony-Region-URL im Anmeldedialogfeld. Wenn SSO aktiviert ist, wird die SSO-Umleitung nur für die Harmony-Region aufgelöst, die die Organisation hostet. Benutzer müssen Design Studio daher auf die URL dieser Region verweisen, bevor sie sich anmelden.
Lösung:
- Drücken Sie im Design Studio-Anmeldedialogfeld Strg + Umschalt + U, um das URL-Feld zu öffnen. Geben Sie die URL für die Harmony-Region der Organisation ein (z. B. https://na-east.jitterbit.com für NA oder https://emea-west.jitterbit.com für EMEA), und schließen Sie dann die SSO-Anmeldung ab.
- Um die Änderung dauerhaft zu speichern, legen Sie die URL in der Konfigurationsdatei client.properties fest:
  - Öffnen Sie <Jitterbit Studio Home>\configuration\client.properties in einem Text-Editor (unter macOS ist der Pfad /Applications/Jitterbit Studio [version].app/Contents/Java/configuration/client.properties).
  - Heben Sie die Auskommentierung des Parameters cloud.url auf und setzen Sie ihn auf die regionale URL.
  - Speichern Sie die Datei und starten Sie Design Studio neu.

Installation und Start

macOS: Fehler „Client Properties Do Not Exist" beim Start

Symptom: Design Studio startet unter macOS nicht und zeigt einen Fehler an, dass Client-Eigenschaften nicht vorhanden sind.
Mögliche Ursache: Design Studio wurde direkt vom Disk-Image (.dmg) statt aus dem Ordner Programme gestartet. Die Anwendung muss in den Ordner Programme kopiert werden, damit sie ihre Konfigurationsdateien finden kann.
Lösung:
1. Beenden Sie Design Studio, falls es ausgeführt wird.
2. Öffnen Sie die .dmg-Installerdatei.
3. Ziehen Sie das Jitterbit Studio-Symbol in die Verknüpfung zum Ordner Programme im Installerfenster.
4. Starten Sie Design Studio aus dem Ordner Programme (oder über Spotlight/Launchpad), nicht vom Disk-Image.

Design Studio wird unter macOS Sequoia als Malware gekennzeichnet

Symptom: Unter macOS 15 (Sequoia) zeigt macOS eine Warnung an, dass Design Studio Malware ist, und verhindert das Öffnen.
Mögliche Ursache: macOS Gatekeeper warnt vor Anwendungen, die nicht von Apple beglaubigt sind und außerhalb des Mac App Store verteilt werden. Da Design Studio über die Seite Downloads des Harmony-Portals verteilt wird, meldet macOS, dass es nicht auf Malware überprüft werden kann. Dies ist normales macOS-Verhalten und kein tatsächliches Problem mit dem Installer.
Lösung:
1. Bestätigen Sie, dass Design Studio vom offiziellen Harmony-Portal auf der Seite Downloads heruntergeladen wurde.
2. Falls die Malware-Warnung für eine vom Portal heruntergeladene Installation angezeigt wird, kann die Warnung ignoriert werden: Sie deutet nicht auf ein tatsächliches Sicherheitsrisiko mit dem Jitterbit-Installer hin.

Anzeigeprobleme

Unscharfe oder kleine Benutzeroberfläche unter Windows 10 auf hochauflösenden Displays

Symptom: Design Studio-Elemente erscheinen unscharf oder zu klein, wenn sie unter Windows 10 mit einem hochauflösenden Display wie einem 4K-Monitor ausgeführt werden.
Mögliche Ursache: Eine standardmäßige Windows 10-DPI-Skalierungseinstellung, die nicht mit Design Studio kompatibel ist.
Lösung: Lösungsschritte finden Sie unter Windows 10 – Skalierungsfehler bei hochauflösenden Displays.

Leistung

Lange Projektladezeit bei Verwendung eines Proxys

Symptom: Das Öffnen eines Design Studio-Projekts dauert mehrere Minuten, wenn die Verbindung über einen Proxy erfolgt. Dies kann von einem Fehler wie dem folgenden begleitet werden:
```
Message: Unable to load image icon at this address: https://citizen.jitterbit.eu/v1/endpoints/s3images/financialforce.png
Details: Can't get input stream from URL!
```
Mögliche Ursache: Die Verzögerung wird normalerweise dadurch verursacht, dass Design Studio versucht, Citizen Integrator-Rezeptsymbole über einen Proxy abzurufen, der den externen Bildserver nicht erreichen kann.
Lösung: Lösungsschritte finden Sie unter Lange Ladezeiten bei Verwendung eines Proxys.

Transformationen

Transformation mit Skript schlägt mit Fehler `/PRESCRIPT/ node` fehl

Symptom: Eine Transformation, die ein Skript verwendet, schlägt zur Laufzeit fehl mit:

Zielknoten kann nicht gefunden werden (/PRESCRIPT/).
Die Struktur hat sich möglicherweise geändert. Versuchen Sie, die Transformation 'example' zu öffnen und die Strukturbäume zu aktualisieren.

Mögliche Ursache: Die interne XML-Struktur der Transformation ist inkonsistent mit dem aktuellen Zielschema geworden, typischerweise nach einer Schemaänderung.
Lösung:
1. Öffnen Sie die fehlerhafte Transformation in Design Studio.
2. Klicken Sie auf der Target-Seite auf die Schaltfläche zum Aktualisieren oben im Strukturbaum. Dies liest das Schema erneut ein und erstellt die interne Struktur der Transformation neu.
3. Speichern und stellen Sie die Transformation bereit.

`Unmap` hebt die Zuordnung eines Feldes nicht auf, wenn es zusammen mit `RunScript` verwendet wird

Symptom: Der Zuordnungsausdruck eines Zielfeldes umfasst sowohl RunScript als auch Unmap, aber das Feld wird nicht zugeordnet. Bei einem JSON- oder XML-Ziel wird das Feld in der Ausgabe mit einem null-Wert angezeigt, anstatt weggelassen zu werden.
Mögliche Ursachen:
- RunScript steht vor Unmap im selben Zuordnungsausdruck (z. B. RunScript("<TAG>script:MyScript</TAG>"); Unmap();). Bei Agent-Versionen vor 12.9 hat diese Kombination das Feld nicht zugeordnet.
- Unmap wird aus dem von RunScript aufgerufenen Skript aufgerufen, anstatt direkt im eigenen Zuordnungsausdruck des Zielfeldes. RunScript gibt das Ergebnis des aufgerufenen Skripts als Zeichenkette zurück, anstatt ein Unmap-Signal zurück zur Zuordnung zu propagieren. Das Aufrufen von Unmap aus dem aufgerufenen Skript hat daher keine Auswirkung, unabhängig von der Agent-Version und unabhängig von bedingter Logik um den Aufruf. Dies ist das erwartete Verhalten.
Lösung:
- Wenn RunScript und Unmap beide direkt im Zuordnungsausdruck des Zielfeldes aufgerufen werden, aktualisieren Sie den privaten Agent auf Version 12.9 oder später.
- Wenn Unmap aus dem von RunScript aufgerufenen Skript aufgerufen wird, verschieben Sie den Unmap-Aufruf aus dem aufgerufenen Skript in den eigenen Zuordnungsausdruck des Zielfeldes, z. B.:
```
RunScript("<TAG>script:MyScript</TAG>"); If(<condition>, Unmap(), <value>);
```

Datumsfunktionen geben Mitternacht statt eines reinen Datumswerts zurück

Symptom: Nach dem Upgrade auf Agent-Version 12.8 oder später geben ConvertTimeZone, Date oder GeneralDate für eine Eingabe von genau Mitternacht eine vollständige Datums- und Zeitzeichenkette zurück (z. B. 2026-01-01 00:00:00), anstatt eine reine Datumzeichenkette (2026-01-01) zurückzugeben. Dies kann nachgelagerte Logik unterbrechen, die das kürzere Format erwartet. CVTDate ist nicht betroffen.
Mögliche Ursache: Bei Agent-Versionen 12.8 und später behandeln diese Funktionen Mitternacht (00:00:00) als gültigen Zeitwert und behalten ihn im zurückgegebenen Wert bei, genauso wie jede andere Zeit. Zuvor wurde ein Wert von genau Mitternacht auf eine reine Datumzeichenkette gekürzt, während jede andere Zeit korrekt beibehalten wurde.
Lösung: Wenn nachgelagerte Logik einen reinen Datumswert erfordert, verwenden Sie FormatDate, um das Ergebnis explizit zu formatieren, anstatt sich auf das Standardausgabeformat der Funktion zu verlassen.

Byte-Order-Marke (BOM) in einer Quelldatei wird an den Wert des ersten Datensatzes weitergeleitet

Symptom: Wenn eine Quelldatei (z. B. eine CSV-Datei) mit einer UTF-8-Byte-Order-Marke (BOM) beginnt, enthält das erste Feld des ersten Datensatzes in der Transformationsausgabe ein zusätzliches oder unerwartetes Zeichen, das nicht Teil der Quelldaten ist, anstelle des erwarteten Werts. Dateien, die als UTF-8-CSV aus Microsoft Excel exportiert werden, enthalten häufig diese BOM.
Mögliche Ursache: Design Studio liest den Inhalt einer Quelldatei unverändert und erkennt oder entfernt eine führende BOM nicht. Die rohen Bytes der BOM werden Teil des Werts des ersten Felds, sobald die Datei in Datensätze analysiert wird.
Lösung: Überprüfen Sie den Wert des betroffenen Felds, um die genauen Zeichen zu identifizieren, die von der BOM erzeugt werden, und ordnen Sie das Feld dann mit Replace zu, um diese zu entfernen. In einer früheren Version, in der UTF-8 nicht die Standardeinstellung ist, können Sie auch explizit die Zeichenkodierung auf UTF-8 setzen, bevor die Quellaktivität ausgeführt wird, z. B. $jitterbit.source.text.character_encoding = "utf-8";. Design Studio Version 11.63 und später sowie Agent Version 12.7 und später verwenden standardmäßig UTF-8.

Projektverwaltung

Symptom: Ein Design Studio-Projekt, das auf einer Netzwerkfreigabe gespeichert ist (anstatt lokal oder im Harmony-Cloud-Speicher), zeigt Datenverluste, bei denen UI-Änderungen nach dem erneuten Öffnen des Projekts nicht beibehalten werden, oder die Leistung ist deutlich langsamer als erwartet.
Mögliche Ursache: Jitterbit empfiehlt nicht, Design Studio-Projektarbeitsbereiche auf einer Netzwerkfreigabe zu speichern. Der Netzwerkfreigabe-Speicher verfügt nicht über die Dateisperrmechanismen, die Design Studio benötigt, was zu inkonsistenten Speicherungen und möglichem Datenverlust führt.
Lösung: Verschieben Sie den Projektarbeitsbereich in den lokalen Speicher oder verwenden Sie stattdessen Harmony-Cloud-Speicher anstelle einer Netzwerkfreigabe.

Projektdownload schlägt mit Fehler `Invalid XML character` fehl

Symptom: Das Herunterladen eines Projekts in Design Studio schlägt mit einem Fehler fehl, der angibt, dass ein ungültiges XML-Zeichen im Elementinhalt gefunden wurde, z. B.:

An invalid XML character (Unicode: 0x15) was found in the element content of the document

oder:

org.xml.sax.SAXParseException; lineNumber: 17499; columnNumber: 21; An invalid XML character (Unicode: 0x5) was found in the element content of the document.

Mögliche Ursache: Die Projektmetadaten enthalten ein Steuerzeichen (z. B. 0x05 oder 0x15), das in XML nicht gültig ist. Dies kann aus einer beschädigten Endpunkt-URL oder aus ungewöhnlichen Zeichen resultieren, die in Skripte, Notizen oder andere Textfelder eingefügt wurden.
Lösung:
1. Öffnen Sie das Projekt in Design Studio (oder verwenden Sie eine aktuelle lokale Sicherung), um die Metadaten zu überprüfen.
2. Überprüfen Sie Endpunkt-URLs, Skripte und Notizen auf unsichtbare oder ungewöhnliche Zeichen und entfernen oder ersetzen Sie diese. Die Zeilennummer in der Fehlermeldung kann helfen, den betroffenen Bereich in der exportierten XML zu lokalisieren.
3. Speichern und stellen Sie das korrigierte Projekt bereit, und versuchen Sie dann erneut, es von Design Studio herunterzuladen.
4. Wenn der problematische Inhalt nicht identifiziert werden kann, wenden Sie sich an den Jitterbit-Support mit der vollständigen Fehlermeldung und der Projekt-ID für eine mögliche Metadaten-Reparatur im Backend.

Projektkomponenten fehlen nach Download oder Import

Symptom: Das Öffnen oder Importieren eines Projekts zeigt Operationen in der Liste, aber es werden keine Komponenten (Transformationen, Skripte, Schemas) angezeigt, oder eine Projektexport-Datei .json kann nicht importiert werden. Die Ursache ist normalerweise eine einzelne beschädigte Komponente im Projektexport, die das Parsing der gesamten Datei unterbricht.
Mögliche Ursache: Eine Komponente im Projektexport hat fehlerhaftes JSON, z. B. einen leeren Body oder ungewöhnliche Zeichen, die die Datei ungültig machen.
Lösung:
1. Exportieren Sie das Projekt aus dem Harmony-Portal, um eine .json-Datei zu erstellen.
2. Öffnen Sie die .json-Datei in einem Texteditor und überprüfen Sie das components-Array auf Einträge, die leer, fehlerhaft oder ungewöhnliche Zeichen enthalten.
3. Entfernen Sie das vollständige JSON-Objekt der verdächtigen Komponente aus dem components-Array.
4. Speichern Sie die Datei und importieren Sie sie zurück in Harmony.
5. Wenn die Beschädigung nicht identifizierbar ist, senden Sie den Projektexport an den Jitterbit-Support zur Analyse.

Duplizierte Operationen oder Transformationen werden in einem heruntergeladenen Projekt angezeigt

Symptom: Einige Benutzer, die dasselbe Projekt herunterladen, sehen duplizierte Operationen oder Transformationen mit identischen Namen und Schemas, und diese Duplikate werden in Design Studio als ungültig (rot markiert) gekennzeichnet. Andere Benutzer sehen eine saubere Version desselben Projekts.
Mögliche Ursache: Das Projekt wurde auf Operationsebene (anstatt auf Projektebene) migriert, und die Migration hat duplizierte Kopien von Abhängigkeiten (wie Transformationen) zum ursprünglichen Projekt hinzugefügt.
Lösung:
1. Erstellen Sie eine Sicherung des Projekts, bevor Sie Änderungen vornehmen.
2. Identifizieren Sie die duplizierte Operationen oder Transformationen. Löschen Sie die Duplikate und behalten Sie die Originale.
3. Stellen Sie das bereinigte Projekt bereit. Alle Benutzer, die das Projekt erneut herunterladen, erhalten die bereinigte Version.
4. Um dies in Zukunft zu vermeiden, vermeiden Sie die Migration auf Operationsebene in ein Projekt, das bereits die Quellkomponenten enthält. Verwenden Sie die Migration auf Projektebene oder migrieren Sie selektiv nur die Abhängigkeiten, die noch nicht vorhanden sind.

Salesforce-Projektimport schlägt mit einer falschen Versionsanforderung fehl

Symptom: Das Importieren oder Öffnen eines Projekts mit einem Salesforce-Endpunkt schlägt mit einem Fehler wie dem folgenden fehl:
```
The Jitterpak requires version 12.7.0.0 or higher. The Studio is currently running version [your Design Studio version]. This means that the Jitterpak cannot be opened by this Studio.
```
Dies kann auch bei einer aktuellen, unterstützten Design Studio-Version auftreten, da Design Studio nie eine 12.x-Version hatte.
Mögliche Ursache: Das Projekt wurde aus Design Studio 11.63 oder 11.64 exportiert. Diese Versionen kennzeichnen ein Projekt mit einem Salesforce-Endpunkt mit einer falschen erforderlichen Version (12.7.0.0) anstelle der korrekten Mindestversion. Design Studio 11.64.1 und später exportieren die korrekte erforderliche Version.
Lösung:
- Wenn das Projekt in eine lokale .jpk-Datei exportiert wurde:
  1. Benennen Sie die .jpk-Datei in .zip um und extrahieren Sie sie.
  2. Ändern Sie in environment.properties den Wert requires-version so, dass er Ihrer installierten Design Studio-Version entspricht, z. B.: requires-version=11.63.0.0.
  3. Ändern Sie in jitterpak.properties den Wert required_version in den entsprechenden codierten Wert. Verwenden Sie für Design Studio 11.63.0.0 required_version=110630000000000. Exportieren Sie für jede andere Version ein neues, leeres Projekt aus Ihrer installierten Design Studio und kopieren Sie stattdessen die Werte required_version und requires-version aus den Dateien dieses Projekts.
  4. Komprimieren Sie die extrahierten Dateien zurück in ein .zip-Archiv, benennen Sie es in .jpk um und importieren Sie es.
  Diese Schritte korrigieren nur die .jpk-Datei, die Sie bearbeiten. Das erneute Exportieren des Projekts aus Design Studio 11.63 oder 11.64 schreibt die falsche Versionsanforderung erneut, daher führen Sie ein Upgrade auf Design Studio 11.64.1 oder später durch, um dies zu vermeiden.
- Wenn der Fehler beim Herunterladen oder Öffnen eines in der Harmony-Cloud bereitgestellten Projekts auftritt anstatt beim Importieren einer lokalen .jpk-Datei:
  1. Führen Sie ein Upgrade auf Design Studio 11.64.1 oder später durch.
  2. Kontaktieren Sie den Jitterbit-Support, um eine Backend-Korrektur der gespeicherten Versionsanforderung des Projekts anzufordern, die in der Design Studio-Benutzeroberfläche nicht verfügbar ist. Fordern Sie die Korrektur erst nach dem Upgrade an: Das Öffnen oder erneute Exportieren des Projekts mit einer älteren, betroffenen Version danach kann die falsche Versionsanforderung zurück in das Projekt schreiben.

Benachrichtigungen

SOAP-Fehler kann nicht bereitgestellt werden, wenn er direkt eine E-Mail auslösen soll

Symptom: Das Konfigurieren eines SOAP-Fehlers zum direkten Auslösen einer E-Mail-Benachrichtigung schlägt bei der Bereitstellung fehl oder funktioniert nicht wie erwartet.
Mögliche Ursache: Das Bereitstellen einer Operation, bei der ein SOAP-Fehler direkt eine E-Mail auslöst, kann einen Fehler verursachen.
Lösung:
1. Konfigurieren Sie den SOAP-Fehler so, dass stattdessen eine Operation ausgelöst wird.
2. Verwenden Sie in dieser Operation die Funktion SendEmailMessage in einem Skript, um die Benachrichtigungs-E-Mail zu senden.

Datenbankkonnektor

Datenbankverbindung durch Sicherheitsrichtlinie blockiert

Symptom: Ein Verbindungstest für eine Datenbankquelle oder ein Datenbankziel schlägt fehl mit:

HttpErrorResponse: The database connection could not be established due to a security policy violation.

mit einer Detailzeile, die entweder eine Loopback-Verbindung benennt:

Details: java.lang.IllegalArgumentException - JDBC connections to loopback addresses are not permitted.

oder einen spezifischen Verbindungsstring-Parameter:

Details: java.lang.IllegalArgumentException - JDBC connection parameter 'allowmultiqueries' cannot be enabled.

Mögliche Ursache: Agent-Version 12.10 und später beschränken standardmäßig bestimmte Datenbankverbindungen und Verbindungsstring-Parameter aus Sicherheitsgründen. Dies umfasst Verbindungen zu localhost oder 127.0.0.1 sowie spezifische Verbindungsstring-Parameter für die MySQL-, PostgreSQL-, Oracle- und SQL Server-Treiber. Eine Verbindung, die zuvor funktioniert hat, kann nach dem Upgrade eines privaten Agenten auf Version 12.10 fehlschlagen, da die Beschränkung standardmäßig gilt, auch wenn der Abschnitt [JdbcSecurity] nicht automatisch zu einer vorhandenen jitterbit.conf-Datei hinzugefügt wird.
Lösung: Konfigurieren Sie auf einem privaten Agenten den Abschnitt [JdbcSecurity] der Agent-Konfigurationsdatei (jitterbit.conf), um die spezifische Verbindung oder den Parameter zu erlauben, den Sie benötigen, und starten Sie den Agenten neu.

FTP- und Dateiquellen

Dateiübertragungen wiederholen sich unerwartet

Symptom: Ein Vorgang überträgt eine Quelldatei erneut, die bereits in einem vorherigen Durchlauf verarbeitet wurde.
Mögliche Ursache: Design Studio verfolgt drei Kriterien, um festzustellen, ob eine Datei bereits übertragen wurde: Dateiname, Änderungsdatum und Vorgangs-ID. Wenn sich einer dieser Werte seit der letzten Übertragung geändert hat, behandelt Design Studio die Datei als neu und überträgt sie erneut.
Lösung: Um zu verhindern, dass eine bestimmte Datei erneut übertragen wird, löschen Sie ihren Eintrag aus der Übertragungsverlaufsliste: Aktivieren Sie das Kontrollkästchen neben dem Eintrag im unteren Bereich und klicken Sie auf Löschen.

FTP: Passiver Modus und Firewall-Beschränkungen für hohe Ports

Symptom: Eine FTP-Quelle verbindet sich erfolgreich von einer Arbeitsstation, schlägt aber fehl, wenn der Vorgang auf dem privaten Agenten ausgeführt wird, oder Dateiübertragungen treten in Timeout auf, obwohl der Agent den FTP-Server erreichen kann.
Mögliche Ursache: Der passive FTP-Modus verwendet dynamisch zugewiesene Ports mit hohen Nummern für Datenübertragungen. Firewalls, die ausgehende Verbindungen zu bekannten Ports beschränken, blockieren diese Datenkanalverbindungen, auch wenn der Steuerkanal (Port 21) offen ist.
Lösung:
- Bestätigen Sie, dass der passive Modus in der FTP-Quellenkonfiguration aktiviert ist (standardmäßig aktiviert).
- Arbeiten Sie mit Ihrem Netzwerkadministrator zusammen, um den Bereich der Ports mit hohen Nummern zu öffnen, den Ihr FTP-Server für passive Datenverbindungen in der Firewall zwischen dem privaten Agenten-Host und dem FTP-Server verwendet.

FTP: Erfolgs- und Fehlerordnerpfade befinden sich auf dem Agenten, nicht auf dem FTP-Server

Symptom: Dateien werden nach der Ausführung eines FTP-Vorgangs nicht im konfigurierten Erfolgs- oder Fehlerordner angezeigt, oder die Pfade scheinen sich zu unerwarteten Speicherorten aufzulösen.
Mögliche Ursachen:
- Die Felder für den Erfolgsordner und den Fehlerordnerpfad in einer FTP-Quelle beziehen sich auf Verzeichnisse auf dem privaten Agenten-Computer, nicht auf dem Remote-FTP-Server. Relative Pfade werden relativ zum Dateisystem des Agenten-Hosts interpretiert.
- Dateiname-Schlüsselvariablen werden in diesen Feldern nicht aufgelöst.
Lösung:
- Geben Sie absolute Pfade auf dem privaten Agenten-Host für die Erfolgs- und Fehlerordnerfelder ein (z. B. C:\Jitterbit\processed\ unter Windows oder /var/jitterbit/processed/ unter Linux).
- Verwenden Sie keine Dateiname-Schlüsselwörter oder Sonderzeichen wie * in diesen Pfadfeldern.
- Bestätigen Sie, dass das Agent-Dienstkonto Schreibberechtigungen für die konfigurierten Verzeichnisse hat.

FTP: Verzeichnisliste kann nicht analysiert werden

Symptom: Eine FTP-Quelle kann Dateien nicht auflisten, oder bekannte Dateien fehlen in der Quelle, obwohl sie auf dem FTP-Server vorhanden sind.
Mögliche Ursache: Einige FTP-Server geben Verzeichnislisten in einem nicht standardisierten Format zurück, das Design Studio mit seinem Standard-Parser nicht analysieren kann.
Lösung:
- Aktivieren Sie in der FTP-Quellenkonfiguration List only filenames (Nur Dateinamen auflisten). Dies führt dazu, dass die Quelle den NLST-Befehl verwendet, der nur Dateinamen statt einer vollständigen Verzeichnisliste zurückgibt und auf FTP-Servern breiter unterstützt wird.
- Alternativ können Sie die Jitterbit-Variable jitterbit.source.ftp.enable_regex_parser vor dem FTP-Leseschritt auf true setzen, um einen flexibleren Auflistungs-Parser zu aktivieren.

FTP-Ziel: Use FTP Rename funktioniert nicht mit SFTP-Archivierungsvorgängen

Symptom: Dateien, die mit einem FTP-Ziel mit aktiviertem Use FTP Rename auf einen SFTP-Server geschrieben werden, schlagen fehl oder werden nicht korrekt geschrieben, wenn der Vorgangstyp Archivierung ist.
Mögliche Ursache: Die Option Use FTP Rename funktioniert nicht beim Schreiben auf einen SFTP-Server in einem Archivierungsvorgang.
Lösung: Deaktivieren Sie in der FTP-Zielkonfiguration das Kontrollkästchen Use FTP Rename, wenn der Zielserver ein SFTP-Server ist und der Vorgang eine Archivdatei schreibt.

FTP-Ziel: Auto Create Directories ist unzuverlässig

Symptom: Ein FTP-Zielvorgang schlägt fehl, weil ein Zielverzeichnis nicht vorhanden ist, obwohl Auto Create Directories aktiviert ist.
Mögliche Ursache: Es ist ein bekanntes Problem, dass die Option Auto Create Directories inkonsistent funktioniert. Je nach FTP-Server wird das Verzeichnis möglicherweise nicht erstellt.
Lösung:
- Erstellen Sie die erforderlichen Verzeichnisse manuell auf dem FTP-Server, bevor Sie den Vorgang ausführen.
- Wenn Sie Auto Create Directories verwenden, bestätigen Sie, dass das Verzeichnis erstellt wurde, bevor Sie sich in der Produktion darauf verlassen.

Symptom: Das Abrufen einer großen Datei aus einer File Share-Quelle schlägt fehl, obwohl die Datei vorhanden ist und die Quellenverbindung korrekt konfiguriert ist.
Mögliche Ursache: File Share-Quellen haben eine bekannte Einschränkung, bei der einzelne Dateien größer als 2 GB möglicherweise nicht abrufbar sind.
Lösung: Teilen Sie Dateien größer als 2 GB in kleinere Segmente auf, bevor Sie sie in der Dateifreigabe zur Abholung platzieren.

HTTP-Quelle

Verbindungstest schlägt fehl, obwohl der Endpunkt erreichbar ist

Symptom: Das Testen einer HTTP-Quellenverbindung schlägt mit einem Verbindungs- oder Autorisierungsfehler fehl, aber der Endpunkt ist erreichbar und gibt Daten zurück, wenn er direkt in einem Browser oder API-Client aufgerufen wird.
Mögliche Ursache: Die Schaltfläche Test Connection in der HTTP-Quellenkonfiguration sendet eine HTTP HEAD-Anfrage. Einige Server unterstützen die HEAD-Methode nicht und geben einen Fehler 405 oder ähnliches zurück, obwohl GET- und POST-Anfragen erfolgreich sind.
Lösung:
1. Wenn der Endpunkt in einem Browser oder über eine direkte GET-/POST-Anfrage erreichbar ist, kann der fehlgeschlagene Verbindungstest ignoriert werden. Fahren Sie mit der Bereitstellung und Ausführung des Vorgangs fort, um die tatsächliche Konnektivität zu überprüfen.
2. Wenn der Vorgang auch zur Laufzeit fehlschlägt, untersuchen Sie das Problem weiter mithilfe der Vorgangsprotokolle.

NetSuite-Connector

Fehler bei Datencenter-URL: Kontospezifische WSDL-URL verwenden

Symptom: Ein NetSuite-Endpunkt, der zuvor erfolgreich verbunden war, schlägt jetzt fehl mit:

Connector Error: Error getting the data center URL.
...
In this account, you must use account-specific domains with this SOAP web services endpoint.