intra-mart Accel Platform 移行ガイド 第17版 2018-12-01

intra-mart Accel Platform対応

intra-mart WebPlatform 7.2で動作していたプログラムをintra-mart Accel Platformの開発規約に準拠させる場合の概要を説明します。

  • intra-mart Accel Platform対応概要

    1. 画面 … UIデザインガイドライン準拠
    2. ロジック … 非推奨/削除APIへの対応
    3. 初期化処理 … 初期化処理の移行
    4. ルーティング … ルーティング設定ファイルの用意
    5. 認可 … 認可リソースの用意

コラム

移行の場合、ルーティングと認可リソースは移行ツールで生成されるため、ここでは画面とロジックと初期化処理を中心に説明します。

画面(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を定義します。