ESRI CSW Client Installation and USGIN Catalog Profile

Document Information
Document ID: 
app2010-016

ESRI Provides a CSW client that plugs into ArcMap.  The client can be used to browse and query ESRI Geoportal servers.  The spatial data query results can be displayed in ArcMap if the query results originate from a live data source.  Browse to http://www.esri.com/software/arcgis/geoportal/free-addons.html for instructions on how to download and install the CSW client.

The CSW client can be used to query the USGIN Geoportal.  The geoportal is currently a development version located on our development server.  The following list outlines the steps required to install the profile for the USGIN's development geoportal.

1. Install the ESRI CSW Client (http://www.esri.com/software/arcgis/geoportal/free-addons.html)

2. The CSW client installation process will install xml and xslt configuration files to C:\Program Files (x86)\ESRI\Geoportal\CswClients\Data, but once installed the client will look for those files in C:\Program Files\ESRI\Geoportal\CswClients\Data.  My suggestion is to copy all the files in C:\Program Files (x86)\ESRI\Geoportal\CswClients\Data to C:\Program Files\ESRI\Geoportal\CswClients\Data.  You might need administrator priviledges to copy the files.

3. Edit C:\Program Files\ESRI\Geoportal\CswClients\Data\CSWProfiles.xml and add the following xml segment after the opening <CSWProfiles> tag.

<!-- AZGS-USGIN -->
   <Profile>
      <ID>urn:ogc:CSW:2.0.2:HTTP:OGCCORE:USGIN:GPT</ID>
      <Name>USGIN - ArcGIS Server Geoportal Extension (GPT)</Name>
      <CswNamespace>http://www.opengis.net/cat/csw/2.0.2</CswNamespace>
      <Description />
      <GetRecords>

         <XSLTransformations>
            <!--<Request expectedGptXmlOutput="FULL_NATIVE_GPTXML">CSW_2.0.2_OGCCORE_ESRI_GPT_GetRecords_Request.xslt</Request>-->
            <Request expectedGptXmlOutput="DETAILED_GPT_CSW202">USGIN_GetRecords_Request.xslt</Request>
           
            <!--<Response>CSW_2.0.2_OGCCORE_ESRI_GPT_GetRecords_Response.xslt</Response>-->
            <Response>USGIN_GetRecords_Response.xslt</Response>
         </XSLTransformations>
      </GetRecords>
      <GetRecordByID>
         <RequestKVPs>
            <![CDATA[service=CSW&request=GetRecordById&version=2.0.2&ElementSetName=full&OutputSchema=http://www.isotc211.org/2005/gmd]]>
         </RequestKVPs>
         <XSLTransformations>
            <Response>USGIN_GetRecordByID_Response.xslt</Response>
            <!--<Response>CSW_2.0.2_OGCCORE_ESRI_GPT_GetRecordByID_Response.xslt</Response>-->
         </XSLTransformations>
      </GetRecordByID>
      <SupportSpatialQuery>True</SupportSpatialQuery>
      <SupportContentTypeQuery>True</SupportContentTypeQuery>
      <SupportSpatialBoundary>True</SupportSpatialBoundary>
   </Profile>

4. Save and close the file.

    Notice the line "<![CDATA[service=CSW&request=GetRecordById&version=2.0.2&ElementSetName=full&OutputSchema=http://www.isotc211.org/2005/gmd]]>"
    This line is a url requests paramater list.  The last key value pair (OutputSchema=http://www.isotc211.org/2005/gmd) tells the CSW client what output format to use to render the xml metadata record.

5. Copy USGIN_GetRecordByID_Response.xslt, USGIN_GetRecords_Request.xslt, USGIN_GetRecords_Response.xslt to C:\Program Files\ESRI\Geoportal\CswClients\Data.  You might need administrator priviledges to copy the files.

6. Start or re-start ArcMap and enable the CSW client

Start ArcMap, enable the CSW Client (Customize -> addin mnager)
Add the CSW Client button to a tool bar (Customize -> customize mode -> commands -> in "show commands containt" type csw
Drag CSW icon (binoculars) to any toolbar
Click binocular icon on tool bar

From ESRI GIS Portal Find Services interface:
1 click "Configure"
2 Catalog Service URL = http://debug.usgin.org/geoportal/csw/discovery?Request=GetCapabilities&Service=CSW&Version=2.0.2
3 Display name = [anything]
4 Click save button (blue floppy disk icon)
5 Click "Find" tab
6 "In Catalog" drop-down select name from step 3
7 Click "find" button
8 Select the "A Live Data Test"
9 Click "Add to Map" icon (icon with little green plus in lower right corner)
10 Map layers will be added to the legend list

Toggling layers can sometimes make all layers toggle off until the map re-renders.


Resources
Application Documents Description Document ID Posted by Update Ratingsort icon
CSW Client for ESRI ArcGIS Desktop and ArcExplorer ESRI offers CSW clients for ArcGIS Desktop and ArcExplorer as part of their free Geoportal add-ons.This client allows...
app2009-011 wgrunberg 12/28/2010 - 12:40pm
5
ArcMap Extension to Adjust for Invalid WMS 1.3.0 Requests PurposeThis extension was built to deal with a bug in ArcMap 9.3.1 which issues invalid WMS 1.3.0 GetMap requests....
Download the extension here
app2010-014 Ryan Clark 03/08/2010 - 12:08pm
0
CSW client application This is an ArcMap add-in application which can access the CSW Catalog Services to locate WMS services that can be added...
Click to download CSW Client
app2011-028 gchen 11/15/2011 - 7:57pm
0
The 2nd version of CSW Client application The only difference between this version and the previous version is that this version is using FGDC...
app2012-030 gchen 01/03/2012 - 4:00pm
0
Related Community Groups
Troubleshooting Web Service Deployment - Blog | 5 Posts | Join
This blog is for documenting our group's experiences with web service deployment.