XML-zu-Datenbank-Assistent im Jitterbit Design Studio

Erstellen Sie eine XML-zu-Datenbank-Transformation mit dem Jitterbit-Verbindungsassistenten

Jitterbit Connect^TM bietet einen schnellen und einfachen Route zur Transformation. Dies wird durch ein assistentenbasiertes Integrationstool ermöglicht, das direkt in Jitterbit integriert ist. Der Assistent erstellt für den Benutzer alle komplexen, detaillierten Vorgänge und Komponenten eines Transformation. Indem Benutzer den Assistenten durchgehen, können sie ein Integrationsprojekt erstellen, ohne dass sie programmieren müssen.

Dieser Hilfeabschnitt behandelt die Erstellung von XML in einer Datenbank. Die Bildschirmkonventionen in diesem Dokument lauten: Die Quelle befindet sich links, das Ziel befindet sich rechts.

Erstellen einer XML-zu-Datenbank-Transformation

• Melden Sie sich bei Ihrem Jitterbit an.

• Um den Jitterbit Connect Wizard zu verwenden, klicken Sie im Hauptmenü auf Hilfe > Erste Schritte. Die Tab „Erste Schritte“ wird im rechten Bereich Ihres Bildschirms angezeigt.

• Klicken Sie nun auf die Schaltfläche mit der Bezeichnung Connect^TM-Assistent starten; ODER

• Klicken Sie auf -Symbol oben auf dem Bildschirm, um das Jitterbit Connect-Menü anzuzeigen.

  

• Starten Sie den Assistenten, indem Sie in der Spalte „Standard“ im Menü des Jitterbit Connect-Assistenten auf die Schaltfläche XML in Datenbank klicken. Dadurch wird der Bildschirm „Datenbankquellenauswahl“ angezeigt. ODER

• Klicken Sie im Entwurfsbereich mit der rechten Maustaste auf den gewünschten Jitterbit Connect-Unterzweig und wählen Sie Neues XML in Datenbank.

• Beginnen Sie mit der Erstellung Ihres Projekts mit dem Assistenten.

  Hinweis

  Wenn Sie sich zu Beginn des Projekts nicht angemeldet haben, werden Sie dazu aufgefordert, wenn Sie auf XML in Datenbank klicken.

  

• Füllen Sie die Felder wie folgt aus:

  Feld	Beschreibung
  Jitterbit-Server	Wählen Sie den Namen des Jitterbit-Servers aus der Dropdown-Liste.
  Benutzer	Geben Sie Ihren Benutzernamen ein.
  Passwort	Geben Sie Ihr Passwort ein.
  Kontrollkästchen „Passwort merken“	Aktivieren Sie dieses Kontrollkästchen, wenn das System sich Ihr Passwort in Zukunft merken soll.
  Erweiterter Link	Klicken Sie auf das linke Dreieck, um erweiterte Linkoptionen anzuzeigen: Verwendung von HTTPS bei der Kommunikation mit dem Server. Auswahl eines Port. Klicken Sie für weitere Informationen auf die Schaltfläche Hilfe in der unteren rechten Ecke dieses Dialogs.

• Nachdem Sie die Felder ausgefüllt haben:

  Steuerung	Beschreibung
  Anmelden	Klicken Sie auf diese Schaltfläche, um sich beim Jitterbit-Server anzumelden und den Quellbildschirm anzuzeigen.
  Abbrechen	Klicken Sie auf diese Schaltfläche, um den Assistenten zu schließen, ohne Ihre Eingaben zu speichern.
  Fragezeichen	Klicken Sie auf das Fragezeichen, um Hilfe zu diesem Dialog anzuzeigen.

Erstellen einer XML-Quellstruktur

• Wählen Sie eines der Optionsfelder **aus:

  • XML-Struktur auswählen - zeigt alle vorhandenen XML-Schemata an (Erweiterung .xsd oder .dtd). Markieren Sie dann Ihre Auswahl.
  • XML-Strukturdatei hochladen - ermöglicht Ihnen, zu einer anderen DTD oder einem anderen Schema zu navigieren und diese/s hochzuladen.

• In diesem Beispiel haben wir das Optionsfeld XML-Struktur auswählen ausgewählt und PurchaseOrder.dtd markiert.

  Steuerung	Beschreibung
  Weiter	Klicken Sie auf diese Schaltfläche, um den Bildschirm „Quelle: Root auswählen“ anzuzeigen.
  Abbrechen	Klicken Sie auf diese Schaltfläche, um den Assistenten zu schließen, ohne Ihre Eingaben zu speichern.

• Klicken Sie auf die Schaltfläche Zurück, um zum vorherigen Bildschirm zurückzukehren.

Quellstammelement erstellen

• Wählen Sie eines der Optionsfelder auswählen:

  • Wählen Sie einen Stammknoten aus der Liste aus - zeigt Datenknoten an, und Sie können einen als Stamm auswählen.
  • Suchen Sie den Stamm aus einem XML-Beispieldokument - ermöglicht Ihnen, zu einem anderen XML-Dokument zu navigieren, um dessen Stammknoten zu bestimmen.

• In diesem Beispiel wählen wir das Optionsfeld Wählen Sie einen Stammknoten aus der Liste aus und markieren Firmenname.

  Steuerung	Beschreibung
  Weiter	Klicken Sie auf diese Schaltfläche, um den Bildschirm „Quelloptionen“ anzuzeigen.
  Abbrechen	Klicken Sie auf diese Schaltfläche, um den Assistenten zu schließen, ohne Ihre Eingaben zu speichern.

• Klicken Sie auf die Schaltfläche Zurück, um zum vorherigen Bildschirm zurückzukehren.

  

• Das Kontrollkästchen Validiert XML-Instanzen anhand des ausgewählten XSD oder DTD ist standardmäßig aktiviert. In diesem Beispiel lassen wir das Kontrollkästchen aktiviert.

  Steuerung	Beschreibung
  Weiter	Klicken Sie auf diese Schaltfläche, um den Bildschirm „Quelle: Dateiquelle auswählen“ anzuzeigen.
  Abbrechen	Klicken Sie auf diese Schaltfläche, um den Assistenten zu schließen, ohne Ihre Eingaben zu speichern.

• Klicken Sie auf die Schaltfläche Zurück, um zum vorherigen Bildschirm zurückzukehren.

Dateiquelle erstellen

• Um eine vorhandene Dateiquelle zu bearbeiten, wählen Sie aus der Dropdown-Liste (z. B. XML-Quelle, Textquelle, komplexer Text) und klicken Sie auf Bearbeiten. Der Bildschirm wird erweitert, um den Namen und Typ der XML-Quelle sowie die Verbindungsparameter anzuzeigen.

• Um eine neue Dateiquelle zu erstellen, klicken Sie auf die Schaltfläche Neu erstellen und füllen Sie die Felder aus.

• In diesem Beispiel haben wir eine XML-Quelle aus der Dropdown-Liste ausgewählt und auf Bearbeiten geklickt, um die Quellverbindungsparameter zu aktualisieren.

  Hinweis

  Der Typ der ausgewählten Dateiquelle bestimmt die einzugebenden Verbindungsparameter. Einzelheiten finden Sie unter Aktivieren lokaler Dateiquellen.

  

• XML-Quellfelder:

  Feld	Beschreibung
  Name	Dieses Feld wird automatisch mit einem vom System zugewiesenen Namen ausgefüllt. Dies ist ein editierbares Feld, in das Sie einen beliebigen Namen eingeben können.
  Typ	Verwenden Sie das Dropdown-Menü, um Ihren Typ auszuwählen. In diesem Beispiel haben wir File3-are ausgewählt.

• Füllen Sie die Felder für die Verbindungsparameter wie folgt aus.

  Parameter	Beschreibung
  Pfad	Geben Sie den Pfad ein, in dem sich die „Get“-Dateien befinden.
  Anmelden	Geben Sie Ihren Anmeldenamen ein und klicken Sie auf die Schaltfläche Passwort. Ein Dialogfeld zur Eingabe Ihres Passworts wird angezeigt.
  Dateien abrufen	Geben Sie den Namen der Datenquelldatei ein. Sie können Platzhalter verwenden, um mehrere Dateien abzurufen.
  Filteroptionen	Klicken Sie auf diese Schaltfläche, um einen Dialog zu öffnen, in dem Sie die Groß-/Kleinschreibung ignorieren oder einen regulären Ausdruck verwenden können.
  Options-Link	Klicken Sie auf diesen Link, um den Operation zu verfeinern, z. B. eine Datei nach der Verarbeitung zu löschen oder umzubenennen.

• Nach Abschluss Ihrer Eingaben:

  Steuerung	Beschreibung
  Verbindung testen	Klicken Sie vor dem Klicken auf Weiter auf diese Schaltfläche, um sicherzustellen, dass alle Ihre Verbindungen funktionieren. Ein Dialogfeld wird angezeigt, das bestätigt, dass die Verbindung erfolgreich war. Wenn der Verbindungstest nicht erfolgreich ist, gehen Sie zurück, überprüfen Sie Ihre Parameter und korrigieren Sie sie gegebenenfalls. Klicken Sie auf OK, um zum Quellbildschirm zurückzukehren.
  Weiter	Klicken Sie auf diese Schaltfläche, um den Bildschirm „Datenbankzielauswahl“ anzuzeigen.
  Abbrechen	Klicken Sie auf diese Schaltfläche, um den Assistenten zu schließen, ohne Ihre Eingaben zu speichern.

• Klicken Sie auf die Schaltfläche Zurück, um zum vorherigen Bildschirm zurückzukehren.

Datenbankzielauswahl erstellen

• Um ein vorhandenes Datenbankziel zu bearbeiten, wählen Sie es aus der Dropdown-Liste aus und klicken Sie auf Bearbeiten. Der Bildschirm wird erweitert und zeigt den Namen und Typ des Datenbankziels sowie die Verbindungsparameter an.

• Um ein neues Datenbankziel zu erstellen, klicken Sie auf die Schaltfläche Neu erstellen und füllen Sie die Felder aus.

• In diesem Beispiel haben wir PostgreSQL aus der Dropdown-Liste ausgewählt und auf Bearbeiten geklickt, um die Verbindungsparameter zu aktualisieren.

  Hinweis

  Der Typ des ausgewählten Datenbankziels bestimmt die einzugebenden Verbindungsparameter.

  

• PostgreSQL -Felder:

  Feld	Beschreibung
  Name	Dieses Feld wird automatisch mit einem vom System zugewiesenen Namen ausgefüllt. Dies ist ein editierbares Feld, in das Sie einen beliebigen Namen eingeben können.
  Typ	Verwenden Sie das Dropdown-Menü, um Ihren Typ auszuwählen. In diesem Beispiel haben wir „Datenbank“ ausgewählt.

• Füllen Sie die Felder für die Verbindungsparameter wie folgt aus.

  Parameter	Beschreibung
  Treiber	Klicken Sie auf die Schaltfläche Auswählen und markieren Sie den Namen des Driver, in dem sich die Datenbank befindet.
  Servername	Geben Sie den Server-Namen ein.
  Datenbankname	Geben Sie den Datenbanknamen ein.
  Anmelden	Geben Sie Ihren Anmeldenamen ein und klicken Sie auf die Schaltfläche Passwort. Ein Dialogfeld zur Eingabe Ihres Passworts wird angezeigt.

• Nach Abschluss Ihrer Eingaben:

  Steuerung	Beschreibung
  Verbindung testen	Klicken Sie vor dem Klicken auf Weiter auf diese Schaltfläche, um sicherzustellen, dass alle Ihre Verbindungen funktionieren. Ein Dialogfeld wird angezeigt, das bestätigt, dass die Verbindung erfolgreich war. Wenn der Verbindungstest nicht erfolgreich ist, gehen Sie zurück, überprüfen Sie Ihre Parameter und korrigieren Sie sie gegebenenfalls. Klicken Sie auf OK, um zum Quellbildschirm zurückzukehren.
  Weiter	Klicken Sie auf diese Schaltfläche, um den Bildschirm „Zieltabellenauswahl“ anzuzeigen.
  Abbrechen	Klicken Sie auf diese Schaltfläche, um den Assistenten zu schließen, ohne Ihre Eingaben zu speichern.

• Klicken Sie auf die Schaltfläche Zurück, um zum vorherigen Bildschirm zurückzukehren.

Zieltabellenauswahl erstellen

• Klicken Sie auf die Schaltfläche Tabellenliste herunterladen, um die Liste der verfügbaren Tabellen herunterzuladen.

• Optional:

  • Sie können eine Suchzeichenfolge als Filter eingeben. Aktivieren Sie die Kontrollkästchen „Tabelle“ oder „Ansicht“, um die Auswahl der Objekte einzuschränken.

  • Sie können das Kontrollkästchen zum Einschließen des Schema/Eigentümers aktivieren.

  Hinweis

  Wenn Sie sich zu Beginn des Projekts nicht angemeldet haben, werden Sie dazu aufgefordert, wenn Sie auf die Schaltfläche Tabellenliste herunterladen klicken.

  

• Füllen Sie die Felder wie folgt aus:

  Feld	Beschreibung
  Jitterbit-Server	Wählen Sie den Namen des Jitterbit-Servers aus der Dropdown-Liste.
  Benutzer	Geben Sie Ihren Benutzernamen ein.**
  Passwort	Geben Sie Ihr Passwort ein.**
  Kontrollkästchen „Passwort merken“	Aktivieren Sie dieses Kontrollkästchen, wenn das System sich Ihr Passwort in Zukunft merken soll.
  Erweiterter Link	Klicken Sie auf das linke Dreieck, um erweiterte Linkoptionen anzuzeigen: Verwendung von HTTPS bei der Kommunikation mit dem Server. Auswahl eines Port. Klicken** Sie für weitere Einzelheiten auf die Schaltfläche Hilfe in der unteren rechten Ecke dieses Dialogs.

• Nachdem Sie die Felder ausgefüllt haben:

  Steuerung	Beschreibung
  Anmelden	Klicken Sie auf diese Schaltfläche, um sich beim Jitterbit-Server anzumelden und den Bildschirm zur Tabellenauswahl anzuzeigen.
  Abbrechen	Klicken Sie auf diese Schaltfläche, um den Assistenten zu schließen, ohne Ihre Eingaben zu speichern.
  Fragezeichen	Klicken Sie auf das Fragezeichen, um Hilfe zu diesem Dialog anzuzeigen.

  

• Sobald die Tabellen heruntergeladen sind, können Sie Tabellen aus der Spalte „Verfügbare Tabellen“ in die Spalte „Ausgewählte Tabellen“ kopieren.

• Markieren Sie die zu kopierenden Tabellen in der Spalte „Verfügbare Tabellen“ und klicken Sie auf den rechten Pfeil.

• Die Auswahl wird dann in die Spalte „Ausgewählte Tabellen“ kopiert, wie im folgenden Beispiel.

  

• Nach dem Ausfüllen Ihrer Tabellen:

  Steuerung	Beschreibung
  Weiter	Klicken Sie auf diese Schaltfläche, um den Bildschirm „Hierarchische Quellbeziehungen“ anzuzeigen.
  Abbrechen	Klicken Sie auf diese Schaltfläche, um den Assistenten zu schließen, ohne Ihre Eingaben zu speichern.

• Klicken Sie auf die Schaltfläche Zurück, um zum vorherigen Bildschirm zurückzukehren.

Hierarchische Beziehungen erstellen

• Klicken Sie auf das Dropdown-Menü Übergeordnete Tabelle auswählen und treffen Sie eine Auswahl. In diesem Beispiel haben wir OrderHeader aus der Liste ausgewählt.

• Klicken Sie auf das Dropdown-Menü Untergeordnete Tabelle auswählen und treffen Sie eine Auswahl. In diesem Beispiel haben wir OrderDetail aus der Liste ausgewählt.

• Klicken Sie dann auf die Schaltfläche Tabellen verknüpfen. Das Dialogfeld Verknüpfungseigenschaften wird angezeigt.

  

• Ziehen Sie im Abschnitt „Link Keys“ eine übergeordnete Spalte (OrderHeader in diesem Beispiel) per Drag & Drop in eine untergeordnete Spalte (OrderDetail in diesem Beispiel), um sie zu verknüpfen. Alternativ können Sie in jeder Tabelle eine Spalte auswählen, um die Schaltfläche Link zu aktivieren, und dann auf diese Schaltfläche klicken, um die Spalten zu verknüpfen.

• Sie können eine Verknüpfung zwischen zwei Spalten auswählen, um die Schaltfläche Verknüpfung entfernen zu aktivieren, und dann auf diese Schaltfläche klicken, um die Verknüpfung zu entfernen.

• Klicken Sie auf die Schaltfläche Spaltenanzeigereihenfolge, um Datenbank (Standard) oder Alphabetisch auszuwählen.

• Wählen Sie nach Abschluss der Verknüpfung von übergeordneten und untergeordneten Spalten ein Optionsfeld aus, um den Verknüpfungstyp zu identifizieren. Der Standardwert ist 1 bis N. In diesem Beispiel haben wir den Standardwert bei 1 bis N belassen.

  

• Nach dem Ausfüllen Ihrer Tabellen:

  Steuerung	Beschreibung
  OK	Klicken Sie auf diese Schaltfläche, um zum Bildschirm „Hierarchische Quellbeziehungen“ zurückzukehren, auf dem Ihr Tabellenbaum mit den aktuell definierten Beziehungen angezeigt wird.
  Abbrechen	Klicken Sie auf diese Schaltfläche, um zum Bildschirm „Hierarchische Quellbeziehungen“ zurückzukehren, ohne Ihre Eingaben zu speichern.

• Klicken Sie auf die Schaltfläche Zurück, um zum vorherigen Bildschirm zurückzukehren.

  

  Steuerung	Beschreibung
  Weiter	Klicken Sie auf diese Schaltfläche, um den Bildschirm „SQL Where Clause“ anzuzeigen.
  Abbrechen	Klicken Sie auf diese Schaltfläche, um den Assistenten zu schließen, ohne Ihre Eingaben zu speichern.

• Klicken Sie auf die Schaltfläche Zurück, um zum vorherigen Bildschirm zurückzukehren.

  

• In diesem Beispiel verwenden wir keine Filterbedingungen.

  Steuerung	Beschreibung
  Weiter	Klicken Sie auf diese Schaltfläche, um den Zielbildschirm anzuzeigen.
  Abbrechen	Klicken Sie auf diese Schaltfläche, um den Assistenten zu schließen, ohne Ihre Eingaben zu speichern.

• Klicken Sie auf die Schaltfläche Zurück, um zum vorherigen Bildschirm zurückzukehren.

Überprüfen Sie die Zusammenfassung der Datenbank

In diesem Schritt können Sie die Elemente Ihres Projekts überprüfen, bevor Jitterbit automatisch alle Projektdefinitionen einschließlich Operationen, Transformations und Webdienstaufrufen erstellt.

Nehmen Sie sich einen Moment Zeit, um alle Elemente des Projekts durchzusehen.

• Wenn Sie Anpassungen am Projekt vornehmen müssen, klicken Sie auf die Schaltfläche Zurück, um zum vorherigen Bildschirm zurückzukehren und die erforderlichen Änderungen vorzunehmen.

• Klicken Sie nach der Überprüfung Ihres Projekts auf Fertig, um die Tab „Transformations“ anzuzeigen. Der Entwurfsbereich wird ausgefüllt.

Überprüfen der Zuordnung

• Wenn Sie im Bildschirm „Zusammenfassung“ auf Fertigstellen klicken, wird die Tab „Transformations“ im Arbeitsbereich geöffnet. (Sie können sie auch jederzeit öffnen, indem Sie den Namen Ihres Projekts im Entwurfsbereich auswählen und doppelklicken.) Die Meldung „Zuordnungen“ wird auch über der Tab angezeigt.

  

• Wenn Sie das Kontrollkästchen „Automapper verwenden“ aktiviert gelassen haben, könnten die meisten oder alle Felder bereits für Sie zugeordnet sein. Eine gültige Zuordnung wird durch grüne Linien zwischen den Elementen in den Spalten „Quelle“ und „Ziel“ und zusätzlich durch das Vorhandensein eines blauen Quadrats neben jedem gültig zugeordneten Elementnamen angezeigt.

• Eine rote Linie zeigt eine ungültige Zuordnung an.

• Eine gelbe Linie zeigt an, dass Jitterbit nicht sicher ist, ob die Zuordnung für alle Datenmöglichkeiten gültig ist, aber die Transformation mit dieser Zuordnung versucht.

• Sie können die Zuordnung auf der Tab „Transformations“ abschließen, indem Sie sie per Drag & Drop von der Quelle links zum Ziel rechts ziehen. Wenn Sie dies tun, erhält das Zielelement denselben Namen wie das Quellelement und links neben dem Quellelement und dem Zielelement wird ein blaues Quadrat angezeigt. Siehe Transformations für weitere Transformation.

• Um Ihre Transformation zu speichern, klicken Sie auf den Abwärtspfeil in der Statusleiste und wählen Sie Speichern.

• Um diesen Bildschirm zu verlassen, klicken Sie ganz rechts auf der Tab auf das X.

Die Tab „SFDC-Assistenten“ wird auch geöffnet, wenn Sie auf Fertig stellen klicken.

• Klicken Sie auf die Tab „SFDC-Assistenten“, um den Bildschirm „Konto erstellen“ anzuzeigen. Hier können Sie Konfigurationen wie Chunking ändern. und Felder kürzen. Die letztere Konfiguration kürzt Felder nach Bedarf, wenn das Zielfeld kleiner als das Quellfeld ist. Auf der Tab „SFDC-Assistenten“ können Sie den Operation auch ausführen oder testen.

• Zeigen Sie die grafische Zusammenfassung des gesamten Projekts an, klicken Sie auf die Tab Vorgänge oder klicken Sie im Entwurfsbereich mit der Rechtsklick auf den Projektnamen.

  

Bereitstellen des Projekts

• Klicken Sie im Bereich „Entwurf“ unter „Transformations“ mit der rechten Maustaste auf das soeben erstellte Projekt und klicken Sie dann in der angezeigten Dropdown-Liste mit der linken Maustaste auf Bereitstellen. Oder

• Klicken Sie oben im Entwurfsbereich mit der rechten Maustaste auf Operationen und dann mit der linken Maustaste auf Bereitstellen.

• Der Bereitstellungsprozess beginnt mit dem Senden der Daten an den Server und eine Fortschrittsmeldung wird angezeigt.

• Um den Bereitstellungsvorgang abzubrechen, klicken Sie auf die Schaltfläche Abbrechen. Dadurch gelangen Sie zum vorherigen Bildschirm zurück.

Damit ist der Prozess „XML zur Datenbank“ abgeschlossen. Wenn Sie dieses Projekt als Jitterpak exportieren möchten, klicken Sie hier.