intra-mart Accel Platform対応¶
intra-mart WebPlatform 7.2で動作していたプログラムをintra-mart Accel Platformの開発規約に準拠させる場合の概要を説明します。
intra-mart Accel Platform対応概要
- 画面 … UIデザインガイドライン準拠
- ロジック … 非推奨/削除APIへの対応
- 初期化処理 … 初期化処理の移行
- ルーティング … ルーティング設定ファイルの用意
- 認可 … 認可リソースの用意
コラム
移行の場合、ルーティングと認可リソースは移行ツールで生成されるため、ここでは画面とロジックと初期化処理を中心に説明します。
画面(HTML/JSP)¶
intra-mart Accel PlatformのUIデザインガイドラインに従い、1枚のHTMLとして表示するための対応を行ってください。詳細は、各プログラミングガイドを参照してください。
frameset, frameタグを削除
frame間でデータのやりとりを行っている場合、Ajaxを使った実装に置き換えることをお勧めしますhtml, bodyタグを削除
bodyタグのonload属性にJavaScriptを記述していた場合、jQueryの機能を利用して実行するようにしてください。jQuery(document).ready(function() { doSomething(); });<imart type=”imDesignCss”/>を削除
headタグを置き換える
- Jsp Tag → <imui:head> に置き換える
- Script Tag → <imart type=”head”> に置き換える
タイトルバータグを置き換える
- Jsp Tag → imartTitleBarをheaderタグに置き換える
- Script Tag → imTitleBarをheaderタグに置き換える
ツールバータグを置き換える
- Jsp Tag → imartToolbarXxxを<div class=”imui-toolbar-xxx”>に置き換える
- Script Tag → imToolbarXxxを<div class=”imui-toolbar-xxx”>に置き換える
コラム
ツールバーの構成に従って、複数のタグを適切に設定してください。詳細は、各プログラミングガイドを参照してください。form の target を変更
- target=”IM_MAIN” → target=”_top”
注意
より厳密に対応する場合は、上記のほかに、互換対応表を参照し、非推奨になったタグ、および削除されたタグへの対応を行ってください。
ロジック(Java/JavaScript)¶
互換対応表を参照し、非推奨になったAPI、および削除されたAPIへの対応を行ってください。
初期化処理¶
intra-mart WebPlatform 7.2 で独自に設定した初期化処理を intra-mart Accel Platform 上で動作させるためには、ユーザモジュールを作成する必要があります。 intra-mart WebPlatform 7.2 の初期化処理ファイルごとにユーザモジュールで作成する必要のあるファイルを以下で説明します。
コラム
ユーザモジュールの作成については「intra-mart e Builder for Accel Platform アプリケーション開発ガイド - モジュール開発の基本機能 」を参照してください。
注意
ユーザモジュールには、初期化処理で利用しているAPIを確認して依存関係を正しく設定してください。 初期化処理でデータベースを参照する処理を実行することはできません。
conf/system_install.xml の移行¶
intra-mart WebPlatform 7.2 のconf/system_install.xml で設定した初期化処理を intra-mart Accel Platform 上で動作させるためには、以下のファイルを含むユーザモジュールを作成してください。
- conf/system_install.xml に設定した初期化処理のJavaクラス、js ファイル
- conf/system_install.xml の設定を移行したinitializer-XXX.xml
conf/system_install.xml の設定の移行先 移行元(conf/system_install.xml)のタグ 移行先(initializer-XXX.xml)のタグ 拡張API:Javaクラス <system-install>/<java-script-api>/<api-class> <initializer-config>/<java-script-api>/<api-class> 拡張API:JavaScript関数 <system-install>/<java-script-api>/<api-script> <initializer-config>/<java-script-api>/<api-script> サーバサイドJavaScript グローバル関数:Javaクラス <system-install>/<java-script-api>/<global-function-class> <initializer-config>/<java-script-api>/<global-function-class> サーバサイドJavaScript グローバル関数:JavaScript関数 <system-install>/<java-script-api>/<global-function-script> <initializer-config>/<java-script-api>/<global-function-script> 拡張IMARTタグ:Javaクラス <system-install>/<jssp-tag>/<tag-class> <initializer-config>/<jssp-tag>/<tag-class> 拡張IMARTタグ:JavaScript関数 <system-install>/<jssp-tag>/<tag-script> <initializer-config>/<jssp-tag>/<tag-script> 起動時初期化Javaクラス <system-install>/<initializer>/<application>/<class-name> <initializer-config>/<initializer>/<class-name> 起動時初期化js ファイルのパス <system-install>/<initializer>/<application>/<script-name> <initializer-config>/<initializer>/<script-name>コラム
initializer-XXX.xml の設定については「intra-mart Accel Platform 設定ファイルリファレンス - initializer 設定 」を参照してください。
注意
ファイル名の initializer-XXX.xml のXXXはショートモジュールIDを指します。ショートモジュールIDとはモジュールIDを”.”で分割した末尾のことです。例として、モジュールIDが「org.example.foo」場合は「initializer-foo.xml」をという名前で initializerを定義します。
pages/src/init.js の移行¶
intra-mart WebPlatform 7.2 のpages/src/init.js(初期化ファイル)で設定した初期化処理を intra-mart Accel Platform 上で動作させるためには、以下のファイルを含むユーザモジュールを作成してください。
- intra-mart WebPlatform 7.2 のpages/src/init.js の処理を記述したjs ファイル
- 作成したjs ファイルを起動時初期化js ファイルのパス( <initializer-config>/<initializer>/<script-name> )に設定したinitializer-XXX.xml
コラム
intra-mart Accel Platform 2016 Summer(Nirvana) 以降の場合上記手順以外の方法として、 intra-mart WebPlatform 7.2 のpages/src/init.js の処理をsrc/init.js へそのまま記述することで移行可能です。注意
ファイル名の initializer-XXX.xml のXXXはショートモジュールIDを指します。ショートモジュールIDとはモジュールIDを”.”で分割した末尾のことです。例として、モジュールIDが「org.example.foo」場合は「initializer-foo.xml」をという名前で initializerを定義します。