Fehler und Regeln zur Komponentenvalidierung in Jitterbit Integration Studio

Einführung

Komponenten müssen gültig sein, um bereitgestellt werden zu können. Auf dieser Seite erfahren Sie, wie Sie ungültige Komponenten identifizieren und die damit verbundenen Validierungsfehler anzeigen sowie Validierungsfehler beheben.

Validierungsfehler

In diesem Abschnitt erfahren Sie, wie Sie ungültige Projektkomponenten identifizieren und die mit ungültigen Komponenten verbundenen Validierungsfehler anzeigen.

Bei neuen Projekten werden ungültige Elemente standardmäßig auf der Design-Canvas hervorgehoben, mit der Standardauswahl Ungültige Elemente hervorheben. Um diese Option zu deaktivieren, löschen Sie diese Auswahl:

Wenn Ungültige Elemente hervorheben ausgewählt ist, werden ungültige Komponenten auf der Design-Canvas mit einem roten Rahmen hervorgehoben:

Im Projektbereich, werden die Namen ungültiger Komponenten ebenfalls kursiv und rot dargestellt. Darüber hinaus werden ungültige Komponenten, die einen impliziten Fehler aufweisen, mit einem Fehlersymbol. Dieses Symbol wird nicht angezeigt, wenn die Komponente ungültig ist, weil sie andere Komponenten mit impliziten Fehlern enthält. Beispielsweise kann ein Workflow ungültig sein, weil er Vorgänge oder andere Komponenten enthält, die ungültig sind, oder ein Operation kann ungültig sein, weil er andere Komponenten enthält, die ungültig sind, wie unten dargestellt:

Um Validierungsfehler für Komponenten anzuzeigen, die als implizit ungültig identifiziert wurden, klicken Sie auf das Fehlersymbol neben dem Komponentennamen. In einem Dialogfeld werden die Validierungsfehler für die Komponente angezeigt. Detaillierte Informationen zu den Ursachen für ungültige Komponenten und zur Behebung von Validierungsfehlern finden Sie unter Validierungsregeln, nächste.

Validierungsregeln

Bestimmte Validierungsregeln müssen befolgt werden, damit Projektkomponenten in der Harmony-Cloud bereitgestellt werden können und damit die darin verwendeten Vorgänge auf Jitterbit-Agenten ausgeführt werden können. Diese Regeln stellen sicher, dass alle Teile eines Projekts vom Agenten unterstützt und erwartet werden. Validierungsregeln für Workflows und Vorgänge werden auf diesen Seiten behandelt:

• Workflow Gültigkeit
• Gültigkeit der Operation

Die Regelungen für weitere einzelne Projektbestandteile sind im Folgenden aufgeführt.

Namen müssen eindeutig sein

Die Namen einiger Projektkomponententypen müssen für jeden Komponententyp eindeutig sein.

Abhängig davon, welche Komponente ungültig ist, wird die entsprechende Variante dieser Fehlermeldung zurückgegeben, wenn diese Regel nicht erfüllt ist:

[Operation / Connection / Activity / Transformation / Script / Email / Variable] names must be unique.

Wenn Sie eine neue Projektkomponente von Grund auf neu erstellen, können Sie aufgrund der Feldüberprüfung im Komponentenkonfigurationsbildschirm nicht denselben Namen für mehrere Projektkomponenten angeben. Sie erhalten diese Fehlermeldung jedoch möglicherweise, wenn Sie beispielsweise ein Projekt importiert haben, das Komponenten mit doppelten Namen enthält.

Wenn Sie einen dieser Fehler erhalten, überprüfen Sie, ob Sie jeder Projektkomponente einen eindeutigen Namen gegeben haben, und benennen Sie alle Duplikate bei Bedarf um. Dokumentationslinks für jede Projektkomponente finden Sie unter Projektkomponenten Seite.

Projektkomponenten müssen gültig sein

Die Validierungsregeln hängen vom Komponententyp ab.

Aktivitäten

Damit eine Aktivität gültig ist, muss sie richtig konfiguriert sein. Wenn eine Aktivität nicht oder falsch konfiguriert wurde, wird diese Validierungsfehlermeldung zurückgegeben:

Activity is not configured properly.

Diese Meldung wird in einigen häufigen Szenarios angezeigt:

• Wenn einer Operation neue Aktivitäten aus der Design-Komponentenpalette hinzugefügt werden, sind sie noch nicht konfiguriert. Sie erhalten daher möglicherweise diese Fehlermeldung, wenn Sie eine neue Aktivität hinzugefügt haben, ohne sie bereits zu konfigurieren. Um das Problem zu beheben, öffnen Sie den Aktivitätskonfigurationsbildschirm und konfigurieren Sie die Aktivität.
• Wenn die Aktivität teilweise konfiguriert ist oder die einzelnen Felder in der Aktivitätskonfiguration nicht validiert wurden, erhalten Sie möglicherweise auch diese Fehlermeldung. Um das Problem zu beheben, öffnen Sie die Aktivitätskonfiguration und füllen Sie alle erforderlichen Felder mit gültigen Eingaben aus.

Einige Konnektoren sind verfügbar und können nur in Umgebungen verwendet werden, die einer privaten Agentengruppe zugeordnet sind. Obwohl mit diesen Konnektoren auf Cloud-Agenten keine neuen Verbindungen und Aktivitäten erstellt werden können, ist es möglich, mit diesen Konnektoren erstellte Projekte in eine Cloud-Umfeld zu migrieren oder zu importieren. In dieser Situation sind Verbindungen und Aktivitäten, die mit privaten, nur für Agenten verfügbaren Konnektoren erstellt wurden, ungültig und es wird diese Fehlermeldung angezeigt:

Connector is only available on private agents.

Aktivitäten können ihren eigenen Validierungsregeln unterliegen, die in der Dokumentation der Aktivität beschrieben werden. Eine solche Aktivität ist beispielsweise die Acknowledge-Aktivität für den RabbitMQ-Anschluss.

Wenn eine Aktivität aus einem anderen Grund ungültig ist, der nicht ohne weiteres ermittelt werden kann, wird diese Fehlermeldung zurückgegeben:

Activity is invalid.

Um das Problem zu beheben, lesen Sie die Dokumentation für jede Aktivität, die unter Anschlüsse verfügbar ist.

Scripts

Damit ein Script gültig ist, muss es richtig konfiguriert sein. Wenn ein Script nicht konfiguriert wurde, wird diese Validierungsfehlermeldung zurückgegeben:

Script is not configured properly.

Diese Meldung wird am häufigsten angezeigt, wenn Sie einem Operation ein neues Script hinzugefügt haben und dieses leer ist. Um das Problem zu beheben, öffnen Sie den Script und erstellen Sie dann im Editor ein Script.

Darüber hinaus muss für ein Jitterbit Script gültig zu sein, darf es keine Validierungsfehler im Script selbst enthalten. Wenn ein Jitterbit Script Validierungsfehler enthält, wird entweder eine bestimmte Validierungsfehlermeldung oder diese Validierungsfehlermeldung zurückgegeben:

Script is invalid.

Um das Problem zu beheben, öffnen Sie den Script Editor und Script anzeigen. Wir empfehlen außerdem, das Script zu testen, um sicherzustellen, dass die Ausgabe wie erwartet ist. Weitere Dokumentation finden Sie unter Scripts.

Transformations

Damit eine Transformation gültig ist, muss sie richtig konfiguriert sein. Wenn eine Transformation nicht oder falsch konfiguriert wurde, wird diese Validierungsfehlermeldung zurückgegeben:

Transformation is not configured properly.

Diese Meldung wird am häufigsten angezeigt, wenn Sie einer Operation eine neue Transformation hinzugefügt haben und diese noch nicht konfiguriert wurde. Um das Problem zu beheben, öffnen Sie den Transformation und konfigurieren Sie die Transformation entsprechend.

Damit eine Transformation gültig ist, darf sie außerdem keine Validierungsfehler innerhalb der Transformation selbst aufweisen. Um als gültig zu gelten, muss eine Transformation die folgenden Regeln erfüllen:

• Eine Zuordnung kann keine Verweise auf nicht vorhandene Felder oder Variablen enthalten.
• Eine Zuordnung darf keine Datentypkonflikte enthalten.
• Ein Zielschleifenknoten kann nicht mehrere Quellen haben.
• Für eine angrenzende Quell- oder Zielaktivität muss ein Schema bereitgestellt werden.

Darüber hinaus kann für bestimmte Zielfelder eine Zuordnung erforderlich sein oder nicht. Ungültige Zuordnungen werden im Transformation optisch angezeigt (siehe Gültigkeit der Transformation).

Abhängig vom Fehler wird bei Nichteinhaltung dieser Regel die entsprechende Variante dieser möglichen Fehlermeldungen zurückgegeben:

Mapping refers to a non-existent [source / target / variable] field $[path].

Potential data type conflict in mapping.

Target field $[node.name] [must be mapped / cannot be mapped].

Mappings of a target loop node depend on more than one source loop node.

[Source / Target] schema must be provided.

Versuchen Sie zur Behebung des Problems die folgenden Tipps zur Fehlerbehebung:

• Wenn Sie Verweise auf nicht vorhandene Felder, Datentypkonflikte oder andere ungültige Zuordnungen haben, suchen Sie entweder die ungültige Zuordnung und heben Sie die Zuordnung auf oder überprüfen Sie das Schema, um sicherzustellen, dass alle Felder berücksichtigt werden und kompatible Datentypen haben. Wenn Sie Verweise auf nicht vorhandene Variablen haben, überprüfen Sie, ob die Variable vorhanden ist.
• Wenn Sie einen Zielschleifenknoten haben, der von mehr als einem Quellschleifenknoten abhängt, befolgen Sie die Anweisungen unter Von einer Quelle mit mehreren Instanzen zu einem Ziel mit einer einzigen Instanz zuordnen unter Datenstrukturen.
• Wenn Sie Quell- oder Zielaktivitäten neben der Transformation haben, stellen Sie sicher, dass Sie für jede ein Schema angeben. Dateischemata können innerhalb der Aktivität bereitgestellt werden selbst während seiner Konfiguration (siehe Dokumentation für jeden Konnektor) oder durch Definieren eines Schema direkt innerhalb der Transformation.

Wenn eine Transformation aus einem anderen, nicht ohne weiteres zu ermittelnden Grund ungültig ist, wird außerdem diese Fehlermeldung zurückgegeben:

Transformation is invalid.

Ausführlichere Informationen finden Sie unter Gültigkeit der Transformation sowie weitere Seiten unter Transformations.