Working with product configuration files

Configuring options are controlled in a product XML file. Although it is not necessary to have a full understanding of the XML specification to configure Nautical Solution, you might find it useful to review some of the basic concepts of XML.

Each product supported by Nautical Solution has its own product XML file with the same settings stored on each file. Although each file has the same configuration settings, not all product XML files are configured the same way by default. For example, the Nautical Information System (NIS) product XML has many of its import options set to true where the other products do not. Of course, you have the ability to change these settings based on your agency's or organization's needs.

All product XML files packaged in Nautical Solution adhere to the XML standards of the W3C XML working group. You can find the product XML files in the following location:

When you open the product XML file using a third-party application, you will see a number of elements and subelements containing different attribute values. The configuration settings are stored in the element attribute values, but not all the element attribute values are configurable. This document only covers the element attributes that you can update; the remaining element attributes should not be modified.

Since the product XML files are valid XML documents, you can modify them using any third-party XML editing application you are comfortable using. It is strongly recommended that you use an XML editing application that will autovalidate the XML format when you are making configuration edits to the file. This ensures that any modification you make to the XML file is interpreted by the nautical tools that reference it.

Verifying features when importing

The following Boolean element attribute value controls whether or not each feature imported by the S-57 to Geodatabase tool will have its VERIFIED field set to true:

<VERIFY value = "T"/>

When the attribute value is set to "T", the VERIFIED field controlled by the product's XML file configuration setting <COMMONFIELD name="VERIFIED" field="VERIFIED" /> is set to true on all imported features. The value of field controls what the attribute name is. In the NIS, it is set to NIS_VERIFIED.

By default, this attribute value is set to true for all product XML files, except for the NIS. The NIS_VERIFIED value is set to false. This means that data being loaded into the NIS must be verified before it can be committed to the SDE.DEFAULT version using Nautical Post.

Controlling the Relationship Manager's display fields

Relationship Manager shows features that participate in an S-57 relationship through a list view. This list view can be modified based on the following element attribute values:

<RELATIONSHIPDISPLAYFIELD primaryField="LNAM" secondaryField="FCSubtype" secondaryLength="6"/>

The primaryField attribute is the field that is listed first in the Relationship Manager's view, while the secondaryField attribute controls the field displayed in parentheses. The secondaryLength attribute combines the attribute down to the listed numeric value if necessary.

Relationship Manager

Configuring the S-57 to Geodatabase importing options

The S-57 to Geodatabase importing tool has a variety of options you can set before importing your S-57 cell into the geodatabase. Each option is contained under the S57IMPORTER\OPTIONS elements within the product XML files. Different products supported by Nautical Solution have their own importing configurations predefined. For example, an NIS product has many of these options set to true, while the Electronic Navigation Chart (ENC) and charting products have all these options set to false. In the following sections, the various options are described in full detail.

Copying spatial attributes to feature records

When you import an S-57 cell into the geodatabase, you can copy the QUAPOS and POSACC spatial attributes held on the vector records (VI, VC, and VE) to the associated feature records. For line and point feature records, the P_QUAPOS and P_POSACC fields store the QUAPOS and POSACC values, respectively, held on the vector records. For area features, if a segment of the area feature is linked to a vector edge that holds a spatial attribute value for QUAPOS and/or POSACC, that segment's geometry is copied to the PLTS_SpatialAttributeL linear feature class held within the geodatabase. The PLTS_SpatialAttributeL feature class maintains the QUAPOS and/or POSACC attribute values held on the vector edge. The following Boolean element attribute controls this functionality:

<OPTION name="CopySpatialAttributesToFeatures" value="F"/>

Set the value attribute to "T" if you want to copy all the spatial attributes to the feature records; otherwise, set the value to "F".

NoteNote:

If this option is set to true, you must also set the delete primitive data option to true.

Deleting primitives after the import process

You have the option of removing the spatial records that are imported into the PLTS_VectorIsolatedNodes, PLTS_VectorConnectedNodes, and PLTS_VectorEdges feature classes. The following Boolean element attribute controls this functionality:

<OPTION name="DeletePrimitiveData" value="F"/>

Set the value attribute to "T" if you want to remove all vector records after the import process, or set the value to "F" if you want to keep them.

Populating the scale band attribute while importing

You have the option to populate the PLTS_COMP_SCALE attribute with the applicable value based on where the feature lies within the cell. If the feature is completely contained by an M_CSCL meta feature, the PLTS_COMP_SCALE attribute is populated with the CSCALE attribute value held on M_CSCL. If the feature falls outside M_CSCL or is not completely contained by the meta object, PLTS_COMP_SCALE will have the CSCL value held on the DSPM table inserted. The following Boolean element attribute controls this functionality:

<OPTION name="PopulateScaleBand" value="F"/>

If you want to populate the PLTS_COMP_SCALE field during import, set the value attribute to "T"; otherwise, set the value to "F".

Splitting features while populating the scale band

If you elected to populate the PLTS_COMP_SCALE field during the import process, you can also choose to split any features that cross the M_CSCL meta features. This option ensures that all features crossing the meta feature will be fully contained by the M_CSCL, thus receiving the CSCALE value instead of the DSPM CSCL value. For example, if you have a DEPCNT feature that partially runs through an M_CSCL meta feature and you choose to split features during import, DEPCNT is split so that the portion of the DEPCNT feature within M_CSCL is a new DEPCNT feature. The original DEPCNT is preserved, but its length will have been modified due to the split operation. The following Boolean element attribute controls this functionality:

<OPTION name="SplitFeaturesDuringPopulateScaleBands" value="F"/>

Set the value attribute to "T" if you want to split features during the populate scale band process; otherwise, set the value to "F". There is no dependency on the populate scale band option described above.

NoteNote:

If this option is set to true, you must also set the delete primitive data option to true.

Removing the M_CSCL meta feature post import

You can automatically delete the M_CSCL meta feature once the import process has taken place by using the delete M_CSCL option. Populating the scale band and splitting features while populating the scale band, which hold dependencies on the M_CSCL meta feature, occur before this option. The following Boolean element attribute controls this functionality:

<OPTION name="DeleteMetadataCSCL" value="F"/>

Set the value attribute to "T" if you want to remove the M_CSCL meta feature; otherwise, set this value to "F" if you want the meta feature to remain.


4/19/2012