ユーザーガイド

1. Web ブラウザーで http://localhost:8080/business-central に移動します。ユーザーインターフェースがドメイン名で実行するよう設定されている場合、localhost をドメイン名に置き換えます。たとえば、http://www.example.com:8080/business-central のようになります。
2. インストール時に作成されたユーザー認証情報を使用してログインします (例: ユーザー = helloworlduser およびパスワード = Helloworld@123)。

手順: アセットのロック解除

1. アセットを開きます。

2. Overview タブをクリックし、Metadata 画面を開きます。

   アセットが別のユーザーによってすでに編集されている場合は、以下が Lock status フィールドに表示されます。

   Locked by <user_name>

3. 別のユーザーによってロックされたアセットを編集するには、Force unclock asset ボタンをクリックします。

   以下の確認ポップアップメッセージが表示されます。

   Are you sure you want to release the lock of this asset? This might cause <user_name> to lose unsaved changes!

4. Yes をクリックして確定します。

   アセットがロック解除された状態に戻ります。

手順: Business Central を使用した組織単位の作成

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

3. Organizational Unit Manager ビューで、Add をクリックします。

   Add New Organizational Unit ダイアログウィンドウが開きます。

   図3.1 *Add New Organizational Unit* ダイアログウィンドウ

   

   View larger image

   
4. 必須パラメーターを 2 つ (名前 と デフォルトのグループ ID) を入力して Ok をクリックします。

手順: Business Central を使用したリポジトリーの作成

1. Business Central で、Authoring → Administration に移動します。

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

   New Repository のポップアップウィンドウが表示されます。

   図3.2 *New Repository* ダイアログウィンドウ

   

   View larger image

   

3. 必須パラメーター 2 つを指定します。

   • リポジトリー名

     注記

     リポジトリー名が有効なファイル名であることを確認してください。名前が無効になる可能性があるので、スペースまたは特殊文字の使用は避けるようにしてください。

   • 組織単位: 新規に作成されたリポジトリーの場所を指定します。
4. Finish をクリックします。

手順: Business Central を使用したリポジトリーのクローン作成

1. Business Central で、Authoring → Administration に移動します。

2. パースペクティブメニューで Repositories → Clone repository を選択します。

   Clone Repository のポップアップウィンドウが表示されます。

   図3.3 *Clone Repository* ダイアログウィンドウ

   

   View larger image

   

3. Clone Repository ダイアログウィンドウで、リポジトリーの詳細を入力します。

   1. アセットリポジトリーでリポジトリーの識別子として使用する Repository Name を入力して、リポジトリーの追加先の Organizational Unit を選択します。

   2. git リポジトリーの URL を入力します。

      • ローカルのリポジトリーの場合は、file:///PATH_TO_REPOSITORY/REPOSITORY_NAME を使用します。

        注記

        ファイルプロトコルは、読み取り操作の場合にのみサポートされ、書き込み操作はサポート されません。

      • リモートまたは既存のリポジトリーの場合は、https://github.com/USERNAME/REPOSITORY_NAME.git または git://HOST_NAME/REPOSITORY_NAME を使用します。

        重要

        SCP スタイルの SSH URL ではなく、HTTPS または Git プロトコルを使用することが重要です。Business Central は、基本的な SSH URL をサポートせず、Invalid URL format で失敗してしまいます。

   3. 適切な場合には、認証に使用する git アカウントの User Name と Password を入力します。

4. Clone をクリックします。

   確認プロンプトとして、リポジトリーが正常に表示されたことを示す通知が表示されます。

5. OK をクリックします。

   これでリポジトリーがインデックス化されます。インデックス化が完了するまで、ワークベンチの機能の一部が使用できない場合があります。

手順: Business Central を使用したプロジェクトの作成

1. Business Central で、Authoring → Project Authoring に移動します。
2. Project Explorer で、組織単位と、プロジェクトを作成する必要のあるリポジトリーを選択します。

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

   New Project のダイアログウィンドウが開きます。

   

   View larger image

   

4. 新規プロジェクトの Project General Settings および Group artifact version の詳細を定義します。これらのパラメーターは pom.xml Maven 設定ファイルに保存されます。

   パラメーターの詳細な説明を参照してください。

   • Project Name: プロジェクトの名前 (例: MortgageProject)。
   • Project Description: プロジェクトの説明。プロジェクトの文書化に役立ちます。
   • Group ID: プロジェクトのグループ ID (例: org.mycompany.commons)。
   • Artifact ID: グループ内で一意のアーティファクト ID (例: myframework)。名前が無効になる可能性があるので、スペースまたは特殊文字の使用は避けるようにしてください。
   • Version: プロジェクトのバージョン (例: 2.1.1)。

5. Finish をクリックします。

   プロジェクト画面のビューは、pom.xml ファイルで定義されるように新規プロジェクトの詳細で更新されます。プロジェクト画面のビューの先頭にある Project Settings: Project General Settings ボタンをクリックして、プロジェクト記述子ファイル間の切り替えや、コンテンツの編集を実行できます。

手順: Business Central での新規パッケージの作成

1. Business Central で、Authoring → Project Authoring に移動します。
2. Project Explorer ビューで、組織単位、リポジトリーおよびパッケージを作成するプロジェクトを選択します。

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

   Create new Package ダイアログウィンドウが開きます。

   

   View larger image

   
4. パッケージの詳細を定義します。パッケージ名を入力し、パッケージを指定します。

5. OK をクリックします。

   これで新規パッケージが選択されたプロジェクトの下に作成されます。

1. 指定プロジェクトの Project Editor を開きます。

   1. Project Authoring パースペクティブの Project Explorer ビューで、プロジェクトディレクトリーを開きます。
   2. Open Project Editor をクリックしてプロジェクトビューを開きます。
2. Project Screen ビューで、Project Settings ドロップダウンボックスから Dependencies 項目を選択します。

3. 更新された Project Screen で、Add ボタンをクリックし、maven 依存関係を追加するか、または Add from repository ボタンをクリックしてナレッジストア (アーティファクトリポジトリー) から依存関係を追加します。

   1. maven 依存関係を追加する際に、ユーザーは Dependency ダイアログウィンドウで Group ID、Artifact ID および Version ID を定義する必要があります。
   2. ナレッジストアから依存関係を追加する際に、表示されるダイアログボックスで依存関係を選択します。依存関係は依存関係表に追加されます。
4. 各種の変更を適用するには、依存関係が保存されている必要があります。

1. Authoring → Project Authoring をクリックしてプロジェクトに移動します。
2. Project Explorer ウィンドウで、Open Project Editor をクリックします。
3. Project Settings: Project General Settings → Knowledge bases and sessions をクリックします。このビューでは、kmodule.xml を変更するためのユーザーインターフェースが提供されます。

4. Add をクリックしてベースを定義し、これを追加します。

   1. ナレッジベースの名前を入力した後に、パッケージを追加します。すべてのパッケージを組み込むには、Packages の下にある Add をクリックしてからアスタリスク * を入力します。
5. Knowledge Sessions の下で、Add をクリックし、セッションの名前を入力します。

6. Default としてマークし、該当する状態を選択します。

   Red Hat JBoss BRMS の場合、ステートフル と ステートレス セッション間の切り替えを行えます。ファクトのインタラクティブな呼び出しが不要な場合には ステートレス を使用します。その他の場合には、ステートフル セッションを使用します。｜

7. いったん終了したら、右上にある Save をクリックします。

1. プロジェクトのリポジトリービューを開きます。

   図3.4 リポジトリービューへの切り替え

   

   View larger image

   
2. /src/main/resources/META-INF に移動します。kmodule.xml をクリックしてファイルを直接編集します。

3. kbases および ksessions を定義します。以下のようになります。

   <kmodule xmlns="http://www.drools.org/xsd/kmodule" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
     <kbase name="myBase" default="true" eventProcessingMode="stream" equalsBehavior="identity" packages="*">
       <ksession name="mySession" type="stateless" default="true" clockType="realtime"/>
     </kbase>
   </kmodule>

   Copy to Clipboard Toggle word wrap
4. 右上にある save をクリックします。

1. Business Central にログインして、Extensions → Data Sets をクリックします。
2. New Data Set をクリックします。

3. プロバイダーのタイプを選択し、Next をクリックします。現時点で、以下のプロバイダータイプがサポートされています。

   • Java クラス: Java クラスからデータセットを生成します。
   • SQL: ANSI-SQL 準拠データベースからデータセットを生成します。
   • CSV: リモートまたはローカル CSV ファイルからデータセットを生成します。
   • Elasticsearch – generate a data set from Elasticsearch nodes.

1. Data Set Creation Wizard を完了し、Test をクリックします。
2. 選択するプロバイダーに応じて、設定手順は異なります。手順が完了したら、Save をクリックしてデータセットの定義を作成します。

1. Business Central にログインして、Extensions → Data Sets をクリックします。
2. Data Set Explorer で、既存のデータセットをクリックしてから Edit をクリックします。

3. Data Set Editor が開きます。3 つのタブでデータセットを編集できます。タブの一部は選択するプロバイダーに応じて変わることに注意してください。以下は CSV データプロバイダーに適用されます。

   • CSV Configuration: データセット定義の名前、ソースファイル、区切り (separator) その他のプロパティーを変更することができます。

   • Preview: CSV Configuration タブで Test をクリックした後に、システムはデータセットのルックアップ呼び出しを実行し、データが利用可能な場合にはプレビューが表示されます。2 つのサブタブがあることに注意してください。

     • Data columns: データセット定義に含める列をカスタマイズできます。
     • Filter: 新規フィルターを追加できます。

   • Advanced: 以下を管理できます。

     • キャッシング: 詳細は、「キャッシング」 を参照してください。
     • キャッシュのライフサイクル: 詳細は、「データ更新」 を参照してください。

1. Project Authoring パースペクティブで、パースペクティブメニューにある New Item → Data Object をクリックします。
2. 名前を入力し、パッケージを選択します。名前はパッケージ内で一意である必要がありますが、2 つの異なるパッケージにまたがる場合には同じ名前のデータオブジェクトが 2 つ存在しても問題ありません。
3. データオブジェクトを永続化するには、Persistable チェックボックスにチェックを付けます。
4. OK をクリックします。

5. データオブジェクトのフィールドを作成します。

   1. メインエディターウィンドウで add field をクリックし、属性 Id、Label および Type を持つオブジェクトにフィールドを追加します。必須属性には * のマークが付けられます。

      • Id: データオブジェクト内で一意のフィールド ID。
      • Label: Fields パネルで使用されるラベル。このフィールドはオプションになります。

      • Type: フィールドのデータタイプ。

        

        View larger image

        
   2. Create をクリックして新規フィールドを作成し、New field ウィンドウを閉じます。または、Create and continue をクリックして New field ウィンドウを開いたままにします。

   属性を編集するには、属性を選択し、通常のプロパティー画面を使用します。

1. Business Central でデータオブジェクトを開きます。
2. Editor タブをクリックします。

3. 右側のメニューから Persistence アイコンを選択します。

   

   View larger image

   
4. Persistable にチェックを付けます。
5. Save をクリックして変更を保存します。

手順: 新規ルールの作成

1. Project Explorer ビューで、以下を実行します。

   1. Project Explorer の Project ビューにいる場合、組織単位、リポジトリーおよびルールを作成する必要のあるプロジェクトを選択します。
   2. Project Explorer の Repository ビューにいる場合、src/main/resources/ とルールテンプレートのプロジェクトフォルダーを作成する必要のある SUBFOLDER/PACKAGE に移動します。
2. パースペクティブメニューで、New Item → Guided Rule に移動します。

3. Create new Guided Rule ダイアログウィンドウで、パッケージの詳細を定義します。

   • Guided Rule テキストボックスで、ルールの名前を入力し、OK をクリックします。DSL を使用するには Use Domain Specific Language (DSL) にチェックを付けます。詳細は、「ドメイン固有言語エディター」 を参照してください。
4. 新規のガイド付きルールが選択されたプロジェクトの下に作成されます。

新規テストシナリオの作成

1. Business Central で、Authoring → Project Authoring をクリックして Projects ビューを開きます。
2. テストシナリオのプロジェクトを選択します。
3. New Item → Test Scenario をクリックします。
4. 名前を入力し、パッケージを選択して OK をクリックします。

5. テストシナリオの編集画面が表示されます。

   

1. テストシナリオを開きます。
2. Data Objects タブをクリックします。
3. New Item をクリックし、インポートを選択して Ok をクリックします。インポートはプロジェクトのデータモデルに固有な場合もあれば、String または Double オブジェクトなどのように汎用的なものである場合もあります。

テストシナリオファクトの指定

1. データオブジェクトのインポート後に、Editor タブをクリックします。最低でも、GIVEN および EXPECT などの 2 つのセクションで入力が必要になります。

   • GIVEN: テストの入力ファクトです。

   • EXPECT: 入力ファクトに基づいて予想される結果です。

     入力パラメーターを 仮定した場合 (GIVEN)、これらのルールが有効にされるか、または実行されることが 予想されます (EXPECT)。また、ファクトが表示され、特定フィールドの値を持つことを 予想 できる場合や、ルールが全く実行されないことを 予想 できる場合もあります。

     予想される内容が一致する場合、テストシナリオはパスし、ルールが正しいとされます。そうでない場合にテストは失敗します。

仮定 (Given) ファクトの指定

1. 新規ファクトを追加するには、GIVEN ラベルの横にある をクリックします。Data Objects タブでインポートしたデータモデルに基づいて、ファクトデータを New Input ダイアログウィンドウに指定します。

   

   ウィンドウ内で、モデルから特定のデータオブジェクトを選択し、これに Fact Name という変数名を付けるか、または代わりにルールフローグループのアクティブ化を選択することもできます。ルールフローグループをアクティブにすると、事前にグループをアクティブして指定されたルールフローグループのルールをテストすることができます。仮定されるファクトを追加し、ルールフローグループをアクティブ化するには、以下を実行します。

   1. 仮定ファクトを追加します。
   2. を再度クリックして、ルールフローグループのアクティブ化を追加します。

2. オプションで、挿入するオブジェクトに制限を追加します。

   1. Add a field をクリックしてオブジェクトのプロパティーを選択します。

      

      View larger image

      

   2. プロパティーの横にある をクリックします。

      • プロパティータイプが別のファクトオブジェクトの場合は、Create a new fact をクリックします。

      • または、Literal value をクリックします。

        詳細は、「追加のテストシナリオ機能」 を参照してください。

   3. 値を指定します。以下は例になります。

      

      View larger image

      

      上記の例は、以下に相当します。

      Customer fact1 = new Customer();
      fact1.setHasInternetService(true);
      insert(fact1);

      Copy to Clipboard Toggle word wrap

予想されるルールの指定

1. GIVEN 条件に問題がなければ、実行されるルール、作成されるファクト、または変更された既存ファクトのフィールド値を予想できます。EXPECT ラベルの横にある をクリックして予想される結果の追加を開始します。

   

2. Given セクションで作成されたデータのセットに基づいて、3 つの予想される内容のいずれかを指定できます。

   • Rule: 特定ルールの実行についてチェックできます。実行が予想されるルールの名前を入力するか、またはルールの一覧からこれを選択します。終了したら、OK をクリックします。

   • Fact value: 特定のオブジェクトインスタンスおよびその値をチェックできます。以下の例では、顧客オブジェクトで hasInternetService ブール値が true に設定されている場合に、同じオブジェクトの hasPhoneService ブール値が true に設定されることが予想されます。

     

     View larger image

     

   • Any fact that matches: 作業メモリーのオブジェクトおよびそれらのフィールドの値をチェックできます。以下の例では、インターネットサービスを有する顧客オブジェクトの場合、新規オブジェクトの RecurringPayment が amount フィールドが 5 にされた作業メモリーに挿入されることが予想されます。

     

     View larger image

     

シナリオの確認、保存および実行

1. 右上にある Save をクリックしてシナリオを保存します。シナリオは定期的に保存し、確認するようにしてください。

2. 右上の Run scenario をクリックしてテストを実行します。結果は、この画面下の Reporting という新規パネルに表示されます。

   

   View larger image

   
3. 1 つのファイルに複数のテストを作成した場合、すべてのテストを順番に実行できます。これを実行するには、Run all scenarios をクリックします。

4. Audit log: では、挿入されたファクトおよび実行されたルールについての通知が表示されることにも留意してください。

   

   View larger image

   

メソッドの呼び出し

1. Call Method により、ルールの実行開始時に既存ファクトでメソッドを呼び出すことができます。この機能には、CALL METHOD ラベルの横にある をクリックしてアクセスできます。

   図10.2 メソッドの呼び出し

   

   View larger image

   

2. ドロップダウンリストから既存ファクトを選択した後に、Add をクリックします。緑の矢印ボタン を使って、ファクトに対してメソッドを呼び出すことができます。

   図10.3 メソッドの呼び出し

   

   View larger image

   

1. New Item → Global Variable(s) をクリックしてグローバル定義を作成します。
2. グローバル変数の名前およびタイプを定義します。
3. オブジェクトタイプをテストにインポートします。グローバル変数のタイプをインポートしない場合、変数はテストで利用可能になりません。

新規グローバルの追加

1. (globals) ラベルの横にある をクリックしてグローバルを追加し、Add をクリックします。

   

   View larger image

   

ルールの設定

1. (configuration) ラベルを使用すると、以下のオプションを指定してルールの実行についての追加の制約を設定することができます。

   • Allow these rules to fire: 実行を許可するルールを選択できます。
   • Prevent these rules from firing: テストシナリオで一部のルールが実行されないようにできます。
   • All rules may fire: 特定のテストですべてのルールの実行を許可します。

   図10.4 設定

   

   View larger image

   

2. 以下のいずれかを選択します。

   • Allow these rules to fire:

   • Prevent these rules from firing:

     ルールを空のフィールドに入力します。空のフィールドの横にある をクリックして、条件の影響を受けるルールを選択します。

     図10.5 ルールの選択

     

     View larger image

     
3. ドロップダウンリストからルールを選択し、OK をクリックします。選択されたルールが、ルール設定オプションの横にあるフィールドに表示されます。

日付と時刻の設定

1. Use real date and time オプションは、テストシナリオの実行時に実際の時間を使用します。

   図10.6 実際の日時

   

   View larger image

   

2. Use a simulated date and time オプションでは、テストシナリオに関連した年、月、日、時間、分を指定することができます。

   図10.7 タイトル

   

   View larger image

   

詳細のファクトデータ

1. フィールドを、作成されたファクトの一部として編集可能なプロパティーに指定した後に、 をクリックして Field value ダイアログを開きます。リテラル値を編集するか、または詳細なファクトデータを指定することができます。

   図10.8 詳細オプション

   

   View larger image

   

2. Advanced Options…​ セクションでは、作成されるファクトや特定のテストシナリオで使用されるモデルオブジェクトに基づいて以下のいずれかを選択できます。

   • Bound variable: フィールドの値を、選択された変数にバインドされたファクトに設定します。フィールドタイプは、バインドされた変数タイプに一致している必要があります。
   • Create new fact: 新規ファクトを作成し、これを親ファクトのフィールド値として割り当てることができます。各種フィールド値のドロップダウンで指定されるフィールド値として割り当てられるファクトをクリックします。これらの値には、詳細なフィールド値が指定される場合があります。