Creating Homepage Gadgets

In addition to the provided Viewpoint Gadgets, you can create gadgets of your own and place them in Homepage. Here are the steps to create and place a new gadget in Homepage.

1. Acquire data from Moab:
   1. The packages com.cri.rest.server and com.cri.rest.server.handlers contain examples of servlets loading data from Moab and making that data available in XML or JSON for consumption by UIs. Data can, however, be served to custom gadgets from Moab using any language.
   2. Any servlet data now available can be used or combined with other information in the creation of new gadget UIs.
2. Design the UI portion of the gadget:
   1. Examples of JSP UI gadgets can be found in the Viewpoint deployment in moab/jsp/dashboard/.
      1. Examples of FusionCharts are in moab/jsp/dashboard/charts. The Resource Utilization Gadget uses resource_utilization_chart.jsp, which uses FusionChartsHTMLRenderer.jsp as a FusionCharts helper, and loads its data from the REST Servlet. The path to the FusionCharts SWFs, as well as configuration, can be found in the resource_utilization_chart.jsp file. There are additional UI configurations passed to the UI portion in the XML from the REST Servet and contained in the file ResourceUtilizationRequestHandler.java. FusionCharts mixes UI configuration with data. For more information on the FusionCharts bar chart configuration, see the Column 3D Chart Specification Sheet. For more information on FusionCharts, see the FusionCharts Documentation
      2. Examples of the JavaScript widget library SmartClient tables are found in moab/jsp/dashboard/tables. The System Events Gadget, loaded from system_events_table.jsp, is a good example. Data is loaded in JSON from the REST Servlet as explained above. Data is loaded using the SmartClientRestDataSource and displayed in the SmartClient ListGrid. User preferences are used to determine the refresh rate as described in Configuring Homepage.
   2. Any UI technology can be used for creating gadgets. Homepage requires merely a URL and loads the URL into an iframe. As the provided Viewpoint Gadgets are nearly compatible with the Google Gadgets API, they can be ported to a compatible dashboard.
3. Configure Homepage to include the provided gadget:
   1. For more information on how to configure your gadget in Homepage, see Configuring Homepage.
   2. Set the href attribute to point to the URL of the UI portion of your gadget.