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 Visual Application-Vorlage erstellen und dann einige Konfigurationseinstellungen im Projekt vornehmen, damit es für die Entwicklung visueller Anwendungen bereit ist.

Im Folgenden finden Sie eine Übersicht über das Erstellen und Einrichten eines VB Studio-Projekts für die Entwicklung, beginnend mit der Vorlage für die visuelle Anwendung:

So führen Sie diese Aktion aus:	Siehe:
1. Erstellen Sie ein Projekt.	Projekt mit der visuellen Anwendungsvorlage erstellen Hinweis Bevor Sie versuchen, ein Projekt zu erstellen, stellen Sie sicher, dass Ihre VB Studio-Instanz für den Zugriff auf Visual Builder-Instanzen autorisiert ist, die mit Ihrem OCI-Account verbunden sind. Ohne diese Autorisierung können diese Instanzen nicht als Deployment-Ziel in Ihrem Projekt ausgewählt werden. Siehe VB Studio für den Zugriff auf Visual Builder und Integrationsinstanzen autorisieren.
2. Konfigurieren Sie den Deployment-Job. Standardmäßig fehlen dem Deployment-Job die Zugangsdaten für die Verbindung zur Zielentwicklungsinstanz. Sie müssen sie daher manuell angeben.	Deployment-Job konfigurieren
3. Prüfen Sie Ihre Zugangsdaten, indem Sie die Entwicklungspipeline ausführen.	Pipeline manuell ausführen
4. Zeigen Sie die bereitgestellten visuellen Anwendungen an.	Bereitgestellte visuelle Anwendung anzeigen
5. Fügen Sie dem Projekt Teammitglieder hinzu.	Benutzer zum Projekt hinzufügen

Projekt 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 Visual Application-Projektvorlage basieren.

Melden Sie sich bei VB Studio an. Siehe Über die Oracle Cloud-Homepage auf VB Studio zugreifen.
Klicken Sie auf der Seite "Organisation" auf + Erstellen.
Geben Sie auf der Seite Projektdetails des Assistenten "Neues Projekt" einen eindeutigen Namen und eine Beschreibung für das Projekt ein.
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 Name und Kontaktinformationen des Eigentümers. Private Projekte, die nicht auffindbar sind, werden nicht für Nicht-Mitglieder zugänglich sein.
2. Wählen Sie Freigegeben aus, um den Projektcode, die Wiki-Dokumente, Aufgaben und Builds für jede Person innerhalb Ihrer Organisation verfügbar zu machen.
Geben Sie unter Bevorzugte Sprache die Sprache für die E-Mail-Benachrichtigungen an, die Ihre Projektbenutzer erhalten.
Sie können die Sprache ändern, in der die Benutzeroberfläche in Ihren Benutzereinstellungen angezeigt wird.
Klicken Sie auf Weiter.
Wählen Sie auf der Seite Projektvorlage die Projektvorlage Visuelle Anwendung aus, und klicken Sie auf Weiter.
Auf der Seite Projekteigenschaften:
1. Ändern Sie bei Bedarf unter Git-Repository-Name den Standardnamen des Git-Repositorys.
2. Wählen Sie in 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, falls noch nicht ausgewählt, die Visual Builder-Entwicklungsinstanz aus.
  Wenn die erforderliche Visual Builder-Instanz nicht angezeigt wird, gehen Sie zurück, und ändern Sie die Auswahl für die OCI-Region und das Compartment.
4. Wählen Sie unter Visuelle Anwendungsvorlage eine visuelle Anwendungsvorlage aus, die auf 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 Auswahl verwenden.
5. (Optional) Ändern Sie bei Bedarf unter Workspace-Name den Namen Ihres privaten Workspace. Standard ist Workspace1.
  
  Ein Workspace enthält alle Artefakte, die Sie für die Entwicklung visueller Anwendungen benötigen, einschließlich eines Klons des Git-Repositorys dieses Projekts und der Verzweigung mit den Quelldateien. Weitere Informationen zu Workspaces finden Sie unter Was ist ein Workspace und warum benötige ich einen Workspace?
6. (Optional) Ändern Sie bei Bedarf unter Name der Arbeitsverzweigung den Namen der Arbeitsverzweigung 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.
Gehen Sie auf der Seite Team wie folgt vor:
1. Klicken Sie auf Mitglieder hinzufügen, und wählen Sie aus der angezeigten Liste Benutzer oder Gruppen aus, die dem Projekt hinzugefügt werden sollen.
2. Wählen Sie die Mitgliedschaft (Project Owner, Developer Full Access, Developer Limited Access oder Contributor), die den Mitgliedern, die Sie hinzufügen, im Projekt zur Verfügung steht.
  Weitere Informationen zu jeder Mitgliedschaft 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.
Klicken Sie auf Fertigstellen.

Nachdem das Projekt bereitgestellt wurde, wird die Seite Projekt-Home geöffnet, auf der eine Zusammenfassung der Provisioning-Aktivitäten des Projekts, der Standardumgebung, des Standard-Workspace und der Git-, Maven- und NPM-Repositorys angezeigt wird. Prüfen Sie den Aktivitätsfeed und das Feld "Umgebungen" auf Fehler.

Wenn Sie ein Projekt mit der Visual Application-Vorlage erstellen, werden diese 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 Namen des Git-Repositorys:

Beschreibung der Abbildung default_visualapp_repository.png
Eine Entwicklungsumgebung, die auf die Visual Builder-Entwicklungsinstanz verweist.
Klicken Sie im linken Navigator auf Umgebungen , um die Entwicklungsumgebung anzuzeigen:

Beschreibung der Abbildung default_visualapp_environment.png
Erstellen Sie Jobs, die das Artefakt der visuellen Anwendung verpacken, und stellen Sie es in der Visual Builder-Entwicklungsinstanz bereit.
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 und dann auf die Registerkarte Jobs, um die Build-Jobs anzuzeigen:

Beschreibung der Abbildung default_visualapp_buildjobs.png

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 zur Ausführung der Build-Jobs in einer Sequenz.
Klicken Sie im linken Navigator auf Builds und dann auf die Registerkarte Pipelines. Klicken Sie in der Pipelinezeile auf das Menü Aktionen , und wählen Sie Layout anzeigen aus.

Beschreibung der Abbildung default_visualapp_pipeline.png
Ein privater Workspace zum Bearbeiten der visuellen Anwendung im VB Studio Designer.
Klicken Sie im linken Navigator auf Workspaces , um den Workspace anzuzeigen:

Beschreibung der Abbildung default_visualapp_workspace.png
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 Language eines Projekts ändern.
Ein VM-Executor wird erstellt, wenn es sich bei diesem Projekt um das erste VB Studio-Projekt 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 auch die Vorlage Systemstandardwert OL7 für Visual Builder im aktuellen Projekt und in anderen Projekten referenzieren. Weitere Informationen zu VM-Executors und Build-Executor-Vorlagen finden Sie unter VM-Build Executors.
Klicken Sie im linken Navigator auf Organisation und dann auf die Registerkarte VM-Build Executors, um den VM-Executor anzuzeigen.

Beschreibung der Abbildung vbs-builtin-freevm.png

Deployment-Job konfigurieren

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

Klicken Sie im linken Navigator auf Builds .
Klicken Sie auf der Registerkarte Jobs auf den Deployment-Job.
Klicken Sie auf Konfigurieren.
Klicken Sie auf Konfigurieren .
Klicken Sie auf die Registerkarte Steps.
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 die 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 und 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 beim Einrichten einer OAuth-Verbindung Probleme auftreten. Um die Basisauthentifizierung zu verwenden, wählen Sie Basic verwenden aus, und geben Sie die Zugangsdaten eines Benutzers ein, der auf die Visual Builder-Instanz zugreifen kann, in 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-Ressourcen-App 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 Inaktivitätszeiträume abläuft (z.B. im Urlaub), klicken Sie auf Autorisierung erneuern (oder führen Sie den Job manuell aus, sodass Sie aufgefordert werden, abgelaufene OAuth-Token zu autorisieren).
(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 nicht das Kontrollkästchen Anwendungsversion in URL aufnehmen.
(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 auf Daten von verschiedenen Servern für REST-Services 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. Dadurch wird die Verwaltung der visuellen Anwendung beim Übergang von der Entwicklung zur Produktion vereinfacht. Weitere Informationen finden Sie unter Info über Anwendungsprofile.
(Optional) Um die Datenbank der vorhandenen Anwendung zu verwenden, wählen Sie in Data Management die Option Vorhandene Umgebungsdaten beibehalten aus.

Um eine bereinigte Datenbank für die Anwendung zu verwenden, wählen Sie in Data Management die Option Bereinigte Datenbank verwenden aus.
Klicken Sie auf Speichern.

Pipeline manuell ausführen

Die Entwicklungs-Build-Pipeline wird automatisch ausgeführt, wenn ein Commit an die im Packaging-Job angegebene Verzweigung des Git-Repositorys übergeben wird.

Wenn Sie die Pipeline manuell ausführen möchten:

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

Um die Pipeline zu überwachen und den Status der einzelnen 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.

Klicken Sie im linken Navigator auf Umgebungen .
Wählen Sie die Visual Builder-Umgebung aus.
Klicken Sie auf das Register Deployments.
Wenn diese Option nicht aktiviert ist, klicken Sie auf die Umschaltschaltschaltfläche Visuelle Anwendungen.
Wenn die Visual Builder-Instanz aus einer anderen Identitätsdomain stammt, geben Sie die zugehörigen Zugriffszugangsdaten an.
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. Es werden keine Anwendungen angezeigt, die von anderen Benutzern des Projekts bereitgestellt wurden, oder Anwendungen, die aus anderen Projekten bereitgestellt wurden. Beispiel:

Beschreibung der Abbildung visualapp_deployment.png

Wenn Sie das Deployment der bereitgestellten visuellen Anwendung rückgängig machen möchten, können Sie dies manuell oder über eine Jobkonfiguration tun. Siehe Deployment einer visuellen Anwendung aufheben.

Oracle Cloud Infrastructure-Dokumentation