XML in Datenbank für den Einführungskurs zu Jitterbit Studio

Einführung

Modul 3 im Einführungskurs zu Jitterbit Studio demonstriert das Lesen von XML-Daten von einem SFTP-Server und das Upserten in eine PostgreSQL-Datenbank.

Voraussetzungen

Diese Seite setzt voraus, dass Sie Modul 1 - Datenbank zu Text abgeschlossen haben, in dem Sie Verbindungen zur Trainings-PostgreSQL-Datenbank und zum SFTP-Server von Jitterbit konfiguriert haben.

Zusammenfassung

In diesem Modul stellen Sie eine Verbindung zum Trainings-SFTP-Server her, um Datensätze aus der Datei customer.xml abzurufen und sie zur Tabelle customer in der PostgreSQL-Datenbank hinzuzufügen.

Die abgeschlossene Operation sieht folgendermaßen aus:

Diese Operation verwendet diese Transformationszuordnung:

1. Laden Sie ein XML-Schema herunter

Laden Sie zunächst eine XML-Datei herunter, die später als Schema verwendet wird:

1. Melden Sie sich beim Trainings-SFTP-Server von Jitterbit an.
2. Laden Sie im Verzeichnis DataSets > Customer die Datei customer.xml herunter.

2. Konfigurieren Sie eine FTP-Aktivität

Für dieses Modul arbeiten Sie weiterhin im selben Projekt und verwenden die gleiche SFTP-Serververbindung wie in Modul 1, konfigurieren jedoch eine separate FTP-Leseaktivität, um die XML-Daten vom Server abzurufen:

1. Erstellen Sie im selben Projekt wie Modul 1 einen neuen Workflow und benennen Sie ihn "Modul 3."

2. Klicken Sie im Tab Projektendpunkte und -verbinder der Komponentenpalette unter dem Filter Endpunkte auf die "SFTP"-Verbindung, die Sie in Modul 1 erstellt haben, um die Aktivitätstypen der Verbindung anzuzeigen:

   

3. Ziehen Sie einen FTP-Lese-Aktivitätstyp in die Komponentenablage auf der Entwurfskanvas, um eine Instanz einer FTP-Lese-Aktivität in einem neuen Vorgang zu erstellen.

4. Benennen Sie den Vorgang in "XML zu DB" um.

5. Doppelklicken Sie auf die FTP-Lese-Aktivität innerhalb des Vorgangs, um deren Konfiguration zu öffnen.

6. Konfigurieren Sie die FTP-Lese-Aktivität:

   • Name: "XML SFTP"
   • Antwortschema bereitstellen: Wählen Sie Ja, neues Schema bereitstellen und klicken Sie auf Datei hochladen, um die customer.xml-Datei auszuwählen und hochzuladen, die Sie vom Trainings-SFTP-Server heruntergeladen haben.
   • Pfad: Geben Sie den Pfad zur customer.xml-Datei auf dem Trainings-SFTP-Server an: "/DataSets/Customer"
   • Dateien abrufen: "*.xml". Klicken Sie auf Weiter.
   • Datenschema: Überprüfen Sie das Datenschema und klicken Sie auf Fertig, um zur Entwurfskanvas zurückzukehren.

Der letzte Bildschirm der Aktivitätskonfiguration sollte ähnlich wie folgt aussehen:

3. Konfigurieren Sie eine Datenbankaktivität

In diesem Schritt verwenden Sie dieselbe Verbindung zur PostgreSQL-Datenbank wie in Modul 1, konfigurieren jedoch eine separate Upsert-Aktivität:

1. Klicken Sie im Tab Projektendpunkte und -verbindungen der Komponentenpalette unter dem Filter Endpunkte auf die Verbindung "Postgres-Datenbank", die Sie in Modul 1 erstellt haben, um die Aktivitätstypen der Verbindung anzuzeigen:

   

2. Ziehen Sie eine Datenbank-Upsert-Aktivität in eine Komponentenablage rechts von der FTP-Lese-Aktivität innerhalb des Vorgangs auf der Entwurfskanvas.

3. Doppelklicken Sie auf die Datenbank-Upsert-Aktivität innerhalb des Vorgangs, um deren Konfiguration zu öffnen.

4. Konfigurieren Sie die Datenbank-Upsert-Aktivität:

   • Name: "Upsert in Postgres DB"
   • Referenz der Tabellennamen bereitstellen: Aktualisieren Sie die Tabellen und wählen Sie die Kundentabelle aus. Klicken Sie auf Weiter.
   • Aktualisierungsschlüssel auswählen: Löschen Sie das Feld id (Schlüssel) und wählen Sie das Feld company aus. Klicken Sie auf Weiter.
   • Datenschema: Überprüfen Sie das Datenschema und klicken Sie auf Fertig, um zur Entwurfskanvas zurückzukehren.

Der letzte Bildschirm der Aktivitätskonfiguration sollte ähnlich aussehen wie dieser:

4. Eine Transformation konfigurieren

Als Nächstes erstellen Sie eine Transformation, um Daten von der FTP-Quelle zum Datenbankziel zu transformieren:

1. Bewegen Sie den Mauszeiger auf der Designfläche über den Bereich zwischen der FTP-Leseaktivität und der Datenbank-Upsert-Aktivität, bis eine Komponentenzone erscheint.

2. Klicken Sie auf die Drop-Zone und wählen Sie Neue Transformation. Eine neue Transformation öffnet sich zur Konfiguration:

   • Transformationsname: "XML zu DB"
   • Quelle: Das Quellschema ist bereits bereitgestellt (links).
   • Ziel: Das Zielschema ist bereits bereitgestellt (rechts).

3. Ziehen Sie den customer-Quellknoten zum customer-Zielknoten und wählen Sie Automap.

4. Klicken Sie oben im Transformationskopf auf die graue Vorschau-Schaltfläche, um den Vorschauprozess zum Testen und Validieren der Zuordnungen zu starten. Klicken Sie auf Weiter, um die aufgeführten Komponenten bereitzustellen. Wählen Sie auf dem nächsten Bildschirm Neue Datei zum Testen hochladen und geben Sie die customer.xml-Datei an, die Sie zuvor heruntergeladen haben. Klicken Sie auf Fertig.

5. Der Vorschau-Bildschirm zeigt Daten an, die aus der Quelle befüllt und dem Ziel zugeordnet sind. Klicken Sie auf die rechten und linken Pfeile, um durch die importierten Daten zu blättern.

6. Nachdem Sie die Daten überprüft haben, klicken Sie auf Zurück zum Workflow. Durch Klicken auf diese Schaltfläche wird die Arbeit, die Sie in der Transformation geleistet haben, gespeichert.

Die Vorschau der Transformation sollte ähnlich aussehen wie diese:

5. Die Operation bereitstellen und ausführen

Schließlich, nachdem alle Schritte der Operation konfiguriert sind, stellen Sie die Operation bereit und führen sie aus:

1. Klicken Sie oben rechts in der Operation auf das Aktionsmenü-Symbol und wählen Sie im Menü Bereitstellen und Ausführen. Der Status der Operation wird unten links in der Operation angezeigt.
2. Sobald die Operation erfolgreich ist, melden Sie sich bei Jitterbits PostgreSQL-Datenbank an und sehen Sie sich die zusätzlichen Datensätze in der Kundentabelle an.