Zum Inhalt springen

Jitterbit Northwinds App

Übersicht

Jitterbit stellt Northwinds über den Jitterbit Marketplace als Jitterbit App Builder-Releasepakete zur Verfügung. Das Paket enthält nicht etwa eine fertige Anwendung, sondern nur die klassische Northwinds-Beispieldatenbank mit vorgefüllten Beispieldaten, die als App-Builder-Datenquelle installiert wird.

Northwinds eignet sich hervorragend zur Ergänzung der Tutorial-Serie Einführung in App Builder, die diese Datenbank nutzt, um eine Bestellabwicklungs-App schrittweise über die Daten-, Business- und UI-Ebenen hinweg zu erstellen. Installieren Sie das Paket, um die Beispieldaten in Ihre Instanz zu laden, und folgen Sie dann dem Tutorial, um zu erfahren, wie eine App-Builder-App erstellt wird.

Sie laden Northwinds als App-Builder-Releasepakete (eine .LP-Datei) aus dem Marketplace herunter und installieren es in Ihre eigene App-Builder-Instanz.

Diese Seite beschreibt die Funktionsweise, sein Datenmodell, die Voraussetzungen, das Herunterladen und Installieren, das Verwenden zum Erlernen von App Builder und häufige Schritte zur Fehlerbehebung.

Funktionsweise

Das Installieren des Pakets fügt die Northwinds-Beispieldatenbank als Datenquelle zu Ihrer App-Builder-Instanz hinzu, mit vorgefüllten Beispieldaten. Die Datenquelle wird versiegelt installiert. Um darauf aufzubauen, entstiegeln Sie sie in einer Entwicklungsumgebung und folgen dann dem Tutorial, um eine App auf Basis dieser Datenbank zu erstellen:

%%{init: {"themeVariables": {"lineColor": "#6b7280", "edgeLabelBackground": "#f5f5f5"}}}%% flowchart TD A["Install the Northwinds
package in App Builder"] --> B["Northwinds data source
added to your instance,
pre-loaded with sample data"] B --> C["Unseal the data source
in a development environment"] C --> D["Build an order-fulfillment app
by following the tutorial"]

Datenmodell

Die Northwinds-Beispieldatenbank enthält die standardmäßigen Northwinds-Entitäten: Kunden, Bestellungen, Bestellpositionen, Produkte, Kategorien, Mitarbeiter und Versender. Jede Tabelle wird mit Beispieldaten vorgefüllt installiert.

Voraussetzungen

Um Northwinds zu verwenden, benötigen Sie Folgendes:

  • Eine Jitterbit Harmony-Lizenz mit Zugriff auf App Builder. Dies ermöglicht den Marketplace-Download. Wenn Ihre Organisation nicht für App Builder lizenziert ist, wird die Aktion App herunterladen durch die Aktion App anfordern ersetzt (siehe Herunterladen und Installieren).

  • Eine App-Builder-Instanz und eine unterstützte Datenbank. Northwinds wird als separates Paket für jede App-Builder-Version und jede Datenbank bereitgestellt: App Builder 4.46 bis 4.58 für PostgreSQL und 4.48 bis 4.57 für Microsoft SQL Server. Jedes Paket kann nur auf der exakten App-Builder-Version installiert werden, für die es erstellt wurde. Laden Sie daher diejenige herunter, die Ihrer Instanzversion und Datenbank entspricht. Falls kein aufgelistetes Paket Ihrer Version entspricht, wenden Sie sich an den Jitterbit-Support, um eines anzufordern.

Herunterladen und Installieren

App aus dem Marketplace herunterladen

  1. Melden Sie sich im Harmony-Portal unter https://login.jitterbit.com an und öffnen Sie Marketplace.

  2. Suchen Sie die App namens Northwinds. Sie können die Suchleiste verwenden oder im Bereich Filter unter Typ die Option App auswählen, um nur Apps anzuzeigen.

  3. Klicken Sie auf die App-Karte, um das Bedienfeld Details zu öffnen. Überprüfen Sie die Anforderungen der App (die erforderliche App-Builder-Version und Datenbank).

  4. Klicken Sie auf den Link Zur Dokumentation der App, um diese Dokumentation in einem separaten Tab zu öffnen, und lassen Sie diesen für die Referenz offen.

  5. Führen Sie einen der folgenden Schritte aus, je nachdem, ob Ihre Organisation für App Builder lizenziert ist:

    • App herunterladen: Falls Ihre Organisation für App Builder lizenziert ist, klicken Sie auf App herunterladen, entweder auf der App-Karte oder im Bedienfeld Details. Ihr Browser speichert die .LP-Datei am Download-Ort, und eine Benachrichtigung App-Builder-Datei erfolgreich heruntergeladen bestätigt den Download.

    • App anfordern: Falls Ihre Organisation nicht für App Builder lizenziert ist, ist die Aktion mit App anfordern gekennzeichnet. Das Bedienfeld Details zeigt eine Nachricht an, die besagt, dass eine App-Builder-Lizenz erforderlich ist, zusammen mit einer Schaltfläche Absenden. Klicken Sie auf Absenden, um eine Anfrage zu senden, damit sich ein Vertreter mit Ihnen bezüglich App Builder in Verbindung setzt. Eine Benachrichtigung Nachricht erfolgreich gesendet bestätigt dies.

Die App in App Builder installieren

Installieren Sie die heruntergeladene .LP-Datei in Ihrer App Builder-Instanz:

  1. Melden Sie sich bei App Builder an und gehen Sie zur IDE.

  2. Klicken Sie unter Deploy auf Install Release.

  3. Klicken Sie auf + Package, dann Browse und wählen Sie die heruntergeladene .LP-Datei.

  4. Klicken Sie auf Save. Das Panel Release zeigt die Paketinformationen an und schließt dann das Dialog Package.

  5. Bestätigen Sie, dass die Details korrekt sind, und klicken Sie dann auf Install.

Die Datenquelle entsperren

Die Datenquelle Northwinds wird versiegelt installiert. Wenn Sie das Paket in einer Entwicklungsumgebung bereitstellen und mit den Beispieldaten arbeiten oder das Datenmodell erweitern möchten (z. B. um die Einführung in App Builder-Tutorial-Serie zu folgen), entsperren Sie die Datenquelle. Lassen Sie sie in QA und Produktion versiegelt, um die Equivalenz über Umgebungen hinweg zu bewahren.

  1. Wählen Sie IDE > Data Servers.

  2. Klicken Sie im Panel Data Servers auf View All Data Sources.

  3. Wählen Sie die installierte Datenquelle Northwinds.

  4. Klicken Sie im Panel Data Source auf More > Unseal Data Source.

Weitere Informationen finden Sie unter Datenquelle versiegeln oder entsperren.

App Builder mit Northwinds erlernen

Northwinds ist die Datenbank, die in der gesamten Einführung in App Builder-Tutorial-Serie verwendet wird. Diese Serie entwickelt schrittweise über die Daten-, Business- und UI-Schichten hinweg eine Bestellabwicklungs-App. Wenn Sie neu in App Builder sind, installieren Sie die Beispieldatenbank und folgen Sie dem Tutorial, um zu sehen, wie jeder Teil konstruiert ist.

Am Ende des Tutorials werden Sie eine App mit einer Seite Customers zum Durchsuchen und Verwalten von Kunden und einer Seite Orders erstellt haben, die jede Bestellung zusammen mit ihren Versandinformationen, dem Kunden und den Positionen anzeigt:

Fehlerbehebung

Überprüfen Sie Ihre App Builder-Protokolle und kontaktieren Sie den Jitterbit-Support, um Hilfe bei der Installation, der Datenquelle oder den Beispieldaten zu erhalten.