Zum Inhalt springen

Best Practices für Jitterbit Design Studio

Einführung

Dieses Dokument soll als Leitfaden für die Verwendung von Harmony mit Design Studio dienen, der desktopbasierten Projektdesignanwendung von Jitterbit. Für bewährte Vorgehensweisen bei der Verwendung von Integration Studio, die webbasierte Version der Projektdesignanwendung von Jitterbit, siehe Harmony Best Practices.

Dieses Dokument ist nicht als umfassend gedacht und soll nicht alle Integrationsszenarien abdecken. Es soll vielmehr Anleitungen für gängige Integrationsszenarien bieten und die besten Entscheidungen bei der Verwendung der vielen Tools empfehlen, die einem Jitterbit-Benutzer zur Verfügung stehen.

Diese Seite sollten Sie am besten lesen, nachdem Sie mit Jitterbit vertraut sind: Sie haben die Erste Schritte durchlaufen Seite, vervollständigte die Jitterbit University Kurse und haben vielleicht selbst ein Integrationsprojekt abgeschlossen. An diesem Punkt kennen Sie die grundlegenden Konzepte und Begriffe von Jitterbit und wissen, was Jitterbit mit Projekten, Operationen, Quellen, Zielen, Skripting und Bereitstellung meint.

Dieses Dokument ist eine Zusammenfassung der Funktionen von Harmony 9.9. Stand Frühjahr 2019, das webbasierte Integration Studio ist anstelle des Desktops Design Studio verfügbar Anwendung für die Projektgestaltung.

Siehe Zusätzliche Ressourcen weiter unten finden Sie Links zu Videos und anderen Dokumenten, die die Best Practices für Jitterbit erläutern.

Support, Customer Success Manager und Dokumentation

Der Zugriff auf den Jitterbit-Support ist Teil einer Harmony Kundenlizenz. Wenn Fragen oder technische Probleme auftreten, können Sie vom Jitterbit-Support kompetente Unterstützung erhalten. Der Jitterbit-Support Seite beschreibt spezielle Anweisungen für Produktionsausfälle, um zeitkritische Probleme zu eskalieren.

Sie können sich auch an Ihren Customer Success Manager (CSM) wenden bei Fragen zur Lizenzierung oder anderen Themen.

Diese Dokumentationsseite (Jitterbit-Dokumentation) und unsere Entwickler (Jitterbit Developer Portal) enthalten mehr als 3.600 eindeutige URLs mit technischem Material.

Jitterbit-Produktaktualisierungen

Harmony Updates werden regelmäßig veröffentlicht (siehe Veröffentlichungsplan). Selbst eine Nebenversion enthält neben Fehlerbehebungen auch neue Funktionen und Verbesserungen.

Zugriff auf Webanwendungen über das Harmony Portal werden automatisch aktualisiert und führen immer die neueste veröffentlichte Version aus.

Cloud API Gateway und Cloud-Agent-Gruppe Updates werden automatisch angewendet. Für die Cloud-Agent-Gruppen gibt es zwei Sets: Produktion und Sandbox. Letzteres Set wird zum Testen der Kompatibilität mit Vorabversionen der Agent-Software verwendet und ist keine Umfeld.

Lokal installierte Anwendungen werden durch Herunterladen und Ausführen eines Installationsprogramms aktualisiert:

Es ist ratsam, sich über aktuelle Versionen zu informieren, insbesondere über Versionen mit Funktionsupgrades.

Projektorganisation und -design

Wiederverwendbarkeit

Wiederverwendbarkeit von Projekten

Ein typisches Szenario für die Wiederverwendung eines Projekts ist die Entwicklung eines „Standard“-Projekts mit umfassender Verwendung globaler Variablen und insbesondere Projektvariablen. Konfigurierbare Elemente wie Endpoint, optionale Feldzuordnungen, Email-Adressen und Dateinamen können als Projektvariablen bereitgestellt werden. Das „Standard“-Projekt wird in mehreren Umgebungen bereitgestellt und mithilfe der Management Console werden die Projektvariablen für jede Umfeld aufgefüllt.

Quelle/Ziel-Wiederverwendung

Obwohl Dateiquellen und -ziele häufig in Operationen verwendet werden, muss nicht unbedingt für jede Operation ein neues Quell-/Zielpaar erstellt werden. Da Dateiquellen und -ziele globale Variablen für Pfad und Dateinamen akzeptieren, können Quellen und Ziele für ähnliche Operationen einmal erstellt und über globale Variablen gesteuert werden. Nehmen wir beispielsweise an, dass „Quelle“- und „Ziel“-Objekte erstellt werden und im Feld „Dateiname“ steht [filename]. Der $filename Die Variable kann an einer beliebigen Stelle vor dem Schreiben des Ziels gesetzt und verwendet werden.

Dies gilt für Datenbanken, Dateifreigaben, FTP Sites, lokale Dateien und HTTP-Quellen und-Ziele.

Wiederverwendbarkeit von Script

Eigenständige Scripts, die eine bestimmte Funktion ausführen, z. B. eine Datenbanksuche oder das Bereitstellen eines Ergebnisses aus einer Reihe von Argumenten, können Kandidaten für die Wiederverwendung sein, insbesondere wenn sie in mehreren Vorgängen verwendet werden.

Wenn ein Script beispielsweise die DBLookup() Funktion für eine Datenbanktabelle und diese Funktion wird während der gesamten Integration verwendet, dann kann ein eigenständiges Script (getrennt von einer Operation) erstellt werden. Mit dem ArgumentList() Funktion oder einfache globale Variablen, es kann Argumente akzeptieren und ein Ergebnis zurückgeben. Da jede Operation einen anderen Umfang hat, kann dasselbe Script problemlos von mehreren gleichzeitigen Operationen aufgerufen werden.

Hinweis

Wenn Sie Ihre Projekte auf einer Dateifreigabe speichern, bleiben Änderungen, die an einem Projekt vorgenommen werden und sich ausschließlich auf die Benutzeroberfläche beziehen (z. B. Sie ordnen Objekte in einer Ansicht neu an), beim erneuten Öffnen des Projekts nicht erhalten.

Aus diesem Grund empfiehlt Jitterbit nicht, Projekte auf einer Dateifreigabe zu speichern, da:

  • Änderungen an der Benutzeroberfläche (Anordnung der Objekte) beim Speichern einer Datei nicht erhalten bleiben
  • Die Leistung leidet: Das Laden und Speichern eines Projekts kann aufgrund fehlender Zwischenspeicherung träge sein
  • Andere Benutzer im Netzwerk können Änderungen, die an einem Projekt vorgenommen werden, aufgrund fehlender Dateisperren überschreiben

Organisieren Sie die Vorgänge in einem Projekt

Design Studio stellt Operation bereit und sortiert Operationen beim erneuten Öffnen eines Projekts alphabetisch. Durch die Verwendung eines Nummerierungsschemas beim Benennen von Operationen und Ordnern ist der Integrationsfluss klarer und die fehlerbehebung einfacher.

Beispiel: Angenommen, es gibt zwei Integrationsflüsse, einen für Customer Master und einen zweiten für Item Master, jeweils mit zwei Operationen. In Design Studio können zwei Ordner erstellt werden, „Customer Master“ und „Item Master“. Im ersten Ordner könnten die Operationen „CM001 Get Customer“ und „CM002 Update Customer“ heißen. Im zweiten Ordner könnten die Operationen dann „IM001 Get Items“ und „IM002 Update Items“ heißen:

Anhang

Das Operation kann dann einfach die Schritte in der Integrationskette anzeigen und zeigen, ob Schritte ausgelassen wurden. Wenn Sie in Design Studio mit der rechten Maustaste auf einen Ordner klicken, werden in der Vorgangsliste nur die Vorgänge eines Ordners angezeigt. Eine konsistente Organisationsstruktur und Benennung erleichtert es jemandem, der neu in einem Projekt ist, den grundlegenden Operation schnell zu erfassen.

Verwalten von Race Conditions bei der Verwendung asynchroner Vorgänge

Bei Verwendung der RunOperation() Funktion im asynchronen Modus, Operationen werden ausgeführt, ohne die Kontrolle an den Aufrufer zurückzugeben. Die Verwendung asynchroner Operationen kann zu Race Conditions führen.

Wenn beispielsweise Operation A eine Datenbanktabelle aktualisiert und mit Operation B verkettet ist, die dieselbe Tabelle liest (beide sind synchron), treten keine Race Conditions auf. Wenn Operation A jedoch asynchron aufgerufen wird und unmittelbar darauf Operation B folgt, kann B ausgeführt werden, bevor A abgeschlossen ist.

Endpoint

Verwenden Sie als Endpoint eine System-ID mit Administratorberechtigungen anstelle einer ID auf Benutzerebene. Benutzer-IDs laufen normalerweise ab oder müssen deaktiviert werden, wenn der Benutzer das Unternehmen verlässt.

Durch die Verwendung von Projektvariablen (deren Werte ausgeblendet werden können) zur Verwaltung der Anmeldeinformationen muss der Jitterbit-Administrator keine Produktionsanmeldeinformationen eingeben. Dies kann ein Benutzer über die Management Console tun. Dieser Ansatz kann bei Bedarf auch für Email Anmeldeinformationen verwendet werden.

API Behandlung

Anstelle von HTTP- Endpoints sollte API-Manager verwendet werden. HTTP- Endpoints waren eine Möglichkeit, eingehende Anrufe mit geringem Datenverkehr abzuwickeln und erforderten das Öffnen bestimmter Netzwerkports, was viele Unternehmen heute als ernstes Sicherheitsrisiko betrachten.

API-Manager und sein API Gateway sind auf hohe Leistung ausgelegt, führen detaillierte Protokollierung durch, implementieren allgemeine Sicherheitsmaßnahmen und verfügen über eine benutzerfreundliche Designoberfläche, die Teil der Harmony-Plattform ist. Es müssen keine Netzwerkports zur Verarbeitung des eingehenden Datenverkehrs konfiguriert werden.

Für Echtzeit-/ereignisgesteuerte Integrationsmuster sollte eine API-Manager API verwendet werden. Beispiel: Endpoint A kann mithilfe ausgehender Nachrichten eine API wie Salesforce aufrufen. Eine API-Manager API kann schnell implementiert und an eine Vorgangskette angebunden werden.

Der bevorzugte Ansatz zum Beantworten eines Anrufs besteht darin, dies so schnell wie möglich zu tun. Wenn das Integrationsdesign so ausgelegt ist, dass die nachfolgenden Vorgänge viel Zeit zum Antworten benötigen, besteht das Risiko eines Timeouts oder das Risiko, dass andere eingehende Anrufe die Antwortfähigkeit des Zielendpunkts überfordern.

Wenn der Endpoint viele Anrufe pro Minute tätigt und das Gateway des Zielendpunkts nur eine bestimmte Anzahl von Verbindungen verarbeiten kann, ist es möglich, dass der Endpoint nicht hochskaliert werden kann, um die Anforderungen zu verarbeiten. In diesem Fall ist eine asynchrone Antwort möglicherweise der bevorzugte Ansatz. Das heißt, die Antwort erfolgt sofort und der Datensatz vom Endpoint wird über einen Aufruf an die API der Quelle gesendet.

Persistente Integrationsdaten

Es gibt viele Szenarien, in denen die Möglichkeit, Daten „in der Cloud“ zu speichern, hilfreich sein kann. Jitterbit bietet mehrere Methoden: Projektvariablen, Cloud-Caching-Funktionen und temporären Speicher.

Projektvariablen

Projektvariablen sind vorinitialisierte statische Variablen (ähnlich wie Projektkonstanten), die in Design Studio oder der Management Console bearbeitet werden können.

Ein Beispiel für die Verwendung von Projektvariablen sind Endpoint. Durch die Verwendung von Projektvariablen können verschiedene Endpoint (die normalerweise unterschiedliche Anmeldeinformationen haben) auf verschiedene Jitterbit-Umgebungen angewendet und über die Management Console bearbeitet werden. Dies ermöglicht einen Geschäftsprozess, bei dem ein Benutzer mit Management Console Rechten Anmeldeinformationen ändern kann, ohne Zugriff auf Design Studio zu benötigen.

Ein zweites Beispiel ist die Verwendung von Projektvariablen, um Flags zu speichern, die von der Integrationslogik verwendet werden, die das Verhalten der Integration anpassen können. Wenn ein einzelnes Projekt entwickelt wird, aber für verschiedene Endpoints verwendet wird, könnte eine boolesche Projektvariable (wie „Send_PO_number“) von der Logik der Transformation für das Feld „PO-Nummer“ überprüft werden. Wenn der Wert der Projektvariablen „false“ ist, dann UnMap() Befehl könnte verwendet werden, um dieses Feld „auszuschalten“.

Cloud-Caching-Funktionen

Cloud-Cache-Funktionen (ReadCache() Und WriteCache()) sind zuweisbare Datenräume, die projekt- und umgebungsübergreifend verfügbar sind. Ein zwischengespeicherter Wert ist für alle Vorgänge sichtbar, die im selben Bereich ausgeführt werden, bis er abläuft, unabhängig davon, wie dieser Operation gestartet wurde oder auf welchem Agenten er ausgeführt wird. Durch das Zwischenspeichern von Daten in Harmony können Daten zwischen separaten Vorgängen und projektübergreifend gemeinsam genutzt werden, anstatt sich auf lokale oder agentenspezifische Datenspeicher zu verlassen.

Zu den weiteren Einsatzmöglichkeiten von Cloud-Caching gehören:

  • Daten können zwischen asynchronen Vorgängen innerhalb eines Projekts geteilt werden.
  • Fehler, die bei verschiedenen Vorgängen auftreten, können in einem gemeinsamen Cache gespeichert werden. Durch die Sammlung von Operation können umfassendere Warnmeldungen erstellt werden.
  • Anmeldetoken können betriebsübergreifend genutzt werden.

Temporären Speicher verwalten

Temporärer Speicher wird häufig bei Integrationsvorgängen verwendet. Dies unterscheidet sich von lokalen Dateien (Quellen oder Ziele), das nur auf privaten Agenten verwendet werden kann. Beachten Sie diese Richtlinien, insbesondere wenn Sie eine Umfeld verwenden möchten:

  • Machen Sie Ihr Projekt „upgradesicher“ und verwenden Sie temporären Speicher so, dass für die Migration von einem Einzelserver zu einer Umfeld kein Refactoring erforderlich ist.

  • Temporärer Speicher wird in das temporäre Verzeichnis des Standardbetriebssystems auf dem Agenten geschrieben, der die Arbeit ausführt. Im Fall eines einzelnen privaten Agenten ist dies das temporäre Standardverzeichnis des Serverhosts dieses privaten Agenten. Wenn Sie mehr als einen privaten Agenten verwenden, ist dies das temporäre Standardverzeichnis des Host für den Agenten, der die Arbeit ausführt. Wenn Sie einen Cloud-Agenten verwenden (die geclustert sind), ist dies das temporäre Standardverzeichnis des jeweiligen Cloud-Agent-Host.

  • Standardmäßig wird der temporäre Speicher nach 24 Stunden durch einen Jitterbit-Bereinigungsdienst gelöscht. Bei Cloud-Agenten kann dies sofort erfolgen.

  • Ein einfacher Ansatz besteht darin, ein Ziel zu erstellen, ihm einen eindeutigen Namen zu geben und dann mit „In neue Quelle kopieren“ eine Quelle mit demselben Dateinamen zu erstellen. Ziel und Quellen sind tatsächlich unabhängig und verlassen sich auf die Verwendung desselben Dateinamens, um Lese- und Schreibvorgänge zu synchronisieren.

  • In einer Cluster-Umfeld (private oder Cloud-Agenten) werden alle Lese- und Schreibvorgänge im temporären Speicher auf demselben Host ausgeführt, solange die Vorgänge, die den temporären Speicher verwenden, miteinander verknüpft (verkettet) sind. Wenn jedoch Operation A in den temporären Speicher „myfile“ schreibt und Operation B den temporären Speicher „myfile“ liest, kann die Leseaktion inkonsistent sein, da sie möglicherweise nicht denselben Host wie Kette A liest.

  • Bei Zielen ist standardmäßig das Überschreiben der Datei vorgesehen. Dies kann mit der Option „An Datei anhängen“ geändert werden. Normalerweise erfordert dies dann, dass die Datei nach dem Lesen der Quelle gelöscht oder archiviert wird. Eine einfache Möglichkeit hierfür ist, in der Quelle „Datei löschen“ oder „Datei umbenennen“ auszuwählen.

  • Dateinamen-Schlüsselwörter sind verfügbar, die beim Erstellen eines Dateinamens verwendet werden können.

  • Eine Datei im temporären Speicher kann schnell gelesen werden, indem man ein Script mit dem ReadFile() Funktion, wie zum Beispiel ReadFile("<TAG>Sources/test</TAG>"). Bedenken Sie, dass dies nur zuverlässig funktioniert, wenn es einen einzigen privaten Agenten gibt.

Siehe Globale Variable versus temporärer Speicher für einen Vergleich dieser beiden Typen und Empfehlungen, wann welcher geeignet ist.

Skripterstellung

Wann wird Skripting verwendet?

Obwohl Jitterbit eine robuste Skriptfunktion bietet, sollte Skripting nur bei Bedarf verwendet werden. Wenn Sie die Wahl zwischen Skripting und einer Standardmethode haben, entscheiden Sie sich für die Standardmethode. Eine „Standardmethode“ ist eine Methode, die über die Benutzeroberfläche von Jitterbit Design Studio bereitgestellt wird, um eine Aufgabe auszuführen.

Ein Beispiel hierfür wäre die Organisation von Operation. Die Design Studio Benutzeroberfläche von Jitterbit ermöglicht es Ihnen, „Operation “ zu erstellen, die durch Erfolgs- und Fehlerpfade verknüpft sind. Alternativ ist es möglich, eigenständige Operationen zu erstellen und diese dann mithilfe von Skripten zu verknüpfen RunOperation() Funktion. Sofern es keine technischen Anforderungen gibt, die diesen Ansatz erfordern (wie etwa die Verwendung asynchroner oder optionaler Pfade), ist es vorzuziehen, sich auf die Benutzeroberflächenmethode von Jitterbit zu verlassen, um verschiedene Vorgänge miteinander zu verknüpfen.

Skripting ist im Allgemeinen an zwei Stellen am besten: im Formel-Generator in Transformations und in eigenständigen Scripts. Wenn derselbe Code in mehr als einer Transformation verwendet wird, sollten Sie ihn in ein eigenständiges Script verschieben und es aus jeder Transformation heraus aufrufen, indem Sie RunScript().

Namenskonvention für Variablen

Jitterbit hat vier Arten von Variablen:

  • lokale Variablen
  • globale Variablen
  • Projektvariablen
  • Jitterbit-Variablen

Lokale und globale Variablen werden in Jitterbit Scripts erstellt; Projektvariablen werden im Jitterbit Design Studio definiert; Jitterbit-Variablen sind im Jitterbit-System vordefiniert.

Da der Gültigkeitsbereich einer lokalen Variable auf ein einzelnes Script beschränkt ist, kann die Namenskonvention für sie sehr einfach sein, z. B. nur Kleinbuchstaben oder ein Anfangswort wie "return" oder "myVariable".

Globale Variablen sollten, da ihr Umfang größer ist (eine globale Variable kann in denselben oder nachlegende Operationen und Scripts innerhalb einer Operation referenziert werden), eine einheitliche Namenskonvention verwenden, um eine unbeabsichtigte Wiederverwendung zu vermeiden. Wenn Sie beispielsweise mehrere Komponenten für einen Variablennamen verwenden, die durch Punkte getrennt sind, können Sie einem Muster wie dem folgenden folgen:

first.second.third[.fourth]

Wo:

  • Erste Komponente: Org-Spezifizierer
  • Zweite Komponente: Ein Typ wie id, Fehler, Datum, Datei, Token, Zeitstempel, Zeitzone, Flagge, Email, GUID, Benutzer, externe ID, val (für einen sonstigen Wert), arr (für Array) oder ein Endpoint wie sfdc
  • Dritte Komponente: Variablenname
  • Vierte Komponente: Optionaler Name der Untervariable

Kombinieren Sie diese Komponenten und nehmen Sie an, dass Ihr Organisationsname lautet example, Variablennamen könnten sein:

  • $example.arr.names- $example.sfdc.success.message

Da Projektvariablen über die Management Console sichtbar sind und im Allgemeinen zum Konfigurieren des Integrationsverhaltens verwendet werden, können benutzerfreundlichere Namen verwendet werden. Da ein Projektvariablenname keine Leerzeichen enthalten darf, können stattdessen Unterstriche verwendet werden. Beispiel: "Start_Date" Und "Include_Assemblies".

Für welche Konvention Sie sich auch entscheiden, wir empfehlen, sie zu kodifizieren und zu dokumentieren, damit alle Teammitglieder sie in allen Projekten einheitlich verwenden können.

Warnung

Wenn Sie Ihre globalen Jitterbit-Variablen in einem JavaScript Script verwenden möchten, ist es wichtig, Unterstriche statt Punkte zu verwenden:

  • $example_arr_names
  • $example_sfdc_success_message

Umgebungen und Bereitstellungen

Jitterbit ermöglicht Methoden für den Softwareentwicklungslebenszyklus durch die Verwendung von Umgebungen und Bereitstellungsoptionen.

Umgebungen

In Harmony können mit der Umfeld Produktions- und Nicht-Produktionsumgebungen eingerichtet werden.

Nehmen wir beispielsweise an, dass in der Management Console eine „Dev“- und eine „Prod“ Umfeld eingerichtet und beide der Agentengruppe A zugewiesen sind. Projekt 1 wird in der „Dev“ Umfeld entwickelt. Jitterbit bietet eine „Migrations“-Funktion, die dieses Projekt in die „Prod“ Umfeld kopiert. Anschließend werden die Endpoint in die Endpoint für „Prod“ geändert. Andere Quellen und Ziele werden ebenfalls geändert. Anschließend werden bei allen Migrationen von „Dev“ nach „Prod“ Endpoints, Quellen und Ziele ausgeschlossen, sofern sie nicht neu sind.

Bereitstellungsverwaltungsoptionen

Es gibt mehrere Möglichkeiten, Projekte bereitzustellen.

  • Vollständige Bereitstellung: Wenn Sie Aktionen > Bereitstellen > Alles auswählen, wird das gesamte Projekt übernommen und in der Cloud überschrieben.

  • Projektsicherung: Wenn Sie Aktionen > Bereitstellen > Alles auswählen, gibt es die Option „Auch eine Sicherung in der Cloud speichern“. Bevor Sie größere Änderungen an einem Projekt vornehmen, wählen Sie diese Option aus, um einen Wiederherstellungspunkt in Harmony zu speichern.

  • Alle neuen und geänderten Elemente: Diese Option ist unter Aktionen > Bereitstellen > Erweiterte Optionen verfügbar. Da Design Studio „schmutzige“ Elemente verfolgt, werden hierdurch Änderungen sowie alle Abhängigkeiten einsetzen.

  • Eine neue Funktion besteht darin, den Fortschrittsdialog während einer einsetzen zu deaktivieren (siehe Einstellungen > Bereitstellen), wodurch die Bereitstellung einzelner Elemente im Hintergrund erfolgen kann.

Versionswarnungen

Wenn beim Bereitstellen von Änderungen an einem Projekt eine neuere Version eines Projekts bereitgestellt wurde, wird eine Warnung angezeigt, die darauf hinweist, dass eine neuere Version vorhanden ist, und angibt, wer sie bereitgestellt hat. Der Jitterbit-Administrator hat die Möglichkeit, das Projekt zu überschreiben. Im Allgemeinen ist es in einer Umfeld mit mehreren Entwicklern vorzuziehen, das aktuelle Projekt vor dem Vornehmen von Änderungen aus der Cloud herunterzuladen.

Testen, Fehlerbehebung und Protokollierung

Verwenden Sie Testfunktionen für die Entwicklung einer rAPID-Integration

Jitterbit ermöglicht eine schnelle Integrationsentwicklung und Unittests, indem es die tatsächlichen Integrationsdaten während der Designzeit sichtbar macht. Der offensichtliche Vorteil besteht darin, dass ein iterativer Entwicklungsprozess ermöglicht wird, indem die Daten vor und nach Transformations angezeigt werden, anstatt den gesamten Operation zu erstellen, auszuführen und die Ausgabe zu prüfen. Dies geschieht hauptsächlich über das Transformations, insbesondere über die Funktionen „Transformation testen“ und „Vorgang ausführen“.

Wenn die zu integrierenden Objekte bekannt sind, kann ein erfahrener Entwickler mithilfe des Transformation und seines Toolkits schnell eine Integration entwickeln. Stellen Sie beispielsweise eine Verbindung zu einer Datenbank her und erstellen Sie mithilfe des Transformation die Operation und die Transformation. Führen Sie dann bei geöffneter Transformation einen „Operation ausführen“-Vorgang aus. Die Daten werden im Transformation angezeigt und die Datensätze können durchlaufen werden. Dadurch werden sofort die genauen Daten angezeigt, die Jitterbit erhält, wenn die Operation ausgeführt wird.

Wenn für ein Feld eine Transformation erforderlich ist, doppelklicken Sie auf das Feld, um den Formel-Generator zu öffnen und das erforderliche Script zu erstellen. Wenn Sie die Funktion „Test“ im Formel-Generator verwenden, werden in der Ausgabe die Transformation verwendet und die genaue Ausgabe angezeigt, die während der Laufzeit generiert wird.

Wenn die Quelle nicht verfügbar ist, die Quelldaten jedoch in einer Datei (CSV, XML, JSON) vorliegen, kann die Datei mit den Funktionen „Beispielquelldaten laden“ und „Transformation testen“ in das Transformations importiert werden.

Fehlerbehebung bei der Integration aktivieren

Ein Schlüsselkonzept für eine gesunde Integrationsarchitektur besteht darin, zu erkennen, dass das Unternehmen Fragen zur Genauigkeit der Integrationsarbeit stellen wird, insbesondere wenn Unstimmigkeiten in den Endpoint auftreten. Der Fehler kann bei der Integration liegen, muss es aber nicht. Die Integration muss ein hohes Maß an Transparenz bieten, um Fragen zur Datengenauigkeit zu klären.

Wenn beispielsweise Daten in einem Endpoint nicht korrekt zu sein scheinen, wird in der Regel der Integrationssupport herangezogen, um Einzelheiten zu allen Integrationsaktionen bereitzustellen, wie etwa Zeiten, Quellen, Transformation, Erfolgs- oder Fehlermeldungen usw. Der Fehlerbehebungsprozess profitiert davon, wenn diese Informationen als Standardteil der Integrationsarchitektur verfügbar gemacht werden.

In Jitterbit wird dies durch Protokollierungs- und Warnfunktionen unterstützt.

Protokollierung

Das Jitterbit Operation erfasst standardmäßig wichtige Daten wie Operation sowie Erfolgs-, Fehler- oder Abbruchmeldungen. Wenn Fehler auftreten und der Endpoint Fehlerinformationen zurückgibt, werden diese im Protokoll erfasst.

Verwenden Sie beim Entwickeln einer Integration die WriteToOperationLog() Funktion in den Zuordnungen und Scripts, um wichtige Daten und Schritte im Prozess zu erfassen. Dies ist normalerweise so einfach wie: WriteToOperationLog("The id is: "+sourcefieldid).

Wenn die gesamte Ausgabe einer Transformation erfasst werden soll, können Sie dazu eine Operation erstellen, die die Quelle liest, die Transformation durchführt und in eine temporäre Datei schreibt. Ein Post-Operation Script kann die Datei lesen und in das Operation schreiben: WriteToOperationLog(ReadFile(<tempfile>)). Anschließend kann die „eigentliche“ Operation durchgeführt werden.

Protokolle können entweder in Design Studio oder in der Management Console angezeigt werden. Der Vorteil der Management Console besteht darin, dass Supportmitarbeiter über den Browser darauf zugreifen können, ohne dass ein Design Studio Client auf ihrem Desktop erforderlich ist.

Die Daten in den Protokollen sind durchsuchbar. Dies ermöglicht das Szenario, in dem die genaue Zeichenfolge, die zur Fehlerbehebung gehört, ein bekannter Wert ist und protokolliert wird.

APIs verfügen häufig über eine informative Erfolgs- oder Nichterfolgs-Antwortmeldung. Machen Sie den zusätzlichen Schritt und erfassen Sie diese Informationen im Protokoll.

Betriebsprotokolle, einschließlich detaillierter Protokollmeldungen von Cloud-Agenten und privaten Agenten, werden von Harmony 30 Tage lang aufbewahrt.

Alarmierung

Häufig müssen Integrationsergebnisse nicht nur protokolliert, sondern auch eskaliert werden. Jitterbit bietet eine Email Integration, die einfach an Vorgänge und Erfolgs-/Fehlerpfade angehängt oder aus Scripts aufgerufen werden kann.

Weitere Informationen finden Sie unter Warnung, Protokollierung und Fehlerbehandlung einrichten.

Zusätzliche Ressourcen

Diese Abschnitte und Seiten in der Dokumentation beziehen sich auf bewährte Vorgehensweisen und werden von Interesse sein.

Technische Gespräche

Jitterbit Tech Talks sind Videopräsentationen, die Bereiche abdecken, die für Benutzer aller Ebenen von Interesse sind:

Dokumentation

Die Jitterbit-Dokumentation enthält Best Practices auf unseren Seiten zur Verwendung von Jitterbit:

Sicherheit

Entwurfsmuster und Beispiele

  • Best Practices für SAP
    Probleme und Überlegungen, die bei der Integration in und aus SAP Instanzen auftreten können, insbesondere beim Erstellen einer bidirektionalen Integration.
  • Anleitungen für Design Studio
    Häufige Integrationsprobleme unserer Kunden, die durch den Einsatz unserer Software gelöst werden können.
  • Jitterpak-Bibliothek
    Beispielprojekte, die Ihnen den Einstieg erleichtern.

Projekte erstellen

Protokollierung

Projekte verwalten

  • Neue Rezepte erstellen
    Bewährte Methoden beim Erstellen von Jitterpaks zur Verwendung mit Citizen Integrator-Rezepten für Design Studio.
  • Methodik für Integrationsprojekte
    Wichtige Dinge, die ein Projektmanager für ein Design Studio Projekt wissen sollte, darunter, wie man sein Team organisiert, Anforderungen klar und präzise erfasst und validiert und die Stärken von Harmony nutzt, um ein erfolgreiches Integrationsprojekt abzuliefern.
  • Aus Cloud-Backup wiederherstellen
    Best Practices zum Sichern und Wiederherstellen von Projekten.
  • Ein Team-Kollaborationsprojekt einrichten
    Best Practices zur Unterstützung mehrerer Entwickler, die am selben Projekt arbeiten.

Private Agenten

APIs verwenden