Fehlerbehebung in Design Studio

Dieser Leitfaden 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 Studio statt Design Studio, aber viele der Einträge (z. B. blockierte 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

SAP-Connector

Diagnoseschritte

Fehlerprotokoll prüfen

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

Seite mit bekannten Problemen prüfen

Überprüfen Sie die Seite Design Studio – bekannte Probleme auf Probleme, 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-Allowlist für Ihren Netzwerk-Proxy oder Web-Filter enthält nicht die erforderlichen Jitterbit-Adressen. Siehe Allowlist-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 stellt sich standardmäßig auf eine einzelne Harmony-Region-URL im Anmeldedialogfeld ein. Wenn SSO aktiviert ist, wird die SSO-Umleitung nur gegen 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).
  - Kommentieren Sie den Parameter cloud.url aus 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 kann unter macOS nicht gestartet werden, und es wird eine Fehlermeldung angezeigt, die besagt, dass Client-Eigenschaften nicht vorhanden sind.
Mögliche Ursache: Design Studio wurde direkt vom Disk-Image (.dmg) aus gestartet, anstatt vom Ordner Applications. Die Anwendung muss in den Ordner Applications kopiert werden, bevor 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 des Ordners Applications im Installerfenster.
4. Starten Sie Design Studio vom Ordner Applications (oder von Spotlight/Launchpad) aus, nicht vom Disk-Image.

Design Studio wird auf 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 standardmäßiges macOS-Verhalten und kein tatsächliches Problem mit dem Installer.
Lösung:
1. Bestätigen Sie, dass Design Studio von der offiziellen Seite Downloads des Harmony-Portals heruntergeladen wurde.
2. Falls die Malware-Warnung für eine vom Portal heruntergeladene Installation angezeigt wird, kann die Warnung ignoriert werden: Sie weist nicht auf ein tatsächliches Sicherheitsrisiko mit dem Jitterbit-Installer hin.

Anzeigeprobleme

Unscharfe oder kleine Benutzeroberfläche auf Windows 10 mit 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-Fehler bei der Skalierung hochauflösender 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:

Can not find target node (/PRESCRIPT/).
The structure may have changed so try to open the transformation 'example' and refresh the structure trees.

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

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

Symptom: Der Zuordnungsausdruck eines Zielfelds 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 Mapping-Ausdruck (zum Beispiel RunScript("<TAG>script:MyScript</TAG>"); Unmap();). Bei Agent-Versionen vor 12.9 hat diese Kombination das Feld nicht unmapped.
- Unmap wird aus dem von RunScript aufgerufenen Skript aufgerufen, anstatt direkt im eigenen Mapping-Ausdruck des Zielfelds. RunScript gibt das Ergebnis des aufgerufenen Skripts als Zeichenkette zurück, anstatt ein Unmap-Signal zurück zum Mapping 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 Mapping-Ausdruck des Zielfelds 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 Mapping-Ausdruck des Zielfelds, zum Beispiel:
```
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 (zum Beispiel 2026-01-01 00:00:00) statt einer reinen Datumzeichenkette (2026-01-01), was nachgelagerte Logik unterbrechen kann, 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 Standard-Ausgabeformat der Funktion zu verlassen.

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

Symptom: Wenn eine Quelldatei (zum Beispiel 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, anstatt 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 Rohdaten der BOM werden Teil des Werts des ersten Felds, sobald die Datei in Datensätze geparst wird.
Lösung: Überprüfen Sie den Wert des betroffenen Felds, um die genauen Zeichen zu identifizieren, die von der BOM erzeugt werden, und mappen Sie das Feld dann mit Replace, um diese zu entfernen. Bei einer früheren Version, bei der UTF-8 nicht der Standard ist, können Sie auch die Zeichenkodierung explizit auf UTF-8 setzen, bevor die Quellaktivität ausgeführt wird, zum Beispiel $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.

Projektmanagement

Symptom: Ein Design Studio-Projekt, das auf einer Netzwerkfreigabe (anstatt lokal oder im Harmony-Cloud-Speicher) gespeichert ist, zeigt Datenverlust, bei dem 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-Projekt-Arbeitsbereiche 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 Projekt-Arbeitsbereich in den lokalen Speicher oder verwenden Sie stattdessen Harmony-Cloud-Speicher anstelle einer Netzwerkfreigabe.

Projekt-Download schlägt mit Fehler `Invalid XML character` fehl

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

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 Projekt-Metadaten enthalten ein Steuerzeichen (wie 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, kontaktieren Sie den Jitterbit-Support mit der vollständigen Fehlermeldung und Projekt-ID für mögliche Metadaten-Reparatur im Backend.

Projekt-Komponenten 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 Projekt-Export-Datei .json kann nicht importiert werden. Die Ursache ist normalerweise eine einzelne beschädigte Komponente im Projekt-Export, die das Parsen der gesamten Datei unterbricht.
Mögliche Ursache: Eine Komponente im Projekt-Export hat fehlerhaftes JSON, wie 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 Text-Editor und überprüfen Sie das Array components auf Einträge, die leer, fehlerhaft oder mit ungewöhnlichen Zeichen versehen sind.
3. Entfernen Sie das vollständige JSON-Objekt der verdächtigen Komponente aus dem Array components.
4. Speichern Sie die Datei und importieren Sie sie zurück in Harmony.
5. Wenn die Beschädigung nicht identifizierbar ist, senden Sie den Projekt-Export an den Jitterbit-Support zur Analyse.

Doppelte Operationen oder Transformationen erscheinen in einem heruntergeladenen Projekt

Symptom: Einige Benutzer, die dasselbe Projekt herunterladen, sehen doppelte Operationen oder Transformationen mit identischen Namen und Schemas, und diese Duplikate sind 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 doppelte Kopien von Abhängigkeiten (wie Transformationen) in das ursprüngliche Projekt eingefügt.
Lösung:
1. Erstellen Sie eine Sicherung des Projekts, bevor Sie Änderungen vornehmen.
2. Identifizieren Sie die doppelten Operationen oder Transformationen. Löschen Sie die Duplikate, während Sie die Originale beibehalten.
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 Verwendung von Operationsmigration in ein Projekt, das bereits die Quellkomponenten enthält. Verwenden Sie stattdessen Projektmigration 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-Endpoint schlägt mit einer Fehlermeldung wie der 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 versehen ein Projekt mit einem Salesforce-Endpoint mit einer falschen erforderlichen Version (12.7.0.0) statt 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. Für Design Studio 11.63.0.0 verwenden Sie required_version=110630000000000. Für jede andere Version exportieren Sie ein neues, leeres Projekt aus Ihrer installierten Design Studio und kopieren Sie die Werte required_version und requires-version aus den Dateien dieses Projekts stattdessen.
  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 verhindern.
- Wenn der Fehler beim Herunterladen oder Öffnen eines in der Harmony-Cloud bereitgestellten Projekts auftritt statt 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 die 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 eines Vorgangs, bei dem ein SOAP-Fehler direkt eine E-Mail auslöst, kann einen Fehler verursachen.
Lösung:
1. Konfigurieren Sie den SOAP-Fehler so, dass er stattdessen einen Vorgang auslöst.
2. Verwenden Sie in diesem Vorgang die Funktion SendEmailMessage in einem Skript, um die Benachrichtigungs-E-Mail zu versenden.

Datenbankconnector

Datenbank: Verbindung durch Sicherheitsrichtlinie blockiert

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

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 bestimmten Verbindungszeichenfolgen-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 Verbindungszeichenfolgen-Parameter aus Sicherheitsgründen. Dies umfasst Verbindungen zu localhost oder 127.0.0.1 sowie spezifische Verbindungszeichenfolgen-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 Workstation, schlägt aber fehl, wenn der Vorgang auf dem privaten Agenten ausgeführt wird, oder Dateiübertragungen werden unterbrochen, 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 bestätigt 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 bestätigt 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.