Simple Openbravo Workspace Widgets
Step by Step
User Experience Architect
Spotlight on Openbravo 3.0
What is this guide about?
This guide will show you how to create an Openbravo Workspace Widget and fill it
with content by pointing to a URL, by e.g. reusing a Google Gadget. Obviously,
creating a real cool widget that uses Openbravo data is a bit more difficult
but...let´s first learn the basics.
Before you start
Make sure you have done the following
Run Openbravo 3.0 – RC3 (or higher). See release notes  on how to download
and install this distribution.
Run Firefox. I just noticed that Chrome does not like super-long URLs in the text
field for the widget (issue logged ). IE and Safari should be okay.
Be logged on as System Administrator.
This is what we are going to do
(1) Create a module. You only need to create one module that can “store” multiple
(2) Create simple widget(s) by copying and pasting URLs from sites or existing
(3) Add the widget(s) to your workspace
Be logged in
Use QuickCreate menu
to start creating a new
Complete New Module
form and save it
must be checked
Version must be
Something unique such as
(most common is to use your domain the other
Now create a new Widget
using the QuickCreate
You´re looking at the
bottom half of the form
In case you are serious about things
and want to register your module (to
share or sell the widget maybe), you
can register its module. You will use
your Forge credentials to register the
module in the Central Repository.
Let´s not do that for now. See
Appendix II for more info.
Complete the form
In this example we are going
to reuse an existing Google
Gadget called “Section
Summary” that shows
industry sector trends
Copy and paste this from the other
widgets or type it here without making
Check this one to let
all users enjoy the
Set a height
A little detour to iGoogle.
Here you want to reuse the
source for the Google Gadget
Using Firefox (and e.g. the
Firebug extension) find the code
for the specific widget that starts
with <iframe and ends with “>.
Now paste it in an editor...
That´s the one we
Now only take the part
following the src between the
“ “ as shown below. This must
be a valid URL
And paste this in the child tab´s
URL field for the widget. Save.
Note: in Chrome there was a problem
with large URLs (issue logged)
Going back to the Workspace tab
we now find it in the list that
appears when you click the Add
Widget >> link. Press the Add
And here it appears
We now have added some more
widgets: Motion Chart, Team
Calendar and Google Insights.
Now let´s share them with the
Click Admin MyOBs>>, choose
System and press Edit...
This opens a blank workspace
which is in fact the workspace of
all users you manage. Click the
Add Widget link to start adding
Add the widgets you want to
share and when you are done,
press the Publish button...
All users in the entity (SYSTEM in
our case) now have “received”
the widgets you published to
them. They will see them on next
Let´s check this. Change the role
to e.g. Sales
Et voila. The widgets you choose
are now added to everybody´s
This user now has deleted the boring
widgets, added some others and
reshuffled the lot.
All set for a great day at work! :P
Now you´re all ready to create your own
Some more ideas: http://openbravouxlab.blogspot.com/2010/12/24-ideas-for-
Share and discuss widgets:
On the next pages you find some URLs to copy and paste for your widgets
URL for Google Docs widget (to copy & paste)
How to create the URL for the Google Calendar widget
Go to https://www.google.com/calendar/embedhelper
Log in to your Google Account (if you had not already)
Pick the calendar you want to display and choose the settings
Copy the part of the code between “ and the > as show below and paste it in the URL field on the Widget>URL tab
Registering, 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 module
In 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