預入トークン・デプロイメント・リファレンス

次の情報には、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ベアラー・トークンが必要です。ORDSはコレクション・エンベロープを返します。HTTP 200が指定された空のitems配列は、リクエストが有効であったが、一致する索引付きレコードがないことを意味します。

ルート	使用および応答動作	必須の入力	オプションの入力とデフォルトの動作
getDepositTokenTransactionById	正規化された元帳取引詳細レコードを1つ返します。	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はアクター・ウォレットです。すべてのアクターに対して省略するか、1つのウォレットにスコープを指定します。
getDepositTokenHistory	トークン・レベルの履歴および供給関連情報を返します。	token_idはトークンを識別します。	なし。
getDepositTokenAccountsByRole	ロールに関連付けられたアカウントを返します。	roleは、照合するロール名です。	なし。
getDepositTokenUsersByRole	ロールのユーザー/アカウント・ロール割当を返します。	roleは、照合するロールの名前です。	なし。
getDepositTokenOrganizationAccountsByRole	ロールを持つ組織アカウントを返します	org_idは組織を識別し、roleはロール名です。	なし。
getAllDepositTokenAccounts	1つのトークンのすべてのインデックス付きアカウントを返します。	token_idはトークンを識別します。	なし。
getAllActiveDepositTokenAccounts	現在のインデックス付きステータスがアクティブであるアカウントを返します。	token_idはトークンを識別します。	なし。
getAllSuspendedDepositTokenAccounts	現在の索引付けステータスが一時停止になっているアカウントを返します。	token_idはトークンを識別します。	なし。
getDepositTokenOrganizationAccounts	1つの組織内のすべての索引付き勘定科目を返します。	org_idは、組織を識別します。	なし。
getPendingDepositTokenIssuance	現在の保留中の転送保留操作のみを返します。	token_idはトークンを識別します。	caller_account_idは、公証人/マネージャ・ウォレットです。フル・キューを省略し、そのウォレットにスコープを指定します。ターミナル操作は除外されます。
getPendingDepositTokenRequest	保留中のミント/バーン/転送要求のみを返します。	token_idはトークンを識別し、request_typeはサポートされているリクエスト・タイプを選択します。	なし。最新のライフサイクル・イベントが保留中の操作のみが返されます。
getPendingRequest	互換性保留中のリクエスト・ルート。	token_idおよびrequest_typeは、getPendingDepositTokenRequestと同じ意味を持ちます。	なし。
getDepositTokenAccountsByUser	1つの組織/ユーザー/トークンの組合せの勘定科目レコードを返します。	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は1つのポリシーを選択します。account_addressはアカウントでフィルタします。すべてをリストする場合は両方を省略します。bookmarkのデフォルトは0で、pageSizeのデフォルトは20です。
getDepositTokenAccountPolicyHistory	アカウントポリシーのリビジョンを返します。	なし。	account_policy_idおよびaccount_addressフィルタのリビジョン。両方を省略してすべてをリストします。bookmarkのデフォルトは0で、pageSizeのデフォルトは20です。
getDepositTokenApprovalPolicies	現在の承認ポリシー・レコードを返します。	なし。	approval_policy_idは1つのポリシーを選択し、すべてをリストする場合は省略します。bookmarkのデフォルトは0で、pageSizeのデフォルトは20です。
getDepositTokenApprovalPolicyHistory	承認ポリシーのリビジョンを返します。	なし。	approval_policy_idはリビジョンをフィルタし、すべてをリストする場合は省略します。bookmarkのデフォルトは0で、pageSizeのデフォルトは20です。
getPendingDepositTokenApprovalOperations	承認待ちの現在の操作を返します。	なし。	token_idおよびoperation_idはオプションのフィルタです。operation_idを省略すると、現在の保留中の操作がすべてリストされます。bookmarkのデフォルトは0で、pageSizeのデフォルトは20です。
getDepositTokenApprovalsByApprover	承認者による承認/却下の決定を返します。	approver_addressは、承認者のウォレット・アドレスです。	operation_idは、結果を1つの操作に絞り込み、その承認者によるすべての決定を省略します。bookmarkのデフォルトは0で、pageSizeのデフォルトは20です。
getDepositTokenApprovalsByOperationId	1つの操作の承認/却下イベントを返します。	operation_idは、承認操作を識別します。	bookmarkのデフォルトは0で、pageSizeのデフォルトは20です。
getDepositTokenApprovalStatusByOperationId	格納されたワークフロー・ステータスと現在のアクティブ・ポリシー解決を返します。	token_idおよびoperation_idは、ワークフロー/保留を識別します。	なし。合成BLOCKEDまたはAWAITING_MANAGER_COMPLETIONステータスは生成されません。

ページ区切りとタイムスタンプ: bookmarkパラメータはゼロベースの行オフセットで、pageSizeパラメータでは大文字と小文字が区別されます。履歴ルートの場合、startTimeおよびendTimeはYYYY-MM-DDTHH:MI:SS+/-HH:MI形式のISO-8601タイムスタンプ・テキストを使用します。

エンドポイント・インベントリ: 正確なルート・インベントリは、デプロイメント用にパッケージ化されたスクリプト・バージョンに属します。実行後、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管理者に承認済の無効化/再マップ/有効化プロシージャを完了してもらいます。
ビューには行がありません	インスタンスの作成中に正しいリッチ履歴プロファイルが選択され、表接頭辞が完全で、契約住所がデプロイされたプロキシと一致し、トランザクションが索引付けされていることを確認します。
オブジェクトが別のデプロイメントと競合しています	個別のVIEW_PREFIX、モジュール名、ベース・パス、ロール、権限、OAuthクライアント名および別名を使用します。