<?xml version="1.0" encoding="UTF-8"?>

<xwikidoc>
<web>Main.Documentation.AspireIDE</web>
<name>BusinessEventGeneratorPlug-in</name>
<language></language>
<defaultLanguage>en</defaultLanguage>
<translation>0</translation>
<parent>Main.Documentation.AspireIDE</parent>
<creator>xwiki:XWiki.nkef</creator>
<author>xwiki:XWiki.nkons</author>
<contentAuthor>xwiki:XWiki.nkons</contentAuthor>
<creationDate>1233321608000</creationDate>
<date>1274105361000</date>
<contentUpdateDate>1274105361000</contentUpdateDate>
<version>1.19</version>
<title>Business Event Generator Plug-in</title>
<template></template>
<attachment>
<filename>BegPreferences.jpg</filename>
<filesize>50141</filesize>
<author>xwiki:XWiki.nkef</author>
<date>1234183867000</date>
<version>1.1</version>
<comment></comment>
</attachment>
<attachment>
<filename>BegIDE.jpg</filename>
<filesize>98143</filesize>
<author>xwiki:XWiki.nkef</author>
<date>1234183879000</date>
<version>1.1</version>
<comment></comment>
</attachment>
<content>1 Business Event Generator Plug-in

----
#toc("" "" "true")
----


1.1 Introduction

The objective of this tool is to provide a control client to configure Business Event Generator (BEG) so as to translate ECReports to specific EPCIS Events by taking in consideration the previously defined Master Data. Moreover, it provides a view which is able to show the real time processed readings for each event served at that time.

&lt;center&gt;
&lt;a href="http://wiki.aspire.objectweb.org/xwiki/bin/download/Main.Documentation.AspireIDE/BusinessEventGeneratorPlug-in/BegIDE.jpg"&gt;{image:BegIDE.jpg|350}&lt;/a&gt;
&lt;/center&gt;



1.1 Requirements

*Hardware (minimum)*
* P IV 1.2GHz or equivalent
* 512 MB Ram
* 50 MB free HD space

*Software*
* [EPCIS Repository&gt;Main.Documentation.EpcisRepository]
* [Business Event Generator&gt;Main.Documentation.BEG]
* Java 1.6
* [Eclipse 3.4&gt; http://www.eclipse.org/downloads/] and above (with RCP/Plug-in Development Environment plug-ins and [Subversive plug-in&gt; http://www.polarion.org/index.php?page=download&amp;project=subversive]) (required only for developers)

1.1 Users Guide

1.1.1 Download &amp; Run
You can download the aspireRfidIDE RCP application with the aspireRfidIde-beg plug-in from the [AspireRFID forge&gt;http://forge.objectweb.org/project/showfiles.php?group_id=324]  under "AspireRFID IDE" package. Just decompress it and hit the “aspireRfidIDE” executable
1.1.1 Configuration

The BEG Configurator is configured through the IDE’s preferences window (Window -&gt; Preferences) by choosing the BEG from the list appearing at the left see the picture below.

&lt;center&gt;
&lt;a href="http://wiki.aspire.objectweb.org/xwiki/bin/download/Main.Documentation.AspireIDE/BusinessEventGeneratorPlug-in/BegPreferences.jpg"&gt;{image:BegPreferences.jpg|350}&lt;/a&gt;
&lt;/center&gt;

Here you can configure the:
*. * EPCIS Repository Capture Endpoint*: The endpoint that accepts connections for the capturing interface.
*. * EPCIS Repository Query Endpoint *: The endpoint that accepts connections for the Query interface.
*. * Event/Port Binding*: The predefined event/port bindings.
*. * Observator Refresh Rate *: How often the server will update the observator view.


1.1 Developers Guide

Business Event Generator Plug-in is an “AspireRfidIDE” product plug-in that is running within its environment. In order to use this plug-in you should first download the “[AspireRfidIDECore&gt;Main.Documentation.AspireIDE.AspireRfidIdeCore]”.

1.1.1 Acquiring the code
The “Business Event Generator Plug-in” source code is available for checkout at the AspireRFID forge [SVN&gt;http://forge.objectweb.org/plugins/scmsvn/index.php?group_id=324]. 
Check it out by:
* hitting the create new repository location button at the SVN Repositories view of the Eclipse’s subversion plug-in and by using the following URL at the window that appears: 
svn://svn.forge.objectweb.org/svnroot/aspire/trunk/AspireRfidIDE/AspireRfidIdePlug-ins/aspireRfidIde-beg/
* right click the repository that has been just created and hit the check out button
* check the aspireRfidIde-beg project on the list and hit ok

1.1.1 Running the Project

For running AspireRfidIDE with the aspireRfidIde-beg Plug-in:
* Create an aspireRfidIDE project (unless you already have created one)
* Go to the aspireRfidIde project Run Configurations (Run&gt;Run Configurations…) and at the list choose Eclipse Application&gt;aspireRfidIde.product
* At the Main tab of the “aspireRfidIde.product” set Run a product: aspireRfidIde.product
* At the Plug-ins tab of the “aspireRfidIde.product”  hit deselect all button and then choose the aspireRfidIde and org.ow2.aspirerfid.ide.beg and then hit the Add required Plug-ins button.
* Hit apply
* Now you are ready to run the application.
</content>
<renderedcontent>&lt;h2 class="heading-1"&gt;&lt;span id="HBusinessEventGeneratorPlugin"&gt;Business Event Generator Plug-in&lt;/span&gt;&lt;/h2&gt;&lt;p class="paragraph"/&gt;&lt;hr class="line"/&gt;
            &lt;ul&gt;
          &lt;li&gt;&lt;a href="#HIntroduction"&gt;1 Introduction&lt;/a&gt; 
      &lt;li&gt;&lt;a href="#HRequirements"&gt;2 Requirements&lt;/a&gt; 
      &lt;li&gt;&lt;a href="#HUsersGuide"&gt;3 Users Guide&lt;/a&gt; 
        &lt;ul&gt;
          &lt;li&gt;&lt;a href="#HDownload26Run"&gt;3.1 Download &amp; Run&lt;/a&gt; 
      &lt;li&gt;&lt;a href="#HConfiguration"&gt;3.2 Configuration&lt;/a&gt; 
        &lt;/ul&gt;
          &lt;li&gt;&lt;a href="#HDevelopersGuide"&gt;4 Developers Guide&lt;/a&gt; 
        &lt;ul&gt;
          &lt;li&gt;&lt;a href="#HAcquiringthecode"&gt;4.1 Acquiring the code&lt;/a&gt; 
      &lt;li&gt;&lt;a href="#HRunningtheProject"&gt;4.2 Running the Project&lt;/a&gt; 
      &lt;/ul&gt;&lt;/ul&gt; &lt;hr class="line"/&gt;
&lt;h3 class="heading-1-1"&gt;&lt;span id="HIntroduction"&gt;Introduction&lt;/span&gt;&lt;/h3&gt;&lt;p class="paragraph"/&gt;The objective of this tool is to provide a control client to configure Business Event Generator (BEG) so as to translate ECReports to specific EPCIS Events by taking in consideration the previously defined Master Data. Moreover, it provides a view which is able to show the real time processed readings for each event served at that time.&lt;p class="paragraph"/&gt;&lt;center&gt;
&lt;a href="http://wiki.aspire.objectweb.org/xwiki/bin/download/Main.Documentation.AspireIDE/BusinessEventGeneratorPlug-in/BegIDE.jpg"&gt;&lt;img src="/xwiki/bin/download/Main.Documentation.AspireIDE/BusinessEventGeneratorPlug-in/BegIDE.jpg" height="350" alt="BegIDE.jpg" /&gt;&lt;/a&gt;
&lt;/center&gt;
&lt;h3 class="heading-1-1"&gt;&lt;span id="HRequirements"&gt;Requirements&lt;/span&gt;&lt;/h3&gt;&lt;p class="paragraph"/&gt;&lt;strong class="strong"&gt;Hardware (minimum)&lt;/strong&gt;
&lt;ul class="star"&gt;
&lt;li&gt;P IV 1.2GHz or equivalent&lt;/li&gt;
&lt;li&gt;512 MB Ram&lt;/li&gt;
&lt;li&gt;50 MB free HD space&lt;/li&gt;
&lt;/ul&gt;&lt;strong class="strong"&gt;Software&lt;/strong&gt;
&lt;ul class="star"&gt;
&lt;li&gt;&lt;span class="wikilink"&gt;&lt;a href="/xwiki/bin/view/Main.Documentation/EpcisRepository"&gt;EPCIS Repository&lt;/a&gt;&lt;/span&gt;&lt;/li&gt;
&lt;li&gt;&lt;span class="wikilink"&gt;&lt;a href="/xwiki/bin/view/Main.Documentation/BEG"&gt;Business Event Generator&lt;/a&gt;&lt;/span&gt;&lt;/li&gt;
&lt;li&gt;Java 1.6&lt;/li&gt;
&lt;li&gt;&lt;span class="wikiexternallink"&gt;&lt;a href="http://www.eclipse.org/downloads/"&gt;&amp;#69;clipse 3.4&lt;/a&gt;&lt;/span&gt; and above (with RCP/Plug-in Development Environment plug-ins and &lt;span class="wikiexternallink"&gt;&lt;a href="http://www.polarion.org/index.php?page=download&amp;project=subversive"&gt;&amp;#83;ubversive plug-in&lt;/a&gt;&lt;/span&gt;) (required only for developers)&lt;/li&gt;
&lt;/ul&gt;&lt;h3 class="heading-1-1"&gt;&lt;span id="HUsersGuide"&gt;Users Guide&lt;/span&gt;&lt;/h3&gt; 
&lt;h4 class="heading-1-1-1"&gt;&lt;span id="HDownload26Run"&gt;Download &amp; Run&lt;/span&gt;&lt;/h4&gt; 
You can download the aspireRfidIDE RCP application with the aspireRfidIde-beg plug-in from the &lt;span class="wikiexternallink"&gt;&lt;a href="http://forge.objectweb.org/project/showfiles.php?group_id=324"&gt;&amp;#65;spireRFID forge&lt;/a&gt;&lt;/span&gt;  under "AspireRFID IDE" package. Just decompress it and hit the “aspireRfidIDE” executable
&lt;h4 class="heading-1-1-1"&gt;&lt;span id="HConfiguration"&gt;Configuration&lt;/span&gt;&lt;/h4&gt;&lt;p class="paragraph"/&gt;The BEG Configurator is configured through the IDE’s preferences window (Window -&gt; Preferences) by choosing the BEG from the list appearing at the left see the picture below.&lt;p class="paragraph"/&gt;&lt;center&gt;
&lt;a href="http://wiki.aspire.objectweb.org/xwiki/bin/download/Main.Documentation.AspireIDE/BusinessEventGeneratorPlug-in/BegPreferences.jpg"&gt;&lt;img src="/xwiki/bin/download/Main.Documentation.AspireIDE/BusinessEventGeneratorPlug-in/BegPreferences.jpg" height="350" alt="BegPreferences.jpg" /&gt;&lt;/a&gt;
&lt;/center&gt;&lt;p class="paragraph"/&gt;Here you can configure the:
&lt;ul class="star"&gt;
&lt;li&gt;&lt;strong class="strong"&gt; EPCIS Repository Capture Endpoint&lt;/strong&gt;: The endpoint that accepts connections for the capturing interface.&lt;/li&gt;
&lt;li&gt;&lt;strong class="strong"&gt; EPCIS Repository Query Endpoint &lt;/strong&gt;: The endpoint that accepts connections for the Query interface.&lt;/li&gt;
&lt;li&gt;&lt;strong class="strong"&gt; Event/Port Binding&lt;/strong&gt;: The predefined event/port bindings.&lt;/li&gt;
&lt;li&gt;&lt;strong class="strong"&gt; Observator Refresh Rate &lt;/strong&gt;: How often the server will update the observator view.&lt;/li&gt;
&lt;/ul&gt;&lt;h3 class="heading-1-1"&gt;&lt;span id="HDevelopersGuide"&gt;Developers Guide&lt;/span&gt;&lt;/h3&gt;&lt;p class="paragraph"/&gt;Business Event Generator Plug-in is an “AspireRfidIDE” product plug-in that is running within its environment. In order to use this plug-in you should first download the “&lt;span class="wikilink"&gt;&lt;a href="/xwiki/bin/view/Main.Documentation.AspireIDE/AspireRfidIdeCore"&gt;AspireRfidIDECore&lt;/a&gt;&lt;/span&gt;”.
&lt;h4 class="heading-1-1-1"&gt;&lt;span id="HAcquiringthecode"&gt;Acquiring the code&lt;/span&gt;&lt;/h4&gt; 
The “Business Event Generator Plug-in” source code is available for checkout at the AspireRFID forge &lt;span class="wikiexternallink"&gt;&lt;a href="http://forge.objectweb.org/plugins/scmsvn/index.php?group_id=324"&gt;&amp;#83;VN&lt;/a&gt;&lt;/span&gt;. 
Check it out by:
&lt;ul class="star"&gt;
&lt;li&gt;hitting the create new repository location button at the SVN Repositories view of the Eclipse’s subversion plug-in and by using the following URL at the window that appears:&lt;/li&gt;
&lt;/ul&gt;svn://svn.forge.objectweb.org/svnroot/aspire/trunk/AspireRfidIDE/AspireRfidIdePlug-ins/aspireRfidIde-beg/
&lt;ul class="star"&gt;
&lt;li&gt;right click the repository that has been just created and hit the check out button&lt;/li&gt;
&lt;li&gt;check the aspireRfidIde-beg project on the list and hit ok&lt;/li&gt;
&lt;/ul&gt;&lt;h4 class="heading-1-1-1"&gt;&lt;span id="HRunningtheProject"&gt;Running the Project&lt;/span&gt;&lt;/h4&gt;&lt;p class="paragraph"/&gt;For running AspireRfidIDE with the aspireRfidIde-beg Plug-in:
&lt;ul class="star"&gt;
&lt;li&gt;Create an aspireRfidIDE project (unless you already have created one)&lt;/li&gt;
&lt;li&gt;Go to the aspireRfidIde project Run Configurations (Run&gt;Run Configurations…) and at the list choose Eclipse Application&gt;aspireRfidIde.product&lt;/li&gt;
&lt;li&gt;At the Main tab of the “aspireRfidIde.product” set Run a product: aspireRfidIde.product&lt;/li&gt;
&lt;li&gt;At the Plug-ins tab of the “aspireRfidIde.product”  hit deselect all button and then choose the aspireRfidIde and org.ow2.aspirerfid.ide.beg and then hit the Add required Plug-ins button.&lt;/li&gt;
&lt;li&gt;Hit apply&lt;/li&gt;
&lt;li&gt;Now you are ready to run the application.&lt;/li&gt;
&lt;/ul&gt;
</renderedcontent>
</xwikidoc>