Creating Query and HTML Openbravo workspace widgets

  • View

  • Download

Embed Size (px)


2nd volume of instructions on how to create Openbravo Workspace Widgets that are part of Openbravo 3.


Creating Openbravo Workspace Widgets Step by Step

Creating Openbravo HTML and Query Workspace WidgetsStep by StepRob GorisUser Experience Architect OpenbravoJanuary 2011Spotlight on Openbravo 3.0What is this guide about?This guide will show you how to create HTML and Query Openbravo Workspace Widget s

Before you startMake sure you have done the followingRun Openbravo 3.0 RC3 (or higher, RC4 is due for mid February 2011). See release notes [1] on how to download and install the RC3 distribution.

Be logged on as System Administrator.

[1] is what we are going to do(1) Create a Facebook HTML widget on user level. This is nothing more than just adding a widget and pasting HTML code. (2) Learn how Query widgets are defined(3) Learn how to create your own Query widget

Creating a Facebook HTML widget on user levelIn this example were using a test server with RC4 that already includes a HTML widget.If youre using RC3, you can install the HTML widget by downloading the module

For your convenience, here is the Facebook html code:

(1) Add the HTML widget to your workspace(2) Paste html code and Save

(3) Facebook widget ready! (You might need to log on to Facebook first if you were not already)Learning how Query widgets are definedIn this example were using a test server with RC4 that already includes a number of Query widgets.If youre using RC3, you can install the Query widgets by downloading the module

(1) Grab an existing Query/List Widget, such as Invoices to Pay(3) Go to Query(2) On the Parameter tab you define parameters such as filters (that the user can edit)

(4) Here you find the HQL Query(5) Click the Column tab to view the column definition

(5) Here you define which columns to display and howCreating your own Query Widget

(1) Create a module. You only need to create one module that can store multiple widgets. Make sure the module is in Development mode (tick the checkbox)

(2) Create widget- Using the widget superclass Query/List- Define the parameters- Define the HQL query- Define the columns

(3) Change to a non-admin role

(4) Add the widget to your workspace

(5) Click Edit button (pen icon on widget title bar) to change parameter settings

Appendix IIRegistering, create and publish widgets as modules Publishing a Widget as a Module (Advanced Users)So you want to share these awesome widgets with the world? For free or...if they are really really good, even for money?You then need register, create and publish them as a module to the Central Repository

1) Register your moduleIn the Module tab, press the Register Module button at the bottom of the form. You can use your Forge credentials in the registration popup that follows.

2) Create and package a module

3) Publishing modules