IWidget Editor

A new editor has been added to the App Builder to provide for the visual creation and definition of iWidget events.
The primary building blocks used for describing IWidget events are:

• Event Descriptions
  An Event Description identifies the event payload. The same Event Description can be used by multiple Events defined for the IWidget.
  An Event Description is identified with a Unique Id.
• Events
  An Event describes an operation (Send/Receive) performed by the iWidget using a particular Event Description.
  An Event is identified by a Unique ID and specifies one or both of the Send or Receive Operations agains a specific Event Description.

Lotus Mashup Maker allows the wiring of any 2 widgets that declare the same or compatible Event Descriptions (payloads)
where one Widget is defined as a Sender and the other a Receiver of that payload.

The following steps demonstrate the various functions of the IWidget Editor:

Setup

• Create a New Application and Open that Application
  
• In the File Editor, click on New File and select iwidget in app/iwidgets
  
• In the IWidget Create Dialog. provide a Descriptive Name different than the Widget Name to see how these 2 names are used.
  (mywidget is used as the widget name in this example)
  The Widget Name is used to uniquely identify the iWidget on the File System.
  The Descriptive Name will be recognized an d identified by Lotus MashupMaker as the widget "Title".
  
• In the File Editor, click on the iWidget XML File (e.g. mywidget.xml)
  If asked whether you wish to add the zero.iwidget, answer Yes
  
• Click on the Design tab at the bottom of the editor pane
  

Your screen should look something like this:

• IWidget Editor:
  

Working with Event Descriptions

• NOTE: One or More Event Descriptions must Exist before Events can be created.
• Click on the Event Descriptions Tab
  
• Click on the Add icon
  
• Supply the values shown here and click Save:
  
• Click again on the Add icon to create a second definition
  
• Supply the values shown here and click Save:
  

At this point, you should have 2 event descriptions and your screen should look something like this:

• Event Descriptions:
  

Working with Events

• Click on the Events Tab
  
• Click on the Add icon
  
• Supply the values shown here and click Save:
  Note: You will be selecting zipcode from the drop down and creating a reference to that Event Description
  

You should now have 1 event defined and your screen should look something like this:

• Events:
  

Return to Event Descriptions

• Click on the Event Descriptions Tab
  
• Event Descriptions:
  
  

• NOTE:
  The zipcode Event Description is now showing that it is linked to an event.
  Event Descriptions that are linked to Events cannot be deleted until the event that is linking to it is deleted.
  Removing the link in the ReceiveZipCode will drop the reference to the zipcode Event Description and
  it will once again be delete-able.
  

• Click on the Properties icon for the Descrption with ID: zipcode
  Note that ReceiveZipCode is now showing as an Event Reference
  

The Editor Source View

<iw:event id="ReceiveZipCode" eventDescName="zipcode" onEvent="onReceiveZipCode" handled="true" />
<iw:eventDescription id="areacode" payloadType="json" description="Area%20Code" lang="en" />
<iw:eventDescription id="zipcode" payloadType="text" description="Zip%20Code" lang="en" />