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.
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.
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:
|