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: Crea viste 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`
`channel`	Nome del canale in cui viene distribuito il codice concatenato.	`test`
`confidentialApplication`	Variabile booleana impostata su `true` per la modalità riservata, `false` per la modalità generica.	`false`
`ordsEndpointUrls`	Oggetto contenente gli URL dell'endpoint ORDS per il proprietario del sistema e le organizzazioni partecipanti, visualizzati nell'output dello script di creazione della vista del database. In modalità generica, si aggiorna solo l'endpoint del proprietario del sistema e si devono lasciare tutte le organizzazioni partecipanti ai valori predefiniti. In modalità riservata, è possibile aggiornare tutti gli endpoint.	Per ulteriori informazioni, vedere le seguenti informazioni.
`restproxyId`	Oggetto contenente gli ID proxy REST per il proprietario del sistema e le organizzazioni partecipanti. È necessario specificare tutti gli ID, indipendentemente dalla modalità applicazione.	Per ulteriori informazioni, vedere le seguenti informazioni.

Oggetto ordsEndpointUrls di esempio, modalità generica:

"ordsEndpointUrls": {
    "SystemOwner": "https://<base_URL>/ords/obp/cbdc/accountTrxDetails",
    "ParticipantOrg1": "<default_value>",
    "ParticipantOrg2": "<default_value>",
    "ParticipantOrg3": "<default_value>",
    "ParticipantOrg4": "<default_value>",
    "ParticipantOrg5": "<default_value>",
    "ParticipantOrg6": "<default_value>"
}

Oggetto ordsEndpointUrls di esempio, modalità riservata:

"ordsEndpointUrls": {
    "SystemOwner": "https://cb-centralbank.example.com/ords/obp/cbdc/accountTrxDetails",
    "ParticipantOrg1": "https://bank1.example.com/ords/obp/cbdc/accountTrxDetails",
    "ParticipantOrg2": "https://bank2.example.com/ords/obp/cbdc/accountTrxDetails",
    "ParticipantOrg3": "https://bank3.example.com/ords/obp/cbdc/accountTrxDetails",
    "ParticipantOrg4": "https://bank4.example.com/ords/obp/cbdc/accountTrxDetails",
    "ParticipantOrg5": "https://bank5.example.com/ords/obp/cbdc/accountTrxDetails",
    "ParticipantOrg6": "https://bank6.example.com/ords/obp/cbdc/accountTrxDetails"
}

Oggetto restproxyId di esempio, entrambe le modalità:

"restproxyId": {
    "systemOwner": "restProxy_CentralBank",
    "participantOrg1": "restProxy_Bank1",
    "participantOrg2": "restProxy_Bank2",
    "participantOrg3": "restProxy_Bank3",
    "participantOrg4": "restProxy_Bank4",
    "participantOrg5": "restProxy_Bank5",
    "participantOrg6": "restProxy_Bank6"
}

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 le informazioni sulla connessione, le proprietà e gli endpoint dell'API REST necessari per accedere a tali sistemi.

Per ulteriori informazioni, vedere Informazioni sui backend.

Completare i passi riportati di seguito per configurare i backend di Visual Builder sia per le interazioni con Oracle Blockchain Platform che per le interazioni con il database della cronologia avanzata.

Configurazione backend per le interazioni di Oracle Blockchain Platform

L'applicazione CBDC all'ingrosso utilizza backend di Visual Builder per gestire le interazioni con Oracle Blockchain Platform.

Proprietario del sistema: SystemOwnerMgmt: gestisce le interazioni di Oracle Blockchain Platform e la creazione dell'iscrizione per il proprietario del sistema.; SystemOwnerRestproxyConfiguration: backend dedicato che gestisce le chiamate proxy REST per il proprietario del sistema.
Organizzazioni partecipanti: ParticipantOrg1Mgmt: gestisce le interazioni di Oracle Blockchain Platform, la creazione delle iscrizioni e le chiamate proxy REST per l'organizzazione partecipante 1.; ParticipantOrg2Mgmt: gestisce le interazioni di Oracle Blockchain Platform, la creazione delle iscrizioni e le chiamate proxy REST per l'organizzazione partecipante 2.; ParticipantOrg3Mgmt: gestisce le interazioni di Oracle Blockchain Platform, la creazione delle iscrizioni e le chiamate proxy REST per l'organizzazione partecipante 3.; ParticipantOrg4Mgmt: gestisce le interazioni di Oracle Blockchain Platform, la creazione delle iscrizioni e le chiamate proxy REST per l'organizzazione partecipante 4.; ParticipantOrg5Mgmt: gestisce le interazioni di Oracle Blockchain Platform, la creazione delle iscrizioni e le chiamate proxy REST per l'organizzazione partecipante 5.; ParticipantOrg6Mgmt: gestisce le interazioni di Oracle Blockchain Platform, la creazione delle iscrizioni e le chiamate proxy REST per l'organizzazione partecipante 6.

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.
Solo per il backend SystemOwnerRestproxyConfiguration, aggiornare quanto riportato di seguito nella finestra Dettagli 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.
Per tutti gli altri backend, aggiornare quanto riportato di seguito nella finestra Dettagli 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
```
- 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 tutti i backend.

Configurazione backend per le interazioni del database Rich History

Ogni organizzazione dispone di un backend dedicato che gestisce l'accesso al database della cronologia avanzata.

Backend: SystemOwnerRichHistoryDBConfiguration; ParticipantOrg1RichHistoryDBConfiguration; ParticipantOrg2RichHistoryDBConfiguration; ParticipantOrg3RichHistoryDBConfiguration; ParticipantOrg4RichHistoryDBConfiguration; ParticipantOrg5RichHistoryDBConfiguration; ParticipantOrg6RichHistoryDBConfiguration

In modalità generica, si aggiorna solo il backend SystemOwnerRichHistoryDBConfiguration. In modalità riservata, è necessario aggiornare il backend proprietario del sistema e i backend per tutte le organizzazioni partecipanti in uso nella distribuzione.

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 appropriato. Fare clic su Server.
Fare clic sull'icona Modifica accanto al server predefinito.
Aggiornare quanto segue nella sezione Dettagli 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 di Visual Builder Visual Applications, fare clic su Business object nel Navigator per aprire il riquadro Business object. Vengono elencati gli oggetti CBDC all'ingrosso.
Acquisizione dello schermo 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 pagina Dati e viene utilizzato per connettere le istanze di Oracle Blockchain Platform al backend corretto per ogni banca. Ad esempio, se un utente immette i dettagli Bank1 nel sistema ParticipantOrg1, l'applicazione deve collegare ParticipantOrg1 a Bank1. In questo modo, ogni volta che un utente associato a Bank1 esegue il login, il sistema sa estrarre i dati dal backend ParticipantOrg1.

In questo business object aggiornare le colonne BankName e mspId per i rispettivi valori orgName. Gli aggiornamenti devono corrispondere al numero di organizzazioni partecipanti nella rete. Ad esempio, se nella rete sono presenti due organizzazioni partecipanti, è necessario aggiornare le colonne BankName e mspId per queste due organizzazioni. Per le organizzazioni partecipanti rimanenti (ParticipantOrg3, ParticipantOrg4, ParticipantOrg5, ParticipantOrg6), lasciare le colonne BankName e mspId impostate sul valore empty.

Nome campo	Descrizione	Valori predefiniti	Aggiornamento obbligatorio (Sì/No)	Aggiorna requisito
BankName	Mapping utilizzato tra i nomi delle istanze di Oracle Blockchain Platform e i nomi delle banche utilizzati nell'applicazione CBDC. Ad esempio, se l'istanza di Oracle Blockchain Platform è stata creata con il nome `CentralBank` ma si desidera che il valore `BankName` sia `BSP` nell'applicazione, questo mapping crea il mapping tra l'istanza di Oracle Blockchain Platform e `BSP`.	`CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5, Bank6`	Sì	Obbligatorio per le organizzazioni partecipanti attive. Lasciare vuoto per le organizzazioni partecipanti non utilizzate.
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.	`CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5, Bank6`	Sì	Obbligatorio per le organizzazioni partecipanti attive. Lasciare vuoto per le organizzazioni partecipanti non utilizzate.
OrgName	Questa colonna rappresenta i valori `orgName` mappati con il backend. `SystemOwner` rappresenta il fondatore e `ParticipantOrg#` rappresenta i partecipanti.	`SystemOwner,ParticipantOrg1,ParticipantOrg2, ParticipantOrg3, ParticipantOrg4, ParticipantOrg5, ParticipantOrg6`	N.	ND

Peer

Questo business object è progettato per memorizzare le informazioni sui peer in tutte le istanze di Oracle Blockchain Platform nella rete. Per immettere i dettagli dell'URL peer nel business object, 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 e due istituti finanziari, ciascuno con due pari livello, è necessario immettere un totale di sei URL peer insieme ai relativi valori mspId associati.

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.
  
  OACSystemOwnerProjectPath
  
  Percorso del progetto per la cartella di lavoro del proprietario del sistema in Analytics Cloud.
  
  OACParticipantOrgProjectPath
  
  Percorso del progetto per la cartella di lavoro organizzazione partecipante 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>
```