So erstellen Sie ein Release-Paket im Jitterbit App Builder

Einführung

Diese Seite zeigt Ihnen, wie Sie ein Release-Paket erstellen, das eine ausgewählte Sammlung von Anwendungen, Datenquellen und anderen Komponenten ist, die zusammen für die Bereitstellung verpackt sind. Dieser Prozess wird verwendet, wenn eine Anwendung von einer Umgebung in eine andere verschoben wird, beispielsweise beim Verschieben einer Anwendung von Entwicklungs- zu QA-Umgebungen und von dort in Produktionsumgebungen.

Das folgende Diagramm zeigt, was ein Release enthält.

Erstellen eines Releases

Das Erstellen eines Releases in ein Paket und das anschließende Installieren eines Pakets in einer neuen Umgebung erfolgt im Bereich Bereitstellung, der über die App Builder IDE zugänglich ist. Während dieses Prozesses bewegen Sie sich von der linken Seite des Bildschirms Release Template Builder zur rechten Seite, während Sie alle hier beschriebenen Schritte durchlaufen:

1. Wählen Sie Aktionsbereich > IDE.

2. Wählen Sie Bereitstellen > Release erstellen.

3. Um einen Build zu starten, können Sie entweder eine vorhandene Vorlage auswählen (wenn Sie ein vorhandenes App-Upgrade aktualisieren) oder auf + Release klicken, um eine neue Vorlage zu erstellen.

4. Wenn Sie eine vorhandene Vorlage verwenden, klicken Sie auf die Schaltfläche Template für den vorhandenen Vorlageneintrag.

5. Aktualisieren Sie die Felder Name, Version und Developer auf dem Bildschirm Release Details, um den Build widerzuspiegeln, den Sie erstellen:

   

6. Klicken Sie auf die Schaltfläche Next.

7. Auf dem Bildschirm Solution Objects wählen Sie aus, was in das Release-Paket aufgenommen werden soll. Die Optionen sind wie folgt:

   • Anwendung
   • Assembly
   • Bundle
   • Sammlung
   • Datenquelle
   • Funktion
   • Logischer Datentyp
   • Seite
   • Rolle
   • Regel
   • SQL-Objekt
   • Widget

   Um eines dieser Elemente hinzuzufügen, klicken Sie auf die Schaltfläche + Object, wählen Sie den Typ aus dem Menü aus und klicken Sie dann auf die Schaltfläche Save:

   

   Hinweis

   Die folgenden Punkte gelten für Release-Pakete:

   • Wenn Sie ein Anwendungsobjekt hinzufügen, werden das Bundle und die Datenquelle der Anwendung automatisch zum Release-Paket hinzugefügt.

   • Das Release-Paket enthält keine Instanzgruppen, Instanz-Sicherheitsanbieter oder Serveranmeldeinformationen.

   • Neu unterstützte Objekte (wie Funktionen und logische Datentypen) werden nicht automatisch zu vorhandenen Vorlagen hinzugefügt. Sie müssen sie selbst hinzufügen.

8. Klicken Sie auf die Schaltfläche Next.

9. Der Bildschirm Configure Data Sources listet alle Datenquellen auf, die für den Release-Build relevant sind. (Wenn keine Datenquellen vorhanden sind, wird dieser Schritt übersprungen.) Überprüfen Sie für jede aufgeführte Datenquelle die Spalte Include und stellen Sie sicher, dass sie so eingestellt ist, wie Sie es für den Build wünschen. Je nach Typ der Datenquelle stehen folgende Optionen zur Verfügung:

   • Logical Model Only: Verwenden Sie, wenn Sie nur die Daten paketieren möchten, die in App Builder erstellt wurden und existieren. Beispiele: Daten- und Geschäftsobjekte, Unterabfragen, CRUDs, Workflows, Brücken. Diese Option wird in der Regel für Datenquellen verwendet, die Sie nicht besitzen und/oder die nicht über App Builder verwaltet werden (externe Datenquellen, API-Datenquellen usw.).

10. Nur physisches Modell: Verwenden Sie dies, wenn Sie nur die Tabellen und Spaltenstrukturen der Datenquelle ohne die Daten verpacken möchten.

11. Logisches Modell und physische Tabellen: Verwenden Sie dies, wenn Sie alle Daten, die im App Builder selbst vorhanden sind, sowie die zugrunde liegenden Tabellen und Spaltenstrukturen der Datenquelle mitbringen möchten. Hier bezieht sich physisch darauf, dass der App Builder die tatsächliche Datenbankebene verwaltet oder aktualisiert. Wenn Sie ein physisches Modell verschieben, bedeutet das, dass alle Änderungen, die in der Entwicklung an der Datenbank vorgenommen wurden, auch in der QA/Prod-Datenbank beim Verschieben des LP vorgenommen werden. Diese Option wird in der Regel für Datenquellen verwendet, die Sie verwalten.

12. Nicht einbeziehen: Verwenden Sie dies, wenn Sie diese Datenquelle in diesem Release nicht einbeziehen möchten.

    Wichtig

    Wenn Sie Datenbankänderungen haben, die übernommen werden müssen, sollten Sie Logisch und Physisch für diese Datenbank verschieben. Der Release-Management-Prozess unterstützt das Importieren von Tabellen. Wenn Sie Tabellen in eine Datenquelle importieren, werden diese importierten Tabellen im Zielsystem erstellt, wenn sie Teil des ersten physischen Änderungssets sind.

13. Klicken Sie auf die Schaltfläche Weiter.

14. Wenn Sie Übersetzungen in Ihrer App haben, erscheint der Bildschirm Lösungsbündel. Andernfalls erscheint der Bildschirm Versionshinweise mit Überblicksinformationen über das Release-Paket:

    

    • Name: Der Name Ihrer Anwendung.

    • Version: Die Versionsnummer des zu erstellenden Pakets.

    • Veröffentlichungsdatum: Das Datum, an dem das Release erscheinen soll (dies ist ein vorläufiges Datum und kann vom tatsächlichen Veröffentlichungsdatum abweichen).

    • Erstellungsdatum: Das Datum, an dem Sie das Paket erstellt haben.

    • Veröffentlichungsdatum: Das Datum, an dem Sie das Paket veröffentlicht haben.

    • Vorlagenbeschreibung: Eine textliche Beschreibung dessen, was Ihre App oder Suite tut.

15. Klicken Sie auf die Schaltfläche Weiter.

16. Überprüfen Sie die Informationen auf dem Bildschirm Veröffentlichen, und klicken Sie dann auf die Schaltfläche Fertigstellen.

    Sie sollten jetzt wieder auf dem Bildschirm Release-Vorlagen-Builder sein, wobei die Spalte Bereit ein grünes Häkchen enthält.

17. Klicken Sie auf die Schaltfläche Datenbankänderungen, und Sie wissen, dass Sie unbestätigte Änderungen zur Überprüfung und Genehmigung haben, wenn ein rotes Häkchen in der DB-Spalte auf dem Bildschirm Release Template Builder erscheint. Der Bildschirm Änderungsmanagementanfragen listet alle mit der Datenquelle verbundenen Änderungen auf, die Teil des Pakets sein werden. Wenn Sie Änderungen sehen, die mit einem roten Häkchen in der Status-Spalte aufgeführt sind, müssen Sie manuell darauf klicken, um sie zu überprüfen und zu genehmigen.

    Das Klicken zur Überprüfung bringt Sie zum Bildschirm Änderungsmanagementanfrage. Hier wird das Feld Patchnummer automatisch mit einem Wert ausgefüllt und zeigt an, welche Iteration dieses Paketupdate widerspiegelt. Stellen Sie sicher, dass Sie alle Einträge im Bereich Änderungen überprüfen, um sicherzustellen, dass diese Informationen dem entsprechen, was Sie erwarten, dass mit dem Paket übertragen wird. Auf diesem Bildschirm müssen Sie Folgendes eingeben:

    • Referenznummer: Dies kann den Wert der Patchnummer widerspiegeln, eine JIRA- oder AHA-Ticketreferenz sein oder einen Kundennummernwert verwenden.

    • Kurze Beschreibung: Geben Sie eine Textbeschreibung zum Paket an. Falls gewünscht, fügen Sie zusätzliche Informationen im Feld Kommentare hinzu.

18. Klicken Sie auf die Schaltfläche Speichern, und wenn Sie bereit sind, fortzufahren, klicken Sie auf die Schaltfläche Diese Anfrage schließen.

19. Schließen Sie die verbleibenden Bildschirme, sodass Sie den Bildschirm Release Template Builder sehen. Sie werden jetzt ein grünes Häkchen in der DB-Spalte sehen.

20. Die Datenkonfiguration ist optional und wird nur verwendet, wenn Sie Logische und Physische Daten mit dem Paket übertragen. Vom Bildschirm Datenkonfiguration aus sehen Sie die Positionen aller Datenquellen, Tabellen für die Datenquelle sowie den Besitzertyp, der zugewiesen wurde, zusammen mit der entsprechenden Aktion, die erfolgt, wenn die Tabelle in diese Umgebung verschoben wird. Die verschiedenen Besitzertypen sind wie folgt:

    • Benutzerdaten: Überträgt keine der Daten. Die Benutzer in jeder Umgebung sind dafür verantwortlich, diese Tabelle zu befüllen. Zum Beispiel: Kunden oder Bestellungen, die transaktionale Tabellen sind.

    • Freigabedaten: Fügt die neuen Datensätze nur in die nächste Umgebung ein. Zum Beispiel: Email-Vorlagen, die eine Tabelle sind, die der Benutzer anpassen möchte.

21. Entwicklerdaten: Kürzt die Tabelle in QA und fügt alle Datensätze aus dem Paket ein. Dies wird typischerweise verwendet, wenn Sie Lookup-Tabellen oder Tabellen haben, die Teil einer Konfiguration sind. Zum Beispiel: Kundentyp, Mitarbeitertyp.

22. Informationen können manuell für Eigentümertypen überschrieben und für das spezifische Paket festgelegt werden, oder Sie können einfach auf Konfiguration bestätigen klicken. Dies markiert diesen Prozess als abgeschlossen und kehrt zum Bildschirm Release Template Builder zurück. Beachten Sie, dass die beste Praxis der Jitterbit-Methodik darin besteht, den Wert der Installationsoption auf Tabellenebene festzulegen, der dem Eigentümertyp im Bildschirm Release Template Builder zugeordnet ist. Installationsoptionen sind Benutzerdaten, Freigabedaten und Entwicklerdaten. Wenn die Werte auf Tabellenebene festgelegt sind, werden diese Einstellungen in das Release-Paket übertragen. Diese Informationen auf Tabellenebene festzulegen, ist hilfreich für Projekte mit mehreren Teammitgliedern.

23. Der Bereich SQL-Konfiguration ermöglicht es Ihnen, die Datenbank auszuwählen und zu sehen, ob es Objekte (Sichten oder gespeicherte Prozeduren) gibt, die auf der Datenbank auf der nativen SQL-Ebene gespeichert sind. Dies ermöglicht es Ihnen, Sichten oder gespeicherte Prozeduren zu verschieben. Diese Informationen werden nicht automatisch auf dem resultierenden Bildschirm Code angezeigt, und Sie müssen manuell auf die Schaltfläche Erstellen klicken und sie hinzufügen. Dieser Schritt wird typischerweise nur in fortgeschrittenen Situationen verwendet und ist kein erforderlicher Schritt.

24. Der Schritt Bauen zeigt die Version für dieses Release an, ermöglicht es Ihnen, spezifische Notizen zu diesem Release hinzuzufügen, und lässt Sie eine Option auswählen, um einen Snapshot vor dem Bauen zu erstellen. Wenn Sie Ihre Release-Notizen strukturieren, sollten Sie ein Format wie im folgenden Screenshot verwenden. Es ist wichtig, über die Zeit einen konsistenten Prozess für die Benennung Ihrer Release-Notizen zu verfolgen, insbesondere wenn Ihr Projekt eines ist, an dem mehrere Personen arbeiten. Dies wird zu einem fortlaufenden Protokoll der App-Release-Notizen.

25. Klicken Sie auf die Schaltfläche Paket erstellen, die einen Hintergrundjob startet, der das Paket erstellt. Es gibt keine Benachrichtigung, die Sie darüber informiert, wann das Paket fertig ist und/oder fehlschlägt. Um den Status des Prozesses zu überprüfen, müssen Sie zum App Builder IDE, zu Servern und Zeitplänen verwalten und das Panel Instanz laufende Jobs überprüfen.

26. Der Zurücksetzen-Button entfernt alle Informationen, die mit der Paketvorlage verbunden sind, und ermöglicht es Ihnen, mit einer sauberen Grundlage für Ihren Paketaufbau zu beginnen.

27. Klicken Sie auf das Packages-Symbol, das Sie zum Bildschirm für Lösungsfreigaben bringt, auf dem die herunterladbare LP-Datei für die nächste Umgebung erstellt wurde. Dies ist die Datei, die Sie zur Installation in die nächste Umgebung mitnehmen werden. Laden Sie von diesem Bildschirm die Paketdatei herunter und speichern Sie sie lokal auf Ihrem Computer.

28. Mit der verfügbaren LP-Datei gehen Sie zu Ihrer nächsten Umgebung, in der Sie sie installieren werden (QA oder Prod). Gehen Sie von dort aus zu Deploy your Application im App Builder IDE und klicken Sie auf die Install Release-Schaltfläche.

    Tipp

    Um den Inhalt des Pakets vor der Installation zu sehen, klicken Sie auf die Manifest-Schaltfläche.

29. Klicken Sie auf die Erstellen-Schaltfläche und Durchsuchen, um die Paketdatei zu finden, und klicken Sie auf Speichern. Nach dem Speichern sehen Sie im rechten Bereich das Lösungsfeld, das die Paketinformationen zu Name, Version, Entwickler, Veröffentlichungsdatum, Beschreibung und Versionshinweisen anzeigt.

30. Klicken Sie auf die Installieren-Schaltfläche, nachdem Sie bestätigt haben, dass dies das Paket ist, das Sie installieren möchten. Dieser Prozess läuft im Vordergrund. Wenn er erfolgreich ist, erhalten Sie eine Erfolgsmeldung. Wenn er fehlschlägt, gehen Sie zu Logs > App Server Fast Logs, und Sie sehen spezifische Fehlermeldungen, warum die Installation fehlgeschlagen ist.

Zeitpläne und Freigabepakete

Zeitpläne werden in ein Freigabepaket (oder LP) aufgenommen, es sei denn, sie werden manuell entfernt, wenn das Paket erstellt wird. Von der Gestaltung her sind Zeitpläne, die in einer Produktionsumgebung bereitgestellt wurden, "versiegelt" oder daran gehindert, bestimmte Änderungen an den Zeitplaninformationen vorzunehmen. Dies verhindert, dass jemand versehentlich Entwicklungsänderungen in einer nachgelagerten Umgebung vornimmt, was zu verschiedenen Problemen führen könnte, wenn versucht wird, die App in der Zukunft bereitzustellen. Zeitpläne sind Teil einer Anwendung, daher sind sie in diesen nachgelagerten Umgebungen "versiegelt". Sie können Zeitpläne ein- oder ausschalten oder die Zeit anpassen, aber Sie können den Ausführungstyp eines Zeitplans nicht ändern.

Es gibt einige Szenarien, in denen Sie einen Zeitplan in der Entwicklungsumgebung (Dev) einrichten, aber in der Produktionsumgebung (Production) der Dev-Zeitplan deaktiviert wird. Zum Beispiel bei der Interaktion mit einer API. Möglicherweise möchten Sie nur aus der Produktionsumgebung mit einer API interagieren, sodass Sie den Zeitplan in der Entwicklungsumgebung deaktivieren können, sobald die Entwicklung abgeschlossen ist.

Sobald ein Zeitplan zu einem LP hinzugefügt wurde, beachten Sie, dass nicht alle Änderungen am Zeitplan in zukünftige Builds eines Pakets übernommen werden. Wenn Sie Ereignisse, die mit einem Zeitplan verbunden sind, hinzufügen oder entfernen, werden diese Änderungen in einem neuen Build reflektiert. Andere Änderungen an der Zeitplandefinition werden nicht in zukünftige Builds übernommen.

Um Änderungen an einem versiegelten Produktionszeitplan vorzunehmen, können Sie einen neuen Zeitplan erstellen, der dann im nächsten LP enthalten ist. Dieser Prozess stellt sicher, dass der Zeitplan korrekt erstellt wird und alle neuen Einstellungen in den nachgelagerten Umgebungen reflektiert werden.