2.30 Blueprints
APEX now supports a new Markdown-based blueprint format for Spec-Driven Development (SDD) with AI coding assistants. With SDD, the specification becomes the durable source of truth: it describes what the application should do, what the database means, and how users should work with the data. An AI assistant can use those specifications to generate an inspectable APEX application design artifact that can be reviewed before creating the application.
For more information on blueprint support, see https://github.com/oracle/apex.
Importing an Application Blueprint
Application Blueprints can be imported directly through the App Builder Import page.
何を説明しているのか分からなかったので（Markdownをインポートしてアプリケーションを作成する？）、リンクが貼られているGitHubから内容を確認してみました。GitHubのapexのリポジトリを開きます。blueprintsは26.1の新機能なので、ブランチとして26.1を選択します。フォルダblueprintsが現れます。
git clone -b 26.1 https://github.com/oracle/apex.git
blueprint % git clone -b 26.1 https://github.com/oracle/apex.git
Cloning into 'apex'...
remote: Enumerating objects: 6382, done.
remote: Counting objects: 100% (527/527), done.
remote: Compressing objects: 100% (238/238), done.
remote: Total 6382 (delta 387), reused 324 (delta 286), pack-reused 5855 (from 1)
Receiving objects: 100% (6382/6382), 449.49 MiB | 7.62 MiB/s, done.
Resolving deltas: 100% (3112/3112), done.
blueprint %
cp -r apex/blueprints/examples/order-entry .
ls order-entry
blueprint % cp -r apex/blueprints/examples/order-entry .
blueprint % ls order-entry
database-objects README.md screenshots skills-input skills-output
blueprint %
blueprint % local-26ai.sh create-user blueprint
loaded .env file
SQLcl: 月 6月 08 14:27:11 2026のリリース26.1 Production
Copyright (c) 1982, 2026, Oracle. All rights reserved.
接続先:
Oracle AI Database 26ai Free Release 23.26.1.0.0 - Develop, Learn, and Run for Free
Version 23.26.1.0.0
USER
_______
SYS
[中略]
接続先:
Oracle AI Database 26ai Free Release 23.26.1.0.0 - Develop, Learn, and Run for Free
Version 23.26.1.0.0
USER
____________
BLUEPRINT
名前: local-26ai-blueprint
接続文字列: localhost:1521/FREEPDB1
ユーザー: blueprint
パスワード: ******
PL/SQLプロシージャが正常に完了しました。
Oracle AI Database 26ai Free Release 23.26.1.0.0 - Develop, Learn, and Run for Free
Version 23.26.1.0.0から切断されました
>>>>
saved sqlcl connection
connect with 'sql -name local-26ai-blueprint'
blueprint %
blueprint % sql -name local-26ai-sys
SQLcl: 月 6月 08 14:28:20 2026のリリース26.1 Production
Copyright (c) 1982, 2026, Oracle. All rights reserved.
接続先:
Oracle AI Database 26ai Free Release 23.26.1.0.0 - Develop, Learn, and Run for Free
Version 23.26.1.0.0
SQL> revoke select_catalog_role from blueprint;
Revokeが正常に実行されました。
SQL> exit
Oracle AI Database 26ai Free Release 23.26.1.0.0 - Develop, Learn, and Run for Free
Version 23.26.1.0.0から切断されました
blueprint %
blueprint % ls order-entry/database-objects
order-entry-schema-19c.sql order-entry-seed-data-19c.sql
order-entry-schema-26ai.sql order-entry-seed-data-26ai.sql
blueprint %
@order-entry/database-objects/order-entry-schema-26ai.sql
blueprint % sql -name local-26ai-blueprint
SQLcl: 月 6月 08 14:34:20 2026のリリース26.1 Production
Copyright (c) 1982, 2026, Oracle. All rights reserved.
接続先:
Oracle AI Database 26ai Free Release 23.26.1.0.0 - Develop, Learn, and Run for Free
Version 23.26.1.0.0
SQL> @order-entry/database-objects/order-entry-schema-26ai.sql
View OREN_ORDERS_DVが削除されました。
Table OREN_ORDER_ITEMSが削除されました。
Table OREN_ORDERSが削除されました。
[中略]
Table OREN_ORDER_ITEMSが変更されました。
Table OREN_ORDER_ITEMSが変更されました。
Table OREN_ORDER_ITEMSが変更されました。
Table OREN_ORDER_ITEMSが変更されました。
SQL> @order-entry/database-objects/order-entry-seed-data-26ai.sql
0行削除されました。
0行削除されました。
0行削除されました。
0行削除されました。
[中略]
Table OREN_PRODUCTSが変更されました。
Table OREN_ORDERSが変更されました。
Table OREN_ORDER_ITEMSが変更されました。
SQL> exit
Oracle AI Database 26ai Free Release 23.26.1.0.0 - Develop, Learn, and Run for Free
Version 23.26.1.0.0から切断されました
blueprint %
blueprint % rm order-entry/skills-output/order-entry-blueprint.md
blueprint %
フォルダorder-entryに移動します。
name: order-entry
version: 1.0.0
description: order entry blueprint
author: Yuji
dependencies:
apm:
# Oracle Database Skills
- git: https://github.com/oracle/skills
path: db
ref: main
# Oracle APEXlang Skills
- git: https://github.com/oracle/skills
path: apex
ref: mainorder-entry % apm install --target codex
[>] Installing dependencies from apm.yml...
[>] Resolving skills-db...
[>] Resolving skills-apex...
[i] Targets: codex (source: --target flag)
[+] github.com/oracle/skills/apex#main #main @55679630
|-- Skill integrated -> .agents/skills/
[+] github.com/oracle/skills/db#main #main @55679630
|-- Skill integrated -> .agents/skills/
[i] Added apm_modules/ to .gitignore
[*] Installed 2 APM dependencies in 1.2s.
ynakakoshi@Ns-Macbook order-entry %
必ずしも必要ではないと思いますが、MCPサーバーなどの設定を.codex/config.tomlに記述します。
[mcp_servers.oracle-apexdev]
command = "/opt/homebrew/Caskroom/sqlcl/26.1.2.132.1334/sqlcl/bin/sql"
args = [ "-R", "4", "-mcp" ]
[sandbox_workspace_write]
network_access = true
Using the prompt and icon allowlist files:
- prompt/blueprint-prompt.md
- prompt/apex-fa-icons-allowlist.txt
Generate and overwrite:
- <full-path-to-output-blueprint.md>
Using:
- examples/order-entry/skills-input/order-entry-functional-requirements.md
- examples/order-entry/skills-input/order-entry-schema-metadata.md
Don't read any other files unless directed by the prompt.プロンプトとなるblueprint-prompt.mdとapex-fa-icons-allowlist.txtは、添付ファイルとして与えることにします。
添付したファイルblueprint-prompt.mdおよびapex-fa-icons-allowlist.txtより、Oracle APEXのblueprintをskills-output/order-entry-blueprint.mdとして生成してください。
以下のファイルの内容だけが、生成するAPEX blueprintの要求仕様になります。
skills-input/order-entry-functional-requirements.md
skills-input/order-entry-schema-metadata.md
生成しました: skills-output/order-entry-blueprint.md
確認した点:
- 17ページ、39リージョンを出力
- 指定のトップメニュー順を反映
- Order Line ID は OREN_ORDER_ITEMS.ORDER_ITEM_ID 由来で、LINE_ITEM_ID や行番号由来の識別子は未使用
- 使用アイコンは apex-fa-icons-allowlist.txt 内に存在することを確認済み
添付の検証エラー内容に沿って、skills-output/order-entry-blueprint.md を修正しました。
主な修正:
- List of Values / Lists / Breadcrumb の構造を blueprint 文法どおりに修正
- Calendar の Render As を startDateCol / supplementalInfo に修正
- Map の Render As を latitudeCol / longitudeCol / tooltip / hidden に修正
- hidden列に残っていた不正な Format Mask を削除
- Modal Forms ページグループを Forms に変更して参照も統一
- Calendar SQL内の禁止されやすい order by を除去
確認済み:
- 17ページ、39リージョンのまま維持
- 使用アイコンは allowlist 内
- LINE_ITEM_ID / ROWNUM / ROW_NUMBER は未使用です。
原因はHome Dashboardの「Top 5 Revenue Products Last 12 Months」カードSQLでした。PRODUCT_IMAGE がBLOBなのに GROUP BY に含まれていて、Oracleが ORA-22848 を出していました。
skills-output/order-entry-blueprint.md (line 523) を修正済みです。売上集計を内側のサブクエリで PRODUCT_ID 単位に行い、外側で OREN_PRODUCTS をJOINして画像BLOBを取得する形にしました。
確認済み:
- PRODUCT_IMAGE は GROUP BY / ORDER BY / WHERE / JOIN条件 に使われていません。
- 画像表示用のSELECT列としては維持しています。
