Visual Builder für die Wholesale CBDC-Beispielanwendung konfigurieren

Nachdem Sie alle anderen Produkte konfiguriert haben, die mit Oracle Blockchain Platform verknüpft sind, können Sie Oracle Visual Builder so konfigurieren, dass eine Verbindung zu diesen hergestellt wird.

Überblick

Die folgenden Details müssen in der Oracle Visual Builder-Konfiguration aktualisiert werden. Diese Details erhalten Sie, wenn Sie Oracle Blockchain Platform konfigurieren, wie unter Oracle Blockchain Platform für die Wholesale CBDC-Beispielanwendung konfigurieren beschrieben.

REST-Proxy-ID, Instanz-URL und MSP-IDs der Oracle Blockchain Platform-Instanz.
Siehe: RestproxyId abrufen
Client-ID und Client Secret der Oracle Blockchain Platform-Instanz.
Siehe: ClientId und ClientSecret abrufen.
Oracle REST Data Services-(ORDS-)Endpunkt, Client-ID, Client Secret und OAuth-Basis-URL.
Siehe: Rich History-Datenbankansichten erstellen.
Kanalname und Chaincode-Name.
Siehe: Chaincode für die Wholesale CBDC-Beispielanwendung bereitstellen.

Globale Variablen aktualisieren

Klicken Sie auf der Homepage von Visual Builder Visual Applications im Navigator auf Webanwendungen, um den Bereich Webanwendungen zu öffnen.
Klicken Sie auf die Anwendung cbdcapp. Der App-Editor wird geöffnet.
Wählen Sie Variablen aus.

Suchen Sie im Abschnitt Globale Variablen das Variablenobjekt configuration, und aktualisieren Sie die folgenden Parameter im Objekt:

Parametername	Beschreibung	Standardwert
`chaincodeName`	Die `chaincodeName`, die im Oracle Blockchain Platform-Netzwerk verwendet wird.	`WholesaleCBDC`
`channel`	Der Name des Kanals, in dem der Chaincode bereitgestellt wird.	`test`
`confidentialApplication`	Eine boolesche Variable, die im vertraulichen Modus auf `true` und im generischen Modus auf `false` gesetzt ist.	`false`
`ordsEndpointUrls`	Ein Objekt, das die ORDS-Endpunkt-URLs für den Systemeigentümer und die Teilnehmerorganisationen enthält, die in der Ausgabe des Erstellungsskripts für die Datenbankansicht angezeigt werden. Im generischen Modus aktualisieren Sie nur den Endpunkt des Systemeigentümers, und Sie müssen alle Teilnehmerorganisationen auf die Standardwerte setzen. Im vertraulichen Modus aktualisieren Sie alle Endpunkte.	Weitere Informationen finden Sie in den folgenden Informationen
`restproxyId`	Ein Objekt mit den REST-Proxy-IDs für den Systemeigentümer und die Teilnehmerorganisationen. Unabhängig vom Anwendungsmodus müssen alle IDs angegeben werden.	Weitere Informationen finden Sie in den folgenden Informationen

Beispielobjekt ordsEndpointUrls, generischer Modus:

"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>"
}

Beispielobjekt ordsEndpointUrls, vertraulicher Modus:

"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"
}

Beispielobjekt restproxyId, beide Modi:

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

Visual Builder-Backends konfigurieren

Eine Backend-Serviceverbindung in Visual Builder ist eine Möglichkeit, die Kommunikation zwischen Ihrer visuellen Anwendung und externen Systemen herzustellen, indem wesentliche Details wie Verbindungsinformationen, Eigenschaften und REST-API-Endpunkte bereitgestellt werden, die für den Zugriff auf diese Systeme erforderlich sind.

Weitere Informationen finden Sie unter Was sind Backends?.

Gehen Sie folgendermaßen vor, um Visual Builder-Backends sowohl für Oracle Blockchain Platform-Interaktionen als auch für umfangreiche Historiendatenbankinteraktionen zu konfigurieren.

Backend-Konfiguration für Oracle Blockchain Platform-Interaktionen

Die CBDC-Großhandelsanwendung verwendet Visual Builder-Backends, um Interaktionen mit Oracle Blockchain Platform zu verwalten.

Systemeigentümer: SystemOwnerMgmt: Verarbeitet Oracle Blockchain Platform-Interaktionen und Registrierungserstellung für den Systemeigentümer.; SystemOwnerRestproxyConfiguration: Ein dediziertes Backend, das REST-Proxyaufrufe für den Systemeigentümer verarbeitet.
Teilnehmerorganisationen: ParticipantOrg1Mgmt: Verarbeitet Oracle Blockchain Platform-Interaktionen, Anmeldungserstellung und REST-Proxyaufrufe für die Teilnehmerorganisation 1.; ParticipantOrg2Mgmt: Verarbeitet Oracle Blockchain Platform-Interaktionen, Anmeldungserstellung und REST-Proxyaufrufe für die Teilnehmerorganisation 2.; ParticipantOrg3Mgmt: Verarbeitet Oracle Blockchain Platform-Interaktionen, Anmeldungserstellung und REST-Proxyaufrufe für die Teilnehmerorganisation 3.; ParticipantOrg4Mgmt: Verarbeitet Oracle Blockchain Platform-Interaktionen, Anmeldungserstellung und REST-Proxyaufrufe für die Teilnehmerorganisation 4.; ParticipantOrg5Mgmt: Verarbeitet Oracle Blockchain Platform-Interaktionen, Anmeldungserstellung und REST-Proxyaufrufe für die Teilnehmerorganisation 5.; ParticipantOrg6Mgmt: Verarbeitet Oracle Blockchain Platform-Interaktionen, Anmeldungserstellung und REST-Proxyaufrufe für die Teilnehmerorganisation 6.

So aktualisieren Sie die Backend-Serverdetails:

Klicken Sie auf der Homepage von Visual Builder Visual Applications im Navigator auf Services, um den Bereich Services zu öffnen. Klicken Sie auf Backends, um eine Liste der Backends anzuzeigen.
Wählen Sie das Backend aus, das Sie aktualisieren möchten. Klicken Sie auf Server.
Klicken Sie neben dem Standardserver auf das Symbol Bearbeiten.
Aktualisieren Sie für das SystemOwnerRestproxyConfiguration-Backend im Fenster Serverdetails Folgendes:
- Instanz-URL: Ersetzen Sie die Standard-URL durch die Oracle Blockchain Platform-Instanz-URL, indem Sie den Basis-URL-Teil der Standard-URL ändern (test-xyz-abc.blockchain.ocp.oraclecloud.com). Beispiel:
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy/api/v2/channels/{channelName}
```
- Servervariablen: Ändern Sie channelName, um den Namen des Kanals anzugeben, in dem der Chaincode bereitgestellt wird.
- Authentifizierung für angemeldete Benutzer: OAuth 2.0 User Assertion wird zur Authentifizierung verwendet. Ändern Sie die URL so, dass sie mit der REST-Proxy-URL von Oracle Blockchain Platform übereinstimmt. Beispiel:
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy
```
- Client-ID und Client Secret: Klicken Sie auf das Symbol "Bearbeiten" neben ClientID. Aktualisieren Sie die Felder Client ID und Client Secret so, dass sie mit Ihrer Oracle Blockchain Platform-ID und Ihrem Secret übereinstimmen.
Aktualisieren Sie für alle anderen Backends im Fenster Serverdetails Folgendes:
- Instanz-URL: Ersetzen Sie die Standard-URL durch die Oracle Blockchain Platform-Instanz-URL, indem Sie den Basis-URL-Teil der Standard-URL ändern (test-xyz-abc.blockchain.ocp.oraclecloud.com). Beispiel:
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443
```
- Authentifizierung für angemeldete Benutzer: OAuth 2.0 User Assertion wird zur Authentifizierung verwendet. Ändern Sie die URL so, dass sie mit der REST-Proxy-URL von Oracle Blockchain Platform übereinstimmt. Beispiel:
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy
```
- Client-ID und Client Secret: Klicken Sie auf das Symbol "Bearbeiten" neben ClientID. Aktualisieren Sie die Felder Client ID und Client Secret so, dass sie mit Ihrer Oracle Blockchain Platform-ID und Ihrem Secret übereinstimmen.
Wiederholen Sie diese Schritte, um alle Backends zu aktualisieren.

Backend-Konfiguration für Rich-History-Datenbankinteraktionen

Jede Organisation verfügt über ein dediziertes Backend, das den Zugriff auf die umfangreiche Historiendatenbank verwaltet.

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

Im generischen Modus aktualisieren Sie nur das Backend SystemOwnerRichHistoryDBConfiguration. Im vertraulichen Modus müssen Sie das Backend des Systemeigentümers und die Backends für alle Teilnehmerorganisationen aktualisieren, die in Ihrem Deployment verwendet werden.

So aktualisieren Sie die Backend-Serverdetails:

Klicken Sie auf der Homepage von Visual Builder Visual Applications im Navigator auf Services, um den Bereich Services zu öffnen. Klicken Sie auf Backends, um eine Liste der Backends anzuzeigen.
Wählen Sie das entsprechende Backend aus. Klicken Sie auf Server.
Klicken Sie auf das Symbol Bearbeiten neben dem Standardserver.
Aktualisieren Sie im Abschnitt Serverdetails Folgendes:
- Instanz-URL: Ersetzen Sie die Standard-URL durch OAuth Base URL(ORDS_REST_BASE_URL/ords/<userName|aliasName>). Beispiel: Die Standard-URL:
```
https://g53630e55ee33f4-abc.def.gh-xyz-1.oraclecloudapps.com/ords/aliasName
```
  wird ersetzt durch:
```
https://g53630e55ee33f4-rhjkdb.adb.ap-sydney-1.oraclecloudapps.com/ords/vbcstest
```
- Authentifizierung für angemeldete Benutzer: Basic wird für die Authentifizierung verwendet.
- Client-ID und Client Secret: Klicken Sie neben Benutzername auf das Symbol "Bearbeiten". Aktualisieren Sie den Benutzernamen mit Client ID und das Kennwort mit Client Secret, damit er mit Ihrer ORDS-Endpunkt-ID und Ihrem Secret übereinstimmt.

Visual Builder-Geschäftsobjekte konfigurieren

Ein Geschäftsobjekt ist eine Ressource, wie z.B. eine Rechnung oder Bestellung, ähnlich einer Datenbanktabelle. Es enthält Felder, in denen die Daten für Ihre Anwendung gespeichert sind. Wie eine Datenbanktabelle stellt ein Geschäftsobjekt die Struktur für Daten bereit. Geschäftsobjekte werden in einer Datenbank gespeichert. Die Apps in Ihrer visuellen Anwendung und andere Clients greifen über ihre REST-Endpunkte auf die Geschäftsobjekte zu.

Klicken Sie auf der Homepage von Visual Builder Visual Applications im Navigator auf Geschäftsobjekte, um den Bereich "Geschäftsobjekte" zu öffnen. Die CBDC-Großhandelsobjekte werden aufgelistet.
Screenshot mit der vollständigen Liste der Geschäftsobjekte, die zur CBDC-Beispielanwendung im Großhandel in der Ansicht "Geschäftsobjekte" von Visual Builder gehören.

Sie können ein beliebiges Geschäftsobjekt auswählen und zur Registerkarte "Daten" gehen, um die zugehörigen Daten zu aktualisieren oder zu ändern.

Organisationsnamen

Dieses Geschäftsobjekt enthält vier Felder auf der Seite Daten und wird verwendet, um die Oracle Blockchain Platform-Instanzen mit dem richtigen Backend für jede Bank zu verbinden. Beispiel: Wenn ein Benutzer Bank1-Details in das ParticipantOrg1-System eingibt, muss die Anwendung ParticipantOrg1 mit Bank1 verknüpfen. Auf diese Weise kann das System Daten aus dem ParticipantOrg1-Backend abrufen, wenn sich ein Benutzer, der mit Bank1 verknüpft ist, anmeldet.

Aktualisieren Sie in diesem Geschäftsobjekt die Spalten BankName und mspId für die jeweiligen orgName-Werte. Die Aktualisierungen müssen der Anzahl der Teilnehmerorganisationen im Netzwerk entsprechen. Beispiel: Wenn zwei Teilnehmerorganisationen im Netzwerk vorhanden sind, müssen Sie die Spalten BankName und mspId für diese beiden Organisationen aktualisieren. Lassen Sie für die verbleibenden Teilnehmerorganisationen (ParticipantOrg3, ParticipantOrg4, ParticipantOrg5, ParticipantOrg6) die Spalten BankName und mspId auf den Wert empty gesetzt.

Feldname	Beschreibung	Standardwerte	Aktualisierung erforderlich (Ja/Nein)	Anforderung aktualisieren
BankName	Die Zuordnung zwischen den Oracle Blockchain Platform-Instanznamen und den Banknamen, die in der CBDC-Anwendung verwendet werden. Beispiel: Wenn Sie die Oracle Blockchain Platform-Instanz mit dem Namen `CentralBank` erstellt haben, der Wert `BankName` jedoch in der Anwendung `BSP` sein soll, erstellt diese Zuordnung die Zuordnung zwischen der Oracle Blockchain Platform-Instanz und `BSP`.	`CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5, Bank6`	Ja	Für aktive Teilnehmerorganisationen erforderlich; für nicht verwendete Teilnehmerorganisationen leer lassen.
mspId	Diese Spalte stellt die tatsächliche MSP-ID der Oracle Blockchain Platform-Instanz dar. Sie müssen diese Werte aktualisieren, wenn Oracle Blockchain Platform-Instanzen mit anderen Namen als Standardwerten erstellt werden.	`CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5, Bank6`	Ja	Für aktive Teilnehmerorganisationen erforderlich; für nicht verwendete Teilnehmerorganisationen leer lassen.
OrgName	Diese Spalte stellt `orgName`-Werte dar, die dem Backend zugeordnet werden. `SystemOwner` steht für den Gründer und `ParticipantOrg#` für die Teilnehmer.	`SystemOwner,ParticipantOrg1,ParticipantOrg2, ParticipantOrg3, ParticipantOrg4, ParticipantOrg5, ParticipantOrg6`	Nr.	N/V

Gleichgestellte Mitarbeiter

Dieses Geschäftsobjekt speichert Informationen zu den Peers in allen Oracle Blockchain Platform-Instanzen im Netzwerk. Um die Peer-URL-Details in das Geschäftsobjekt einzugeben, geben Sie die entsprechenden Peer-URL-Werte in die Spalte peerURL zusammen mit den entsprechenden Serviceprovider-IDs der Oracle Blockchain Platform-Mitgliedschaft (mspId) ein.

Beispiel: Wenn es eine Zentralbank und zwei Finanzinstitute mit jeweils zwei Peers gibt, müssen Sie insgesamt sechs Peer-URLs zusammen mit den zugehörigen mspId-Werten eingeben.

Feldname	Beschreibung
orgName	Oracle Blockchain Platform-Instanz `mspId`.
peerURL	Der `peerURL`-Wert von Oracle Blockchain Platform-Instanzen.

Hinweis:

Die in dieser Geschäftsschnittstelle enthaltenen Peers müssen dem erstellten gemeinsamen Kanal hinzugefügt werden.

Oracle Analytics Cloud für Oracle Visual Builder konfigurieren

Die Oracle Analytics Cloud-Instanz und die Oracle Visual Builder-Instanz müssen sich im selben OCI-Mandanten befinden.

Die Oracle Analytics Cloud-Instanz und die Oracle Visual Builder-Instanz müssen ebenfalls denselben Oracle Identity Cloud Service für das Identitätsmanagement verwenden. Benutzer, die auf die Oracle Visual Builder-Anwendung zugreifen, müssen über die erforderlichen Berechtigungen für Oracle Analytics Cloud und Oracle Visual Builder verfügen.

Bevor Sie die folgenden Schritte ausführen, konfigurieren Sie das CBDC-Analysepaket für den Großhandel. Weitere Informationen finden Sie unter Großhandels-CBDC-Beispielanalysepaket.

Rufen Sie die Oracle Visual Builder-Domain-URL ab.
1. Klicken Sie in der OCI-Konsole auf Entwicklerservices > Visual Builder.
2. Wählen Sie Ihre Visual Builder-Instanz aus, und klicken Sie auf Service-Homepage. Die Schnittstellenseite für Visuelle Anwendungen wird geöffnet. Kopieren Sie den Domainnamen aus der Adressleiste Ihres Browsers.
  Beispieldomainname: Example: https://wcbdc-vb-oabcs1.builder.ap-hyderabad-1.ocp.example.com
Fügen Sie die Domain als sichere Domain in Oracle Analytics Cloud hinzu.
1. Melden Sie sich bei Ihrer Oracle Analytics Cloud-Instanz an, öffnen Sie die Oracle Analytics Cloud-Konsole, und klicken Sie auf Navigatormenü.
2. Klicken Sie unter Konfiguration und Einstellungen auf Konsole > Sichere Domains.
3. Klicken Sie auf Domain hinzufügen, und fügen Sie die zuvor kopierte Visual Builder-Domain-URL ein. Die Domain wird automatisch hinzugefügt, wenn Sie an einer anderen Stelle auf dem Display klicken.
4. Aktivieren Sie die Kontrollkästchen Schritte zulassen und Einbetten, die mit der Domain verknüpft sind, die Sie gerade hinzugefügt haben.
Rufen Sie die Oracle Analytics Cloud-Host-URL ab.
1. Melden Sie sich bei Ihrer Oracle Analytics Cloud-Instanz an.
2. Kopieren Sie die Oracle Analytics Cloud-Host-URL aus der Adressleiste Ihres Browsers. Kopieren Sie den vollqualifizierten Domainnamen bis zu .com, einschließlich https://.
  Beispielhost-URL: https://<your-oac-instance>.analytics.ocp.example.com
Fügen Sie die Oracle Analytics Cloud-Host-URL als zulässigen Ursprung in Oracle Visual Builder hinzu.
1. Melden Sie sich bei Ihrer Oracle Visual Builder-Instanz an, und klicken Sie auf Service-Homepage.
2. Klicken Sie auf Navigationsmenü und dann auf Einstellungen. Die Seite Mandanteneinstellungen wird angezeigt.
3. Klicken Sie im Abschnitt Zulässige Ursprünge auf + Neuer Ursprung, und fügen Sie die Analytics Cloud-Domain-URL, die Sie zuvor kopiert haben, in das Feld Ursprungsadresse ein.
Aktualisieren Sie die Konfigurationsvariablen in der Visual Builder-Anwendung.
1. Öffnen Sie die Anwendung cbdcapp im App-Editor, und wählen Sie Variablen aus.
2. Aktualisieren Sie im Abschnitt Globale Variablen die folgenden Parameter im Objekt Konfigurationsvariable.
  
  OACHost
  
  Die URL der Oracle Analytics Cloud-Instanz, die Sie zuvor kopiert haben.
  
  OACSystemOwnerProjectPath
  
  Der Projektpfad für die Arbeitsmappe für den Systemeigentümer in Analytics Cloud.
  
  OACParticipantOrgProjectPath
  
  Der Projektpfad für die Arbeitsmappe der Teilnehmerorganisation in Analytics Cloud.
3. Um den Projektpfad einer Arbeitsmappe abzurufen, klicken Sie auf der Analytics Cloud-Homepage auf Navigator > Katalog.
4. Klicken Sie auf das Menü Aktionen für die Arbeitsmappe, und wählen Sie Prüfen aus. Das Fenster "Untersuchen" wird angezeigt.
5. Klicken Sie auf die Registerkarte Allgemein und dann auf Kopieren, das mit der Objekt-ID verknüpft ist.
Bearbeiten Sie die HTML in Visual Builder.
1. Öffnen Sie die Anwendung cbdcapp im App-Editor, und navigieren Sie zum Abschnitt HTML.
2. Aktualisieren Sie die Analytics Cloud-Host-URL in den Zeilen 30 und 31 entsprechend Ihrer Analytics Cloud-Instanz, wie im folgenden Code-Snippet dargestellt. Ändern Sie nicht die Unterverzeichnisstruktur der URL, sondern nur den Domainbereich bis zu .com.
```
<script src="https://abc-xyz-ia.analytics.ocp.example.com/public/dv/v1/embedding/jet/embedding.js" type="application/javascript"></script>
```