Exporting a Gadget

How to:

You can export an information gadget to a standardized file. This capability enables you to:


Top of page

x
Procedure: How to Export a Gadget

Before you export a Gadget, make sure to test it and ensure that it is working properly in your environment. If the Gadget uses a FOCEXEC, you should note any executable dependencies for the FOCEXEC other than the main FOCEXEC so that you can copy these files manually into the new environment to make sure the Gadget works after it is registered in a new environment. Likewise, if the Gadget is a custom developed applet or SWF, make sure any non-SWF dependencies for these programs are likewise noted so that you can make sure the Gadget works after it is registered in a new environment.

  1. In the Manage tab in PMF, click the Dashboards panel button.
  2. In the navigation tree on the left, expand the Dashboards and Gadgets folder and the Gadget Definitions folder to locate the name of the gadget that you want to export.
  3. Click the name of the gadget.

    The Edit Gadget Class Designer panel opens.

  4. If required, modify any field values on the panel. The values reflect the properties that will be saved with the exported file.

    For details on the fields on the Edit Gadget Class Designer panel, see Creating a Gadget Class. For details on the type of content that you can export, see Adding Various Content Types as Gadgets.

  5. Click Export when you have supplied all the values as desired, as shown in the following image.

    Export button on Edit Gadget Class Designer panel

  6. Supply the information needed to create the Export file, as shown in the following image.

    Sample Export panel

  7. Complete the fields on the Export panel.

    Field

    Description

    Gadget creation date

    Date the Gadget was originally created.

    Gadget revision version

    Version number for the gadget. Type a number in the field.

    Gadget revision date

    Date on which the gadget was last revised. Type a date, or accept the system-supplied date, which is the current date.

    Gadget author name

    ID of the creator of the gadget. Click a value from the drop-down list, or accept the default value. The default value is the ID of the person who was logged on to PMF when the gadget was created.

    Minimum supported PMX version

    Earliest PMF version that supports the content type for the gadget. Type a version number, or accept the system-supplied number.

    Preview image

    Name of the .png file that supplies the preview image for the gadget. The preview image appears on the Catalog chevron in Dashboard Designer. Click the name of the .png file from the drop-down list. PMF displays the selected preview image below the field.

    Preview images for Gadgets are stored in the [approot]\pmfgadgets\thumbs folder. If you do not see an appropriate Preview image for your gadget in this folder, you should create one using an image capture program. Gadget Preview files should be in PNG format, with a recommended size of no larger than 160px x 160px. If you do not want to create a new Gadget Preview file, you can use the default preview file name, preview_na.png, for a generic Preview.

  8. After you have supplied the values on the panel, click Export.

    You are returned to the Edit Gadget Class Designer panel.

    Gadget Export files have a .GDG file extension, contain no spaces or non-alphanumeric characters in the name, are generally all lowercase, and are placed in the [approot]\pmfgadgets\pmf_import_export folder on your server. After you export a Gadget to a file, you can move a copy of the export file to your PC by clicking the link in the confirmation message. You can later download the file by navigating to the approot for your server and looking in the [approot]\pmfgadgets\pmf_import_export folder on your server.


WebFOCUS