Geoportal Server Files

Esri Geoportal Server version 0.9 patch to invoke xsd schema validation

Introduction
ESRI® announces the Esri Geoportal Server 0.9 Patch to invoke xsd schema validation. This patch addresses an issue in Geoportal Server version 0.9 where xsd schema validation for metadata profiles are not invoked even when schemas are referenced in the definition.xml files.

Description: 
Fixes defect ID #3192509 (see http://sourceforge.net/tracker/?func=detail&aid=3192509&group_id=306452&atid=1291151).

In Geoportal Server version 0.9, xsd schema validation for metadata profiles is not invoked even when schemas are referenced in the definition.xml files (found in the \\geoportal\WEB-INF\classes\gpt\metadata subdirectories of the geoportal web application). The resulting behavior is that only the definition.xml file rules are used for validation, and xsd schema validation is not invoked.

This fix addresses the issue by enabling the xsd schema validation to be invoked if an xsd is referenced in the definition.xml files. Out of the box, an xsd is referenced in the following definition.xml files, although an xsd reference can be added to any of the definition.xml files in the geoportal web application: iso-19115-definition.xml, nap-iso-19115-definition.xml, and nap-iso-19119-definition.xml.

Files Installed in this Patch: 
Under the \\geoportal\WEB-INF\lib folder, the gpt-0.9-hf1.jar


Installing this Patch:
Esri Geoportal Server 0.9 must be installed before you can install this patch.

1. Stop your geoportal web application.

2. Download, save, and unzip the patch to a location local to your geoportal web application.

3. Navigate to the \\geoportal\WEB-INF\lib directory on the server hosting your geoportal.

4. Cut the gpt.jar file from this location, and paste it to a backup location. IMPORTANT: This gpt.jar file must not be present in the \\geoportal\WEB-INF\lib directory.

5. Navigate to the unzipped directory containing the patch file.

6. Copy the gpt-0.9-hf1.jar file from the unzipped directory to the \\geoportal\WEB-INF\lib directory.

7. Start your geoportal web application. From this point forward, the xsd validation will be applied when you publish resources to the geoportal.

NOTE: Once you've applied this patch, the geoportal will first evaluate a metadata document by the applicable definition.xml file validation rules, and next apply the rules according to the referenced xsd. Errors that appear in the Geoportal user interface as a result of a document failing xsd schema validation may not be as easy for the user to interpret as those displayed when the document fails the definition.xml validation rules.

For more information about how the Geoportal validates metadata, see the 'Process of creating a discoverable metadata document' section of the 'Add a Custom Profile' help topic http://sourceforge.net/apps/mediawiki/geoportal/index.php?title=Add_a_Custom_Profile#Process_of_creating_a_discoverable_metadata_document.