Análisis de Stablecoin

Oracle Blockchain Platform Digital Assets Edition incluye un libro de trabajo de Oracle Analytics de ejemplo para el escenario stablecoin.

Para utilizar el libro de trabajo de Oracle Analytics de ejemplo, debe ejecutar el script de Oracle REST Data Services (ORDS) para configurar las definiciones de vista de base de datos y, a continuación, importar los archivos de libro de trabajo para configurar Oracle Analytics Cloud.

Definiciones de vista de Oracle Database para Stablecoin

Debe configurar las definiciones de vista de base de datos para poder utilizar el libro de trabajo de Oracle Analytics en el escenario de stablecoin.

Active y configure la base de datos de historial enriquecido.
Para obtener más información, consulte Activación y configuración de la base de datos de historial enriquecida en Uso de Oracle Blockchain Platform.
Active el historial enriquecido en los canales que contienen los datos de código de cadenas que desea escribir en la base de datos de historial enriquecido. Para obtener más información, consulte Configuración de los canales que escriben datos en la base de datos de historial enriquecida en Uso de Oracle Blockchain Platform.
Descargue e instale Node.js versión 18 o posterior.
En la página Activos digitales de Oracle Blockchain Platform, seleccione Stablecoin.
Haga clic en Descargar el paquete Database View Definitions.
Extraiga el archivo de almacenamiento descargado.
Vaya a la carpeta ORDSscript e instale las dependencias necesarias ejecutando el siguiente comando.
```
npm install
```

Edite el archivo .env que se proporciona con el script para configurarlo para su entorno.

Los puntos finales de Oracle REST Data Services utilizan el siguiente formato general.

<base_URL>/<user_name>/<resource_link>

Tipo de entorno/configuración	Variables de entorno/configuración	Descripción	Ejemplo
`DB Connection`	`CONNECTION_STRING`	Cadena de conexión para la base de datos.	`CONNECTION_STRING="(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522) (host=adg.ap-sydney-1.example.com))(connect_data= (service_name=g536390e55ee33f4_db_high.adg.example.com))(security=(ssl_server_dn_match=yes)))"`
`View Configuration`	`CHAINCODE_NAME`	Nombre del código de cadenas desde el que se recuperarán los detalles de la transacción en la base de datos de historial enriquecida.	`CHAINCODE_NAME="Stablecoin"`
`View Configuration`	`INSTANCE_NAME`	Nombre de la instancia en la que se despliega el código de cadena.	`INSTANCE_NAME="Stablecoin"`
`View Configuration`	`CHANNEL_NAME`	Nombre del canal donde se despliega el código de cadena.	`CHANNEL_NAME="default"`
`ORDS Endpoint Setup`	`MODULE_NAME`	El nombre del módulo ORDS que se va a utilizar. Puede ser cualquier valor que no entre en conflicto con los activos existentes en la base de datos.	`MODULE_NAME="demotest"`
`ORDS Endpoint Setup`	`BASE_PATH`	Ruta base de la URL de ORDS. Puede ser cualquier valor que no entre en conflicto con los activos existentes en la base de datos.	`BASE_PATH="demotest"`
`ORDS Endpoint Setup`	`PATTERN`	Nombre de patrón de la URL de ORDS. Puede ser cualquier valor que no entre en conflicto con los activos existentes en la base de datos.	`PATTERN="accountTransactionDetails"`
`ORDS REST Endpoint`	`ORDS_REST_BASE_URL`	URL base del punto final de REST de ORDS de la base de datos.	`ORDS_REST_BASE_URL="https://g536390e55ee33f4_db_high.adg.ap-sydney-1.example.com"`
`Alias Configuration`	`ALIAS_NAME`	Alias que se utilizará en lugar de un nombre de usuario en la URL de punto final de REST. Puede ser cualquier valor que no entre en conflicto con los activos existentes en la base de datos.	`ALIAS_NAME="demotestAlias"`
`ORDS Role`	`ROLE_NAME`	El rol ORDS asignado al usuario. Puede ser cualquier valor que no entre en conflicto con los activos existentes en la base de datos.	`ROLE_NAME="demotest_role"`
`ORDS Privilege`	`PRIVILEGE_NAME`	El privilegio ORDS que se asigna al usuario. Puede ser cualquier valor que no entre en conflicto con los activos existentes en la base de datos.	`PRIVILEGE_NAME="demotest_priv"`
`ORDS Privilege`	`LABEL`	Etiqueta para el privilegio ORDS. Puede ser cualquier valor que no entre en conflicto con los activos existentes en la base de datos.	`LABEL="demotest_label"`
`ORDS Privilege`	`DESCRIPTION`	Descripción del privilegio ORDS. Puede ser cualquier valor que no entre en conflicto con los activos existentes en la base de datos.	`DESCRIPTION="demotest_description"`
`OAuth Configuration`	`CLIENT_NAME`	Nombre de cliente que se va a utilizar para la autenticación OAuth con el punto final REST de ORDS. Puede ser cualquier valor que no entre en conflicto con los activos existentes en la base de datos.	`CLIENT_NAME="demotest_client"`
`OAuth Configuration`	`OWNER`	Nombre del propietario que se utilizará para la autenticación OAuth con el punto final de REST de ORDS. Puede ser cualquier valor que no entre en conflicto con los activos existentes en la base de datos.	`OWNER="demotest"`
`OAuth Configuration`	`DESCRIPTION`	Descripción de la configuración OAuth. Puede ser cualquier valor que no entre en conflicto con los activos existentes en la base de datos.	`DESCRIPTION="demotest_description"`
`OAuth Configuration`	`SUPPORT_EMAIL`	Dirección de correo electrónico de soporte para la configuración de OAuth. Puede ser cualquier valor que no entre en conflicto con los activos existentes en la base de datos.	`SUPPORT_EMAIL="test@example.com"`

Las siguientes vistas de Oracle Analytics las genera el script: ACCOUNTS_MOD, TRANSACTION_MOD y ACCOUNTS_TRANSACTION_MOD.

Ejecute el script de ORDS con el siguiente comando.
```
npm run start
```
Cuando se ejecuta el comando, se muestran las siguientes indicaciones.

Enter your DB User Name

Introduzca el nombre de usuario para la base de datos de historial enriquecido. La cuenta debe tener los permisos necesarios para crear vistas y puntos finales de ORDS.

Enter your DB Password

Introduzca la contraseña de la base de datos de historial enriquecido.

Please select a chaincode type

Seleccione STABLECOIN (STABLECOIN). Utilice las teclas de flecha para desplazarse y, a continuación, pulse la tecla Intro para confirmar la selección.

Do you want to create the View and ORDS Endpoint? (y/n)

Introduzca y para crear la vista y el punto final. Introduzca n si ya ha creado la vista y el punto final.

Please select the language of your chaincode? (TS/GO)

Si ha introducido y anteriormente, introduzca TS para TypeScript.

Do you want to generate ORDS Endpoint URL and Bearer Token? (y/n)

Introduzca y para generar las credenciales de punto final. De lo contrario, introduzca n.

Configuración de Oracle Analytics Cloud para Stablecoin

Complete los siguientes pasos para configurar Oracle Analytics Cloud y utilizar el libro de trabajo de análisis para el escenario de stablecoin.

Cree una instancia de Oracle Autonomous Database.
Configure las definiciones de vista de base de datos. Para obtener información sobre cómo configurar las definiciones de vista de base de datos para el ejemplo de stablecoin, consulte Oracle Database View Definitions for Stablecoin.
Cree una instancia de Oracle Analytics Cloud en Oracle Cloud Infrastructure (OCI).
1. Conéctese a la consola de OCI.
2. Haga clic en Analytics & AI > Oracle Analytics Cloud.
3. Seleccione Crear instancia y, a continuación, agregue la información necesaria.
4. Seleccione Crear y, a continuación, espere a que finalice la creación de la instancia.
Para obtener más información sobre Oracle Analytics Cloud, consulte Oracle Analytics Cloud.
En Sample Stablecoin Analytics Workbook de la página Digital Assets de Oracle Blockchain Platform Digital Assets Edition, seleccione Download sample Analytics package. El archivo StablecoinAnalyticsPackage.zip, que contiene la aplicación de ejemplo, se descarga en el equipo.
Extraiga el archivo StablecoinAnalyticsPackage.zip, que contiene el directorio StablecoinAnalyticsPackage. Los archivos del libro de trabajo (.dva) están en el directorio StablecoinAnalyticsPackage
Realice una copia de seguridad de ambos archivos de libro de trabajo, System Owner Dashboard.dva y Participating Org Dashboard.dva.
Navegue a Oracle Analytics Cloud en la consola de OCI y, a continuación, seleccione Página de inicio de Analytics.
Seleccione Importar libro de trabajo/flujo e importe ambos archivos de libro de trabajo. Seleccione Incluir todos los permisos si existen. Introduzca OraAnalytic@2025 como contraseña. Para obtener más información, consulte Importación de un archivo de libro de trabajo.
Actualice los detalles de conexión de origen de datos para el juego de datos Analytics_Connection.
1. Vaya a la página Datos de Oracle Analytics Cloud.
2. Busque el juego de datos Analytics_Connection y, a continuación, seleccione Inspeccionar/Editar > Actualizar conexión de base de datos.
3. Asigne las vistas de base de datos.
4. Seleccione Guardar.
Para obtener más información sobre la conexión de Oracle Autonomous Transaction Processing a Oracle Analytics Cloud, consulte Conexión a Oracle Autonomous Transaction Processing.
Configurar roles y permisos para los paneles de control de organización de participantes y propietarios del sistema.
1. En Oracle Analytics Cloud, seleccione Consola.
2. Seleccione Roles y permisos y, a continuación, seleccione Roles de aplicación.
3. Seleccione Crear rol de aplicación y cree el rol de aplicación SystemOwnerRole.
4. En Miembros, seleccione Grupos y, a continuación, seleccione Agregar grupos.
5. Asigne grupos a los roles SystemOwnerRole y BI Dataload Author. El rol BI Dataload Author es necesario para embeber datos de Oracle Analytics Cloud en Oracle Visual Builder. Los grupos de Oracle Identity Cloud Service (IDCS) asociados a la aplicación de ejemplo se deben asignar al rol BI Dataload Author. Si no se asignan los roles SystemOwnerRole y BI Dataload Author, los datos de análisis no se mostrarán en la aplicación de ejemplo, aunque Oracle Analytics Cloud esté integrado con Oracle Visual Builder. Asigne todos los grupos de IDCS relevantes de la aplicación de ejemplo a estos roles. Por ejemplo, asigne los siguientes grupos.
  - SYSTEM_ADMINS
  - SYSTEM_AUDITORS
  - SYSTEM_CREATORS
  - SYSTEM_MANAGERS
  - SYSTEM_ISSUERS
  - SYSTEM_RETIRERS
6. Cree roles para las organizaciones participantes: ParticipantOrg1Role, ParticipantOrg2Role, etc.
7. Asigne grupos a los roles de organización de participantes y al rol BI Dataload Author. Puede crear grupos con cualquier nombre, como los siguientes grupos de ejemplo. En los siguientes grupos de ejemplo, cambie el número de la organización participante en el nombre del grupo para que coincida con el rol de organización correspondiente.
  - ORG1_ADMINS
  - ORG1_AUDITORS
  - ORG1_MANAGERS
  - ORG1_OFFICERS
Para obtener más información, consulte Asignación de roles de aplicación a grupos.
Actualice los parámetros de nombre de instancia para los paneles de control de organización de participantes y propietarios del sistema.
1. Inicie sesión como administrador y abra el panel de control del propietario del sistema.
2. Seleccione Editar.
3. En Parámetros, haga clic con el botón derecho para editar el parámetro para el nombre de instancia del propietario del sistema.
4. Introduzca el nombre de la instancia del propietario del sistema o el ID del proveedor de servicios de afiliación (MSP). Por ejemplo, introduzca CB.
5. Repita los pasos anteriores para actualizar el nombre de la instancia del propietario del sistema en el panel de control de la organización del participante.
Actualice los roles en el panel de control de la organización del participante.
1. Abra el panel de control de organización del participante y, a continuación, seleccione Editar panel de control.
2. Seleccione la pestaña Datos y, a continuación, seleccione la vista System_Owner_Account_Trans_Mod-Participating_Org.
3. Seleccione Diagrama de unión.
4. Agregue roles y filtros para cada participante.
  1. Seleccione el botón Agregar junto a Filtros de rol.
  2. Agregue una expresión de filtro que incluya una consulta. Por ejemplo, agregue la siguiente consulta SQL al rol ParticipantOrg1Role, que menciona Org1 y Org2 como organizaciones participantes.
```
FROM_ORG_ID = 'Org1' AND TO_ORG_ID = 'Org2'
```
    Debe agregar roles y filtrar expresiones de forma secuencial antes de continuar con el siguiente rol.
  3. Repita este proceso para los roles ParticipantOrg2Role, ParticipantOrg3Role, etc.
Mueva los paneles de control a carpetas compartidas en Oracle Analytics Cloud.
1. Vaya a Catálogo > Mis carpetas.
2. Cree una carpeta denominada Shared en el directorio Shared Folders.
3. Mueva los paneles de control del directorio My Folders a la carpeta Shared dentro del directorio Carpetas compartidas.
Realice pruebas exhaustivas para asegurarse de que todas las visualizaciones, conexiones de datos, acceso de usuario y otras funciones funcionan según lo esperado.