スタートガイド

1. ブラウザーで Red Hat カスタマーポータルの DOWNLOADS セクションを開きます。
2. 表示された 製品のダウンロード ページで Red Hat JBoss BPM Suite をクリックして、ログインします。
3. バージョン のドロップダウンメニューからバージョン 6.4 を選択します。
4. Red Hat JBoss BPM Suite 6.4.0 Deployable for EAP 6 を選択して、Download をクリックします。Red Hat JBoss EAP 7.0 を使用している場合は、Red Hat JBoss BPM Suite 6.4.0 Deployable for EAP 7 を選択します。

手順: 新規ユーザーの作成

1. EAP_HOME ディレクトリーに移動します。

2. Unix システムでは、以下のコマンドを実行します。

   bin/add-user.sh

   Copy to Clipboard Toggle word wrap

   Windows システムでは以下を実行します。

   bin\add-user.bat

   Copy to Clipboard Toggle word wrap
3. b を入力して、アプリケーションユーザーを選択し、Enter を押します。
4. Enter を押して、デフォルトのレルム (ApplicationRealm) を確定します。

5. ユーザー名入力のプロンプトが表示されたら、ユーザー名を入力し (例: helloworlduser)、確認します。

   重要

   すでにあるロールやグループと選択したユーザー名が 競合しない ようにしてください。

   たとえば、admin と呼ばれるロールがある場合は、admin という名前のユーザーは作成しないでください。

6. パスワード入力のプロンプトが表示されたらユーザーのパスワードを入力し (例: Helloworld@123)、再入力します。

   注記

   パスワードは 8 文字以上で、アルファベットの大文字と小文字 (A-Z、a-z)、1 文字以上の数字 (0-9)、および 1 文字以上の特殊文字 (~ ! @ # $ % ^ * ( ) - _ + =) が含まれる必要があります。

7. ロール入力のプロンプトが表示されたら、ユーザーが必要とするロールをコンマ区切りのリストで入力します。詳細は、「ロールの定義」 を参照してください。

   Business Central のユーザーには analyst か admin のロールを割り当てる必要があり、Dashboard Builder のユーザーには admin ロールの割り当てが必要となります。

8. ユーザーを追加することを確認します。
9. 次のプロンプトで yes を入力してクラスタリングを有効にします。

1. コマンドラインで EAP_HOME ディレクトリーに移動します。

2. Unix 環境 の場合は以下を実行します。

   bin/standalone.sh

   Copy to Clipboard Toggle word wrap

   Windows 環境の場合は以下を実行します。

   bin\standalone.bat

   Copy to Clipboard Toggle word wrap

1. コマンドラインで EAP_HOME ディレクトリーに移動します。

2. Unix 環境 の場合は以下を実行します。

   bin/standalone-secure.sh

   Copy to Clipboard Toggle word wrap

   Windows 環境の場合は以下を実行します。

   bin\standalone-secure.bat

   Copy to Clipboard Toggle word wrap

1. Web ブラウザーで Business Central を開き、admin ロールを持つユーザー (たとえば、helloworlduser) としてログインします。

2. 組織単位を作成します。

   1. Authoring → Administration をクリックします。
   2. パースペクティブメニューで Organizational Units → Manage Organizational Units をクリックします。

   3. 表示された Organizational Unit Manager のビューで、Add をクリックします。

      表示された Add New Organizational Unit ダイアログボックスで以下のようにユニットプロパティーを定義し、Ok をクリックします。

      • Name: Loan Application
      • Owner: finance-dept@company.org

3. Loan Application 組織単位に新しいリポジトリーを作成します。

   1. Authoring → Administration をクリックします。
   2. パースペクティブメニューで Repositories → New repository をクリックします。

   3. 表示された New Repository ダイアログボックスで以下のようにリポジトリープロパティーを定義します。

      • Repository Name: helloworldrepo
      • Organizational Unit: Loan Application
   4. Finish をクリックします。
4. Authoring → Project Authoring をクリックします。

5. 組織単位ドロップダウンボックスの Project Explorer で Loan Application を選択し、リポジトリードロップダウンボックスで helloworldrepo を選択します。

   図4.1 Project Explorer の Loan Application 組織グループでの helloworldrepo リポジトリーの選択

   

6. helloworld リポジトリーでプロジェクトを作成します。

   1. パースペクティブメニューで New Item → Project をクリックします。

   2. 表示された New Project ウィザードで以下のようにプロジェクトプロパティーを定義します。

      • Project Name: Hello World
      • Group ID: org.bpms
      • Artifact ID: HelloWorld
      • Version ID: 1.0
   3. Finish をクリックします。

1. Authoring → Project Authoring をクリックし、Project Authoring パースペクティブを表示します。
2. 左側の Project Explorer ビューで Loan Application 組織単位、helloworldrepo リポジトリー、および HelloWorld プロジェクトを選択します。

3. パースペクティブメニューで New Item → Business Process をクリックして、プロセス定義の詳細を定義します。

   • Hello World をビジネスプロセス名として入力します。
   • org.bpms.helloworld パッケージを選択します。これにより、ビジネスプロセス定義を作成する場所が定義されます。
4. OK をクリックします。

1. Start Event 要素 ( ) をクリックすると、ノードの周りで quick linker アイテムが確認できます。
2. Task ( ) アイコンをクリックし、外向きのシーケンスフローおよび Start Event へ紐付けされた Task 要素を作成します。
3. Business Process Designer タブ右上隅にある をクリックし、Object Library パレットを展開します。
4. パレットから Timer (Catching Intermediate Events の下にある) をドラッグアンドドロップし、クイックリンクメニューの Edge 要素を使用して Task を Timer 要素に紐付けします。
5. Timer Event 要素へ紐付けされる End Event 要素を作成します (クイックリンク機能を使用するか、パレットからドラッグします)。

1. 右上隅にある二重矢印 ( ) をクリックし、Properties タブを展開します。

2. キャンバスの空白部分をクリックします。Properties タブに Hello World プロセスのプロパティーが表示されます。

   必要なプロパティーは事前定義されていますが、必要に応じて値を変更できます。

3. Start 要素と End 要素はオプションのプロパティーのみを持ちますが、Task 要素ではタイプが必要となり、タイプ固有のプロパティーを定義する必要があります。Task をクリックし、必要なプロパティーを定義します。

   • Name: ScriptTask
   • Task Type: Script
   • Script Language: java
   • Script: をクリックし、以下を入力します: System.out.println("Hello World!");

   これで実行時にスクリプトを実行するタスクが定義されました。スクリプトは Java で定義され、System.out.println("Hello World!") を実行します。このメソッドは、サーバーの標準出力に Hello World! を書き込みます。デフォルトでは、サーバーの標準出力はサーバーが起動したコンソールになります。

4. 実行を検証できるようにするために、プロセスが実行時に待機するようタイマーのプロパティーを定義します。タイマーをクリックし、実行を待機する時間を定義します。

   • Time Duration: をクリックして次を入力します: 5m

   この結果、プロセスはスクリプトタスクの実行後にタイマーイベントで 5 分間待機します。

5. タイマー要素をクリックし、Name: Timer と入力してから、ビジネスプロセスエディターの上部にある Save をクリックしてプロセスを保存します。

6. Save this item のプロンプトが表示されます。Check-in comment を入力してください。

   注記

   check-in comment とは、変更内容の簡単な説明などで、資産の保存時には毎回入力する必要があります。

7. プロセスデザイナーのツールバーにある をクリックし、Start validating を選択して、定義されたプロセスが有効であることを確認します。1 つ以上の検証エラーがある要素は外側がオレンジ色になります。検証機能については、『Red Hat JBoss BPM Suite User Guide』を参照してください。

1. Business Central のメインメニューで、Authoring → Project Authoring をクリックします。
2. Project Explorer で Hello World プロジェクトを見つけます。
3. プロジェクトエディターでプロジェクトを開きます。Project Explorer で Open Project Editor をクリックします。

4. プロジェクト画面に正しいプロジェクト詳細が表示されていることを確認し、プロジェクト画面ビューの右上隅にある Build → Build & Deploy を選択します。

   図5.2 プロジェクトエディターでの Hello World プロジェクトプロパティー

   

1. メインメニューで Process Management → Process Definitions をクリックします。
2. 表示された Process Definitions タブで HelloWorld プロセス定義を見つけます。どれも利用可能になっていない場合は、Refresh ボタンをクリックしてリストにプロセス定義を表示させます。

3. プロセス定義エントリーの横にある Start ( ) をクリックし、ダイアログボックスで Submit をクリックして、プロセスのインスタンス化を確認します。

   現在ログインしているユーザーがプロセス所有者となってプロセスがインスタンス化され、プロセスフォームが表示されます。ビジネスプロセスのフォームを定義する場合は、プロセスのインスタンス化の際に、フォームを使ってユーザーからの入力を要求します。詳細については、『Red Hat JBoss BPM Suite User Guide』を参照してください。

1. Project Explorer で Loan Application 組織単位、helloworldrepo リポジトリー、HelloWorld プロジェクト、default パッケージを選択します。

2. DRL ファイルを作成します。

   1. パースペクティブメニューで New Item → DRL file に移動します。
   2. Create new DRL file ダイアログボックスで、リソース名を helloworldrule と定義し、パッケージが default に設定されていることを確認します。
   3. OK をクリックします。

3. DRL エディターで表示された helloworldrule.drl ファイルで、ルールを定義します。

   rule "helloworldrule"
   ruleflow-group "helloworldgroup"
   
   when
   then
     System.out.println("Hello World!");
   end

   Copy to Clipboard Toggle word wrap

   このルールは when 条件を定義しません。つまり、チェックされる (実行するため呼び出される) と常に true になり、Hello World! フレーズが出力されます。

4. 保存 をクリックします。
5. Save this item のプロンプトが表示されます。Check-in comment を入力して、Save をクリックしてください。

1. Project Explorer で、組織単位パスの横にある矢印をクリックします。

2. BUSINESS PROCESSES を展開し、「HelloWorld」を選択します。

   注記: 新規インストールでプロジェクトを作成している場合は、矢印をクリックするまで BUSINESS PROCESSES メニューは表示されません。

   図6.1 Hello World の組織単位パス

   
3. Hello World プロセスで表示されるビジネスプロセスデザイナーで、プロセス要素を持つ Object Library パレットを展開します。ビジネスプロセスデザイナータブの左上にある二重矢印のボタン ( ) をクリックします。

4. Tasks メニューを展開し、ビジネスルールタスクを右側のキャンバスへドラッグアンドドロップします。

   フローの紐付けを調整し、タスクをワークフローへ統合します。

5. ビジネスルールタスクを選択し、そのプロパティーを Properties パネルで定義します。

   • Name: BusinessRule

   • Ruleflow Group: helloworldgroup

     Ruleflow Group プロパティーは、タスクの実行時にチェックされるルールのグループを定義します。この例では、helloworldrule.drl ファイルで定義された helloworldrule ルールのみが、helloworldgroup グループに存在します。

   図6.2 Hello World プロセスのビジネスルールタスクおよびそのプロパティー

   
6. Save ボタンをクリックし、変更を保存します。

1. Business Central のメインメニューで、Authoring → Project Authoring をクリックします。
2. Project Explorer で Hello World プロジェクトを見つけます。
3. プロジェクトエディターでプロジェクトを開きます。Project Explorer で Open Project Editor をクリックします。
4. Version を 1.0.1 に設定します。
5. Save をクリックして、変更保存を確認します。
6. プロジェクト画面に正しいプロジェクト詳細が表示されていることを確認し、プロジェクト画面ビューの右上隅にある Build → Build & Deploy をクリックします。

1. メインメニューで Process Management → Process Definitions をクリックします。
2. 表示された Process Definitions タブで新規の HelloWorld プロセス定義を見つけます。この例では、org.bpms:HelloWorld:1.0.1 になります。利用可能になっていない場合は、Refresh ボタンをクリックしてプロセス定義を表示させます。

3. プロセス定義エントリーの横にある Start ( ) をクリックし、ダイアログボックスで Submit をクリックして、プロセスのインスタンス化を確認します。

   現在ログインしているユーザーがプロセス所有者となってプロセスがインスタンス化され、プロセスフォームが表示されます。ビジネスプロセスのフォームを定義する場合は、プロセスのインスタンス化の際に、フォームを使ってユーザーからの入力を要求します。詳細については、『Red Hat JBoss BPM Suite User Guide』を参照してください。

手順: Drools および jBPM Red Hat JBoss Developer Studio プラグインのインストール

1. Red Hat JBoss Developer Studio を起動します。
2. Help → Install New Software をクリックします。
3. Add をクリックして Add Repository メニューに入ります。
4. Name フィールドの横にソフトウェアサイトの名前を指定し、Location フィールドに https://devstudio.jboss.com/10.0/stable/updates/integration-stack/ の URL を追加します。
5. OK をクリックします。
6. 利用可能なオプションから JBoss Business Process and Rule Development 機能を選択して、Next をクリックし、もう一度 Next をクリックします。
7. ライセンス内容を確認して、該当のラジオボタンを押してライセンス内容に同意し、Finish をクリックします。
8. インストールが完了したら、Red Hat JBoss Developer Studio を再起動します。

手順: Red Hat JBoss BRMS Runtime の設定

1. Red Hat カスタマーポータルの DOWNLOADS セクションを開きます。
2. Red Hat JBoss BRMS をクリックしてログインします。
3. Red Hat JBoss BRMS 6.4.0 Core Engine をダウンロードします。
4. jboss-brms-VERSION-engine.zip に格納されているランタイム JAR ファイルを展開します。
5. Red Hat JBoss Developer Studio メニューより Window → Preferences をクリックします。
6. Drools → Installed Drools Runtimes を選択します。
7. Add…​ をクリックして、新しいランタイムの名前を入力し Browse をクリックして、展開したランタイムファイルのあるディレクトリーに移動します。OK をクリックして、選択したランタイムを Red Hat JBoss Developer Studio に登録します。
8. 横にあるチェックボックスをクリックして、作成したランタイムをデフォルトの Drools ランタイムとして指定します。
9. OK をクリックします。既存のプロジェクトがある場合はダイアログボックスが表示され、Red Hat JBoss Developer Studio を再起動してランタイムを更新する必要があることが示されます。

手順: jBPM ランタイムの設定

1. Red Hat カスタマーポータルの DOWNLOADS セクションを開きます。
2. Red Hat JBossBPM Suite をクリックしてログインします。
3. Red Hat JBoss BPM Suite 6.4.0 Core Engine をダウンロードします。
4. Red Hat JBoss Developer Studio メニューより Window → Preferences をクリックします。
5. jBPM → Installed jBPM Runtimes を選択します。
6. Add…​ をクリックして新しいランタイムの名前を入力し、Browse をクリックして、ランタイムのあるディレクトリーに移動します。
7. OK をクリックし、新しいランタイムを選択してもう一度 OK をクリックします。既存のプロジェクトがある場合はダイアログボックスが表示され、Red Hat JBoss Developer Studio を再起動してランタイムを更新する必要があることが示されます。

手順: サーバーの設定

1. Window → Perspective → Open Perspective → Other と選択した後に jBPM を選んで jBPM を開き、OK をクリックします。
2. Window → Show View → Other…​ と選択した後に、Server → Servers とクリックして、Server のビューを追加します。
3. Servers パネルを右クリックしてサーバーメニューを開き、New → Server を選択します。
4. JBoss Enterprise Middleware → JBoss Enterprise Application Platform 6.1+ を選択し、Next をクリックして、サーバーを定義します。
5. JBoss EAP 6.4 Runtime をクリックして Create new runtime (next page) を選択します。Next をクリックします。
6. Browse をクリックしてホームディレクトリーを設定します。Red Hat JBoss BPM Suite をインストールした Red Hat JBoss EAP 6.4 のインストールディレクトリーを選択します。
7. Name フィールドにサーバーの名前を指定して、設定ファイルが設定されていることを確認し、Finish をクリックします。

Kie Navigator の設定

1. Red Hat JBoss Developer Studio で Window → Show View → Other…​ とクリックします。
2. Kie Navigator と入力し、Kie Navigator オプションを選択します。
3. Red Hat JBoss Developer Studio で Red Hat JBoss BPM Suite サーバーが設定されていない場合は、この設定を求められます。詳細は、「Red Hat JBoss BPM Suite サーバーの設定」 を参照してください。
4. 使用するサーバー名を右クリックして、Properties を選びます。
5. kie のロールがあるユーザー名とパスワードを入力します。例えば、kie-server となります。

6. 以下を入力します。

   • KIE Application Name: business-central
   • HTTP Port: 8080

   • Git Port: 8001

     注記

     上記の値はデフォルト値です。Git または Business Central ポートのデフォルト値を変更している場合は、その値を使用してください。

7. Use default Git Repository Path にチェックを入れ、Apply をクリックします。
8. Servers タブでサーバーを起動し、稼働するまで待機します。
9. Kie Navigator タブで使用するサーバーを右クリックし、Refresh をクリックします。Red Hat JBoss BPM Suite git リポジトリーのコンテンツが確認できます。Red Hat JBoss Developer Studio にインポートするプロジェクトをダブルクリックします。

手順: リモート GIT リポジトリーのクローン

1. Server タブから Red Hat JBoss BPM Suite サーバーを選択し、Start アイコンをクリックして起動します。

2. セキュアシェルサーバーが稼働していない場合は、以下のコマンドを使用してこれを起動します。コマンドは、Linux および Mac 環境に固有のものです。これらのプラットフォームで sshd がすでに起動していると、このコマンドに失敗しますが、無視しても問題ありません。

   /sbin/service sshd start

   Copy to Clipboard Toggle word wrap
3. JBoss Developer Studio で File → Import…​ とクリックし、Git フォルダーに移動します。Git フォルダーを開き、Projects from Git を選択して Next をクリックします。
4. Clone URI としてリポジトリーのソースを選択して、Next をクリックします。

5. 次のウィンドウで Git リポジトリーの詳細を入力して 次へ をクリックします。

   図8.2 Git リポジトリーの詳細

   
6. 次のウインドウでインポートするブランチを選択し、Next をクリックします。
7. このプロジェクトのローカルストレージを定義するために、空でないディレクトリーを入力 (または選択) して設定を変更し、Next をクリックします。
8. 次のウィンドウでプロジェクトを一般プロジェクトとしてインポートし、Next をクリックします。このプロジェクトに名前を付け、Finish をクリックします。

手順: ローカル GIT リポジトリーのインポート

1. Server タブから Red Hat JBoss BPM Suite サーバーを選択し、Start アイコンをクリックして起動します。
2. JBoss Developer Studio で File → Import…​ とクリックし、Git フォルダーに移動します。Git フォルダーを開き、Projects from Git を選択して Next をクリックします。

3. Existing local repository としてリポジトリーのソースを選択して、Next をクリックします。

   図8.3 Git リポジトリーの詳細

   
4. 使用可能なリポジトリーリストから設定するリポジトリーを選択し、Next をクリックします。

5. 表示されたダイアログで、Wizard for project import group から Import as general project のラジオボタンを選択して、Next をクリックします。プロジェクトの名前を指定して Finish をクリックしてください。

   図8.4 プロジェクトインポートのウィザード

   

手順: Red Hat JBoss Developer Studio 新規プロジェクトの作成

1. メインメニューから File → New → Project をクリックします。
2. Drools → Drools Project を選択して、Next をクリックします。
3. ここで、2 つ目のオプションを選択します。Red Hat JBoss Developer Studio では、Red Hat JBoss BPM Suite の例があるプロジェクトが作成されます。Next をクリックします。
4. Project name: テキストボックスにプロジェクト名を入力して Finish をクリックします。

1. src/main/java ディレクトリーに移動し、com.sample パッケージを展開します。

2. Java クラスを右クリックして、Run As → Java Application を選択します。

   Console タブに出力が表示されます。

手順: Red Hat JBoss Developer Studio での Red Hat JBoss BRM Suite プロジェクトの作成

1. メインメニューから File → New → Project を選択します。
2. jBPM → jBPM Project を選択して Next をクリックします。
3. ここで、2 つ目のオプションを選択します。Red Hat JBoss Developer Studio では、Red Hat JBoss BPM Suite の例があるプロジェクトが作成されます。Next をクリックします。
4. Project name: テキストボックスにプロジェクト名を入力して Also include a sample JUnit test for the process オプションにチェックを入れます。
5. Finish をクリックします。

1. src/main/java ディレクトリーに移動し、com.sample パッケージを展開します。

2. ProcessTest.java を右クリックして、Run As → JUnit Test を選択します。

   Console タブに出力が表示されます。

1. Red Hat カスタマーポータルの DOWNLOADS セクションを開きます。
2. Red Hat JBossBPM Suite をクリックしてログインします。
3. バージョン のドロップダウンメニューからバージョン 6.4 を選択します。
4. Red Hat JBoss BPM Suite 6.4.0 Business Resource Planner を選択して、Download をクリックします。

1. コマンドラインで examples/ ディレクトリーに移動します。

2. Unix 環境では以下を実行します。

   ./runExamples.sh

   Copy to Clipboard Toggle word wrap

   Windows 環境では以下を実行します。

   runExamples.bat

   Copy to Clipboard Toggle word wrap
3. 表示された Examples GUI アプリケーションよりサンプルを 1 つ選択し、任意の IDE で実行します。