存款權杖部署參考

下列資訊包括 ORDS 命令檔所建立之資料庫物件的描述，以及疑難排解秘訣。

ORDS 命令檔會使用設定的 VIEW_PREFIX 參數建立下列作業視觀表。

<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

如果您選取分析，就會建立下列分析檢視，並將其範圍設定為部署。

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

此命令檔也會使用設定的值，建立或設定 ORDS 模組、路由、綱要別名、角色、權限、OAuth 從屬端以及從屬端角色關聯。

檢視型錄與查詢邏輯

下列視觀表是所選綱要中的一般 Oracle 視觀表；它們不會修改擷取器表格。

檢視	主要來源	目的 / 邏輯
<VIEW_PREFIX>_ACCOUNTS_V	_more, _store_state	從 createAccount 呼叫和帳戶 / 權杖狀態建立目前的帳戶目錄。它可解決帳戶、使用者和組織識別、餘額、保留餘額、狀態、每日限制、權杖描述資料，以及建立交易描述資料。
<VIEW_PREFIX>_TRANSFER_EVENTS_V	_more	將變數替代字收貨日誌標準化為移轉事件資料列。它會擷取寄件者、接收者、金額、函數、區塊 / 交易描述資料，以及選擇性的 ~OBPRPCTX~.value.category 相關資訊環境。
<VIEW_PREFIX>_HOLDS_V	_store_hist, _more, _store_state	重新建構保留薄荷、燒錄與轉移記錄。它會擷取作業 / 保留 ID、帳戶、公證人、金額、到期、變數替代字、類目、描述及最新生命週期狀態。當目前的狀態資料列無法解析時，它也提供後援資料列。
<VIEW_PREFIX>_ACTIVE_ROLES_V	_more	套用角色新增 / 移除歷史記錄，並傳回每個帳戶與角色的最新有效角色指派。
<VIEW_PREFIX>_ACCOUNT_TX_HISTORY_V	上一個作業視觀表	產生面向帳戶的交易歷史記錄資料列，包含移轉兩側與標準化的薄荷 / 消耗 / 保留生命週期結果。它會從 _ACCOUNTS_V 視觀表強化身分識別。
<VIEW_PREFIX>_ACCOUNT_HISTORY_V	_more, _ACCOUNTS_V	從帳戶合約變化產生帳戶組態歷史記錄，包含每日限額修訂、時間戳記、鎖房團訂編號及交易 ID。
<VIEW_PREFIX>_ACCOUNTS_MOD (選擇性分析)	_ACCOUNTS_V	在與分析相容的帳戶資源配置中顯示帳戶描述資料。
<VIEW_PREFIX>_TRANSACTION_MOD (選擇性分析)	_TRANSFER_EVENTS_V, _HOLDS_V, _store_hist	顯示標準化的業務交易，包括移轉、提示、燒錄、要求、保留、核發及產生的餘額 (若有的話)。
<VIEW_PREFIX>_ACCOUNTS_TRANSACTION_MOD (選擇性分析)	_TRANSACTION_MOD, _ACCOUNTS_V	將來源與目的地組織內容新增至分析異動記錄。

ORDS 路由

所有路由都是 <BASE_PATH>/ 底下的 GET 路由，且需要 OAuth Bearer 權杖。ORDS 會傳回集合附加訊息；具有 HTTP 200 的空白 items 陣列表示要求有效，但沒有相符的已編製索引記錄。

路由	使用與回應行為	必要輸入	選擇性輸入與預設行為
getDepositTokenTransactionById	傳回一筆標準化分類帳 - 交易明細記錄。	token_id 可識別記號；transaction_id 可識別 Besu 交易。	無。沒有相符項目會傳回空白集合。
getDepositTokenAccountTransactionHistory	傳回由業務識別解析之帳戶的歷史記錄。	token_id、org_id 及 user_id 識別帳戶。	startTime 和 endTime 會限制時間範圍；省略無界限。bookmark 預設為 0。pageSize 會使用處理程式預設值。
getAllDepositTokenAccountTransactionHistory	傳回整個權杖的帳戶交易歷史記錄。	token_id 識別記號。	startTime、endTime、bookmark 及 pageSize 的行為與帳戶特定的歷史記錄路徑相同。
getDepositTokenAccountStatusHistory	傳回商業帳戶的已編列索引狀態歷史記錄資料列。	token_id、org_id 及 user_id 識別帳戶。	無。
getDepositTokenApproverActionHistory	傳回經理 / 核准者決定與最終保留移轉作業。	token_id 識別記號。	caller_account_id 是動作者公事包；省略所有動作者，或提供範圍至一個公事包。
getDepositTokenHistory	傳回權杖層級歷史記錄與供應相關資訊。	token_id 識別記號。	無。
getDepositTokenAccountsByRole	傳回與角色相關聯的帳戶。	role 是要比對的角色名稱。	無。
getDepositTokenUsersByRole	傳回角色的使用者 / 帳戶角色指派。	role 是要比對的角色名稱。	無。
getDepositTokenOrganizationAccountsByRole	傳回具有角色的組織帳戶	org_id 識別組織；role 是角色名稱。	無。
getAllDepositTokenAccounts	傳回一個權杖的所有已編製索引帳戶。	token_id 識別記號。	無。
getAllActiveDepositTokenAccounts	傳回目前已編列索引狀態為有效的帳戶。	token_id 識別記號。	無。
getAllSuspendedDepositTokenAccounts	傳回目前已編製索引狀態為暫停的帳戶。	token_id 識別記號。	無。
getDepositTokenOrganizationAccounts	傳回一個組織中所有已編製索引的帳戶。	org_id 識別組織。	無。
getPendingDepositTokenIssuance	僅傳回目前暫緩的移轉保留作業。	token_id 識別記號。	caller_account_id 是公證人 / 管理者公事包。省略整個佇列；提供給該公事包的範圍。排除終端機作業。
getPendingDepositTokenRequest	僅傳回待處理的 Mint/burn/transfer 要求。	token_id 會識別記號；request_type 會選取支援的要求類型。	無。只會傳回其最新生命週期事件維持擱置中的作業。
getPendingRequest	相容性擱置要求路由。	token_id 和 request_type 的意義與 getPendingDepositTokenRequest 的意義相同	無。
getDepositTokenAccountsByUser	傳回一個組織 / 使用者 / 權杖組合的帳戶記錄。	token_id、org_id 及 user_id 可識別帳戶擁有者與權杖。	無。
getDepositTokenAccountHistory	傳回帳戶組態 / 歷史記錄修訂版本。	account_address 是區塊鏈帳戶 / 公事包位址。	offset 為零基位移；limit 大寫資料列。省略處理程式預設值。
getDepositTokenAccountStatus	傳回目前已編列索引的帳戶狀態。	token_id、org_id 及 user_id 識別帳戶。	無。
getDepositTokenRolesByAccount	傳回已解決帳戶的角色。	一律需要 token_id。請提供 account_address 或 org_id 和 user_id。	如果提供 account_address，則為直接查尋；否則會使用組織 / 使用者查尋。
getAllDepositTokenOrganizations	傳回記號已編製索引之帳戶所代表的組織。	token_id 識別記號。	無。
getDepositTokenMetadata	傳回已編製索引的不可變權杖描述資料。	token_id 識別記號。	無。
getDepositTokenRetiredQuantity	傳回變數替代字的處分 / 消耗數量資訊。	token_id 識別記號。	無。
getDepositTokenAccountPolicies	傳回目前帳戶政策記錄。	無。	account_policy_id 會選取一個原則；account_address 會依帳戶篩選。省略兩者以列出全部。bookmark 預設為 0；pageSize 預設為 20。
getDepositTokenAccountPolicyHistory	傳回帳戶原則修訂版本。	無。	account_policy_id 和 account_address 篩選修訂版本；省略兩者以全部列出。bookmark 預設為 0；pageSize 預設為 20。
getDepositTokenApprovalPolicies	傳回目前的 Approval-policy 記錄。	無。	approval_policy_id 會選取一個原則；省略以列出所有原則。bookmark 預設為 0；pageSize 預設為 20。
getDepositTokenApprovalPolicyHistory	傳回 approval-policy 修訂版本。	無。	approval_policy_id 篩選修訂版本；省略以列出所有修訂版本。bookmark 預設為 0；pageSize 預設為 20。
getPendingDepositTokenApprovalOperations	傳回目前等待核准的作業。	無。	token_id 和 operation_id 為選擇性篩選。省略 operation_id 以列出所有目前的擱置中作業。bookmark 預設為 0；pageSize 預設為 20。
getDepositTokenApprovalsByApprover	傳回核准者核准 / 拒絕決定。	approver_address 是核准者公事包位址。	operation_id 會將結果縮小為一個作業；省略該核准者所有決策。bookmark 預設為 0；pageSize 預設為 20。
getDepositTokenApprovalsByOperationId	傳回一項作業的核准 / 拒絕事件。	operation_id 識別核准作業。	bookmark 預設為 0；pageSize 預設為 20。
getDepositTokenApprovalStatusByOperationId	傳回已儲存的工作流程狀態加上目前的作用中原則解析。	token_id 和 operation_id 會識別工作流程 / 保留。	無。它不會產生綜合 BLOCKED 或 AWAITING_MANAGER_COMPLETION 狀態。

分頁和時戳：bookmark 參數是以零為基礎的資料列偏移量，而 pageSize 參數則區分大小寫。對於歷史記錄路由，startTime 和 endTime 使用 ISO-8601 時戳文字，格式為 YYYY-MM-DDTHH:MI:SS+/-HH:MI。

端點產品目錄：實際的路由產品目錄屬於針對部署封裝的命令檔版本。執行之後，請使用 ORDS OpenAPI 目錄或產生的端點輸出作為從屬端應用程式的授權清單。

疑難排解

訊息或條件	解決方式
NJS-516: no configuration directory set	使用的 TNS 別名沒有可存取的公事包 / 組態目錄。擷取公事包並設定 Oracle 從屬端，讓 tnsnames.ora 檔案可供使用。
NJS-511 或 ORA-12506	監聽器、端點、服務名稱、網路允許清單或公事包組態問題。使用 DBA 驗證命令檔之外的 Oracle 連線。
OAuth 權杖要求傳回 404	驗證 /ords/<ALIAS_NAME>/oauth/token 中的確切別名。別名不一定是 Oracle 使用者名稱。
端點傳回 401	取得全新的權杖並確認 OAuth 從屬端具備與所設定模組基本路徑關聯的角色 / 權限。
端點傳回 404	請檢查主機、別名、基礎路徑、路由名稱，以及模組是否已發布。
ORDS-25001	端點已達 ORDS，但其 SQL 失敗。請驗證表格首碼、合約地址、來源資料形狀及必要要求參數。
ORA-20049: Cannot alter the URL mapping while the schema is enabled	選擇的 ALIAS_NAME 與啟用的綱要對應衝突。重複使用綱要的現有別名，或讓 ORDS 管理員完成核准的停用 / 重新對應 / 啟用程序，再重新執行命令檔。
檢視未包含資料列	確認在建立執行處理時選取了正確的 RTF 歷史記錄設定檔、表格前置碼確實相符、符合已部署代理主機的合約地址，以及已編製交易索引。
物件與其他部署衝突	使用不同的 VIEW_PREFIX、模組名稱、基礎路徑、角色、權限、OAuth 從屬端名稱及別名。