Configurare Visual Builder per l'applicazione di esempio CBDC all'ingrosso

Dopo aver configurato tutti gli altri prodotti associati a Oracle Blockchain Platform, è possibile configurare Oracle Visual Builder per connettersi a tali prodotti.

Panoramica

I dettagli riportati di seguito devono essere aggiornati nella configurazione di Oracle Visual Builder. Questi dettagli vengono forniti quando si configura Oracle Blockchain Platform come descritto in Configura Oracle Blockchain Platform per l'applicazione di esempio CBDC all'ingrosso.

ID proxy REST, URL dell'istanza e ID MSP dell'istanza di Oracle Blockchain Platform.
Vedere: Fetch RestproxyId
ID client e segreto client dell'istanza di Oracle Blockchain Platform.
Vedere: Fetch ClientId e ClientSecret.
Endpoint ORDS (Oracle REST Data Services), ID client, segreto client e URL base OAuth.
Vedere: Creazione di viste del database Rich History.
Nome canale e nome codice concatenato.
Vedere: Distribuire il codice concatenato per l'applicazione di esempio CBDC all'ingrosso.

Aggiorna variabili globali

Nella home page di Visual Builder Visual Applications, fare clic su Applicazioni Web nel Navigator per aprire il riquadro Applicazioni Web.
Fare clic sull'applicazione cbdcapp. Viene visualizzato l'editor dell'applicazione.
Selezionare Variabili.

Nella sezione Variabili globali individuare l'oggetto variabile configuration e aggiornare i seguenti parametri nell'oggetto:

Nome parametro	Descrizione	Valore predefinito
`chaincodeName`	`chaincodeName` utilizzato nella rete Oracle Blockchain Platform.	`WholesaleCBDC`
`ordsUrl`	URL dell'endpoint ORDS, visualizzato nell'output dello script di creazione della vista del database.	`https://g53630e55ee33f4-test.xyz.abc.oraclecloudapps.com/ords/obp/cbdc/accountTrxDetails`

Configura backend di Visual Builder

Una connessione al servizio backend in Visual Builder consente di stabilire la comunicazione tra l'applicazione visiva e i sistemi esterni fornendo dettagli essenziali quali informazioni di connessione, proprietà ed endpoint delle API REST necessari per accedere a tali sistemi. È necessario aggiornare i backend con Oracle Blockchain Platform e i dettagli del database della cronologia avanzata.

Per ulteriori informazioni, vedere Informazioni sui backend.

È necessario aggiornare i backend seguenti:

Chiamate proxy REST
Iscrizioni
Database configurazione database cronologia avanzata

Chiamate proxy REST

Sono presenti una connessione backend e sei connessioni di servizio correlate al proxy REST. Questi componenti vengono utilizzati per effettuare chiamate proxy REST all'istanza di Oracle Blockchain Platform.

Backend: CentralBank
Connessioni al servizio: participantBank_FI1; participantBank_FI2; participantBank_FI3; participantBank_FI4; participantBank_FI5; participantBank_FI6

Per aggiornare i dettagli del server backend:

Nella home page di Visual Builder Visual Applications, fare clic su Servizi nel Navigator per aprire il riquadro Servizi. Fare clic su Backend per visualizzare una lista di backend.
Selezionare il backend che si desidera aggiornare. Fare clic su Server.
Fare clic sull'icona Modifica accanto al server predefinito.
Aggiornare quanto segue nei dettagli del server:
- URL istanza: sostituire l'URL predefinito con l'URL dell'istanza di Oracle Blockchain Platform modificando la parte dell'URL di base dell'URL predefinito (test-xyz-abc.blockchain.ocp.oraclecloud.com). Ad esempio:
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy/api/v2/channels/{channelName}
```
- Variabili server: modificare channelName per riflettere il nome del canale in cui viene distribuito il codice concatenato.
- Autenticazione per gli utenti collegati: per l'autenticazione viene utilizzata l'asserzione utente OAuth 2.0. Modificare l'URL in modo che corrisponda all'URL proxy REST di Oracle Blockchain Platform. Ad esempio:
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy
```
- ID client e segreto client: fare clic sull'icona Modifica accanto a ClientID. Aggiornare i campi Client ID e Client Secret in modo che corrispondano all'ID e al segreto della Oracle Blockchain Platform.
Ripetere questi passi per aggiornare le connessioni di servizio di ciascuno dei sei partecipanti selezionandole nella vista Connessioni servizio nel riquadro Servizi.

Iscrizioni

Esistono sette backend correlati alle iscrizioni a Oracle Blockchain Platform. Questi backend vengono utilizzati per creare le iscrizioni all'istanza di Oracle Blockchain Platform.

Backend: CustomEnrollementCB; CustomEnrollementFI1; CustomEnrollementFI2; CustomEnrollementFI3; CustomEnrollementFI4; CustomEnrollementFI5; CustomEnrollementFI6

Per aggiornare i dettagli del server backend:

Nella home page di Visual Builder Visual Applications, fare clic su Servizi nel Navigator per aprire il riquadro Servizi. Fare clic su Backend per visualizzare una lista di backend.
Selezionare il backend che si desidera aggiornare. Fare clic su Server.
Fare clic sull'icona Modifica accanto al server predefinito.
Aggiornare quanto segue nei dettagli del server:
- URL istanza: sostituire l'URL predefinito con l'URL dell'istanza di Oracle Blockchain Platform modificando la parte dell'URL di base dell'URL predefinito (test-xyz-abc.blockchain.ocp.oraclecloud.com). Ad esempio:
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/console/admin/api/v2/nodes/restproxies/{restProxyId}/enrollments
```
- Variabili server: modificare restProxyId per riflettere l'ID proxy REST effettivo per l'istanza di Oracle Blockchain Platform.
- Autenticazione per gli utenti collegati: per l'autenticazione viene utilizzata l'asserzione utente OAuth 2.0. Modificare l'URL in modo che corrisponda all'URL proxy REST di Oracle Blockchain Platform. Ad esempio:
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy
```
- ID client e segreto client: fare clic sull'icona Modifica accanto a ClientID. Aggiornare i campi Client ID e Client Secret in modo che corrispondano all'ID e al segreto della Oracle Blockchain Platform.
Ripetere questi passi per aggiornare i backend di ciascuno dei sei partecipanti selezionandoli nella vista Backend nel riquadro Servizi.

Database configurazione database cronologia avanzata

Esiste un backend correlato al database della cronologia completa. Questo backend viene utilizzato per recuperare i dati dal database della cronologia avanzata.

Backend: RichHistoryDBConfiguration DB

Per aggiornare i dettagli del server backend:

Nella home page di Visual Builder Visual Applications, fare clic su Servizi nel Navigator per aprire il riquadro Servizi. Fare clic su Backend per visualizzare una lista di backend.
Selezionare il backend RichHistoryDBConfiguration DB. Fare clic su Server.
Fare clic sull'icona Modifica accanto al server predefinito.
Aggiornare quanto segue nei dettagli del server:
- URL istanza: sostituire l'URL predefinito con OAuth Base URL(ORDS_REST_BASE_URL/ords/<userName|aliasName>). Ad esempio, l'URL predefinito:
```
https://g53630e55ee33f4-abc.def.gh-xyz-1.oraclecloudapps.com/ords/aliasName
```
  sarà sostituito da:
```
https://g53630e55ee33f4-rhjkdb.adb.ap-sydney-1.oraclecloudapps.com/ords/vbcstest
```
- Autenticazione per gli utenti collegati: Basic viene utilizzato per l'autenticazione.
- ID client e segreto client: fare clic sull'icona Modifica accanto a Nome utente. Aggiornare il nome utente con il valore Client ID e la password con il valore Client Secret in modo che corrisponda all'ID endpoint ORDS e al segreto.

Configura business object di Visual Builder

Un business object è una risorsa, ad esempio una fattura o un ordine di acquisto, simile a una tabella di database; contiene campi che contengono i dati per l'applicazione. Come una tabella di database, un business object fornisce la struttura dei dati. I business object vengono memorizzati in un database. Le applicazioni nell'applicazione visiva e gli altri client accedono ai business object tramite gli endpoint REST.

Nella home page delle applicazioni Visual di Visual Builder, fare clic su Business object nel Navigator per aprire il riquadro Business object. Devono essere elencati gli oggetti CBDC all'ingrosso.
Screenshot che mostra l'elenco completo dei business object appartenenti all'applicazione di esempio CBDC all'ingrosso nella vista Business object di Visual Builder.

È possibile selezionare qualsiasi business object e passare alla relativa scheda Dati per aggiornarne o modificarne i dati.

Nomi organizzazione

Questo business object dispone di quattro campi nella scheda Dati e consente di connettere le istanze di Oracle Blockchain Platform con il backend giusto per ogni banca. Ad esempio, se un utente immette i dettagli Bank1 nel sistema FI1, l'applicazione deve collegare FI1 a Bank1. In questo modo, ogni volta che un utente associato a Bank1 esegue il login, il sistema sa estrarre i dati dal backend FI1.

In questo business object è necessario aggiornare le colonne BankName e mspId per il rispettivo orgNames. Gli aggiornamenti dovrebbero corrispondere al numero di partecipanti (IF) nella rete. Ad esempio, se la rete contiene 2 FIs (FI1, FI2), è necessario aggiornare le colonne BankName e mspId per questi due FIs. Per gli FIs rimanenti (FI3, FI4, FI5, FI6), le colonne BankName e mspId devono essere lasciate empty.

Nome campo	Descrizione	Valori predefiniti	Necessario aggiornamento (Sì/No)	Aggiorna requisito
BankName	Mapping utilizzato tra i nomi delle istanze di Oracle Blockchain Platform e `BankNames` utilizzato nell'applicazione CBDC. Ad esempio, se l'istanza di Oracle Blockchain Platform è stata creata con il nome `CentralBank` ma si desidera che `BankName` sia `BSP` nell'applicazione, questo mapping crea il mapping tra l'istanza di Oracle Blockchain Platform e `BankName`.	`CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5` e `Bank6`	Sì	Obbligatorio per gli FIs attivi. Lasciare vuoto per gli FIs non utilizzati.
mspId	Questa colonna rappresenta l'ID MSP effettivo dell'istanza di Oracle Blockchain Platform. È necessario aggiornare questi valori se le istanze di Oracle Blockchain Platform vengono create con nomi diversi dai valori predefiniti indicati di seguito.	`CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5` e `Bank6`	Sì	Obbligatorio per gli FIs attivi. Lasciare vuoto per gli FIs non utilizzati.
OrgName	Questa colonna rappresenta `orgNames` mappato al backend. `CB` rappresenta il fondatore e `FI#` rappresenta i partecipanti.	`CB, FI1, FI2, FI3, FI4, FI5` e `FI6`	N.	---

Peer

Questo business object è progettato per memorizzare le informazioni sui peer in tutte le istanze di Oracle Blockchain Platform all'interno della rete. Per immettere i dettagli dell'URL peer nel business object, è necessario immettere i valori URL peer corrispondenti nella colonna peerURL insieme ai rispettivi ID provider di servizi di appartenenza a Oracle Blockchain Platform (mspId).

Ad esempio, se esiste una banca centrale (CB) e due istituti finanziari (FI#), ciascuno con due pari livello, è necessario inserire un totale di sei URL peer insieme al relativo mspId associato.

Nome campo	Descrizione
orgName	Istanza di Oracle Blockchain Platform `mspId`.
peerURL	Il valore `peerURL` delle istanze di Oracle Blockchain Platform.

Nota

I pari livello inclusi in questa interfaccia business devono essere aggiunti al canale comune creato.

Configurare Oracle Analytics Cloud per Oracle Visual Builder

L'istanza di Oracle Analytics Cloud e l'istanza di Oracle Visual Builder devono risiedere nella stessa tenancy OCI.

Anche l'istanza di Oracle Analytics Cloud e l'istanza di Oracle Visual Builder devono utilizzare lo stesso Oracle Identity Cloud Service per la gestione delle identità. Gli utenti che accedono all'applicazione Oracle Visual Builder devono disporre dei privilegi necessari sia per Oracle Analytics Cloud che per Oracle Visual Builder.

Prima di completare i passi riportati di seguito, configurare il package di analitica CBDC all'ingrosso. Per ulteriori informazioni, vedere Package di analisi di esempio CBDC all'ingrosso.

Ottenere l'URL del dominio Oracle Visual Builder.
1. Nella console OCI, fare clic su Servizi di sviluppo > Visual Builder.
2. Selezionare l'istanza di Visual Builder, quindi fare clic su Home page del servizio. Viene visualizzata la pagina dell'interfaccia di Visual Applications. Copiare il nome di dominio dalla barra degli indirizzi del browser.
  Nome dominio di esempio: Example: https://wcbdc-vb-oabcs1.builder.ap-hyderabad-1.ocp.example.com
Aggiungere il dominio come dominio sicuro in Oracle Analytics Cloud.
1. Eseguire il login all'istanza di Oracle Analytics Cloud, aprire la console di Oracle Analytics Cloud, quindi fare clic su Menu Navigator.
2. In Configurazione e impostazioni, fare clic su Console > Domini sicuri.
3. Fare clic su Aggiungi dominio, quindi incollare l'URL del dominio di Visual Builder copiato in precedenza. Il dominio viene aggiunto automaticamente quando si fa clic in un altro punto del display.
4. Selezionare le caselle di controllo Consenti frame e Integrazione associate al dominio appena aggiunto.
Ottenere l'URL dell'host di Oracle Analytics Cloud.
1. Eseguire il login all'istanza di Oracle Analytics Cloud.
2. Copiare l'URL dell'host di Oracle Analytics Cloud dalla barra degli indirizzi del browser. Copiare il nome di dominio completamente qualificato fino a .com, incluso https://.
  URL host di esempio: https://<your-oac-instance>.analytics.ocp.example.com
Aggiungere l'URL host di Oracle Analytics Cloud come origine consentita in Oracle Visual Builder.
1. Eseguire il login all'istanza di Oracle Visual Builder, quindi fare clic su Home page servizio.
2. Fare clic su Menu di navigazione, quindi su Impostazioni. Viene visualizzata la pagina Impostazioni tenant.
3. Nella sezione Origini consentite fare clic su + Nuova origine, quindi incollare l'URL del dominio di Analytics Cloud copiato in precedenza nel campo Indirizzo di origine.
Aggiornare le variabili di configurazione nell'applicazione Visual Builder.
1. Aprire l'applicazione cbdcapp nell'editor applicazioni, quindi selezionare Variabili.
2. Nella sezione Variabili globali, aggiornare i seguenti parametri nell'oggetto variabile di configurazione.
  
  OACHost
  
  L'URL dell'istanza di Oracle Analytics Cloud copiato in precedenza.
  
  OACCBDCProjectPath
  
  Percorso del progetto per la cartella di lavoro della banca centrale in Analytics Cloud.
  
  OACFIProjectPath
  
  Percorso del progetto per la cartella di lavoro dell'istituto finanziario in Analytics Cloud.
3. Per ottenere il percorso di progetto di una cartella di lavoro, fare clic su Navigator > Catalogo nella home page di Analytics Cloud.
4. Fare clic sul menu Azioni per la cartella di lavoro, quindi selezionare Ispeziona. Viene visualizzata la finestra Ispeziona.
5. Fare clic sulla scheda Generale, quindi su Copia associata a ID oggetto.
Modificare l'HTML in Visual Builder.
1. Aprire l'applicazione cbdcapp nell'editor applicazioni, quindi passare alla sezione HTML.
2. Aggiornare l'URL dell'host di Analytics Cloud nelle righe 30 e 31 in modo che corrisponda all'istanza di Analytics Cloud, come mostrato nello snippet di codice riportato di seguito. Non modificare la struttura della sottodirectory dell'URL, ma solo la parte del dominio fino a .com.
```
<script src="https://abc-xyz-ia.analytics.ocp.example.com/public/dv/v1/embedding/jet/embedding.js" type="application/javascript"></script>
```