MultiSpeak Import Properties

The following properties are supported by the PropertySet argument to IMMXMLData::ImportDataFromDOM:

Property ImportMode: A string specifying whether GIS features are being exported to MultiSpeak, or results are being imported from MultiSpeak. The values are on of the two following strings:

FromGIS (default): Network features are being exported to a MultiSpeak XML.

FromEA: Engineering analysis results are being imported from a MultiSpeak XML.

Property MessageCallback: A reference to an object in the Implementation of type IMMMessageCallback allows the MultiSpeak API to send error messages, status messages, and progress bar values back to the Implementation. Also, the MultiSpeak API uses this object to periodically check if the Implementation wants the data load stopped.

Property GISExportXSL: A string specifying the full path to the XSL to be used in the transformation. There is no default value. If this property is not specified, the style sheet that is installed with Network Adapter is used. NetAdapterMspEAExport.xsl is installed in the ArcFM Solution directory: ArcFM Solution\bin\Style Sheets\NetAdapterMspEAExport.xsl.

Property MultiSpeakXML: A string specifying the full path of the exported network XML file, in the MultiSpeak format. Like the GISExportXSL property, there is no default value. If the property is not provided, the output file is written to the Network Adapter subfolder in the user’s Application Data folder, to a file called MultiSpeakEngAnalysis.xml. In Windows 2000 and XP, an example of this path is: C:\Documents and Settings\mikeb\Application Data\Miner and Miner\Network Adapter\MultiSpeakEngAnalysis.xml.

Property Verb: A value indicating the action to be taken by the Engineering Analysis engine with the data contained in the XML.

Change (default): The Engineering Analysis application should modify the features and attributes provided in the XML. If the features do not exist, Engineering Analysis should create them.

New: Engineering Analysis should create the features contained in the XML. If the features already exist, they should be overwritten.

Delete: Engineering Analysis should delete the features contained in the XML. In this case, only the ObjectIDs of the features are included in the XML. The NetAdapterMspDeleteFilter.xsl style sheet is used to remove all fields except for the required objectID, owner and verb fields.

These verbs are assigned to each object contained in the XML. There is no difference in the content provided with the Change, New, and Dump verbs. As mentioned, if Delete is requested, no attribute information is included.

Property DefaultUtility: Every object in the MultiSpeak schema can have a "Utility" attribute, designating the owner of the object. If this property is provided, it is used as a default for the utility of every object. If a feature in the geodatabase is exported with a "Utility" or "Owner" attribute which is populated (non-null), then the attribute will be used in place of this property. If this property is not provided, and no attribute is set for an object, a "Utility" attribute will not be exported.