Collection and extended metadata XML schema

Collection metadata allows you to store metadata for a group of source datasets that belong to the same collection, while extended metadata allows you to store metadata that pertains to one source dataset. The collection and extended metadata XML schemas are almost identical. The examples below show the root element, which is the highest-level node in the XML file for both the BisCollectionExtMetadataDef.xml (collection metadata) and the BisDatasetExtMetadataDef.xml (extended metadata) metadata configuration files.

Caution:

While the information in this topic is useful for understanding your BIS metadata configuration, manual modification of the XML schema files is only recommended for advanced users of the BIS who are familiar with editing XML schemas. For most use cases, comprehensive editing functionality is provided by the Collection Metadata Configuration Editor or the Extended Metadata Configuration Editor available from the Manage BIS Settings window.

Collection metadata

<BisExtXmlMetadataDefinition metadataType="BisCollectionExt" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<BisExtXmlMetadataDefinitionFields>

Extended metadata

<BisExtXmlMetadataDefinition metadataType="BisDatasetExt" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<BisExtXmlMetadataDefinitionFields>

The only difference between the two root elements is the value of the metadataType attribute. The extended metadataType attribute is BisDatasetExt, while the Collection metadataType attribute is BisCollectionExt. If you need to modify the metadata XML files, do not alter the metadataType attribute values as these values determine the metadata fields and definitions displayed in ArcMap.

Caution:

It is strongly recommended that you use the Metadata Configuration Editor when making changes to the collection metadata or extended metadata configuration files unless you have a good understanding of editing XML documents. If you need to modify the files manually, make a backup copy of the files before making any changes. This will allow you to revert the changes if you corrupt the files.

Outside of the root element, the collection and extended XML schemas are the same.

The example below shows a breakdown of the element hierarchy in both the collection and extended metadata XML configuration files.

<BisExtXmlMetadataDefinition metadataType="" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<BisExtXmlMetadataDefinitionFields>
<BisExtXmlMetadataDefinitionField xmlNodeName=”” title=”” dataType=”” required=”” searchable=”” displayed=””>
<xmlDataRestriction restrictionType="">
</xmlDataRestriction>
</BisExtXmlMetadataDefinitionField>
</BisExtXmlMetadataDefinitionFields>
</BisExtXmlMetadataDefinition>

The following table summarizes the elements:

Element	Description
BisExtXmlMetadataDefinition	Root element that defines the type of metadata (collection or extended) using the metadata attribute, along with the generic namespaces for the XML schema and definition URLs.
BisExtXmlMetadataDefinitionFields	Single parent element for the BisExtMetadataDefinitionField that stores all of the metadata field definition information. Any custom fields added to the display must be stored in this element.
BisExtXmlMetadataDefinitionField	All of the field definitions are stored in this element as attributes. If you add a new field, you will need to construct this element in the BisExtMetadataDefinitionFields parent element and include all of the attributes defined in the schema.
xmlNodeName	A unique field identifier in the XML configuration file that should follow standard XML attribute naming conventions (no spaces, special characters, and so on).
title	The title displayed for the field in the Bathymetry Solution dialog boxes and windows.
dataType	The field’s data type.
required	A Boolean value that determines if the field is mandatory and must be populated on the dialog box or window.
searchable	A Boolean value that determines whether or not the field will be available in the Manage Collections dialog box and the Explore Bathymetry and Compose Surface windows as a field against which you can filter or create a rule.
displayed	A Boolean value that determines if the field will be displayed in any of the dialog boxes or windows that show the metadata fields. If the required attribute is mandatory (set to true), the displayed attribute must be true as well.
xmlDataRestriction	A single child element of the BisExtXmlMetadataDefinitionField that applies restrictions to the data type defined in the dataType attribute on the BisExtXmlMetadataDefinitionField. This element implements the restrictionType attribute.
restrictionType	Defines the data restriction based on the field's data type. The following is a list of each restriction type: RequiredWhenOtherIsNotNull LessThan LessThanOrEqual Equal GreaterThan GreaterThanOrEqual