Datenbank-zu-XML-Assistent im Jitterbit Design Studio

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

Erstellen einer Datenbank-zu-XML- Transformation

• Melden Sie sich über Jitterbit bei Salesforce an.

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

ODER

• Öffnen Sie Jitterbit und klicken Sie oben auf dem Bildschirm auf das Jitterbit Connect-Symbol.

• Das Menü des Jitterbit Connect Wizard wird angezeigt.

• Starten Sie den Assistenten, indem Sie in der Spalte „Standard“ des Jitterbit Connect-Assistentenmenüs auf die Schaltfläche Datenbank zu XML klicken. Dadurch wird der Bildschirm zur Auswahl der Datenbankquelle angezeigt.

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

Datenbankquellenauswahl erstellen

• Wählen Sie unter „Verfügbare Datenbankquellen“ entweder „Neu erstellen“… oder eine „Vorhandene Datenbankquelle“ aus.

Um eine neue Datenbankquelle zu erstellen, geben Sie die angeforderten Informationen ein.

• Geben Sie im Feld „Name“ einen passenden Namen für Ihre neue Quelle ein.

• Wählen Sie Datenbank aus dem Dropdown-Menü „Typ“.

• Wählen Sie den entsprechenden Datenbanktreiber aus, indem Sie neben dem Treiber auf die Schaltfläche Auswählen klicken. Je nach ausgewähltem Treiber können unterschiedliche Felder aktiviert oder deaktiviert werden.

• Geben Sie den Datenbankservernamen (entweder Name oder IP-Adresse), auf den Sie zugreifen möchten, in das Feld „Servername“ ein.

• Geben Sie den Namen der Datenbank, auf die Sie zugreifen möchten, in das Feld „Datenbankname“ ein.

• Geben Sie in den Feldern „Anmelden“ und „Passwort“ einen gültigen Benutzernamen und ein Passwort ein, die den Zugriff auf Ihre Datenbank ermöglichen.

OPTIONAL:

• Wenn der Datenbankserver einen nicht standardmäßigen Port abhört, können Sie Standardport verwenden deaktivieren und einen Benutzerdefinierten Port angeben. Der Port ist je nach ausgewähltem Treiber unterschiedlich.

• Wählen Sie die Transaktionsisolationsebene aus der Dropdown-Liste aus. Die Optionen sind die Standard-Transact-SQL-Optionen. Treiberspezifische Transaktionsisolationsebenen werden nicht unterstützt. Standardmäßig wird die Standardtransaktionsisolationsebene des Treiber oder Datenbankservers verwendet.

• Wenn Sie ein Limit für die Wartezeit bis zum Herstellen einer erfolgreichen Verbindung zur Datenbank festlegen möchten, geben Sie die Anzahl der Sekunden in das Feld „Timeout“ ein.

• Wenn Sie einen JDBC- Treiber verwenden, können Sie die Fetch Size-Eigenschaft festlegen. Diese Eigenschaft gibt dem Treiber einen Hinweis auf die Anzahl der Zeilen, die aus der Datenbank abgerufen werden sollen, wenn mehr Zeilen benötigt werden. Diese Einstellung kann für eine effizientere Verarbeitung großer Datensätze verwendet werden.

• Wenn Sie Ihrer Datenbankverbindungszeichenfolge weitere Parameter hinzufügen möchten, geben Sie die Parameter in das Feld „Zusätzliche Parameter der Verbindungszeichenfolge“ ein.

• Das Kontrollkästchen Verbindungszeichenfolge manuell erstellen ist standardmäßig deaktiviert. Wenn Sie sie selbst definieren möchten, aktivieren Sie dieses Kontrollkästchen. Anschließend müssen Sie die Verbindungszeichenfolge in das entsprechende Textfeld eingeben. Weitere Informationen finden Sie unter Manuelle Verbindungszeichenfolge.

  • Sie möchten möglicherweise Ihre Verbindungen testen, bevor Sie auf Weiter klicken. Durch Klicken auf diese Schaltfläche stellen Sie sicher, 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 und überprüfen Sie Ihre Parameter. Sie können sich auch an den Jitterbit-Helpdesk wenden.
  • Klicken Sie auf die Schaltfläche Weiter, um zur Tabellenauswahl zu gelangen.

Tabellenquellenauswahl erstellen

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

OPTIONAL:

• Sie können im Fenster „Suchfilter“ einen Suchbegriff eingeben. Aktivieren Sie die Tabelle- oder Anzeige-Kontrollkästchen, um die Auswahl der Objekte einzuschränken.

• Sie können das Kontrollkästchen aktivieren, um Systemtabellen in die heruntergeladenen Tabellennamen einzuschließen.

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

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 Pfeil nach rechts.

• Die Auswahl wird dann in die Spalte „Ausgewählte Tabellen“ kopiert.

• Um Tabellen aus der Spalte „Ausgewählte Tabellen“ zu entfernen, markieren Sie die zu kopierenden Tabellen in der Spalte „Ausgewählte Tabellen“ und klicken Sie auf den Pfeil nach links.

• Die Auswahl wird dann zurück in die Spalte „Verfügbare Tabellen“ verschoben.

Nach dem Ausfüllen Ihrer Tabellen:

• Klicken Sie auf die Schaltfläche Weiter, um den Bildschirm „Hierarchische Quellbeziehungen“ anzuzeigen, wenn die ausgewählten Tabellen eine hierarchische Beziehung aufweisen. Andernfalls wird der Bildschirm „Optionen für SQL Where-Klausel“ angezeigt.

• Klicken Sie auf die Schaltfläche Abbrechen, um den Assistenten zu schließen und zur Tab „Erste Schritte“ zurückzukehren, ohne Ihre Eingaben zu speichern.

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

Erstellen hierarchischer Beziehungen

• 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 auf die Schaltfläche Tabellen verknüpfen. Das Dialogfeld Verknüpfungseigenschaften wird angezeigt.

• Ziehen Sie im Abschnitt „Linkschlüssel“ eine übergeordnete Spalte (in diesem Beispiel OrderHeader) per Drag-and-drop in eine untergeordnete Spalte (in diesem Beispiel OrderDetail), 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 einen Link zwischen zwei Spalten auswählen, um die Schaltfläche Link entfernen zu aktivieren, und dann auf diese Schaltfläche klicken, um den Link zu entfernen.

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

• Wählen Sie nach Abschluss der Verknüpfung von übergeordnetem und untergeordnetem Element eine Optionsschaltfläche aus, um den Verknüpfungstyp anzugeben. Die Standardeinstellung ist „Eins oder Mehr“. In diesem Beispiel haben wir die Standardeinstellung auf „Eins oder Mehr“ belassen.

• Klicken Sie auf OK, um zum Bildschirm „Hierarchische Quellbeziehungen“ zurückzukehren, auf dem Ihr Tabellenbaum mit den aktuell definierten Beziehungen angezeigt wird. ODER klicken Sie auf Abbrechen, um zum Bildschirm „Hierarchische Quellbeziehungen“ zurückzukehren, ohne Ihre Eingaben zu speichern.

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

• Klicken Sie auf die Schaltfläche Weiter, um den optionalen SQL Where-Klausel-Bildschirm anzuzeigen.

• Klicken Sie auf die Schaltfläche Abbrechen, um den Assistenten zu schließen und zur Tab „Erste Schritte“ zurückzukehren, ohne Ihre Eingaben zu speichern.

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

Quell-SQL-WHERE-Klauselauswahl erstellen (optional)

• Geben Sie die gewünschte SQL Where-Klausel ein, um die Quelldaten zu filtern.

• Klicken Sie auf die Schaltfläche Weiter, um den optionalen Bildschirm zur Auswahl des Primärschlüssels anzuzeigen.

• Klicken Sie auf die Schaltfläche Abbrechen, um den Assistenten zu schließen und zur Tab „Erste Schritte“ zurückzukehren, ohne Ihre Eingaben zu speichern.

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

Auswahl des Quellprimärschlüssels erstellen (optional)

• Wählen Sie einen Primärschlüssel aus, indem Sie das Kontrollkästchen in der Spalte „Auswählen“ links neben dem Namen anklicken.

• Das Kontrollkästchen „Nullwert zulässig“ ist standardmäßig aktiviert. Lassen Sie es aktiviert, wenn eine Spalte Null-Datenelemente enthalten soll.

• Klicken Sie auf die Schaltfläche Auswahl aufheben, um Ihre Auswahl aufzuheben. Sie können dann neue Auswahlen treffen.

• Klicken Sie auf OK, um Ihre Auswahl zu speichern und zum Bildschirm „Einfügen/Aktualisieren“ zurückzukehren, der nun Ihre Auswahl anzeigt.

• Klicken Sie auf Abbrechen, um Ihre Auswahl zu verwerfen und zum Bildschirm „Einfügen/Aktualisieren“ zurückzukehren.

Aktualisieren Sie die Auswahl des Quelldatenfelds (optional und wird nur angezeigt, wenn die Transformation in ein flaches Ziel erfolgt.)

• Wählen Sie ein Feld in den Quelldaten zum Aktualisieren aus, wenn Sie bereits transformierte Zeilen herausfiltern möchten.

• Klicken Sie auf die Schaltfläche Weiter, um den Auswahlbildschirm für das Zieldateiformat anzuzeigen.

• Klicken Sie auf die Schaltfläche Abbrechen, um den Assistenten zu schließen und zur Tab „Erste Schritte“ zurückzukehren, ohne Ihre Eingaben zu speichern.

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

Erstellen des Ziels

• Dieser Bildschirm fordert Sie auf, ein XSD (ein XML Schema) basierend auf der Quelltabelle zu generieren.

• Klicken Sie auf die Schaltfläche Nein, um abzulehnen.

• Klicken Sie auf die Schaltfläche Ja, um ein XSD zu generieren. Der Bildschirm wird erweitert und zeigt ein Namensfeld und die Schaltfläche „XSD generieren“ an.

• Geben Sie einen XSD-Dateinamen ein und klicken Sie auf die Schaltfläche XSD generieren. Der Bildschirm wird erweitert und zeigt das XML- Schema an.

• Sie können auf die Schaltfläche Optionen klicken, um Optionen für den Stammnamen, den Zielnamespace und die Einbeziehung von Standardwerten anzugeben.

• Klicken Sie auf die Schaltfläche Weiter, um den Bildschirm „Zieloptionen“ anzuzeigen.

• Klicken Sie auf die Schaltfläche Abbrechen, um den Assistenten zu schließen und zur Tab „Erste Schritte“ zurückzukehren, ohne Ihre Eingaben zu speichern.

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

• 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.

  Notiz

  Wenn Sie die Option zum Generieren eines xsi:schemaLocation-Attributs im Ziel-XML wünschen, geben Sie einen Schemastandort in das Textfeld ein. In diesem Beispiel wählen wir diese Option nicht aus.

• Klicken Sie auf die Schaltfläche Weiter, um den Bildschirm „Dateiziel auswählen“ anzuzeigen.

• Klicken Sie auf die Schaltfläche Abbrechen, um den Assistenten zu schließen und zur Tab „Erste Schritte“ zurückzukehren, ohne Ihre Eingaben zu speichern.

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

In diesem Beispiel wurde das MyXML-Ziel zuvor außerhalb des Operation erstellt und wird hier angezeigt.

• Um ein vorhandenes Dateiziel auszuwählen, klicken Sie auf das Dropdown und treffen Sie Ihre Auswahl.

• Um ein vorhandenes Dateiziel zu bearbeiten, wählen Sie aus der Dropdown-Liste. Dadurch wird ein Dialogfeld geöffnet, in dem Sie die Zielparameter bearbeiten können.

• Klicken Sie auf die Schaltfläche Neu erstellen und füllen Sie die Felder aus, um ein neues Dateiziel zu erstellen.

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

Überprüfen Sie die Zusammenfassung des Operation

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 an Ihrem 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 „Transformation“ anzuzeigen. Der Entwurfsbereich wird ausgefüllt.

Überprüfen der Zuordnung

• Wenn Sie auf dem Bildschirm „Zusammenfassung“ auf Fertig stellen klicken, wird die Tab „Transformations“ im Arbeitsbereich geöffnet. Über der Tab wird außerdem die Meldung „Zuordnungen“ angezeigt.

• Wenn Sie diese Nachricht erhalten haben, klicken Sie auf Schließen. Vor dem Schließen können Sie auch das Kontrollkästchen Nicht mehr anzeigen aktivieren.

• 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 das Element von Quelle links auf Ziel rechts ziehen und dort ablegen. 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 die grafische Zusammenfassung des Operation anzuzeigen, doppelklicken Sie im linken Bereich unter „Jitterbit Connect/Datenbank zu XML“ auf den Namen des Vorgangs.

Bereitstellen des Projekts

• Klicken Sie oben im linken Bereich mit der rechten Maustaste auf den Projektnamen, um ihn hervorzuheben, und klicken Sie dann im angezeigten Dropdown-Menü mit der linken Maustaste auf Bereitstellen.

• Die Optionen zum Bereitstellen des Projekts werden angezeigt.

• Klicken Sie auf die Schaltfläche Bereitstellen, um Ihr Projekt einsetzen.

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

• Um diese Fortschrittsmeldung im Hintergrund auszuführen, klicken Sie auf die Schaltfläche Im Hintergrund ausführen.

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