Configuring the XML builder

The XML builder operates from XML data based on the XMLBuilderDiagram XML Schema Definition file. This XML data can come from input files that are specified at the diagram generations/updates, but they can also be automatically generated in memory using an external component. The content of the diagram generated from the same XML data can then be different depending on the properties that have been configured on the XML properties page.

The steps below focus on the configuration of the XML Builder Properties page.

The first time the XML Builder Properties page displays, the Builder Properties dialog box opens as follows:

XML Builder Property Page default state
The XML Builder Property Page tab is organized into four sections:

Etapes :
  1. If the XML data in input from which the schematic diagrams content will be generated are automatically built by an external component, type the ProgID of the COM class that will be used to generate this XML data in the Generate box.

    The ProgID is the string composed of the project name and the class name of the coclass.

    AttentionAttention :

    The specified class must implement the ISchematicXMLGenerate interface of the esriSchematicUI.olb component.

    RemarqueRemarque :

    When this Generate parameter is not specified, users will have to browse to and select the desired input XML file at the beginning of the diagram generation.

  2. If the XML data in input on which the schematic diagrams content will be updated is automatically built by an external component; type the ProgID of the COM class that will be used to update this XML data in the Update box.

    The ProgID is the string composed of the project name and the class name of the coclass.

    AttentionAttention :

    The specified class must implement the ISchematicXMLUpdate interface of the esriSchematicUI.olb component.

    RemarqueRemarque :

    When this Update parameter is not specified, users will have to browse to and select the desired input XML file at the beginning of the diagram update.

  3. Check Initialize links vertices on the Geometry options section if you want the XML builder to build schematic diagrams in which the schematic links will display with vertices when the Vertices items exist in the input XML data.

    When this check box is unchecked, schematic links will be drawn as straight lines between the end points even if the Vertices items exist in the input XML data.

  4. Check Automatic schematic feature class creation on the Miscellaneous section if you want the XML builder to automatically create a schematic feature class for managing the different SchematicFeatureClass items found in the input XML data when such a schematic feature class doesn't already exist for the schematic diagram template.

    When this check box is unchecked (default state), no new schematic feature class is created when the XML builder operates. For example, if in the input XML data, there are SchematicFeatureClass items whose value is Stations, and there is no schematic feature class for the schematic diagram template to manage these SchematicFeatureClass items, no schematic features will be included in the generated diagram for these XML items.

    RemarqueRemarque :

    Checking this check box also allows the XML builder to automatically create PropertySet attributes when PropertySetProperty items are detected in the input XML data for any LinkFeature or NodeFeature item managed by a schematic feature class, and those attributes don't already exist for that schematic feature class. If it is unchecked and PropertySetProperty items are detected without the related PropertySet attributes exists, this information will be ignored.

  5. If the FeatureClassName items in the input XML data don't match the names of the schematic feature classes associated with the diagram template, you must specify correspondence rules in the Schematic feature class mapping section.

    If you want all FeatureClassName items whose value is FeatureClassNameN_InXMLFile in the input XML file to automatically match the schematic feature class associated with the schematic diagram template whose name is SchematicFeatureClassNameN_ForSchDiagTemp, you must specify the Schematic feature class mapping section as follows:

    FeatureClassNameN_InXMLFile=SchematicFeatureClassNameN_ForSchDiagTemp
    
    When there are different FeatureClassName items in the input XML file for which you want to specify the associated schematic feature class name, you must specify a mapping rule per line as in the following example:
    FeatureClassName1_InXMLFile=SchematicFeatureClassName1_ForSchDiagTemp
    FeatureClassName2_InXMLFile=SchematicFeatureClassName2_ForSchDiagTemp
    FeatureClassNameN_InXMLFile=SchematicFeatureClassNameN_ForSchDiagTemp

    A script can also be set in this section to dispatch items in the input XML data that are all related to a particular FeatureClassNameK_InXMLFile FeatureClass item into several SchematicFeatureClassNameN_ForSchDiagTemp schematic feature classes. For example, when specifying the following script:

    Stations=StationsFeeder1 (Feeder="1")
    Stations=StationsFeeder2 (Feeder="2")
    Stations=StationsFeeder3 (Feeder="3")
    The StationsFeeder1, StationsFeeder2, and StationsFeeder3 schematic feature classes will be automatically used for the Stations FeatureClass XML items where the Feeder PropertySetProperty value is 1, 2, or 3, respectively.

Rubriques connexes


7/10/2012