Hiding a metadata field (Bathymetry Solution)

Once you have created at least one BIS geodatabase, you can link bathymetry data to the BIS geodatabase and associate metadata to the bathymetry data.

ArcGIS for Maritime: Bathymetry allows you to add new metadata fields to or retire existing metadata fields from the Manage Collections and Add Bathymetry dialog boxes and the Explore Bathymetry and Compose Surface windows. In addition to adding and retiring fields, you can append a new selection to a drop-down menu and add validation rules to ensure the metadata values meet your business rule requirements.

In some cases, you may need to modify the visibility of a particular field associated with your BIS metadata to prevent it from being updated. The following steps provide an example of how to hide a metadata field in the Manage Collections dialog box, but you can follow these same steps to hide any metadata field that displays in Bathymetry Solution tool dialog boxes or windows.

These steps should be performed before you associate a BAG file to your BIS geodatabase, since your metadata field will not be hidden for any BAG files that have already been associated with a collection.

If you use multiple BIS geodatabases that require custom metadata, you will need to make changes to the metadata files for each of those BIS geodatabases.

You should make backups of your metadata XML files before making any major configuration changes. This will prevent you from jeopardizing the BIS tool functionality in ArcMap in the event of an XML formatting mistake. It is highly recommended that you place the metadata XML files in a networked or shared location so all BIS users can benefit from the configuration changes.

Note:

You must modify the XML file through a third-party XML editing application. Esri does not endorse or promote any particular XML editing or viewing application, but it is highly recommended that you choose an XML editing application with XML format validation. The tools will not function if your modifications result in an invalid XML format.

Steps:

1. Start ArcMap.
2. On the main menu, click Customize > Toolbars > Bathymetry.
3. Click the Manage BIS Settings button on the Bathymetry toolbar.

   The Manage BIS Settings dialog box appears. The settings for your active BIS geodatabases are shown in the dialog box.
4. Locate the Metadata settings location property.

   This is where the BisDatasetExtMetadataDef.xml, BisCollectionExtMetadataDef.xml, and ONSBagInternalMetadataDef.xml configuration files are stored. These are the files you will need to modify to configure the BIS metadata field display.

5. In Windows Explorer, navigate to your metadata settings location.
   Tip:

   Before performing the steps that follow, it is strongly recommended that you create a backup of your metadata XML file.

6. Open the metadata XML file with a third-party XML editing application.

   In this example, use BisCollectionExtMetadataDef.

7. Locate the title of the field you want to hide.

   For example, to hide the Survey Description, locate:

   title="Collection Description"
   

8. Locate the displayed attribute within the BisExtMetadataDefinitionField opening element and change the value to false.
   displayed="false"
   

   This attribute controls whether or not the field will be displayed on the window or dialog box. The false value hides the field.

   The modified element should look like this:

   <BisExtXmlMetadataDefinitionFields>
   <BisExtXmlMetadataDefinitionField xmlNodeName=”collectionDescription” title=”Collection Description” dataType=”xmlTypeString” required=”false” searchable=”true” displayed=”false”>
   </BisExtXmlMetadataDefinitionField>
   

9. Save the metadata XML file.
10. Close the third-party XML editing application.
11. Close ArcMap.
    Note:

    Metadata will not update dynamically within your ArcMap interface. You will need to close and restart ArcMap to see the applied changes.

12. Start ArcMap.
13. Click the Manage Collections button on the Bathymetry toolbar.

    The Manage Collections dialog box appears.

The field display will no longer show the field you hid.