アップデート時に IM-Juggling で必要なメンテナンス作業¶

【IM-Workflowを利用している場合】¶

【暗号化設定 (cryption-config.xml) を出力している場合】¶

【IMBoxを利用している場合】¶

• IMBox設定 (imbox-config.xml) を出力している場合
  IM-Juggling 内の「ProjectNavigator」-対象プロジェクトより、下記の設定ファイルを削除してください。

  「conf/imbox-config.xml」内の設定値を変更されていた場合は、変更内容のバックアップを行ってください。

  • conf/imbox-config.xml
  • schema/imbox-config.xsd

  最新の設定ファイルを出力するため、 IM-Juggling 内の「設定ファイル」タブを選択してください。

  さらに一覧より「IMBox」-「IMBox設定」を選択した状態で右側の「出力」ボタンを押下すると、新たに上記の２ファイルが出力されます。

  
  

  変更内容がある場合には、バックアップから変更された項目ごとに修正を行ってください。

【IMBoxを利用している場合】¶

• IMBox設定 (imbox-config.xml) を出力している場合
  IM-Juggling 内の「ProjectNavigator」-対象プロジェクトより、下記の設定ファイルを削除してください。

  「conf/imbox-config.xml」内の設定値を変更されていた場合は、変更内容のバックアップを行ってください。

  • conf/imbox-config.xml
  • schema/imbox-config.xsd

  最新の設定ファイルを出力するため、 IM-Juggling 内の「設定ファイル」タブを選択してください。

  さらに一覧より「IMBox」-「IMBox設定」を選択した状態で右側の「出力」ボタンを押下すると、新たに上記の２ファイルが出力されます。

  
  

  変更内容がある場合には、バックアップから変更された項目ごとに修正を行ってください。

【IMBoxを利用している場合】¶

• IMBox設定 (imbox-config.xml) を出力している場合
  IM-Juggling 内の「ProjectNavigator」-対象プロジェクトより、下記の設定ファイルを削除してください。

  「conf/imbox-config.xml」内の設定値を変更されていた場合は、変更内容のバックアップを行ってください。

  • conf/imbox-config.xml
  • schema/imbox-config.xsd

  最新の設定ファイルを出力するため、 IM-Juggling 内の「設定ファイル」タブを選択してください。

  さらに一覧より「IMBox」-「IMBox設定」を選択した状態で右側の「出力」ボタンを押下すると、新たに上記の２ファイルが出力されます。

  
  

  変更内容がある場合には、バックアップから変更された項目ごとに修正を行ってください。
• Cassandraサーバ接続設定（cassandra-config.xml）の使用用途が変更されました。

  cassandra-config.xmlの変更点に関する詳細は、「intra-mart Accel Platform 2014 Spring(Granada)からの変更点」を参照してください。

  使用用途変更に伴い、テナント環境セットアップ時にCassandra接続情報の登録が必要です。

  Cassandra接続情報の登録に関する詳細は、「Apache Cassandra接続情報」を参照してください。

【 TERASOLUNA Global Framework を利用している場合】¶

【 TERASOLUNA Global Framework を利用している場合】¶

2015 Spring(Juno) では、TERASOLUNA Global Framework から TERASOLUNA Server Framework for Java (5.x) へ変わります。それにあわせてモジュールと設定ファイルを入れ替えます。

• IM-Juggling でのモジュール、設定修正

  IM-Juggling 内の「ProjectNavigator」-対象プロジェクトより、下記の操作を行ってください。

  applicationContext-im_tgfw_common.xml、applicationContext-im_tgfw_web.xmlを変更している場合は、変更内容のバックアップを行ってください。

  

  1. モジュールの削除

     アップデートの適用の実行前に以下のモジュールのチェックを外してください
     • TERASOLUNA Global Framework JPA module

       「ライブラリ - サードパーティ製ライブラリ」内にあります。
     • TERASOLUNA Global Framework MyBatis module

       「ライブラリ - サードパーティ製ライブラリ」内にあります。
     • TERASOLUNA Global Framework JPA module for AccelPlatform

       「開発フレームワーク - TERASOLUNA Global Framework on AccelPlatform」内にあります。
     • TERASOLUNA Global Framework MyBatis module for AccellPlatform

       「開発フレームワーク - TERASOLUNA Global Framework on AccelPlatform」内にあります。
     
     
  2. アップデートの適用

     「現行の環境にアップデートを適用します」を押下します。
     
     上記のモジュールのチェックを外していない状態でアップデートを行いますと、以下の様なエラーメッセージが表示されます。

     チェックを外してからアップデートを行ってください。
     
  3. モジュール、設定ファイルの更新
     • 設定ファイルの削除

       IM-Juggling 内の「ProjectNavigator」-対象プロジェクトから以下のファイルを削除します。

       • classes/META-INF/spring/applicationContext-im_tgfw_common.xml

         内容を変更している場合はバックアップを取ってください。
       • classes/META-INF/spring/applicationContext-im_tgfw_web.xml

         内容を変更している場合はバックアップを取ってください。
       • classes/META-INF/spring/applicationContext-jpa.xml
       • classes/META-INF/spring/applicationContext-mybatis.xml
       • classes/META-INF/mybatis/config/sqlMapConfig.xml

       

     • リソースの追加

       「追加リソースの選択」を押下します。

       

       「TERASOLUNA Server Framework for Java (5.x) 設定ファイル」と「TERASOLUNA Server Framework for Java (5.x) for MyBatis3設定ファイル」にチェックを入れます。

       

       以下の4ファイルが追加されます。

       • classes/META-INF/spring/applicationContext-im_tgfw_common.xml

         設定を変更していた場合には、変更内容にあわせて修正してください。
       • classes/META-INF/spring/applicationContext-im_tgfw_web.xml

         設定を変更していた場合には、変更内容にあわせて修正してください。
       • classes/META-INF/spring/applicationContext-im_tgfw_mybatis3.xml
       • classes/META-INF/mybatis/mybatis-config.xml

       

       MyBatis3の設定については、「TERASOLUNA Server Framework for Java (5.x) 用設定ファイル（リポジトリ層にMyBatis3を利用する場合）」を参照してください。
     • モジュールの追加

       以下のモジュールにチェックを入れてください。

       • TERASOLUNA Server Framework for Java (5.x) for MyBatis module for Accel Platform

         「開発フレームワーク - TERASOLUNA Server Framework for Java (5.x) for Accel Platform」内にあります。

       

       「モジュールが不足しています。」のメッセージをクリックし、依存関係を解決します。

       

       warを作成する準備ができました。

       

【IM共通マスタ-設定ファイル (im-master-config.xml) を出力している場合】¶

IM-Juggling 内の「ProjectNavigator」-対象プロジェクトより、下記の設定ファイルを削除してください。

「conf/im-master-config.xml」内の設定値を変更されていた場合は、変更内容のバックアップを行ってください。

• conf/im-master-config.xml
• schema/im-master-config.xml.xsd

最新の設定ファイルを出力するため、 IM-Juggling 内の「設定ファイル」タブを選択してください。

さらに一覧より「IM-共通マスタ」-「IM-共通マスタ設定」を選択した状態で右側の「出力」ボタンを押下すると、新たに上記の２ファイルが出力されます。

変更内容がある場合には、バックアップから変更された項目ごとに修正を行ってください。

【国際化機能-数値フォーマットマスタ (im-decimal-format-config.xml) を出力している場合】¶

2018 Spring(Skylark) より、 国際化機能-数値フォーマットマスタに csjs-path 属性が追加されました。

この属性はクライアントサイドJavaScriptのパスを指定します。指定されたパスは ImDecimalFormatter で変換する処理に利用されます。

詳細は 数値形式マスタ を参照してください。

以下の手順に従い、この属性を設定ファイルに追加してください。

IM-Juggling 内の「ProjectNavigator」-対象プロジェクトより、下記の設定ファイルを削除してください。

「conf/decimal-format-config/im-decimal-format-config.xml」内の設定値を変更されていた場合は、変更内容のバックアップを行ってください。

• conf/decimal-format-config/im-decimal-format-config.xml
• schema/decimal-format-config.xsd

最新の設定ファイルを出力するため、 IM-Juggling 内の「設定ファイル」タブを選択してください。

さらに一覧より「国際化機能」-「数値フォーマットマスタ」を選択した状態で右側の「出力」ボタンを押下すると、新たに上記の２ファイルが出力されます。

変更内容がある場合には、バックアップから変更された項目ごとに修正を行ってください。

コラム

csjs-path 属性は、 2018 Spring(Skylark) より追加された clientDecimalFormatScript タグを利用した場合にのみ、変換処理に利用されます。

そのため、この属性を指定しても指定していなくても、既存の機能に影響はありません。

開発者がクライアントサイドで変換処理が行いたいことを考慮し、製品の標準のパスを設定しておくことを推奨します。

スマートフォンテーマモジュールの選択¶

2018 Summer(Tiffany) より、スマートフォンテーマに「スマートフォン標準テーマ (白)」が追加されました。

2018 Summer(Tiffany) 時点でのスマートフォンテーマモジュールは以下の通りです。

• 「intra-mart Accel Platform」-「画面テーマ」-「intra-mart Accel Platform スマートフォン標準テーマ」-「intra-mart Accel Platform スマートフォン標準テーマ (黒)」
• 「intra-mart Accel Platform」-「画面テーマ」-「intra-mart Accel Platform スマートフォン標準テーマ」-「intra-mart Accel Platform スマートフォン標準テーマ (白)」

「intra-mart Accel Platform スマートフォン標準テーマ (黒)」は、intra-mart Accel Platform リリース時から存在するスマートフォンテーマです。

「intra-mart Accel Platform スマートフォン標準テーマ (白)」は、2018 Summer(Tiffany) より追加されたスマートフォンテーマです。

アップデートを行ったプロジェクトの juggling.im の上部にスマートフォンテーマが選択されていない旨のエラーメッセージが表示されている場合、スマートフォンテーマモジュールを１つ以上選択してください。

メールモジュールでメール送信の日本語で使用するキャラクタセットのデフォルト値設定¶

2019 Spring(Violette) より メールモジュールのメール送信の日本語で使用するキャラクタセットのデフォルト値が “iso-2022-jp” から “UTF-8” に、ボディエンコード設定のデフォルト値が “7bit” から “base64” に変更されました。

「conf/javamail-config/javamail-config_ja.xml」 を出力していない場合は、デフォルトで “UTF-8” が利用されます。

“iso-2022-jp” を利用したい場合は、以下の手順に従い、設定ファイルを編集してください。

なお「conf/javamail-config/javamail-config_ja.xml」 が既に出力されている場合には、その設定が利用されます。

• IM-Juggling 内の「設定ファイル」タブを選択してください。
• さらに一覧より「メールモジュール」-「メール送信：多言語設定(ja)(/javamail-config/javamail-config_ja.xml)」を選択した状態で右側の「出力」ボタンをクリックしてください。
• 出力されたファイル「javamail-config_ja.xml」のキャラクタセットの値を編集してください。

【IM-Spreadsheetを利用している場合】¶

2019 Spring(Violette)よりIM-Spreadsheetで利用しているSpreadJSのバージョンがV12Jに変更されました。

IM-Spreadsheet 8.0.2以前のバージョンのユーザモジュールを追加している場合はSpreadJSライセンスの新しいライセンスキーを設定ファイル（spreadsheet-config.xml）に設定する必要があります。

詳細は「IM-Spreadsheet 利用ガイド」 - 「アップデート・パッチの適用」を参照してください。

【 TERASOLUNA Server Framework for Java (5.x) を利用している場合】¶

2019 Summer(Waltz) では、Dozerのバージョンアップによりパッケージ名が変わりました。

それに伴い、以下の修正が必要です。

1. Bean定義ファイル

   IM-Juggling 内の「ProjectNavigator」-対象プロジェクトより、 < classes/META-INF/spring/applicationContext-im_tgfw_common.xml > の設定のうちDozerBeanMapperFactoryBeanのパッケージを修正します。

   <!-- dozer setting -->
   <bean class="com.github.dozermapper.spring.DozerBeanMapperFactoryBean">
       <property name="mappingFiles" value="classpath*:/META-INF/dozer/**/*-mapping.xml" />
   </bean>
   

2. Javaファイル

   import宣言を修正します。以下はMapperクラスの例です。

   • 修正前

     import org.dozer.Mapper;
     

   • 修正後

   import com.github.dozermapper.core.Mapper;
   

2019 Summer(Waltz) では、Dozerのバージョンアップによりマッピング定義XMLファイルのXMLスキーマURLが変更されました。

それに伴い、以下の通りマッピング定義XMLファイルを修正します。

注意

intra-mart Accel Platform では配置していません。マッピング定義XMLファイルを作成した場合のみ修正が必要です。

• 修正前

<?xml version="1.0" encoding="UTF-8"?>
<mappings xmlns="http://dozer.sourceforge.net"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://dozer.sourceforge.net http://dozer.sourceforge.net/schema/beanmapping.xsd">

• 修正後

<?xml version="1.0" encoding="UTF-8"?>
<mappings xmlns="http://dozermapper.github.io/schema/bean-mapping"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://dozermapper.github.io/schema/bean-mapping https://dozermapper.github.io/schema/bean-mapping.xsd">

コラム

TERASOLUNAの機能を利用している環境のアップデートについては、 TERASOLUNA移行ガイド を参考に修正してください。

コラム

TERASOLUNA 5.5.1 では Hibernate Validator 6.0.14 を使用していますが、 intra-mart Accel Platform では Hibernate Validator 5.2.4を使用しています。

また、TERASOLUNA 5.5.1 では Bean Validation 2.0 を使用していますが、 intra-mart Accel Platform ではBean Validation 1.1 を使用しています。

【 IM-BloomMaker を利用している場合】¶

2019 Winter(Xanadu) から IM-BloomMaker の IM-Juggling で扱っているモジュールの ID が変更になりました。モジュールをアップデートするには以下の手順を踏む必要があります。

1. IM-BloomMaker モジュールの削除
2. モジュールのアップデート
3. IM-BloomMaker モジュールの追加

IM-Juggling 内の「ProjectNavigator」- 対象プロジェクトより、下記の操作を行ってください。

1. IM-BloomMaker モジュールの削除

   1. アプリケーションタブで「IM-BloomMaker for Accel Platform - 8.0.0」を選択し、削除アイコンをクリックしてください。

      

   2. 確認ダイアログが表示されるので、「OK」ボタンをクリックしてください。

      

   3. アプリケーションタブから「IM-BloomMaker for Accel Platform - 8.0.0」が削除されたら保存アイコンをクリックし、修正を確定してください。

      

2. モジュールのアップデート

   1. アップデートの適用アイコンをクリックし、アップデートの適用を行います。

      

   2. 「次へ」ボタンをクリックします。

      

   3. アップデート方法を選択します。今回は「全てのモジュールをアップデートする」を選択します。選択したら「次へ」ボタンをクリックします。

      

   4. アップデート対象を選択します。「次へ」ボタンをクリックします。

      

   5. 適用されるアップデートを確認し、「終了」ボタンをクリックします。

      

3. IM-BloomMaker モジュールの追加

   1. アプリケーションの追加アイコンをクリックします。

      

   2. IM-BloomMaker for Accel Platform を選択し、「OK」ボタンをクリックします。

      

   3. アプリケーションタブに表示されている IM-BloomMaker が 8.0.0 からアップデートされていることを確認します。これで IM-BloomMaker のアップデートは完了です。このあとは通常の手順で war ファイルの作成とアプリケーションサーバへのデプロイを行ってください。

      

PC 版テーマモジュールの選択¶

• 2020 Spring(Yorkshire) より「intra-mart Accel Platform Slim Side Menu テーマ」が追加されました。

  プロジェクトのアップデートを行った場合、上記のテーマモジュールはインストールされないためインストールを行う場合はモジュールを選択してください。モジュール構成の以下から選択可能です。

  • 「intra-mart Accel Platform」 > 「画面テーマ」 > 「intra-mart Accel Platform Slim Side Menu テーマ」

注意

利用機能により、各テーマを利用した場合の制限事項が存在する場合があります。詳細は、「リリースノート」 - 「制限事項」、および、インストールしている各アプリケーションの制限事項を確認してください。

【 IM-Notice を利用している場合】¶

• 2020 Summer(Zephirine) より Android通知に Firebase Cloud Messaging が利用されます。

  Firebaseプロジェクトを作成し、 im-notice-mobile-config.xml の設定を変更してください。

  設定方法については「FCMを使用する場合」を参照してください。

注意

im_notice_module.xml の設定が更新されていない場合、 intra-mart Accel Platform 起動時にエラーが発生します。

【 IM-FileExchange を利用している場合】¶

2022 Spring(Eustoma) より 複数ファイルのアップロードが可能になるため、IM-FileExchange のメッセージ配信のテンプレートを更新します。

PublicStorage のテンプレート および IM-Juggling 内の「設定ファイル」タブで出力したテンプレートの修正を行ってください。

コラム

テンプレートの修正は必須ではありません。

修正内容を確認の上、修正を行うか検討してください。

必要に応じて、一部のみの修正を行うことも可能です。

【 ViewCreator（クロス集計）を利用している場合】¶

2022 Spring(Eustoma) において 「ViewCreatorの設定」 に、ViewCreator のクロス集計に関する新しい設定項目が追加されました。

デフォルト設定では、2021 Winter(Dandelion) 以前とは動作が異なる場合があるため、アップデート時に設定値の検討を行ってください。

クロス集計を利用していない場合は影響がないため検討の必要はありません。

図：クロス集計の例