Projekte mit der visuellen Anwendungsvorlage erstellen und einrichten

Wenn sich Ihre VB Studio-Instanz in derselben Identitätsdomain wie Ihre Visual Builder-Instanz befindet, können Sie ein Projekt basierend auf der Vorlage für die visuelle Anwendung erstellen und dann einige Konfigurationseinstellungen im Projekt vornehmen, damit es für die Entwicklung visueller Anwendungen bereit ist.

Im Folgenden finden Sie eine Übersicht darüber, wie Sie ein VB Studio-Projekt für die Entwicklung erstellen und einrichten, beginnend mit der Vorlage für visuelle Anwendungen:

So führen Sie diese Aktion aus: Informationen hierzu finden Sie unter:
1. Ein Projekt erstellen. Projekte mit der visuellen Anwendungsvorlage erstellen
Hinweis

Bevor Sie versuchen, ein Projekt zu erstellen, stellen Sie sicher, dass Ihre VB Studio-Instanz autorisiert ist, auf Visual Builder-Instanzen zuzugreifen, die mit Ihrem OCI-Account verbunden sind. Ohne diese Autorisierung sind diese Instanzen nicht zur Auswahl als Deployment-Ziel in Ihrem Projekt verfügbar. Siehe VB Studio für den Zugriff auf Visual Builder- und Integrationsinstanzen autorisieren.
2 (Optional) Konfigurieren Sie den Deployment-Job, um Zugangsdaten für die Verbindung zur Zielentwicklungsinstanz hinzuzufügen. Deployment-Job konfigurieren

Wenn Sie ein Projekt mit der Visual Application-Vorlage erstellen, wird ein Workspace erstellt, der so konfiguriert ist, dass Ihre visuelle Anwendung über eine CI/CD-Pipeline in der Visual Builder-Entwicklungsinstanz bereitgestellt wird. Falls gewünscht, können Sie die CI/CD-Pipeline deaktivieren und stattdessen direkt in der Visual Builder-Entwicklungsinstanz bereitstellen.

Wenn Sie die CI/CD-Pipeline für das Deployment deaktivieren, überspringen Sie diesen Schritt.

3 (Optional) Prüfen Sie Ihre Zugangsdaten, indem Sie die Entwicklungspipeline ausführen. Pipeline manuell ausführen

Wenn Sie die CI/CD-Pipeline für das Deployment deaktivieren, überspringen Sie diesen Schritt.

4. Bereitgestellte visuelle Anwendungen anzeigen. Bereitgestellte visuelle Anwendung anzeigen
5. Fügen Sie dem Projekt Teammitglieder hinzu. Benutzer zum Projekt hinzufügen

Projekte mit der visuellen Anwendungsvorlage erstellen

Wenn Sie eine visuelle Anwendung mit einer VB Studio-Instanz entwickeln, die sich in derselben Identitätsdomain wie Ihre Visual Builder-Instanz befindet, können Sie schnell beginnen, indem Sie Ihr Projekt auf der Projektvorlage "Visuelle Anwendung" basieren.

  1. Melden Sie sich bei VB Studio an. Siehe Auf VB Studio von der Oracle Cloud-Homepage zugreifen.
  2. Klicken Sie auf der Seite "Organisation" auf + Erstellen.
  3. Geben Sie auf der Seite Projektdetails des Assistenten "Neues Projekt" einen eindeutigen Namen und eine Beschreibung für das Projekt ein.
  4. Wählen Sie unter Sicherheit den Datenschutz des Projekts aus:
    1. Wählen Sie Privat aus, um den Zugriff nur auf Projektmitglieder einzuschränken.

      Aktivieren Sie das Kontrollkästchen Erkennbar, damit Organisationsmitglieder, die keine Organisationsadministratoren oder Projektmitglieder sind, grundlegende Informationen zu Ihrem privaten Projekt anzeigen können, wie z.B. Name und Kontaktinformationen des Verantwortlichen. Private Projekte, die nicht auffindbar sind, werden nicht Nichtmitgliedern ausgesetzt.

    2. Wählen Sie Gemeinsam verwendet aus, um den Projektcode, die Wiki-Dokumente, Aufgaben und Builds für alle Personen innerhalb Ihrer Organisation verfügbar zu machen.
  5. Geben Sie unter Bevorzugte Sprache die Sprache für die E-Mail-Benachrichtigungen an, die Ihre Projektbenutzer erhalten sollen.
    Sie können die Sprache ändern, in der die Benutzeroberfläche in Ihren Benutzereinstellungen angezeigt wird.
  6. Klicken Sie auf Weiter.
  7. Wählen Sie auf der Seite Projektvorlage die Projektvorlage Visuelle Anwendung aus, und klicken Sie auf Weiter.
  8. Gehen Sie auf der Seite Projekteigenschaften wie folgt vor:
    1. Ändern Sie unter Git-Repository-Name den Standardnamen des Git-Repositorys, falls erforderlich.
    2. Wählen Sie unter Region und Compartment die OCI-Region und das Compartment aus, in der sich Ihre Visual Builder-Instanz befindet.
    3. Wählen Sie unter Entwicklungs-VB-Instanz die Visual Builder-Entwicklungsinstanz aus, wenn sie noch nicht ausgewählt ist.
      Wenn die erforderliche Visual Builder-Instanz nicht angezeigt wird, gehen Sie zurück, und ändern Sie Ihre Auswahl für die OCI-Region und das Compartment.
    4. Wählen Sie unter Visuelle Anwendungsvorlage eine visuelle Anwendungsvorlage aus, die in der ausgewählten Entwicklungsinstanz verfügbar ist.
      Standardmäßig verwendet VB Studio die Vorlage Standard-VB-Anwendung. Um eine andere Vorlage auszuwählen, klicken Sie auf Vorlage ändern, wählen Sie die Vorlage aus, und klicken Sie auf Ausgewählte verwenden.
    5. (Optional) Ändern Sie bei Bedarf unter Workspace-Name den Namen Ihres privaten Workspace. Standardmäßig ist dies Workspace1.

      Ein Workspace enthält alle Artefakte, die Sie zur Entwicklung visueller Anwendungen benötigen, einschließlich eines Klons des Git-Repositorys dieses Projekts und der Verzweigung, in der die Quelldateien enthalten sind. Weitere Informationen zu Workspaces finden Sie unter Workspace erstellen in Responsive Anwendungen mit Visual Builder Studio erstellen.

    6. (Optional) Ändern Sie bei Bedarf unter Arbeitsverzweigungsname den Arbeitsverzweigungsnamen des Workspace. Standardmäßig ist dies branch1.
      Wenn das Projekt bereitgestellt wird, enthält die Verzweigung main des Git-Repositorys die Dateien Ihrer Anwendung. Beim Erstellen des Workspace erstellt VB Studio eine Kopie der Verzweigung main, benennt sie mit dem angegebenen Namen um und verwendet sie als Arbeitsverzweigung des Workspace.
    7. Klicken Sie auf Weiter.
  9. Gehen Sie auf der Seite Team wie folgt vor:
    1. Klicken Sie auf Mitglieder hinzufügen, und wählen Sie in der angezeigten Liste Benutzer oder Gruppen aus, die dem Projekt hinzugefügt werden sollen.
    2. Wählen Sie die Mitgliedschaft (Projektverantwortlicher, Vollzugriff für Entwickler, eingeschränkter Zugriff für Entwickler oder Mitwirkender) aus, die Mitglieder, die Sie hinzufügen, im Projekt haben.
      Weitere Informationen zu den einzelnen Mitgliedschaften finden Sie unter Was sind Projektmitgliedschaften?.
    3. Klicken Sie auf Hinzufügen.
    4. Wiederholen Sie bei Bedarf die Unterschritte a, b und c für verschiedene Benutzer und Gruppen mit verschiedenen Mitgliedschaftstypen.
  10. Klicken Sie auf Fertigstellen.
Nachdem das Projekt bereitgestellt wurde, wird die Seite Projekt-Home geöffnet, auf der Sie eine Übersicht über die Provisioning-Aktivitäten des Projekts, die Standardumgebung, den Standardarbeitsbereich und die Git-, Maven- und NPM-Repositorys anzeigen können. Prüfen Sie den Aktivitätsfeed und das Feld "Umgebungen" auf Fehler.

Wenn Sie ein Projekt mit der Vorlage für die visuelle Anwendung erstellen, werden folgende Artefakte für Sie erstellt:

  • Ein Git-Repository, das den Quellcode der visuellen Anwendung enthält.

    Um die Dateien des Git-Repositorys anzuzeigen, gehen Sie zur Seite Projekt-Home, klicken Sie auf die Registerkarte Repositorys und dann auf den Git-Repository-Namen:

  • Eine Entwicklungsumgebung, die auf die Visual Builder-Entwicklungsinstanz verweist.

    Klicken Sie im linken Navigator auf Umgebungen Umgebungen, um die Entwicklungsumgebung anzuzeigen:

  • Erstellen Sie Jobs, die das Artefakt der visuellen Anwendung verpacken und in der Entwicklungsinstanz von Visual Builder bereitstellen.

    Standardmäßig werden die Jobs Visual-Application-Package und Visual-Application-Deploy für Sie erstellt. Der Job Visual-Application-Package generiert die Artefaktdatei der visuellen Anwendung. Der Job Visual-Application-Deploy stellt die Artefaktdatei der visuellen Anwendung in der Visual Builder-Entwicklungsinstanz bereit.

    Klicken Sie im linken Navigator auf Builds Builds, und klicken Sie dann auf die Registerkarte Jobs, um die Build-Jobs anzuzeigen:

    Um Builds des Packages auszuführen und Jobs bereitzustellen, müssen Sie zunächst VM-Build Executors zuweisen und die entsprechenden Deployment-Konfigurationen vornehmen. Ohne die entsprechende Konfiguration oder VM Executors werden die Builds nicht ausgeführt.

  • Eine Pipeline zum Ausführen der Build-Jobs in einer Sequenz.

    Klicken Sie im linken Navigator auf Builds Builds und dann auf die Registerkarte Pipelines. Klicken Sie in der Zeile der Pipeline auf das Menü Aktionen Aktionen, und wählen Sie Layout anzeigen aus.

    Wenn Sie die CI/CD-Pipeline umgehen und stattdessen direkt in der Visual Builder-Instanz bereitstellen möchten, ändern Sie die CI/CD-Pipelineeinstellung.

  • Ein privater Arbeitsbereich zum Bearbeiten der visuellen Anwendung in VB Studio Designer.

    Klicken Sie im linken Navigator auf Workspaces Designer, um den Workspace anzuzeigen:

  • Standardmäßig verwendet das Projekt die Standard-Markup-Sprache der Organisation. Die Benutzer Ihres Projekts verwenden die Markup-Sprache, um Wiki-Seiten und Kommentare zu formatieren. Bei Bedarf können Sie die Markup-Sprache des Projekts auf der Seite Projektadministration ändern. Siehe Wiki-Markup-Sprache eines Projekts ändern.
  • Ein VM-Executor wird erstellt, wenn es sich bei diesem Projekt um das erste Projekt von VB Studio handelt und bei der Erstellung des Projekts keine Build-VM-Executors vorhanden waren. Der VM-Executor verwendet die Build-Executor-Vorlage Systemstandard OL7 für Visual Builder. Mit diesem VM-Executor können Sie Build-Jobs ausführen, die auf die Vorlage Systemstandard OL7 für Visual Builder im aktuellen Projekt und in anderen Projekten verweisen. Weitere Informationen zu VM Executors und Build Executor-Vorlagen finden Sie unter VM Build Executors.

    Klicken Sie im linken Navigator auf Organisation Organisation, und klicken Sie dann auf die Registerkarte VM-Build Executors, um den VM-Executor anzuzeigen.

Deployment-Job konfigurieren

Der Deployment-Job stellt das Build-Artefakt der visuellen Anwendung in der Visual Builder-Entwicklungsinstanz bereit. Geben Sie im Deployment-Job die Version und das Profil der Anwendung sowie die Zugangsdaten an, die für die Verbindung und das Deployment des Build-Artefakts zur Visual Builder-Entwicklungsinstanz erforderlich sind.

  1. Klicken Sie im linken Navigator auf Builds Builds.
  2. Klicken Sie auf der Registerkarte Jobs auf den Deployment-Job.
  3. Klicken Sie auf Konfigurieren.
  4. Klicken Sie auf Konfigurieren Builds.
  5. Klicken Sie auf die Registerkarte Schritte.
  6. Geben Sie im Abschnitt "Autorisierung" den Autorisierungstyp an, um diesen Build-Schritt auszuführen. Wenn OAuth verwenden standardmäßig ausgewählt ist, wird die Meldung Authorization is required angezeigt, die angibt, dass dieser Build-Schritt eine einmalige Autorisierung benötigt, um OAuth-Anforderungen an die Visual Builder-Instanz Ihrer Umgebung zu verarbeiten. Klicken Sie auf Autorisieren, und geben Sie Zugangsdaten für den Zugriff auf Ihre Visual Builder-Instanz ein. Sie können den Job auch manuell ausführen und die Zugangsdaten eingeben, wenn Sie dazu aufgefordert werden.

    In beiden Fällen wird empfohlen, die OAuth-Verbindung während der anfänglichen Konfiguration zu autorisieren. Wenn Sie diesen Schritt überspringen, können Sie Ihre Änderungen nicht im Designer veröffentlichen. Sie müssen die erforderliche Autorisierung abschließen, bevor Sie versuchen, Änderungen bereitzustellen.

    Nach der Autorisierung wird die Meldung Authorization has been provided angezeigt.

    Hinweis

    OAuth ist der empfohlene Autorisierungstyp. Verwenden Sie die Basisauthentifizierung nur, wenn Probleme beim Einrichten einer OAuth-Verbindung auftreten. Um die Basisauthentifizierung zu verwenden, wählen Sie Basisauthentifizierung verwenden aus, und geben Sie dann die Zugangsdaten eines Benutzers ein, der auf die Visual Builder-Instanz zugreifen kann, unter Benutzername und Kennwort.

    OAuth-Token (Zugriff und Aktualisierung) werden während der regulären Verwendung neu gestartet. Ein Aktualisierungstoken wird verwendet, um ein Zugriffstoken abzurufen, wenn ein Benutzer auf die Zielinstanz zugreift. Dieses Aktualisierungstoken ist in der Regel sieben Tage lang gültig. (Die Tokenablaufzeit wird in der IDCS-Ressourcenanwendung festgelegt und kann je nach Ihren Sicherheitsanforderungen unterschiedlich sein.) Wenn sich der Benutzer innerhalb des Zeitraums von sieben Tagen bei der Zielinstanz authentifiziert, generiert das aktive Aktualisierungstoken ein neues Zugriffstoken und ein neues Aktualisierungstoken. Dieser Zyklus wird unbegrenzt fortgesetzt, solange das Aktualisierungstoken gültig bleibt. Wenn das Aktualisierungstoken während längerer Zeiträume der Inaktivität abläuft (z.B. wenn Sie im Urlaub sind), klicken Sie auf Autorisierung erneuern (oder führen Sie den Job manuell aus, sodass Sie aufgefordert werden, abgelaufene OAuth-Token zu autorisieren).

  7. (Optional) Um die Standardversion der Anwendung zu überschreiben, geben Sie die neue Version in der Anwendungsversion an. Lassen Sie das Feld leer, um die in der Datei visual-application.json der Anwendung definierte Version zu verwenden.
    Deaktivieren Sie das Kontrollkästchen Anwendungsversion in URL einschließen nicht.
  8. (Optional) Geben Sie unter Anwendungsprofil das Profil der Entwicklungsanwendung an. Lassen Sie das Feld leer, um das Standardprofil der Anwendung zu verwenden.

    Ihre visuelle Anwendung greift für REST-Services auf Daten von verschiedenen Servern zu und benötigt möglicherweise unterschiedliche Sicherheitseinstellungen für verschiedene Umgebungen, wie Entwicklung und Produktion. Mit Anwendungsprofilen können Sie verschiedene Kombinationen von Servern und Sicherheitseinstellungen für jede Ihrer Umgebungen definieren und diese beim Deployment der Anwendung in einer Umgebung verwenden. Dies vereinfacht die Verwaltung der visuellen Anwendung beim Übergang von der Entwicklung zur Produktion. Weitere Informationen finden Sie unter Info über Anwendungsprofile.

  9. (Optional) Um die Datenbank der vorhandenen Anwendung zu verwenden, wählen Sie in Datenmanagement die Option Vorhandene Umgebungsdaten beibehalten aus.

    Um eine bereinigte Datenbank für die Anwendung zu verwenden, wählen Sie in Datenmanagement die Option Bereinigte Datenbank verwenden aus.

  10. Klicken Sie auf Speichern.

Pipeline manuell ausführen

Die Entwicklungs-Build-Pipeline wird automatisch ausgeführt, wenn ein Commit in die Verzweigung des Git-Repositorys übertragen wird, die im Packaging-Job angegeben ist.

Wenn Sie die Pipeline manuell ausführen möchten:
  1. Klicken Sie im linken Navigator auf Builds Builds.
  2. Klicken Sie auf die Registerkarte Pipelines.
  3. Klicken Sie in der Zeile der Entwicklungspipeline auf das Menü Aktionen Aktionen, und wählen Sie Pipeline ausführen aus.

Um die Pipeline zu überwachen und den Status jedes Jobs anzuzeigen, klicken Sie auf den Namen der Pipeline. Um das Build-Log eines Jobs anzuzeigen, klicken Sie auf den Namen des Jobs und dann auf Log anzeigen.

Wenn Sie den Build eines Jobs manuell ausführen möchten, öffnen Sie die Detailseite des Jobs, und klicken Sie auf Jetzt erstellen. Sie können den Build auf der Detailseite des Jobs überwachen.

Bereitgestellte visuelle Anwendung anzeigen

Nachdem der Deployment-Job erfolgreich ausgeführt wurde, können Sie die bereitgestellten Anwendungen auf der Registerkarte Deployments der Seite Umgebungen anzeigen.

  1. Klicken Sie im linken Navigator auf Umgebungen Umgebungen.
  2. Wählen Sie die Visual Builder-Umgebung aus.
  3. Klicken Sie auf die Registerkarte Deployments.
  4. Wenn diese Option nicht aktiviert ist, klicken Sie auf die Umschaltfläche Visuelle Anwendungen.
  5. Wenn die Visual Builder-Instanz aus einer anderen Identitätsdomain stammt, geben Sie die zugehörigen Zugriffszugangsdaten an.
  6. Blenden Sie den Namen der App ein, um den Link der bereitgestellten App anzuzeigen.
    Auf der Registerkarte Deployments werden die Anwendungen angezeigt, die Sie aus dem aktuellen Projekt bereitgestellt haben. Anwendungen, die von anderen Benutzern des Projekts bereitgestellt werden, oder Anwendungen, die von anderen Projekten bereitgestellt werden, werden nicht angezeigt. Beispiel:
Wenn Sie das Deployment der bereitgestellten visuellen Anwendung aufheben möchten, können Sie dies manuell oder über eine Jobkonfiguration tun. Siehe Deployment einer visuellen Anwendung aufheben.