There are two methods for running the Freedombase OpenInsight Popup to Template porting program. Via the command line, and via the Freedombase GUI form provided within the Freedombase application.

Generally, for new developers, we recommend using the Freedombase GUI form within the Freedombase application to port popups. However, the command line equivalent described here, and within the Command section of the Freedombase Help, can be used instead.

The format of the command is:

FBTEMPLATEOIPOPUP ‘ApplicationName’,’PopupName’[,‘SystemName’]

ApplicationName is the name of the OpenInsight Application that the Popup resides within.

PopupName is the name of the OpenInsight Popup.

SystemName is optional. If Freedombase finds a table referenced within the Popup, that Freedombase has not attached to previously, then Freedombase needs to know what Freedombase System to load the Table within. If SystemName is passed, then Freedombase will use that system. If SystemName is not passed, then Freedombase will create the system name by taking the ApplicationName and removing any underscores.

This is the command line equivalent of the Popup porting option available within the FREEDOMBASE GUI form provided in the FREEDOMBASE application. New users are likely to find the Popup porting option available within the FREEDOMBASE GUI form easier to use.

The ported popup will be saved as a Freedombase Template, with the name ApplicationName_PopupName.htm. The Template can then be modified as appropriate.

Please see the Templates section for details of how Templates work.

IMPORTANT NOTE: Before porting any popup, any tables referenced by the popup must be attached to/available within the FREEDOMBASE application. Porting a popup will fail if tables referenced within the popup are not attached to the FREEDOMBASE application.

Examples

FBTEMPLATEOIPOPUP ‘EXAMPLES’,’STATES_POPUP’

Will port the STATES_POPUP popup from within the EXAMPLES application, to a Freedombase Template called EXAMPLES_STATES_POPUP.htm. Any tables references within the popup will be ported to a Freedombase system name of EXAMPLES.

FBTEMPLATEOIPOPUP ‘EXAMPLES’,’STATES_POPUP’,’CUSTDATA’

Will port the STATES_POPUP popup from within the EXAMPLES application, to a Freedombase Template called EXAMPLES_STATES_POPUP.htm. Any tables references within the popup will be ported to a Freedombase system name of CUSTDATA.