My first app

General information

Copyright Notice

All rights are reserved by Compex Systemhaus GmbH. In particular, duplications, translations, microfilming, saving and processing in electronic systems are protected by copyright. Use of this manual is only authorized with the permission of Compex Systemhaus GmbH. Infringements of the law shall be punished in accordance with civil and penal laws. We have taken utmost care in putting together texts and images. Nevertheless, the possibility of errors cannot be completely ruled out. The Figures and information in this manual are only given as approximations unless expressly indicated as binding. Amendments to the manual due to amendments to the standard software remain reserved. Please note that the latest amendments to the manual can be accessed through our helpdesk at any time. The contractually agreed regulations of the licensing and maintenance of the standard software shall apply with regard to liability for any errors in the documentation. Guarantees, particularly guarantees of quality or durability can only be assumed for the manual insofar as its quality or durability are expressly stipulated as guaranteed. If you would like to make a suggestion, the Compex Team would be very pleased to hear from you.

(c) 2016-2024 Compex Systemhaus GmbH

License information

The OS.bee Software Factory is distributed under a commercial license.

The product itself is based on the OSBP Software Factory which is an "Eclipse Project". In addition, there are many other open source projects combined and the whole bunch of license used is listed "here".

OS.bee Software Factory

Please install OS.bee Software Factory first. Introduction of installation could be found "here".

Installation of MyFirstApp

Install MyFirstApp

• The installation could be find in Eclipse: in Package Explore, right click the mouse -> New -> Other.
  
  

• select OSBP Projects -> My First App -> Next.
  
  

• Now you start the installation window for MyFirstApp:
  
  

• The default JDNI Data Source is h2memory, which save all data in memory. If you want to use other JNDI Data Source, e.g. MySQL or Oracle, you can change it later.
  
  

• Set for the Mock Data generation.
  
  

• Choose which location you would lick to save the files of MyFirstApp. You can use the default directory:
  
  

• or your own directory:
  
  

• The XMS Memory is usually ¼ of total physical memory.
  
  

• Click finish to start the installation:
  
  

• When the installation window disappears, you could see in Project Explorer, all projects of MyFirstApp are established.
  
  

• Please notice till now the installation is not complete finish, normally it is still building workspace(see the right bottom corner), wait until it completed.
  
  

• After the complete installation, the Project Explorer should be looked like this:
  
  

• Please check myfirstapp.entity file in org.osbp.myfirstapp.model.core\models, in entity Person, it should be regex(“M|F”) not regex(“M|W”) before gender.
  
  

Configuration

change Product Configuration

• The first step of the configuration is changing the Product Configuration from workspace to org.osbp.myfirstapp.product in Preferences -> OSBP Application Configuration. Please notice that, this will be not saved, please do this step every time before you start to configure MyFirstApp.
  
  

• The Desktop URL link could be found here.
  
  http://localhost:8081/myfirstapp
  
  
  

==== Configure Authentication ====

==== Configure Bpm Engine ====

==== Configure Controls ====

Configure Data Sources

• All data sources could be set up here:
  
  

• If you want to use other data sources, please configure it first. Click + to extend the tree, and then set all necessary information, e.g. Server Name, Server Port, Database Name, etc.
  
  

==== Configure Email====

==== Configure External Data Sources ====

==== Configure Localization ====

Configure PersistenceUnits

• All details about Persistence Units could be changed here.
  
  

• Click + to extend the tree, and then you could change the data source, DDL Generation, etc.
  
  
  
  

==== Configure Project Wizard ====

==== Configure Service Communication ====

Configure Verify Dependencies

• If you see all green points, it means MyFirstApp is ready to start without dependencies’ error; if you see the red point, fix the error before starting.
  
  

Start MyFirstApp

Launch Eclipse Application

• Open myfirstapp.product file from org.osbp.myfirstapp.product:
  
  

• We should check the validation first, please click the button on right top:
  
  

• No problems were detected means it is ready to run, otherwise fix the problem first.
  
  

• Now click Launch an Eclipse application to start MyFirstApp.
  
  

• Open "console" to see if the progress is finish, the last sentence should be TRIGGER DONE....
  
  

Start MyFirstApp in Browser

• Now you could start this page from your browser:

http://localhost:8081/myfirstapp

• Log in Page will be showed first.
  
  

log in

• The log in details could be found in authentication.entitymock file in org.osbp.myfirstapp.model.entitymock\models\.
  
  

• Enter the user name and password in log in page, e.g. Charles, Charles, save the password and log in.
  
  

welcome page

• Now you could see the Welcome page.
  
  

menu list

• On the left top of the page, just beside AdminIT is the MENU button, click it to pop up the menu.
• There are 2 main entry: Menu and Persons.
  
  

Menu

• 3 subentries under Menu:
• Persons:
  
  
  
  
• Company:
  
  
  
  
• Company group:
  
  
  
  

Persons

• click the Persons entry, the table All person will be showed directly in the menu list.
  
  

tab list

• on the right top of the page, there are some tabs, by clicking them, you could easily to switch the pages. Default tabs are OPEN and WELCOME.

OPEN

• OPEN tab is the first Tab. click it, the Open perspective menu will be showed. Perspectives such as Datainterchange, BI, BPM etc. could be selected here.