Validate Metadata

Summary

Exports metadata to a standard metadata format then validates the exported file.

ArcGIS metadata can't be directly validated against a metadata standard's XML schema. This tool validates ArcGIS metadata by first exporting it to an XML file that is formatted to follow a metadata standard's XML schema using Export Metadata, then validating the exported file using XML Schema Validation. Only use this tool to validate ArcGIS metadata, not a stand-alone XML file that is already formatted correctly for a metadata standard's XML format.

Any validation errors and warnings will be reported in the tool's messages.

Usage

• Some XML Schemas require you to specify the XML namespace you want to validate, while others do not. If a value is provided in the Namespace URI parameter when none is required, any warnings or errors reported will be related to not finding the correct information in the XML Schema and won't identify whether the XML document is valid.

  For example, if you try to validate an XML document that follows the Federal Geographic Data Committee (FGDC) Content Standard for Digital Geospatial Metadata (CSDGM) using the XML Schema http://www.fgdc.gov/schemas/metadata/fgdc-std-001-1998.xsd, you should not provide a value in the Namespace URI parameter.

• When validating an XML document using a DTD, the name of the element that will be validated must be provided in the Namespace URI parameter. For example, if a DOCTYPE declaration were added to an XML document referencing an external DTD, that syntax might look like this: <!DOCTYPE metadata SYSTEM "http://www.fgdc.gov/schemas/metadata/fgdc-std-001-1998.dtd">. To validate an XML document using this same external DTD with this tool, you would provide the value http://www.fgdc.gov/schemas/metadata/fgdc-std-001-1998.dtd in the Schema URL parameter. Provide the name of the root element in the XML document in the Namespace URI parameter: metadata. The root element's content is validated.

• If the XML document being validated contains an embedded reference to an external XML Schema or XML DTD, that schema will not be used for validation. The schema to use for validation and the namespace or root element to validate must be explicitly specified in this tool's Schema URL and Namespace URI parameters.

• Specify an output file if you want to keep the exported metadata file. For example, after checking that the exported file validated successfully you might publish it to a metadata catalog.

• The output files produced by this tool can't be stored in a geodatabase. If the Current_workspace environment is set to a geodatabase, the output files will be stored in a different location, as described below.

  • If Current_workspace is set to a file or personal geodatabase, the output files will be stored in the folder in which the geodatabase is stored.
  • If Current_workspace is set to an enterprise or workgroup geodatabase, the output files will be stored in the location defined by the system TEMP environment variable.

Syntax

ValidateMetadata_conversion (Source_Metadata, Translator, Schema_URL, {Namespace_URI}, Output_File)

Parameter	Explanation	Data Type
Source_Metadata	The item whose metadata will be validated or a stand-alone XML file that will be validated.	Data Element; Layer
Translator	An XML file that defines the conversion that will be performed. The translator files provided with ArcGIS Desktop can be found in the <ArcGIS Installation Location>\Metadata\Translator folder. The following translators are provided: ARCGIS2FGDC.xml —Translates content stored in the ArcGIS metadata format to the FGDC CSDGM XML format. This translator is used by default when you export metadata from the Description tab using the FGDC CSDGM Metadata style. Metadata is converted using an XSLT transformation and won't produce a log file. ARCGIS2ISO19139.xml —Translates content stored in the ArcGIS metadata format to the ISO 19139 XML format. This translator is used by default when you export metadata from the Description tab using any of the ISO-based metadata styles. It is the preferred translator for exporting metadata to the ISO 19139 XML format. Metadata is converted using an XSLT transformation and won't produce a log file. ESRI_ISO2ISO19139.xml —Translates content stored in either the ArcGIS metadata format or the ESRI-ISO metadata format to the ISO 19139 XML format. This translator is provided for backward compatibility to support existing models and Python scripts. It has some known limitations with exporting metadata to the ISO 19139 XML format. Use the ARCGIS2ISO19139.xml translator instead. Metadata is converted using the Esri Metadata Translator tool's translation engine and produces a log file containing messages produced by the translation engine. FGDC2ESRI_ISO.xml —Translates content stored in the FGDC CSDGM XML format to the ArcGIS metadata format; that is, it translates metadata content that is visible under the FGDC Metadata (read-only) heading on the Description tab. This translator is used when you import FGDC-formatted metadata by running the Import Metadata tool with the FROM_FGDC type and when you upgrade metadata by running the Upgrade Metadata tool with the FGDC_TO_ARCGIS type. Metadata is converted using the Esri Metadata Translator tool's translation engine and produces a log file containing messages produced by the translation engine. FGDC2ISO19139.xml —Translates content stored in the FGDC CSDGM XML format to the ISO 19139 XML format; that is, it translates metadata content that is visible under the FGDC Metadata (read-only) heading on the Description tab. Metadata is converted using the Esri Metadata Translator tool's translation engine and produces a log file containing messages produced by the translation engine. ISO19139_2ESRI_ISO.xml —Translates content stored in the ISO 19139 XML format to the ArcGIS metadata format. This translator is used when you import ISO 19139-formatted metadata by running the Import Metadata tool with the FROM_ISO_19139 type. Metadata is converted using the Esri Metadata Translator tool's translation engine and produces a log file containing messages produced by the translation engine.	File
Schema_URL	The XML Schema or XML DTD that describes the structure and content of a valid XML document.	String
Namespace_URI (Optional)	The XML namespace that will be validated for an XML Schema, if appropriate, or the root element of the document for an XML DTD. If this value is inappropriate for the XML Schema being used, use the pound sign (#) instead of a namespace URI.	String
Output_File	A stand-alone XML file that will be created containing the converted metadata.	File

Code sample

Validate metadata for an ArcGIS item

Exports ArcGIS metadata to an XML file and validates the exported file using an XML Schema.

import arcpy
from arcpy import env
env.workspace = "C:/data"
#set local variables
dir = arcpy.GetInstallInfo("desktop")["InstallDir"]
translator = dir + "Metadata/Translator/ESRI_ISO2ISO19139.xml"
schema = "http://www.isotc211.org/schemas/2005/gmd/metadataEntity.xsd"
namespace = "http://www.isotc211.org/2005/gmd"
arcpy.ValidateMetadata_conversion ("vegtype.dbf", translator, schema,
    namespace, "vegtype_19139.xml")

Environments

• Current Workspace

Licensing information

• ArcGIS Desktop Basic: Yes
• ArcGIS Desktop Standard: Yes
• ArcGIS Desktop Advanced: Yes