Contributing Your Openspace Gadget

Once the Openspace gadget is available, it can be contributed using the Contribute Gadget option in the Openspace Gadget Store.

Note: You must be logged in as a user that has privileges with the ContributeGadget system action assigned to them to use the Contribute Gadget option.

To do this, you must specify the URL of the gadget you want to add. For example protocol://amxbpmhost:8080/openspace/projectname/gadgetfoldername/MyGadget.gadget.xml where:

  • protocol is the communications protocol being used by openspace, either HTTP or HTTPS. This was determined at installation.
  • amxbpmhost is the machine name or IP address of the machine where TIBCO ActiveMatrix BPM is installed.
  • projectname is the name of your web application project. The web application project name must be in lowercase.
  • gadgetfoldername is the name of your gadget folder.
  • MyGadget.gadget.xml is the name you have given your Openspace Gadget.

When adding a gadget to Openspace, note the following:

  • When specifying a thumbnail or screenshot URL in <ModulePrefs>:
    • If you do not specify a thumbnail or screenshot URL that is publicly accessible URL, the gadget is displayed in Openspace as shown below:
    • If you do not specify any thumbnail or screenshot URL, then Openspace uses its default thumbnail or screenshot and the gadget is displayed in Openspace as shown below:
  • If you do not specify a description in <ModulePrefs>,Openspace defaults to Contributed Gadget[n] where n is an incremental number for each gadget you add that has no description.

For more information:

Procedure

  1. Click the down arrow of a tab to display the User Preferences area .
  2. Click next to More Gadgets.
  3. Click next to Contribute Gadget.
  4. In the Gadget Spec URL box, type the URL of the gadget you want to add.
    The first part of the URL is always http://amxbpmhost:8080/openspace where amxbpmhost is the IP address of the machine hosting TIBCO Openspace. The rest of the URL is the location you specified in your gadget XML.
    Note: Your system administrator can configure Openspace to display a specific Gadget Spec URL by specifying the path to the gadget server using the useConfiguredServerUrl property in the OSProperties.properties file. See TIBCO ActiveMatrix BPM Administration guide for more information.
  5. Deselect the URL is not a gadget spec - it is a website check box.
    The URL is not a gadget spec - it is a website checkbox is automatically selected when you start to type in the Gadget Spec URL box. This checkbox should be selected if you want to import an arbitrary web page and use it as a gadget in Openspace. See TIBCO Openspace User's Guide for more information.
  6. In the Hub Policy URL: box, type the URL of the Hub Policy for the Openspace Sample Gadget.
    The first part of the URL is always http://amxbpmhost:8080/openspace where amxbpmhost is the IP address of the machine hosting TIBCO Openspace. The rest of the URL is the location you specified in your HubPolicy xml. Once you have typed in the URL of your Hub Policy, the Hub Policy Administrator dialog displays. You can close this dialog as it is for informational purposes only.
  7. In the Category of Gadget: box, type the name of the category where you want the gadget to be stored in the Openspace Gadget Store. If the category does not already exist, it is created automatically. If you do not specify a category, the gadget is stored in the UNCATEGORIZED category.
  8. Click Import Gadget.
    The new gadget is added to the Openspace Gadget Store to the category you specified and is available to be added to a tab. See TIBCO Openspace User’s Guide for more information.
  9. Click AddGadget to add the gadget to the gadget store and close the Gadget Store.
    Note: The content of gadgets within Openspace may change dynamically. You can specify whether the Openspace user should be able to edit dynamic content, by setting the isDynamicGadgetEditable property in the OSProperties.properties file. By default, this is set to false. To enable editing, it should be set to true. See TIBCO ActiveMatrix BPM - BPM Administration guide for more information.