APEX 24.2より標準テンプレートはアプリケーションのエクスポートから除外されます

Oracle APEX 24.2より、Oracle APEX標準のユニバーサル・テーマに含まれるテンプレートは、アプリケーションのエクスポートから除外されます。

Oracle APEX 24.2のRelease Notesの以下に記載されています。ただ、実際に何が起こるのか分かりにくいように感じます。

2.26 Theme Metadata Decoupled from Application Metadata

Starting with Universal Theme 24.2, theme metadata (templates, theme styles, template components, etc.) is now stored in a central workspace, decoupled from applications. This improves performance with faster application export/import, smaller file sizes, and optimized storage in version control systems.

Related updates include:

• The Refresh Theme button is now on the Application Home Page for better visibility.
• Outdated APEX Builder pages related to theme management have been updated or removed, simplifying the interface.
• Active theme style selection has moved from the theme style level to the theme level.

この変更による効果で一番分かりやすいのは、APEXアプリケーションのエクスポート・ファイルのサイズが小さくなることです。

ひとつ前の記事「APEX 24.2のモーダル・ダイアログのサイズ変更を可能にする設定について」で作成したアプリケーションを使って確認してみます。アプリケーションのエクスポートは、以下のリンクに置いてあります。これはAPEX 24.1よりエクスポートしています。

https://github.com/ujnak/apexapps/blob/master/exports/resizable-modal-dialog.zip

サイズを確認すると、207020バイトあります。

% ls -l resizable-modal-dialog.zip 

-rw-r--r--@ 1 ******  *******  207020  1 24 15:13 resizable-modal-dialog.zip

% 

このアプリケーションをAPEX 24.2にインポートします。

アプリケーションの編集画面に、テーマのリフレッシュを推奨するメッセージとボタンテーマのリフレッシュが表示されます。APEX 24.2以前では、共有コンポーネントを開くと表示されていたメッセージとボタンです。APEX 24.2では、アプリケーションの編集画面に表示されます。

テーマをリフレッシュしてから、アプリケーションをエクスポートします。

ZIP形式でエクスポートされるよう、複数のファイルに分割をオンにして、エクスポートします。

ダウンロードされたファイルのサイズを確認します。57618バイトになっています。

% ls -l f253.zip 

-rw-r--r--@ 1 *********  ********  57618  1 24 17:04 f253.zip

%

APEX 24.2では標準で提供されているユニバーサル・テーマに含まれているテンプレートについては、APEXのインスタンスやワークスペースが異なっていても必ず同じテンプレートが含まれていることから、エクスポートの対象から除外しています。

APEX 24.1のエクスポートに含まれているテンプレートです。

% ls -lR f253_241/application/shared_components/user_interface/templates

total 8

drwxr-xr-x@  3 ynakakoshi  staff    96  1 24 17:06 breadcrumb

drwxr-xr-x@  5 ynakakoshi  staff   160  1 24 17:06 button

drwxr-xr-x@  3 ynakakoshi  staff    96  1 24 17:06 calendar

drwxr-xr-x@  9 ynakakoshi  staff   288  1 24 17:06 label

drwxr-xr-x@ 15 ynakakoshi  staff   480  1 24 17:06 list

drwxr-xr-x@ 12 ynakakoshi  staff   384  1 24 17:06 page

-rw-rw-rw-@  1 ynakakoshi  staff  1884  1 24 04:44 popuplov.sql

drwxr-xr-x@ 23 ynakakoshi  staff   736  1 24 17:06 region

drwxr-xr-x@ 14 ynakakoshi  staff   448  1 24 17:06 report

f253_241/application/shared_components/user_interface/templates/breadcrumb:

total 8

-rw-rw-rw-@ 1 ynakakoshi  staff  1060  1 24 04:44 breadcrumb.sql

f253_241/application/shared_components/user_interface/templates/button:

total 24

-rw-rw-rw-@ 1 ynakakoshi  staff  1231  1 24 04:44 icon.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  1014  1 24 04:44 text.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  1461  1 24 04:44 text_with_icon.sql

f253_241/application/shared_components/user_interface/templates/calendar:

total 24

-rw-rw-rw-@ 1 ynakakoshi  staff  9276  1 24 04:44 calendar.sql

f253_241/application/shared_components/user_interface/templates/label:

total 56

-rw-rw-rw-@ 1 ynakakoshi  staff  2046  1 24 04:44 hidden.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  1970  1 24 04:44 optional.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  1947  1 24 04:44 optional_above.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  1964  1 24 04:44 optional_floating.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  2225  1 24 04:44 required.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  2204  1 24 04:44 required_above.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  2294  1 24 04:44 required_floating.sql

f253_241/application/shared_components/user_interface/templates/list:

total 120

-rw-rw-rw-@ 1 ynakakoshi  staff  1767  1 24 04:44 badge_list.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  2587  1 24 04:44 cards.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  3472  1 24 04:44 links_list.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  2350  1 24 04:44 media_list.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  3362  1 24 04:44 menu_bar.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  3162  1 24 04:44 menu_popup.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  3744  1 24 04:44 navigation_bar.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  6080  1 24 04:44 side_navigation_menu.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  1611  1 24 04:44 tabs.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  6127  1 24 04:44 top_navigation_mega_menu.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  3610  1 24 04:44 top_navigation_menu.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  1882  1 24 04:44 top_navigation_tabs.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  1767  1 24 04:44 wizard_progress.sql

f253_241/application/shared_components/user_interface/templates/page:

total 248

-rw-rw-rw-@ 1 ynakakoshi  staff   7428  1 24 04:44 drawer.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  13917  1 24 04:44 left_and_right_side_columns.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  12779  1 24 04:44 left_side_column.sql

-rw-rw-rw-@ 1 ynakakoshi  staff   7237  1 24 04:44 login.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  14140  1 24 04:44 master_detail.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  12231  1 24 04:44 minimal_no_navigation.sql

-rw-rw-rw-@ 1 ynakakoshi  staff   7431  1 24 04:44 modal_dialog.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  13471  1 24 04:44 right_side_column.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  12307  1 24 04:44 standard.sql

-rw-rw-rw-@ 1 ynakakoshi  staff   7413  1 24 04:44 wizard_modal_dialog.sql

f253_241/application/shared_components/user_interface/templates/region:

total 232

-rw-rw-rw-@ 1 ynakakoshi  staff  3673  1 24 04:44 alert.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  2304  1 24 04:44 blank_with_attributes.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  2340  1 24 04:44 blank_with_attributes_no_grid.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  4667  1 24 04:44 buttons_container.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  2151  1 24 04:44 cards_container.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  6453  1 24 04:44 carousel_container.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  6248  1 24 04:44 collapsible.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  3714  1 24 04:44 content_block.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  3546  1 24 04:44 hero.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  1770  1 24 04:44 image.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  4550  1 24 04:44 inline_dialog.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  4709  1 24 04:44 inline_drawer.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  4479  1 24 04:44 inline_popup.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  2823  1 24 04:44 interactive_report.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  2153  1 24 04:44 item_container.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  3256  1 24 04:44 login.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  2203  1 24 04:44 search_results_container.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  6210  1 24 04:44 standard.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  1996  1 24 04:44 tabs_container.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  6109  1 24 04:44 title_bar.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  3244  1 24 04:44 wizard_container.sql

f253_241/application/shared_components/user_interface/templates/report:

total 112

-rw-rw-rw-@ 1 ynakakoshi  staff  3040  1 24 04:44 alerts.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  2730  1 24 04:44 badge_list.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  4049  1 24 04:44 cards.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  3074  1 24 04:44 comments.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  3118  1 24 04:44 content_row.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  2674  1 24 04:44 contextual_info.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  3969  1 24 04:44 media_list.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  4810  1 24 04:44 search_results.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  3387  1 24 04:44 standard.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  4568  1 24 04:44 timeline.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  2646  1 24 04:44 value_attribute_pairs_column.sql

-rw-rw-rw-@ 1 ynakakoshi  staff  2679  1 24 04:44 value_attribute_pairs_row.sql

% 

APEX 24.2に含まれているテンプレートです。ほぼ全てのテンプレートがエクスポートから除外されています。

% ls -lR f253_242/application/shared_components/user_interface/templates 

total 8

-rw-rw-rw-@ 1 ynakakoshi  staff  415  1 24 08:04 popuplov.sql

% 

結果として、エクスポート/インポート処理の高速化、小さいファイル・サイズ、バージョン管理の効率化につながります。

ユニバーサル・テーマが導入される以前のOracle APEXは、テンプレートを変更してアプリケーションの見た目や操作感を作り込むツールでした。そのため、アプリケーションの新規作成の際に、テンプレートの変更が他のアプリケーションに影響を与えないように、アプリケーションに適用されるテーマに含まれるテンプレートをアプリケーションにコピーしていました。結果として、アプリケーションのエクスポートにすべてのテンプレートが含まれていました。

ユニバーサル・テーマが導入されてからは、アプリケーションの見た目や操作感の作り込みには、1. テーマ・ローラを使う、2. CSS変数を使う、3. CSSクラスを使う、といった方法が推奨され、テンプレートの変更は推奨されていません。

エクスポートから除外されるのはAPEX 24.2以降のテンプレートが対象なので、APEX 24.2以前のアプリケーションはテーマのリフレッシュを実施する必要があります。

上級者向けに、リポジトリを参照して説明をしてみます。

ページ・テンプレートはAPEX_240200スキーマの表WWV_FLOW_TEMPLATESに保存されます。APEX 24.2ではカスタム・テンプレートを作成しない限り、以下のような検索結果になります。列IDはテンプレートのID、列FLOW_IDはアプリケーションIDのことです。

SQL> select id, flow_id, name from wwv_flow_templates where flow_id not between 4000 and 5000 order by flow_id, name;

                    ID     FLOW_ID NAME                           

______________________ ___________ ______________________________ 

   1661186590416509825    8842.242 Drawer                         

   2526643373347724467    8842.242 Left Side Column               

   2526650495349772824    8842.242 Left and Right Side Columns    

   2101157952850466385    8842.242 Login                          

   1998361449248688088    8842.242 Marquee                        

   2979075366320325194    8842.242 Minimal (No Navigation)        

   2100407606326202693    8842.242 Modal Dialog                   

   2526646919027767344    8842.242 Right Side Column              

   4072355960268175073    8842.242 Standard                       

   2121795032473542284    8842.242 Wizard Modal Dialog            

10行が選択されました。 

SQL> 

APEX 24.1でエクスポートしたファイルをインポートします。インポートしたアプリケーションに含まれていたテンプレートが追加されます。

SQL> select id, flow_id, name from wwv_flow_templates where flow_id not between 4000 and 5000 order by flow_id, name;

                    ID     FLOW_ID NAME                           

______________________ ___________ ______________________________ 

    162033734836525999         253 Drawer                         

    162036622290526006         253 Left Side Column               

    162040374175526013         253 Left and Right Side Columns    

    162044346295526021         253 Login                          

    162046924498526027         253 Marquee                        

    162050940609526034         253 Minimal (No Navigation)        

    162054297725526041         253 Modal Dialog                   

    162055879761526044         253 Right Side Column              

    162059507126526052         253 Standard                       

    162062968101526058         253 Wizard Modal Dialog            

   1661186590416509825    8842.242 Drawer                         

   2526643373347724467    8842.242 Left Side Column               

   2526650495349772824    8842.242 Left and Right Side Columns    

   2101157952850466385    8842.242 Login                          

   1998361449248688088    8842.242 Marquee                        

   2979075366320325194    8842.242 Minimal (No Navigation)        

   2100407606326202693    8842.242 Modal Dialog                   

   2526646919027767344    8842.242 Right Side Column              

   4072355960268175073    8842.242 Standard                       

   2121795032473542284    8842.242 Wizard Modal Dialog            

20行が選択されました。 

SQL> 

アプリケーションのテーマをリフレッシュします。

テーマのリフレッシュ後は、アプリケーションは標準テンプレートを参照するように変わるため、それまで参照していたテンプレートは削除されます。

FLOW_IDが8842.242のテンプレートはエクスポートされません。

SQL> select id, flow_id, name from wwv_flow_templates where flow_id not between 4000 and 5000 order by flow_id, name;

                    ID     FLOW_ID NAME                           

______________________ ___________ ______________________________ 

   1661186590416509825    8842.242 Drawer                         

   2526643373347724467    8842.242 Left Side Column               

   2526650495349772824    8842.242 Left and Right Side Columns    

   2101157952850466385    8842.242 Login                          

   1998361449248688088    8842.242 Marquee                        

   2979075366320325194    8842.242 Minimal (No Navigation)        

   2100407606326202693    8842.242 Modal Dialog                   

   2526646919027767344    8842.242 Right Side Column              

   4072355960268175073    8842.242 Standard                       

   2121795032473542284    8842.242 Wizard Modal Dialog            

10行が選択されました。 

SQL> 

今回の記事は以上です。

完