Jitterbit Northwinds App

Übersicht

Jitterbit stellt Northwinds über den Jitterbit Marketplace als Jitterbit App Builder-Releasepakete bereit. Das Paket enthält nicht etwa eine fertige Anwendung, sondern nur die klassische Northwinds-Beispieldatenbank, die mit Beispieldaten vorgeladen ist und als App Builder-Datenquelle installiert wird.

Northwinds soll zusammen mit der Tutorialserie Einführung in App Builder verwendet werden. Diese Serie nutzt diese Datenbank, um eine Bestellerfüllungs-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 Ihrer eigenen App Builder-Instanz.

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

Funktionsweise

Durch die Installation des Pakets wird die Northwinds-Beispieldatenbank als Datenquelle zu Ihrer App Builder-Instanz hinzugefügt, vorgeladen mit Beispieldaten. Die Datenquelle wird versiegelt installiert. Um darauf aufzubauen, entsiegeln Sie sie in einer Entwicklungsumgebung und folgen dann dem Tutorial, um eine App darauf zu erstellen:

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 Versandunternehmen. Jede Tabelle wird mit Beispieldaten vorgeladen 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 eine 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 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 wird nur auf der genauen App Builder-Version installiert, für die es erstellt wurde. Laden Sie daher das Paket herunter, das Ihrer Instanzversion und Datenbank entspricht. Wenn kein aufgelistetes Paket Ihrer Version entspricht, wenden Sie sich an den Jitterbit-Support, um eines anzufordern.

Herunterladen und Installieren

Melden Sie sich beim Harmony-Portal unter https://login.jitterbit.com an und öffnen Sie Marketplace.
Suchen Sie die App mit dem Namen Northwinds. Sie können die Suchleiste verwenden oder im Bereich Filter unter Typ die Option App auswählen, um nur Apps anzuzeigen.
Klicken Sie auf die App-Karte, um das Bedienfeld Details zu öffnen. Überprüfen Sie die Anforderungen der App (die App Builder-Version und die Datenbank, die sie benötigt).
Klicken Sie auf den Link Zur Dokumentation der App, um diese Dokumentation in einem separaten Tab zu öffnen, und halten Sie ihn zur Referenz offen.
Führen Sie je nachdem, ob Ihre Organisation für App Builder lizenziert ist, einen der folgenden Schritte aus:
- App herunterladen: Wenn 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 an ihrem Download-Speicherort, und eine Benachrichtigung App Builder-Datei erfolgreich heruntergeladen bestätigt den Download.
- App anfordern: Wenn Ihre Organisation nicht für App Builder lizenziert ist, wird die Aktion als App anfordern bezeichnet. Das Bedienfeld Details zeigt eine Meldung an, dass eine App Builder-Lizenz erforderlich ist, mit einer Schaltfläche Absenden. Klicken Sie auf Absenden, um eine Anfrage zu senden, damit sich ein Vertreter mit Ihnen über App Builder in Verbindung setzt. Eine Benachrichtigung Nachricht erfolgreich gesendet bestätigt dies.

App in App Builder installieren

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

Melden Sie sich bei App Builder an und gehen Sie zur IDE.
Klicken Sie unter Deploy auf Install Release.
Klicken Sie auf + Package, dann auf Browse und wählen Sie die heruntergeladene .LP-Datei aus.
Klicken Sie auf Save. Das Panel Release zeigt die Paketinformationen an und schließt dann den Dialog Package.
Bestätigen Sie, dass die Details korrekt sind, und klicken Sie auf Install.

Datenquelle entsperren

Die Northwinds-Datenquelle 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-Tutorialserie zu folgen), entsperren Sie die Datenquelle. Lassen Sie sie in QA und Produktion versiegelt, um die Konsistenz zwischen Umgebungen zu bewahren.

Wählen Sie IDE > Data Servers.
Klicken Sie im Panel Data Servers auf View All Data Sources.
Wählen Sie die installierte Datenquelle Northwinds aus.
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-Tutorialserie verwendet wird. Diese Serie erstellt schrittweise eine Auftragserfüllungs-App auf der Datenbank über die Daten-, Business- und UI-Schichten. Wenn Sie neu bei App Builder sind, installieren Sie die Beispieldatenbank und folgen Sie dem Tutorial, um zu sehen, wie jeder Teil aufgebaut ist.

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

Fehlerbehebung

Wenn Sie Hilfe bei der Installation, der Datenquelle oder den Beispieldaten benötigen, überprüfen Sie Ihre App Builder-Protokolle und kontaktieren Sie den Jitterbit-Support.