Integrator Object Methods

The method signatures for Build, Compare, Link and Unlink are shown below. These correspond to the interactive operations described in the Main Table Context Menu in Integrator Controls. The string arguments can be a name like /MyName or a reference like =123/45678. If duplicate names are used, it is best to always use reference numbers to avoid confusion. The array arguments are arrays of strings of the same format.

!!integrator.build(!Name is STRING)

!!integrator.build(!Names is ARRAY)

!!integrator.compare(!Name is STRING)

!!integrator.compare(!Names is ARRAY)

!!integrator.link(!Name1 is STRING, !Name2 is STRING)

!!integrator.unlink(!Name is STRING)

!!integrator.unlink(!Names is ARRAY)

The following methods get or set the current project configuration file, get the list of Configurations defined in the current file, and get or set the selected Configuration:

!!integrator.projectConfigurationFile()

!!integrator.projectConfigurationFile(!Filename is STRING)

!!integrator.getConfigurations()

!!integrator.configuration()

!!integrator.configuration(!Name is STRING)

The following methods return the Names of the Compare Colours, Comparison Category and Rule Set for the currently selected Configuration:

!!integrator.compareColours()

!!integrator.compareCategory()

!!integrator.compareRuleset()

By default the Compare Report is generated to the screen. In order to send the report direct to file the following two lines are needed to suppress the output to screen and set the pathname:

!!integrator.setReportVisible(false)

!!integrator.setReportPath('c:\reports\rep.xml')

If the pathname of the report file has been specified as shown above, then the report can be viewed in the Compare form using the following command (note that this command cannot be used in non-graphics mode).

!!integrator.openReport()

The following methods have been provided to set flags to auto-link matched objects and auto-update attributes:

!!integrator.setCompareAutoLinkMatches(!Flag is BOOLEAN)

!!integrator.setCompareAutoUpdateAttributes(!Flag is BOOLEAN)

If these are set true then the next use of the compare method will perform these functions.

Integrator link information stored on CYMLNK objects includes references to the linked objects. It is possible during project execution for these references to become invalid when objects are deleted. A method is provided to clean up CYMLNK objects with invalid references.

!!Integrator.validateLinks()

Caution: This method should be used only when all of the databases holding objects that have been linked are current on the MDB.

The following method can be used to clear the Integrator 3D graphical view drawlist:

!!integratorSupportHandler.intdrawlist().removeall()