Configurare, distribuire ed eseguire il test dell'applicazione Web

Importare l'applicazione Web in Oracle Visual Builder Studio

Oracle Visual Builder Studio non è solo utilizzato per sviluppare applicazioni Visual Builder, ma consente lo sviluppo di qualsiasi tipo di applicazione moderna grazie alla sua moltitudine di strumenti di sviluppo integrati, come un repository GIT, un motore di pipeline CI/CD, la generazione di artifact, un repository di container, strumenti agili, strumenti di team building e molto altro ancora.

Accedere al menu di navigazione della console Web di Oracle Cloud, andare a Servizi OCI Classic, quindi fare clic su Sviluppatore.
Fare clic sull'icona dell'istanza di Oracle Visual Builder Studio, quindi fare clic su Accedi all'istanza del servizio.

Nota
Se non esiste alcuna istanza esistente, creare una nuova istanza, attendere che venga creata e accedervi. Salvare l'URL di questa istanza di Visual Builder Studio, poiché verrà utilizzata nei passi successivi.
Per creare un nuovo progetto, fare clic su + Crea nella pagina predefinita (Organizzazione).
Immettere un nome di progetto e fare clic su Avanti.
Durante l'importazione di un'applicazione Visual Builder esistente come modello di progetto, selezionare l'opzione Progetto vuoto e fare clic su Successivo.
Nell'ultima schermata della procedura guidata, lasciare la lingua di markup wiki predefinita e fare clic su Fine. Il nuovo progetto verrà creato in circa 5 minuti.
Una volta creato il progetto, verrà visualizzata la pagina principale del progetto. Prima di importare l'applicazione, è necessario disporre di un ambiente per configurarla ed eseguirla temporaneamente. Fare clic su Crea ambiente.
Immettere un nome ambiente, una descrizione e fare clic su Crea.
Se nella tenancy è già presente un'istanza di Visual Builder, aggiungerla a questo ambiente facendo clic su Aggiungi istanza. Se non si dispone di alcuna istanza di Visual Builder, eseguire il provisioning di una istanza e tornare a questo passo per aggiungere l'istanza all'ambiente.
Selezionare l'istanza di Visual Builder e fare clic su Aggiungi.
Una volta aggiunto l'ambiente al progetto, creare l'area di lavoro, in cui sarà possibile importare l'applicazione Web precreata. Selezionare l'opzione di menu Aree di lavoro nel menu di navigazione a sinistra.
È possibile creare un'area di lavoro importando l'applicazione Web Visual Builder nel progetto. Fare clic su Importa.
Nella procedura guidata, fornire i dettagli riportati di seguito.
- File zip dell'applicazione Web precreata di Visual Builder.
- Un nome per l'area di lavoro.
- Selezionare l'ambiente configurato in precedenza nel progetto da utilizzare per il test dell'applicazione.
- Creare un nuovo repository Git vuoto e assegnargli un nome e un nome di diramazione predefinito.
Fare clic su Importa.

Configurare l'applicazione Web in modo che punti all'istanza Blockchain

In questa sezione verrà configurata l'applicazione Web fornita in modo che punti all'istanza Blockchain creata nella sezione precedente.

Prendere nota delle seguenti informazioni dalla rete Blockchain creata:

Endpoint BC
Nome istanza
Canale
Codice concatenato

Accedere all'istanza di Visual Builder Studio e aprire il progetto creato facendo clic sul nome del progetto nella pagina predefinita in cui si trova (Organizzazione) quando si accede a Visual Builder Studio.
Selezionare l'area di lavoro creata durante l'importazione dell'applicazione Web, quindi selezionare l'applicazione Web come mostrato nell'immagine e nei passi riportati di seguito.

Descrizione dell'illustrazione oci-vbs.png
1. Selezionare la sezione Applicazione Web.
2. Selezionare l'applicazione Web.
Andare alla scheda Variabili e modificare il valore predefinito delle variabili bcEndpoint, bcInstance, chaincode e channel facendo clic sul simbolo f(x) nell'angolo superiore destro dell'attributo Valore predefinito per ciascuna variabile.

Configurare l'applicazione Web in modo che punti al bucket di storage degli oggetti

In questa sezione verrà configurato il bucket di storage degli oggetti che l'applicazione Web dovrà utilizzare in base ai valori della chiave e del bucket API creati in precedenza.

Accedere all'istanza di Visual Builder Studio e aprire il progetto creato facendo clic sul nome del progetto nella pagina predefinita in cui si trova (Organizzazione) quando si accede a Visual Builder Studio.
Selezionare la sezione Connessione ai servizi, quindi selezionare la connessione al servizio fileUpload.
Andare alla scheda Server e, sul lato destro della configurazione del server, fare clic sull'icona Matita per modificare la configurazione della connessione al servizio fileUpload.
La configurazione della connessione al servizio utilizzata per interagire con il bucket deve essere adattata in tre posizioni.
Nella schermata Modifica server, aggiornare i seguenti campi:
- URL istanza: deve essere modificato in modo da puntare al bucket in base a un paio di proprietà della tenancy OCI e al nome fornito al bucket al momento della creazione. L'URL deve essere composto in base al seguente modello di URL:
```
https://objectstorage.<region-name>.oraclecloud.com/n/<storage-namespace>/b/<bucket-name>
```
- Autenticazione: è necessario assicurarsi che il metodo di autenticazione sia impostato su Oracle Cloud Infrastructure API Signature 1.0 e che la chiave sia impostata facendo clic sull'icona Matita sul lato destro della proprietà Key Id.
  Nota
  Il ID chiave è composto dal modello riportato di seguito.
```
<Tenancy-OCID>/<User-OCID>/<Key-Fingerprint>
```
  È possibile accedere a tutti questi valori dall'anteprima file di configurazione ottenuta quando la chiave API è stata creata durante la configurazione dello storage bucket OCI. La chiave privata è la chiave privata utilizzata, generata o scaricata (a seconda dell'opzione selezionata) durante la creazione della chiave API.
- Tipo di connessione: deve essere impostato su Dinamico, il servizio supporta CORS.
Dopo aver configurato correttamente queste tre proprietà con il bucket e la chiave API, l'applicazione Web è completamente pronta per interagire con il bucket di storage. È possibile procedere al test dell'applicazione Web.

Test dell'applicazione Web

Ora puoi eseguire il test dell'applicazione dall'ambiente Visual Builder configurato nel nostro progetto. Se tutto va bene, possiamo andare avanti ed esportare l'applicazione Web da distribuire in una configurazione standalone.

Questa applicazione Web interagisce con i due backend utilizzati nella soluzione: Blockchain per memorizzare le cartelle e i metadati dei documenti e i bucket di storage OCI per il contenuto dei documenti. Quindi, testeremo un paio di funzionalità per garantire che entrambi i backend (Blockchain e Bucket) siano accessibili tramite l'applicazione Web.

Per eseguire il test dell'applicazione, fare clic sull'icona Anteprima nell'angolo superiore destro dell'area di lavoro di Visual Studio.
Eseguire il login all'applicazione come gestore cartelle, l'utente potrà accedere alle cartelle per le quali è il proprietario corrente oppure creare una nuova cartella, per la quale sarà il custode corrente, in grado di aggiungere più documenti nella cartella o di trasferire l'intera cartella a un altro utente o reparto.
Proviamo a creare una cartella e caricarvi un documento.
Eseguire il login come uno degli utenti (cmsleg001, cmsfin001 o cmsrsk001) per assicurarsi che il ruolo sia impostato su Gestione cartelle e fare clic su Login.
Nella pagina Gestione cartelle fare clic su Nuova cartella.
Assegnare i valori ai tre campi di input (Tipo cartella, Descrizione e ID cliente) e fare clic su Crea cartella.
Nella console di Oracle Blockchain Service, andare alla scheda Canali, selezionare il canale wedocms e controllare il contenuto dell'ultimo blocco salvato nel libro contabile. Dovrebbe contenere la richiesta di eseguire la transazione che abbiamo appena eseguito.
Per verificare se è possibile caricare un documento nella cartella appena creata, selezionare la cartella e fare clic su Carica documenti.
Se non è stato caricato alcun documento in questa cartella, fare clic su Carica un nuovo documento.
Selezionare un Tipo di documento, immettere un Nome documento, selezionare un file o rilasciare un file PDF nell'area Trascina ed elimina, aggiungere Proprietà dinamiche e fare clic su Carica documento.

Possiamo esaminare nella console di Oracle Blockchain se questa nuova transazione è stata eseguita e anche se il documento è stato caricato nel bucket di storage OCI. Accedere come revisore di documenti, qualsiasi utente che ha accesso all'applicazione sarà in grado di rivedere i documenti caricati da qualsiasi cartella.

Esportare l'applicazione da eseguire in un computer standalone

I passi riportati di seguito descrivono come esportare l'applicazione e scaricare il package esportabile da distribuire all'esterno di Visual Builder.

Un'applicazione Visual Builder, se soddisfa alcune condizioni, può essere eseguita al di fuori del contesto di Visual Builder. Per ulteriori informazioni, vedere i blog seguenti: Esecuzione delle applicazioni di Visual Builder su altri server (e in locale) e Esecuzione delle applicazioni di Visual Builder al di fuori di Visual Builder.

Per esportare l'applicazione, eseguire il PUSH delle modifiche nel repository Git. Fare clic sul menu Git repository/ramolo nella parte superiore sinistra dell'area di lavoro e selezionare l'opzione Push.
Immettere un messaggio di commit e fare clic su Esegui commit di tutto ed esegui push.
La prima volta che questo job viene eseguito, possono essere necessari diversi minuti in attesa di un esecutore build, ma una volta che l'esecutore build seleziona il job, l'esecuzione deve essere eseguita in circa 3 minuti e deve essere visualizzato un messaggio popup Git push riuscito.
A questo punto possiamo pubblicare la nostra applicazione e questa azione attiverà un job di build per ottimizzare l'applicazione da eseguire nelle migliori condizioni. Fare clic su Pubblica nell'angolo superiore destro della pagina Area di lavoro.
Nella finestra di dialogo Pubblica modifiche selezionare Unisci ora o Unisci dopo revisione, quindi fare clic su Pubblica.
Immettere le credenziali e fare clic su Aggiungi credenziali e continua.
Nella finestra popup Generazione avviata fare clic su Apri job.
Fare clic su Artifact per visualizzare il package generato.
Fare clic su built-assets.zip per scaricare il package, in modo che il package esportabile sia pronto per essere distribuito al di fuori di Visual Builder.

Eseguire il package esportato in un server Apache Tomcat

Il pacchetto built-assets.zip può essere distribuito per essere servito direttamente da un server Apache Tomcat.

Installare il server Apache Tomcat, una volta installato, avviarlo e verificare che funzioni tentando di accedere all'URL: http://localhost:8080.
La nostra applicazione può essere installata in Tomcat decomprimendo il pacchetto built-assets.zip e copiando il contenuto del file zip in una nuova cartella creata all'interno della cartella /webapps.
Una volta distribuita l'applicazione all'interno della cartella webapps dell'installazione Tomcat, è possibile riavviare Tomcat e provare ad accedere al seguente URL: http://localhost:8080/<folder-name-inside-webapps>/webApps/docmngmt/
Ora possiamo testare l'applicazione nel nostro ambiente locale.