2014年1月18日土曜日

はじめにお読みください: README

なぜブログを開始したの?

2014年1月14日~15日に行われた Red Hat JBoss BPM Suite Workshop の講師として、エバンジェリストの Mr. Eric D. Schabell が来日しました。その際、「オレのブログを翻訳して日本の皆に公開してみないか?」と気さくに声をかけてもらいました。そう、すべてはここから始まります。

ブログの方向性は?

世界に向けて情報を発信しているクールな人達がいます。そんな人達のメッセージを、日本人が受信し易いように翻訳して日本語で紹介していきます。平行して、自分でも何か情報を提供できればとも思っています。もちろん、日本語で!

対象プロダクト/プロジェクトって、具体的に何?

以下のプロダクトが守備範囲です。このプロダクトに利用されているプロジェクトも守備範囲となります。
  • JBoss BPM Suite/BRMS
  • JBoss Fuse Service Works
  • JBoss Data Virtualization
  • JBoss Fuse


今後の更新内容について

まずは、Mr.Ericが公開しているブログ Thoughts on Middleware, Open Source software, cycling and other news... に投稿されている記事を最新の投稿から順に翻訳していきます。「どこどこでトレーニングやるぜ!」といった記事は翻訳対象から外すつもりでいます。
日本語で購読したいブログがあれば、教えてください。翻訳対象にできるか検討します。


翻訳について

英語が堪能ではないので、間違いがあるかもしれません。バグがあればご連絡ください。修正します。
和訳した記事をポストする際、原文の投稿日時に合わせます。(古い記事を訳した際、最新の記事と間違われないように)


最後に

鮮度の落ちた情報にお気をつけください!興味のある情報があった場合、なるべく最新の1次リソースをチェックしていただければ誤解が生じないかと思います。コメントをいただければ、できる範囲で確認も取ります。

このブログは個人で運営しています。Red Hat でテクニカルサポートエンジニアとして働いておりますが、会社の公式ブログでも何でもありません。あくまでも個人レベルでオープンソースプロジェクトに貢献しようとしている日本人と把握してください。

2014年1月10日金曜日

JBoss BPM Suite の Webinar があります!

原文: JBoss BPM Suite Webinar - Get a move on with JBoss BPM Suite 6 by Eric D. Schabell

現行バージョンである Red Hat JBoss BRMS 5 から、リリースを控えている Red Hat JBoss BPM Suite 6 へのマイグレーションについて webinar を行います。
日程は、日本時間の 2014年1月31日 1:00AM 開始です。(January 30th, 2014 at 16:00 UTC)
このトピックについてはすでにいくつか情報を公開しているので、webinar を視聴する前にご確認いただけます。(今後和訳する予定です)

概要

Red Hat が提供する ビジネスプロセス/ビジネスルールを管理する為のソリューションと、Red Hat JBoss BPM Suite 6 へのマイグレーションについて学びます。

現在、JBoss BPM Suite 6 はベータ版が Red Hatカスタマーポータル上で公開されており、近い将来にリリースを予定しています。あなたに大きな価値を提供できる新機能に触れ、Red Hat JBoss BRMS 5 から JBoss BPM Suite 6 へ移行する理由とその方法について考えてみてはいかがでしょうか。

JBoss BPM Suite 6 使用例

webinar では、Red Hat JBoss BPM Suite 6 の使用例を紹介する他、以下の内容を含むマイグレーション方法(ベストプラックティス)を紹介します。

  • マイグレーションのコンセプト
  • マイグレーションのキーとなる、注目すべき箇所
  • マイグレーションに必要とされる工数見積り
  • JBoss BRMS 5 から JBoss BPM Suite 6 へのマイグレーションをデモ
  • マイグレーション前と後、それぞれのソースコードへのリンク

2013年12月20日金曜日

JBoss Business Optimizer のデモ - テックプレビューを使って見よう

原文: JBoss Business Optimizer Demo - Get Started with Tech Preview by Eric D. Schabell

リリースが予定されている Red Hat JBoss BRMS/BPM Suite には、いくつかテックプレビューとして提供される機能があります。リソースの最適化に興味がないユーザーは、このテックプレビューに含まれる JBoss Business Optimizer に対し、さほど興味を惹かれないようです。

私たちはこの状況を打破すべく、いくつかのデモを JBoss Business Optimizer demo project に用意しました。このデモを通し、コミュニティプロジェクトである OptaPlanner から提供される新機能を試していただく機会を提供します。

デモプロジェクトの中には、すぐに JBoss Business Optimizer を試せるサンプルが 2つ用意されています。どちらも簡単な手順でお試しいただけます。
  1. git clone https://github.com/eschabell/business-resource-optimizer-demo.git を実行する
  2. Readme.md を読む (リクエストがあれば、和訳します)
  3. installs/README を確認し、リストされたプロダクトを https://access.redhat.com/jbossnetwork からダウンロードする
  4. ダウンロードしたプロダクトを、installs/* 配下に加える
  5. init.sh を実行する
  6. http://localhost:8080/optaplanner-webexamples-6.0.0-redhat-6 にアクセスし、デモを楽しんでください
デモには、「配送車両の経路最適化」が含まれています。こちらの動画にて、サンプルの詳細をご確認いただけます。


もう1つのデモは、「クラウドリソースの最適化」です。こちらも動画にて詳細をご確認いただけます。

2013年12月19日木曜日

JBoss BPM Suite - すべてのデモにモックデータを追加する方法

原文: JBoss BPM Suite - adding mock data to all demo projects by Eric D. Schabell

以前の投稿で、Red Hat JBoss BPM Suite でご利用いただけるいくつかのデモプロジェクトをご紹介しました。「一般的なローンのデモ」、「顧客満足度調査のデモ」、「住宅ローンのデモ」などがあります。

これらのデモプロジェクトに唯一欠けているものといえば、プロセス/タスク・ダッシュボードにきれいなサンプルグラフを表示させる為に必要なモックデータでしょう。今回は、前述した3つのサンプルにモックデータを加えてみました!

すぐにご利用いただけるこれらのデモをインストールすると、1000のプロセスインスタンスが H2データベース(デモに利用されるイン・メモリーデータベース)に追加されます。これにより、ダッシュボードをすばらしいグラフで埋めることができます。

これらのデモをリスタートしても、モックデータは再度追加されます。よって、ダッシュボードにアクセスする際、必ず最低 1000 のモックデータをご利用いただけます。

どのモックデータも、デモプロジェクトに直接関係するものではありません。あなたがデモに含まれたビジネスプロセスからプロセスインスタンスを生成しても、モックデータとコンフリクトすることなく動作します。プロセス/タスク・ダッシュボードをご利用される際には、ユーザー名もしくはプロセス名をご確認いただけば良いでしょう。

モックデータ追加機能が含まれたバージョンのデモプロジェクトは、こちらのリンクからご確認いただけます。

正しくデモプロジェクトをセットアップいただくと、以下のようにプロセス/タスク・ダッシュボードに追加されたモックデータをご確認いただけます。

2013年12月12日木曜日

JBoss BPM Suite - マイグレーションされた「顧客満足度調査のデモ」を吟味する

原文: JBoss BPM Suite - examining the migrated Customer Evaluation demo by Eric D. Schabell

顧客満足度のデモ
「顧客満足度調査のデモ」は、JBoss BRMS 用のクイックサンプルとして 用意 され、公開されていました。

このプロジェクトは元々、ビジネスルールをどうやって ビジネスプロセスとインテグレートさせるかお見せする為に設計/開発されたものです。プロジェクトには必要なものがすべて用意されています。JBoss BRMS に含まれるウェブベースのツールや、JBoss Developer Studio IDE を使い、すぐにデモを実行できます。

私達は JBoss BRMS から 近日リリース予定の JBoss BPM Suite へ、どうやってこのプロジェクトをマイグレートするか時間をかけ考察しました。考察とは、修正プロセスを広い視野で確認することや、具体的な修正箇所の確認、そしてマイグレーション前後のプロジェクトをソースコードレベルで比較することです。

気軽にこちらをご参照ください。私達がどのようにマイグレーションを実施したかご確認いただけます。

はじめに

 JBoss BPM Suite のリリースに先行し、ベータ版を カスタマーポータル から入手いただけます。サブスクリプションをお持ちであれば、このプロジェクトを JBoss BPM Suite へマイグレーションすることができます。この記事では、マイグレーションされたプロジェクトの成果物を確認しながら、実行するところまでご紹介します。
Data Modeler

今回は、前回こ紹介したようなマイグレーションの詳細については触れません。特定のデモプログラムが、どうやって JBoss BPM Suite で実行できるか興味を持たれている方が対象となります。

デモプロジェクトのインストール方法は、プロジェクトのdocsディレクトリ と README.md に記述されています。プロジェクトは githubサイト https://github.com/eschabell/bpms-customer-evaluation-demo から入手いただけます。"git clone git://github.com/eschabell/bpms-customer-evaluation-demo.git' と実行しプロジェクトを入手した後、docs配下にある Quick Start Guide をご参照ください。マニュアルは ODT 及び PDFフォーマットが用意されています。(マニュアルの和訳が必要な場合はお知らせください) 必要な作業はすべて プロジェクトに同梱される init.sh により実行される為、Quick Start Guide を読まれない方でも問題はないはずです。

アーキテクチャー

新規に用意されたセットアップでは、JBoss BPM Suite Deployable EAP 6用の war アーカイブを JBoss EAP 6 Appliction Platform にデプロイします。プロジェクトはインストール手順を容易にする為、大幅に見直されています。プロジェクトを clone し、installs/README ファイルに記載されたプロダクトをコピーし、init.sh を実行するだけで作業は完了です。
Process Designer

target ディレクトリが作成され、JBoss EAP 6.1.1 がインストールされます。また、JBoss BPM Suite のコンポーネントがデプロイされ、support 配下の設定ファイルが初期設定としてコピーされます。これで準備万端です!

プロジェクトのデプロイ

これからご案内するセットアップ作業は、2種類に別れます。(Red Hat JBoss BPM Suite用と、JBoss Developer Studio用)

まず、git リポジトリから取得していただいたデモプロジェクトは、JBoss BPM Suite を起動し、ログオンするだけでご利用いただけるようにインストールされます。

この時点で、Quick Start Guide に記載されているプロジェクトの成果物や、Red Hat JBoss BPM Suite が提供するさまざまなコンポーネントをご確認いただけるはずです。プロジェクトは、ルール、プロセス、そしてデータモデル(Person, Request)を含みます。データモデルは、Data Modeler コンポーネントからご確認いただけます。

プロジェクトの maven アーティファクトを作成するには、プロジェクトをビルドし、デプロイする必要があります。詳細は Quick Start Guide をご確認ください。これはデモの後半でご紹介する、開発用途でルール/プロセス/データモデル を使う際に必要となります。

プロジェクトのインテグレーション

mvn install を実行
プロジェクトのビルドとデプロイが完了した時点で、デモの後半が実施可能となります。projects/customer-evaluation-demo ディレクトリにあるプロジェクトを、JBoss Developer Studio へ import できるはずです。import が終了したら、 ユニットテストを実行できるはずです。

このユニットテストは、maven dependency をベースとしたインテグレーションのデモになります。bpms-customer-evaluation-demo/projects/customer-evaluation-demo に ルート pomファイルをご確認いただけるはずです。pomファイルには、バージョン1.0 の customer evaluation project が必要と記載されています。プロジェクトへ取り込む為には、JBoss BPM Suite を起動した状態で、JBoss Developer Studio から 'mvn install' を実行する必要があります。この作業により、先程ビルドした maven アーティファクトへアクセスすることが可能になります。

あなたのローカル maven リポジトリにこのアーティファクトが取り込まれたら、ユニットテストは デモ用のビジネスプロセスを利用した4つのテストの中で、アーティファクトとインテグレートされるはずです。アプリケーション開発は、このように maven アーティファクト を利用しながら、ルールの実行やビジネスプロセスとのやり取り、その他 データモデルの利用を実現します。

ご意見、ご感想をお知らせください

unit tests を実行
今回は駆け足で JBoss BPM Suite 用にマイグレーションされたアプリケーションについてご案内しました。ビジネスプロセスとルールをインテグレートするデモとしてご確認いただくことも可能です。

デモプロジェクトについて、ご意見 ご感想をぜひお聞かせください。デモを向上させるあらゆる pull request をお待ちしています。このデモを楽しんでいただけることを、心より願います。

原文: JBoss BPM Suite - examining the migrated Customer Evaluation demo by Eric D. Schabell

2013年12月9日月曜日

オープンソースカンファレンス アムステルダム 2013 - JBoss Integration & BPM、zeppelin nemo fish もいるよ

原文: Open Source Conference Amsterdam 2013 - JBoss Integration & BPM together with a zeppelin Nemo fish by Eric D. Schabell

OSC 2013 アムステルダム
以前、アムステルダムの Beurs Van Berlage(古い証券取引所) で Red Hat 主催のオープンソースカンファレンス2013(12月6日) が実施され、そこで講演する予定とお伝えしました。

当日は 1000人を超える来場者が訪れました。私のセッションにも 160人を超える参加者が訪れ、席に座れない方もいらっしゃいました。(部屋の後ろで立ちながら参加してくださった方々、ごめんなさい) 面白かったと言えば、1日中、証券取引所のフロアー中を zeppelin Nemo fish が飛んでいました。あれもこれも本当に凄い1日でした。

zeppelin Nemo fish が浮いてます
実は、この魚はイベントに使われたものです。Red Hat のブースから 10m 上に巨大なフープを作り、ラジコンによりその中で魚を泳がせるという競争でした。とても素晴らしいアイディアでした。カンファレンスの最後、会場のスタッフはその魚を 6歳の幼い参加者へプレゼントしました。(どうやってこんな幼い子が会場に入れたのかはわかりません)
その子が選ばれた理由には訳があります。会場にいるどの参加者よりも、その子は速く魚をフープの中で泳がすことができたのです!


JBoss Integration & BPM セッション
私のセッションでは、リリース予定の JBoss Fuse Service Works と JBoss BRMS / BPM Suite に焦点を絞った JBoss Integration & BPM についてお話しました。たくさんのトピックを詰め込んだセッションでした。セッション終了後には、何人かの参加者が私のところに話しかけにきてくださいました。リリース予定の製品は、とても魅力的なようです。会場は1日中混みあっていましたし、とてもせわしなかったではないでしょうか? Beneluxチームはとても良いイベントに作り上げてくれました。また、Red Hat の大御所も参加したようです。

私の講演資料は以前予告した通り、オンラインで確認することができます。




その他には Paul Cormier のインタビューが含まれた、イベントのプロモーションビデオを御覧頂けます。動画の最初には、浮いている魚をご確認いただけるはずです。



2013年11月28日木曜日

マイグレーションテクニック - JBoss BRMS 5 から JBoss BPM Suite へプロジェクトを移行しよう

原文: Migration Tips - moving projects from JBoss BRMS 5 to JBoss BPM Suite 6 by Eric D. Schabell

 マイグレーションの準備はでていますか?

この記事では、開発者がマイグレーション作業を見積もる際に直面する困難な作業についてお話します。

はじめに

近日リリース予定である Red Hat JBoss BPM Suite 6 へ、あなたのプロジェクトをマイグレーションする際に発生する作業内容を評価できるよう、注意点を紹介します。

JBoss BPM Suite 6 は、JBoss BRMS 6 のスーーパーセットであることをご理解ください。なので、BPMを取り扱ったサンプルプロジェクトを紹介することは、ルールを取り扱ったプロジェクトについて紹介したことになります。

この後、私たちは JBoss BPM Suite 6 へのマイグレーションを実施した、JBoss BRMS 5 プロジェクトを使います。マイグレーション前後のソースコードは、下記リンクから参照いただけます。
リンク先のプロジェクトファイルの中身をそれぞれご確認ください。IDE や 製品の UIコンポーネント上でデモをどのようにインストールし、実行させるか記述されています。現時点では、マイグレーション前のプロジェクトがより豊富なドキュメントを揃えています。マイグレーション後のプロジェクトは徐々に良くなっていきます。何か修正を希望される場合は、ぜひプルリクエストを送ってください。

基盤

これからリリースされる JBoss BRMS / BPM Suite 6 は、ルールやプロセスのリポジトリーのベースに GIT を利用します。現行製品である JBoss BRMS 5 は Jackrabbit をベースとする JCRリポジトリーを利用しています。既存のプロジェクトを新しいリポジトリーに push すればマイグレーションは終わりそうに見えますよね。

それとも、シンプルにはいかないものでしょうか?

残念ながら、それほど簡単にはいきません。まず、GIT をサポートするすべてのツールからアクセス可能であることを理解してください。例えば GIT の CLIツールにより、あなたが愛用されているシェルからリポジトリーにアクセスできます。理解していただく必要のある重要事項ですが、リリース予定である JBoss BRMS / BPM Suite が提供する UI は、完全に GIT の持つ機能を提供するわけではありません。現時点ではとても単純化された方法でリポジトリと連携しており、連携がうまくいかなかった場合、空のリポジトリーを表示することが度々あります。

製品を正しく動作させる為には、あなたの GIT リポジトリーが要求されるディレクトリー構成に準拠している必要があります。製品が持つ素晴らしいグラフィカルインターフェイスでプロジェクトを利用する為には、UI 上であなたが必要とするプロセスやルールなどの空ファイルを一旦作成しておく必要があります。そうすることで作成されたプロジェクトを git clone し、あなたの好きな IDE を使いマイグレーション作業を開始することができます。

プロジェクトのクローンが完了したら、先程作成した空ファイルを目印に、アセットをプロジェクトに追加してください。例えば、customer.bpmn2 という空ファイルを作成していたとします。customereval.bpmn2 をマイグレートする場合、customer.bpmn2 と同じ階層に customereval.bpmn2 を追加してください。追加作業が終わったら空ファイルを削除し、編集したプロジェクトをリポジトリーへ push してください。製品の UI は、自動的に変更内容を検知し、追加されたプロセスやアセットはデザイナーで利用可能になります。

同様にルールファイルを取り込むことが可能です。パッケージ名が、新しいプロジェクトの構造と合致していることをご確認ください。製品の UI はよりビジネスユーザー向けに新調されています。よって、マイグレーション前に利用していた古いパッケージ名 "org.jbpm.customer.evaluation" をより簡略化しました。よりシンプルになったパッケージ名は、"customer.evaluation" です。

プロジェクトには、Request と Person という2つの Javaクラス(POJO)がモデルとしてあります。フォームモデラー コンポーネントが認識できるように、これらは正しい場所にインポートされる必要があります。すでに説明しましたが、パッケージ名と階層が一致しなければ、これらは表示されません。

プロジェクトのアセットへのアクセス方法が抜本的に変わります。BRMS / BPM Suite でルール、ビジネスプロセス、モデルなどを取り扱う場合、それらは jar アーカイブとしてビルドされ、Mavenリポジトリー経由で取り扱う方法が主流になります。詳細については Maven と題したセクションでお話します。

これにより、あなたはプロジェクトを ルール、イベント、ビジネスプロセスなどを活用するコードプロジェクトとアーティファクトに2分割することができます。アプリケーションコードでアーティファクトを利用したい場合、jarアーカイブとしてプロジェクトに含まれます。ユニットテストはコードプロジェクトに用意され、jar の依存関係を利用して必要なアーティファクトを使用します。

API

製品のコアAPIは、全面的にリファクタリングされました。ルール、イベント、ビジネスプロセスと相互作用する為に書かれたコードは、すべてマイグレートする必要があります。

最終的には。

今は下位互換用に用意された knowledge-api.jar をご利用いただくことで、既存のプロジェクトを使い続けることは可能です。それは、新しい全面的に刷新されたAPIの恩恵を受けることができません。現在、deployable-generic.zip に含まれていますが、general availability(GA)版がでるまでに変更される可能性があります。

業務用コードの残り半分とも言えるユニットテストについては、jbpm-test.jar を利用しているコードをリファクタリングする必要があります。この jar ファイルに関しては下位互換性が用意されていません。私たちも既存のユニットテストを書き直す必要がありました。良いニュースと言えば、コードをシンプルに書けるようになったので、あなたのユニットテストは見通しがよくなり、理解し易いものになるはずです。

jar アーカイブが利用可能になった段階で、maven の依存関係に追記していただくことが可能です。マイグレーション後の顧客満足度調査のデモプロジェクトでは、参考までにインターナルリポジトリーのサンプルを含めました。mavenの依存関係をご確認いただけます。

Rest API も変更されました。もしお客様がインターフェースをカスタマイズされている場合、再設計する為にある程度の作業が要求されます。Rest API は、以下の領域に対するアクセスを提供します。

  • ジョブ(Jobs)
  • リポジトリー
  • 組織ユニット(Organizational units)
  • プロジェクト
  • プロセスインスタンス(start, variables, details, abort, signal) : 変数を含めることも可能です
  • ワークアイテム(Work items)
  • プロセスインスタンスが終了したか確認する為の履歴
  • 総合的なタスクインターフェース

ドキュメントは、カスタマーポータル にから入手可能です。

JCR から GIT への移行ツール

既存のJCRリポジトリーから GITリポジトリーフォーマットへ変換するツールはコミュニティーにあります。現時点では使われていませんが、これから製品化に向けてテストされるはずです。

マイグレーションツールは、まるでハンマーで叩かれる爪のような状態なんでしょうか?

ぜひこのツールにも注目していてください。初期のベータリリースにはまだ含まれていないようです。

Maven に関する詳細

JBoss BRMS / BPM Suite は、maven リポジトリーを利用します。プロジェクトにこのリポジトリーを加えることで、プロジェクトが依存する ルール、イベント、ビジネスプロセスにアクセスすることができます。以下の内容をプロジェクトの  pomファイルに追加するだけで、依存関係を定義することができます。


   guvnor-m2-repo
   Guvnor M2 Repo
   http://localhost:8080/business-central/maven2/

例えば、顧客満足度調査プロジェクトのプロパティ GAV(Group ID, Artifact ID, Version)を設定していたとします。私達は version 1.0 jar  への依存関係をこのように追加することができます。


      customer
      evaluation
      1.0


最後にもっとも重要な注意事項ですが、GITリポジトリをファイルシステムから直接コピーしないでください。必ず git URI を利用してクローンしてください。顧客満足度調査のデモを例にあげるならばCLI か、ご利用されている IDE でいかのうようにクローンしていただきます。

# ファイルシステムから直接コピーしないでください。製品により監視されません。
# これは悪い例です
#
#    git clone file://{path-to-repo}/.niogit/customer.git
#
# これは良い例です。shell から git を利用している例です:
#
$ git clone git://localhost/customer

Cloning into 'customer'...
remote: Counting objects: 562, done
remote: Finding sources: 100% (562/562)
remote: Getting sizes: 100% (435/435)
remote: Compressing objects:  89% (388/432)
remote: Total 562 (delta 24), reused 72 (delta 21)
Receiving objects: 100% (562/562), 59.21 KiB, done.
Resolving deltas: 100% (198/198), done.

Taskに関する変更事項

JBoss BRMS 5 では、一般的には HornetQによるメッセージングシステムを使用して、コアエンジンからブリッジされた Taskサーバーを提供していました。

リリース予定の JBoss BPM Suite では、ローカル Taskサーバーのみ提供します。その為、メッセージングシステムの構築が不要になります。このアーキテクチャー変更の溝を埋めるべく、いくつかのヘルパー/ユーティリティメソッド LocalHTWorkItemHandler が用意されます。下記ソースコードをご確認いただくことで、機能の詳細がわかります。

bpm-human-task/jbpm-human-task-workitems/src/main/java/org/jbpm/services/task/wih/util/LocalHTWorkItemHandlerUtil.java

その他、TaskService API は public API に含まれておりますので、いくつかマイグレーション時にご留意いだく点があります

  • パッケージ名の変更がある為、import文の修正が発生する可能性があります
  • いくつかの API が変更される為、メソッドの修正が発生する可能性があります

顧客満足調査のデモ

ビジネスプロセスに User Task を利用されている場合、殆どのお客様がカスタムインターフェースを開発され、Human Task コンポーネントと連携されていました。新しいアーキテクチャーに対しても同様の作業をされるのではないかと思います。

マイグレーションの実戦

顧客満足調査のデモを具体的に振り返ると、私達はルール、モデル、ユニットテスト、ビジネスプロセスを含むシンプルなアプリケーションをマイグレートしたかったのです。このマイグレーションは、作業の容易性を評価していただける作業でした。

顧客満足度調査のデモをマイグレートした結果(今も改善され続けています)を、ぜひご確認ください。

ユニットテスト

ユニットテストのマイグレーション作業については、製品が利用するローカル maven リポジトリーを使用するように pom.xml を修正するところから始めました。そして、knowledge-api と jbpm-test.jar に対する依存関係を定義しました。このコードスニペットは、一般的なエントリーが必要最低限 定義されています。現在のリリースバージョンが設定されているプロパティは除外しています。また、製品の依存関係が定義されているエントリーも除外しています。


   org.jbpm
   jbpm-test
   ${bpm-suite-version}
   test



   org.drools
   knowledge-api
   ${bpm-suite-version}
   compile


マイグレーションされたユニットテストの実行結果
依存関係の定義が終了したら、ユニットテストのリファクタリングを始めます。現行のユニットテストから、projectsディレクトリ配下に確認できるものへ修正していきます。

ここには製品が提供するアーティファクトが含まれた jar から取得する為のエントリーが含まれます。pom.xml のインラインコメントをご確認ください。

イニシャルセットアップは、KnowledgeBase と StatefulKnowledgeSession を実行する為に使われていました。

これは、セッションストラテジーとランタイムエンジンを設定するだけに省略されます。

# The createRuntimeManager() method and getRuntimeEngine() method are 
# both part of the provided testing harness found in JbpmJUnitBaseTestCase
# class that you can extend all unit tests off of.
#
createRuntimeManager(Strategy.SINGLETON, resources);
RuntimeEngine runtime = getRuntimeEngine(ProcessInstanceIdContext.get());

現行のユニットテストではセッションを操作する必要がありましたが、これからは合理化されたケースがそれぞれのユニットテストに用意されます。

@Test
public void underagedCustomerEvaluationTest() {
 // setup of a Person and Request.
 Person underagedEval = getUnderagedCustomer();
 Request richEval = getRichCustomer();

 // Map to be passed to the startProcess.
 Map params = new HashMap();
 params.put("person", underagedEval);
 params.put("request", richEval);

 // Fire it up!
 System.out.println("=========================================");
 System.out.println("= Starting Process Underaged Test Case. =");
 System.out.println("=========================================");

 KieSession ksession = runtime.getKieSession();
 ksession.insert(underagedEval);
 ProcessInstance pi = ksession.startProcess("org.jbpm.customer-evaluation", params);
 ksession.fireAllRules();

 // Finished.
 assertProcessInstanceCompleted(pi.getId(), ksession);
 assertNodeTriggered(pi.getId(), "Underaged");
 ksession.dispose();

 System.out.println("======================================");
 System.out.println("= Ended Process Underaged Test Case. =");
 System.out.println("======================================");
}


完全にマイグレートされたユニットテストは、以下のファイルからご確認いただけます。JUnit テストを実行することもできます。
src/test/java/CustomerEvaluationTest.java

IDE から UI

最後の作業は、既存のルール、ドメインモデルとなる 2つの Javaクラス、それとビジネスプロセスをインポートすることです。

インポートされたビジネスプロセスが表示されたデザイナー
作業を実施する為、JBoss BPM Suite を起動し、新規のリポジトリーとプロジェクトを作成しました。また空のビジネスプロセスとルールを作成しました。

IDEでの作業を振り返ると、git clone git://localhost/customer と実行してクローンし、追加したいファイルの設置場所を見つける為に空ファイルを用意しました。既存のルールやビジネスプロセスファイルを追加した後、空ファイルを削除しました。プロジェクトに作業結果を戻すと、UI のプロジェクトエクスプローラに表示されます。修正点としては、今まで使われた長いパッケージ名が、customer.evaluation とシンプルになったことです。

モデルのインポートも同じ作業です。まずモデラーコンポーネントを利用して空ファイルを作り、それら空ファイルと 2つの javaクラスを入れ替えます。プロジェクトの構成とパッケージ名が一致したら、それらは UI に表示されます。

インポートされたモデルを表示するフォームモデラー
フォームモデラーは、アノテーションがついたオブジェクトを作成します。私達のオブジェクトには現時点ではアノテーションが付いていません。これは、ビジネスプロセスを実行する際にいくつかの問題を引き起す原因となります。JBoss BPM Suite はプロセスの初期変数値を入力するようユーザータスクフォームを生成しますが、私達が意図する StringフィールドではなくObject である為にこの処理が失敗します。

まとめ

リリース予定の JBoss BRMS / BPM Suite はまだ初期段階の製品です。あくまでも、マイグレーションの可能性を早い段階で確認しているとご理解ください。これは完全なマイグレーションガイドではありせん。小規模なサンプルアプリケーションを通し、どの分野が影響を受け、何を期待していただけるかをまとめたものです。

モデルのインポート、パッケージングパス、アノテーションに起因する問題は今後さらに調査する価値のあるトピックだと思います。製品へのドキュメントが提供された際には、カバーされるべきトピックでしょう。

projects/customer-evaluation-demo は、JBoss Developer Studio にインポートされ、BPM Suite で実行されているプロジェクトと相互作用することを意図しています。現在開発段階の状況ですが、ぜひ製品リリースの進捗状況と同様、こちらのプロジェクトにもご注目ください。

私達は今後、他のデモに関しても同様にマイグレーションを実施し、作業内容や成果をご紹介していきます。製品の機能、統合性、使い易さを試すべく、個々のプロジェクトはこれからさらに複雑になります。

原文: Migration Tips - moving projects from JBoss BRMS 5 to JBoss BPM Suite 6 by Eric D. Schabell