Referencia de despliegue de token de depósito

La siguiente información incluye descripciones de los objetos de base de datos que crea el script ORDS y consejos para la resolución de problemas.

El script ORDS crea las siguientes vistas operativas mediante el parámetro VIEW_PREFIX configurado.

<VIEW_PREFIX>_ACCOUNTS_V
<VIEW_PREFIX>_TRANSFER_EVENTS_V
<VIEW_PREFIX>_HOLDS_V
<VIEW_PREFIX>_ACTIVE_ROLES_V
<VIEW_PREFIX>_ACCOUNT_TX_HISTORY_V
<VIEW_PREFIX>_ACCOUNT_HISTORY_V

Si selecciona análisis, se crean las siguientes vistas de análisis, dentro del ámbito del despliegue.

<VIEW_PREFIX>_ACCOUNTS_MOD
<VIEW_PREFIX>_TRANSACTION_MOD
<VIEW_PREFIX>_ACCOUNTS_TRANSACTION_MOD

El script también crea o configura el módulo ORDS, las rutas, el alias de esquema, el rol, el privilegio, el cliente OAuth y la asociación de rol de cliente mediante los valores configurados.

Ver catálogo y lógica de consulta

Las siguientes vistas son vistas ordinarias de Oracle en el esquema seleccionado; no modifican las tablas del extractor.

Ver	Origen Primario	Finalidad/Lógica
<VIEW_PREFIX>_ACCOUNTS_V	_more, _store_state	Crea el directorio de la cuenta actual a partir de las llamadas createAccount y el estado de cuenta/token. Resuelve la identidad de la cuenta, el usuario y la organización, los saldos, los saldos de retención, el estado, los límites diarios, los metadatos de token y los metadatos de transacción de creación.
<VIEW_PREFIX>_TRANSFER_EVENTS_V	_more	Normaliza los logs de recepción de token en filas de evento de transferencia. Extrae metadatos de remitente, receptor, cantidad, función, bloque/transacción y contexto opcional ~OBPRPCTX~.value.category.
<VIEW_PREFIX>_HOLDS_V	_store_hist, _more, _store_state	Reconstruye los registros de menta, quema y transferencia. Extrae el ID de operación/retención, las cuentas, el notario, el importe, la caducidad, el token, la categoría, la descripción y el último estado del ciclo de vida. También proporciona filas de reserva cuando una fila de estado actual no se puede resolver.
<VIEW_PREFIX>_ACTIVE_ROLES_V	_more	Aplica el historial de agregación/eliminación de roles y devuelve la última asignación de roles activa por cuenta y rol.
<VIEW_PREFIX>_ACCOUNT_TX_HISTORY_V	Las vistas operativas anteriores	Produce filas de historial de transacciones orientadas a la cuenta, incluidas las dos caras de las transferencias y los resultados normalizados del ciclo de vida de la menta, la quema y la retención. Enriquece las identidades desde/hacia desde la vista _ACCOUNTS_V.
<VIEW_PREFIX>_ACCOUNT_HISTORY_V	_more, _ACCOUNTS_V	Genera el historial de configuración de cuentas a partir de las mutaciones de contratos de cuentas, incluidas las revisiones diarias de límites, los registros de hora, los números de bloque y los ID de transacción.
<VIEW_PREFIX>_ACCOUNTS_MOD (análisis opcional)	_ACCOUNTS_V	Expone los metadatos de la cuenta en la unidad de cuenta compatible con análisis.
<VIEW_PREFIX>_TRANSACTION_MOD (análisis opcional)	_TRANSFER_EVENTS_V, _HOLDS_V, _store_hist	Expone las transacciones de negocio normalizadas, incluidos los saldos de transferencia, menta, consumo, solicitud, retención, liberación y resultantes cuando están disponibles.
<VIEW_PREFIX>_ACCOUNTS_TRANSACTION_MOD (análisis opcional)	_TRANSACTION_MOD, _ACCOUNTS_V	Agrega el contexto de la organización de origen y destino a los registros de transacciones de análisis.

Rutas ORDS

Todas las rutas son rutas GET en <BASE_PATH>/ y necesitan un token de portador de OAuth. ORDS devuelve un sobre de recopilación; una matriz items vacía con HTTP 200 significa que la solicitud era válida pero no tenía registros indexados coincidentes.

Ruta	Uso y comportamiento de respuesta	Entradas necesarias	Entradas opcionales y comportamiento predeterminado
getDepositTokenTransactionById	Devuelve un registro de detalle de transacción-contabilidad normalizada.	token_id identifica el token; transaction_id identifica la transacción Besu.	Ninguno. Ninguna coincidencia devuelve una recopilación vacía.
getDepositTokenAccountTransactionHistory	Devuelve el historial de la cuenta resuelta por identidad de negocio.	token_id, org_id y user_id identifican la cuenta.	startTime y endTime restringen el rango temporal; omita cualquiera de los dos para que no haya límite. El valor por defecto de bookmark es 0. pageSize utiliza el valor por defecto del manejador.
getAllDepositTokenAccountTransactionHistory	Devuelve el historial de transacciones de toda la cuenta del token.	token_id identifica el token.	startTime, endTime, bookmark y pageSize se comportan como para la ruta de historial específica de la cuenta.
getDepositTokenAccountStatusHistory	Devuelve filas indexadas de historial de estado para una cuenta de negocio.	token_id, org_id y user_id identifican la cuenta.	Ninguno.
getDepositTokenApproverActionHistory	Decisiones del gestor/aprobador de devoluciones y acciones de transferencia final.	token_id identifica el token.	caller_account_id es la cartera del actor; omita para todos los actores o proporcione el ámbito a una cartera.
getDepositTokenHistory	Devuelve el historial de nivel de token y la información relacionada con el suministro.	token_id identifica el token.	Ninguno.
getDepositTokenAccountsByRole	Devuelve las cuentas asociadas con un rol.	role es el nombre del rol que se va a confrontar.	Ninguno.
getDepositTokenUsersByRole	Devuelve las asignaciones de rol de usuario/cuenta para un rol.	role es el nombre del rol que se va a confrontar.	Ninguno.
getDepositTokenOrganizationAccountsByRole	Devuelve cuentas de organización que tienen un rol	org_id identifica la organización; role es el nombre del rol.	Ninguno.
getAllDepositTokenAccounts	Devuelve todas las cuentas indexadas para un token.	token_id identifica el token.	Ninguno.
getAllActiveDepositTokenAccounts	Devuelve las cuentas cuyo estado indexado actual está activo.	token_id identifica el token.	Ninguno.
getAllSuspendedDepositTokenAccounts	Devuelve las cuentas cuyo estado indexado actual está suspendido.	token_id identifica el token.	Ninguno.
getDepositTokenOrganizationAccounts	Devuelve todas las cuentas indexadas de una organización.	org_id identifica la organización.	Ninguno.
getPendingDepositTokenIssuance	Devuelve solo las operaciones de transferencia pendientes actuales.	token_id identifica el token.	caller_account_id es la cartera de notario/gestor. Omitir para la cola completa; proporcionar el ámbito a esa cartera. Se excluyen las operaciones de terminal.
getPendingDepositTokenRequest	Devuelve solo solicitudes de menta/quemadura/transferencia pendientes.	token_id identifica el token; request_type selecciona el tipo de solicitud soportado.	Ninguno. Solo se devuelven las operaciones cuyo último evento de ciclo de vida permanece pendiente.
getPendingRequest	Ruta de compatibilidad pendiente de solicitud.	token_id y request_type tienen el mismo significado que getPendingDepositTokenRequest	Ninguno.
getDepositTokenAccountsByUser	Devuelve registros de cuenta para una combinación de organización/usuario/token.	token_id, org_id y user_id identifican el propietario y el token de la cuenta.	Ninguno.
getDepositTokenAccountHistory	Devuelve las revisiones del historial/configuración de la cuenta.	account_address es la dirección de cartera/cuenta de blockchain.	offset es un desplazamiento basado en cero; limit limita las filas. Omita cualquiera de los valores por defecto del manejador.
getDepositTokenAccountStatus	Devuelve el estado de la cuenta indexada actual.	token_id, org_id y user_id identifican la cuenta.	Ninguno.
getDepositTokenRolesByAccount	Devuelve roles para una cuenta resuelta.	token_id siempre es necesario. Proporcione account_address o org_id y user_id.	Si se proporciona account_address, es la consulta directa; de lo contrario, se utiliza la consulta de organización/usuario.
getAllDepositTokenOrganizations	Devuelve organizaciones representadas por cuentas indexadas para un token.	token_id identifica el token.	Ninguno.
getDepositTokenMetadata	Devuelve metadatos de token inmutables indexados.	token_id identifica el token.	Ninguno.
getDepositTokenRetiredQuantity	Devuelve información de cantidad dada de baja/quemada para un token.	token_id identifica el token.	Ninguno.
getDepositTokenAccountPolicies	Devuelve los registros de la política de cuenta actual.	Ninguno.	account_policy_id selecciona una política; account_address filtra por cuenta. Omita ambos para mostrar todos. El valor por defecto de bookmark es 0; el valor por defecto de pageSize es 20.
getDepositTokenAccountPolicyHistory	Devuelve las revisiones de la política de cuentas.	Ninguno.	Las revisiones de filtro account_policy_id y account_address; omita ambas para mostrarlas todas. El valor por defecto de bookmark es 0; el valor por defecto de pageSize es 20.
getDepositTokenApprovalPolicies	Devuelve los registros actuales de política de aprobación.	Ninguno.	approval_policy_id selecciona una política; omítela para mostrarlo todo. bookmark se define por defecto en 0; pageSize se define por defecto en 20.
getDepositTokenApprovalPolicyHistory	Devuelve revisiones de políticas de aprobación.	Ninguno.	approval_policy_id filtra las revisiones; omítelo para mostrarlas todas. bookmark se define por defecto en 0; pageSize se define por defecto en 20.
getPendingDepositTokenApprovalOperations	Devuelve las operaciones actuales en espera de aprobación.	Ninguno.	token_id y operation_id son filtros opcionales. Omita operation_id para mostrar todas las operaciones pendientes actuales. El valor por defecto de bookmark es 0; el valor por defecto de pageSize es 20.
getDepositTokenApprovalsByApprover	Devuelve las decisiones de aprobación/rechazo de un aprobador.	approver_address es la dirección de cartera del aprobador.	operation_id reduce los resultados a una operación; omita todas las decisiones de ese aprobador. bookmark tiene el valor por defecto 0; pageSize tiene el valor por defecto 20.
getDepositTokenApprovalsByOperationId	Devuelve eventos de aprobación/rechazo para una operación.	operation_id identifica la operación de aprobación.	bookmark se define por defecto en 0; pageSize se define por defecto en 20.
getDepositTokenApprovalStatusByOperationId	Devuelve el estado del flujo de trabajo almacenado más la resolución actual de la política activa.	token_id y operation_id identifican el flujo de trabajo/retención.	Ninguno. No genera estados BLOCKED o AWAITING_MANAGER_COMPLETION sintéticos.

Paginación y registros de hora: el parámetro bookmark es un desplazamiento de fila basado en cero y el parámetro pageSize es sensible a mayúsculas/minúsculas. Para las rutas de historial, startTime y endTime utilizan texto de registro de hora ISO-8601 con el formato YYYY-MM-DDTHH:MI:SS+/-HH:MI.

Inventario de punto final: el inventario de ruta exacto pertenece a la versión de script empaquetada para el despliegue. Después de la ejecución, utilice el catálogo ORDS OpenAPI o la salida de punto final generada como lista autorizada para la aplicación cliente.

Solución de problemas

Mensaje o condición	Resolución
NJS-516: no configuration directory set	Se ha utilizado un alias TNS sin un directorio de configuración/cartera accesible. Extraiga la cartera y configure el cliente de Oracle para que el archivo tnsnames.ora esté disponible.
NJS-511 o ORA-12506	Problema de configuración de listener, punto final, nombre de servicio, lista de permitidos de red o cartera. Valide la conexión de Oracle fuera del script con el DBA.
La solicitud de token de OAuth devuelve 404	Verifique el alias exacto en /ords/<ALIAS_NAME>/oauth/token. El alias no es necesariamente el nombre de usuario de Oracle.
El punto final devuelve 401	Obtenga un token nuevo y verifique que el cliente de OAuth tenga el rol/privilegio asociado a la ruta base del módulo configurado.
El punto final devuelve 404	Verifique el host, el alias, la ruta base, el nombre de la ruta y que el módulo está publicado.
ORDS-25001	El punto final ha alcanzado ORDS, pero su SQL ha fallado. Verifique el prefijo de tabla, las direcciones de contrato, la unidad de datos de origen y los parámetros de solicitud necesarios.
ORA-20049: Cannot alter the URL mapping while the schema is enabled	El ALIAS_NAME seleccionado entra en conflicto con una asignación de esquema activada. Vuelva a utilizar el alias existente del esquema o haga que el administrador de ORDS complete el procedimiento de desactivación, reasignación y activación aprobado antes de volver a ejecutar el script.
Las vistas no contienen filas	Confirme que se ha seleccionado el perfil de historial enriquecido correcto durante la creación de la instancia, que el prefijo de tabla es exacto, que las direcciones de contrato coinciden con los proxies desplegados y que las transacciones se han indexado.
Los objetos entran en conflicto con otro despliegue	Utilice un VIEW_PREFIX distinto, un nombre de módulo, una ruta base, un rol, un privilegio, un nombre de cliente de OAuth y un alias.