Skip to content

Geoportal CSW Clients

Jump to bottom
mhogeweg edited this page Dec 14, 2012 · 6 revisions

Table of Contents

Download

Introduction

The CSW Clients bring geoportal discovery functionality into your ArcMap and ArcGIS Explorer applications. They enable searching OGC Catalog Service for the Web (CS-W) catalogs directly through ArcMap and ArcGIS Explorer. Once resources are returned, they can be viewed or downloaded. Additionally, if the resources are live services they can be added to the ArcMap document or ArcGIS Explorer Globe. In ArcMap, there are additional functionalities that allow users to preview the resource's spatial extent. To learn more about how the Geoportal Server uses CS-W, please see Geoportal Catalog Service. Information on installing, using, and customizing the CSW Clients is found in the sections below.

Note: The CSW Client for ArcGIS Explorer is compatible with ArcGIS Explorer versions 1200, 1500, & 1700.

Install the CSW Clients for ArcGIS

Steps to install

  • Download the CSW Client that corresponds to your ArcGIS version and unzip the file.
  • Run the setup.exe for the CSW Clients.
  • Follow the instructions in the setup wizard. The installer will give you the option of a complete or custom install. A custom install allows you to choose if you want to install the CSW Clients for both ArcMap and ArcGIS Explorer, or just one of the two.
  • During installation, the installer checks for the presence of the ArcGIS .NET framework. If the .NET Framework is not found, the CSW Client for ArcGIS Desktop will not be installed. However, installation will continue for CSW Client for ArcGIS Explorer, and a dialog box will appear notifying you of the installation status.

Add the CSW Client to ArcMap

  • Start ArcGIS Desktop. The CSW Client is used with the ArcMap component of ArcGIS Desktop.
  • Click Customize > Customize Mode. The Customize window appears.
  • Click the Commands tab in the Customize window.
  • Scroll down through the list of Commands and select Geoportal. The CSW Client icon csw_client_icon.png will appear in the Commands window on the right.
  • Drag the CSW Client icon to any empty space on any toolbar in ArcMap that you wish.
  • Close the Customize window.

Add the CSW Client to ArcGIS Explorer

  • Open the ArcGIS Explorer application.
  • At the top of the application, click on the ArcGIS Explorer button in the top left corner. A menu displays.
  • Click on the ArcGIS Explorer Options button. The ArcGIS Explorer Options window appears.
  • Click Resources from the menu on the left. The screen to the right populates with several headings. Click the Add-Ins button to the right of the Manage Add-Ins heading.
  • Another window opens where you can view and manage Add-Ins. Click the Add button to the right of the window, and browse to the CSW Clients file named CSWSearchDockWindow.eaz. The default installation location for this file is C:\Program Files\ESRI\Geoportal\CSWClients .
  • Click Open to load the CSWSearchDockWindow.eaz add-in.
  • When you close the Add-In dialog, you may be prompted to restart your ArcGIS Explorer application. After it restarts, the CSW Client will always be available by default unless you choose to remove it from the Add-Ins list.
  • Access the CSW Client by clicking the Add-In tab at the top of the ArcGIS Explorer application.
The CSW Client is now ready to be used. Read the section below for how to use the CSW Client, and The CswClient.log file for the CSW Clients for information about logging.

Use the CSW Clients for ArcGIS

The CSW Clients are used the same way in both ArcMap and ArcGIS Explorer. How to search a catalog for resources, view metadata, download metadata, and add a resource to the map are described below. In ArcMap, click the CSW Client csw_client_icon.png button to open the tool. In ArcGIS Explorer, select the Add-Ins tab, and select CSW Client to open the task.

Search a Catalog

To conduct a search:

  • Click on the Find tab.
  • Type a term in the Find text box.
Note: If you do not input search criteria, the maximum results that can be retrieved is 100. If you attempt to retrieve more than 100, you will get a "no results found" message.
  • Choose one of the catalog services from the In Catalog dropdown menu. To configure additional catalogs, see #How to Configure Additional Catalogs.
  • Enter parameters to further refine your search (optional). Search parameters are described below.
    • Live Data and Maps Only: The search can be limited to live service resources by checking the Live Data and Maps Only checkbox. Live services can be added to the ArcMap or ArcGIS Explorer document as a layer.
Note: If you have not input a search term but you do check the Live Data and Maps Only box, it is possible to retrieve more than 100 records because the search query is then populated with a search parameter, content type = live service.
    • Maximum: To limit the number of records returned in the search results, change the value in the Maximum box. The limit is 500 when search parameters are input, and 100 for a search with no parameters.
    • Use Current Extent (ArcMap only): If an extent is already defined in the ArcMap document window, this box can be checked and the CSW Client will only retrieve results that fall into the defined extent. Some CSW service URLs do not enable extent requests, so this may affect the number of results returned.
  • Click the Find button to execute the search. Results are returned in the Results window. For each result resource returned, the Abstract window will display the abstract information for the selected resource if abstract information is provided in its metadata.

Use Search Results

Notice the tools located above the Results window. There are seven buttons that display, representing functionality related to the search results. Each button's associated functionality is described below.

  • The View Metadata tool view_metadata.png will open the resource's metadata document as XML in a new window.
  • The Download Metadata tool download_metadata.png allows the resource's metadata XML to be downloaded and saved.
  • The Add to Map tool addtomap.png will add the service described by the resource to the map or globe as a new layer. This button will be grayed out unless the resource has a content type of "Live Data and Maps". If you click the Add to Map button and no data is added to the map, it is possible that the resource's metadata does not include service information. In order to display the live service, service connection information must be provided in the metadata xml for that resource.
The next four buttons are related to the display of a resource's spatial footprint in the current map window. The extent shown in the footprint corresponds to the bounding box defined in the resource's metadata.
  • The Display Footprint tool will show the extent of the selected resource overlaid on the map document.
  • The Zoom to Footprint tool zoom_footprint.png will zoom to the extent of the selected resource. This is especially useful if the extent is a small region or the basemap uses a different projection.
  • The Show All Footprint tool show_footprint.png will add all the footprints in the Results window to the map at once. To hide them, click the same button again.
  • The Clear All Footprint tool clear_footprint.png will remove all footprints that have been added to the map.
Use these tools to view resource metadata, download it, and add the service or its footprint to the map or globe.

How the CSW Clients Work

The CSW Clients need three pieces of information in order to retrieve records from a catalog service for display in ArcMap or ArcGIS Explorer.

  1. A GetCapabilities URL to the catalog: This is input in the Catalog Service URL field on the Configure tab of the CSW Clients. The GetCapabilities URL provides the catalog endpoint to which the CSW Clients send the search request and from which they receive the response.
  2. Search criteria: This is entered into the fields on the Find tab of the CSW Clients. Search criteria define what resources are returned by the CSW Clients. Search criteria act as filters, such as filtering by a search term, if data should be Live Data only, and the maximum number of search results returned.
  3. A catalog profile: The catalog service's profile is selected from a dropdown menu on the Configure tab of the CSW Clients. The catalog profile designation indicates to the CSW Clients which profile the catalog service uses. The mapping between the catalog service and its profile is defined in a file called CSWCatalogs.xml. This file is updated each time a new catalog is configured with the CSW Clients Configure tab. The CSW Clients reference CSWCatalogs.xml to find out what profile the catalog uses. The list of available profiles is defined in another file, CSWProfiles.xml. The profile will indicate which xslt files will be used to formulate requests between the CSW Clients and the catalog.
The CSW Clients maintain a list of supported profiles in a file called CSWProfiles.xml. Navigate to the \\CSWClients\Data directory and open the CSWProfiles.xml file. Notice that for each profile in the list, there are three xslt files referenced: GetRecords_Request, GetRecords_Response, and GetRecordByID_Response. These three xslt's transform requests and responses to and from the catalog service for interaction with the ArcMap or ArcGIS Explorer interface. An excerpt from the CSWProfiles.xml file, showing the ArcGIS Server Geoportal Extension profile, is shown below. 
 <Profile>
 <ID>urn:ogc:CSW:2.0.2:HTTP:OGCCORE:ESRI:GPT</id> 
 <Name>ArcGIS Server Geoportal Extension</name>
 <CswNamespace>http://www.opengis.net/cat/csw/2.0.2</cswnamespace> 
 <Description /> 
 <GetRecords>
 <XSLTransformations> 
 <Request>CSW_2.0.2_OGCCORE_ESRI_GPT_GetRecords_Request.xslt</request>
 <Response>CSW_2.0.2_OGCCORE_ESRI_GPT_GetRecords_Response.xslt</response>
 </xsltransformations>
 </getrecords>
 <GetRecordByID> 
 <RequestKVPs>
 <![CDATA[service=CSW&request=GetRecordById&version=2.0.2&ElementSetName=full]]> 
 </requestkvps>
 <XSLTransformations> 
 <Response>CSW_2.0.2_OGCCORE_ESRI_GPT_GetRecordByID_Response.xslt</response>
 </xsltransformations> 
 </getrecordbyid> 
 <SupportSpatialQuery>True</supportspatialquery>
 <SupportContentTypeQuery>True</supportcontenttypequery> 
 <SupportSpatialBoundary>True</supportspatialboundary> 
 </profile></code>

Flow of information using the xslt's

Conceptually, there are three spaces of interaction when using the CSW Clients: the CSW Clients user interface (UI), the CSW Clients translation activity, and the catalog service with which the CSW Clients interact. Interactions take place when the user initiates a search using the CSW Clients and when the user initiates communication with the catalog service using the CSW Clients' View Metadata, Download Metadata, Add to Map, and View Footprint buttons. The three diagrams below show how the UI, the CSW Clients translation activity, and the catalog service interact to carry out search and display of metadata information in ArcMap or ArcGIS Explorer.

Initial Request to a Service

The initial communication flow for the CS-W request and response is shown in the diagram below, and an explanation of the numbered steps follows.

initial_communication_csw.png

  • 1. When a user clicks the Find button for the CSW Clients, the CSW Clients references the CSWCatalogs.xml file to find the corresponding profile for that catalog service. The corresponding profile determines which GetRecordsRequest, GetRecordsResponse, and GetRecordByID_Response files will be used. Then, the CSW Clients create a generic xml. The generic xml looks like this:



Look closely at what information is being transferred in this piece of code. Each bit of information corresponds to what is input into the CSW Clients UI. In the GetRecords element, there is an attribute telling how many records should be retrieved - maxRecords, and in this example, ten records will be returned. There is an element defining the search term that is input - PropertyName AnyText, and in this example the search term is 'wms'. Then there is a parameter for retrieving the content type of the document, if available - PropertyName Format, and in this example, records to be retrieved should be liveData (the Live Data and Maps Only checkbox in the UI).
Note: There can be additional parameters in this generic xml for spatial extent, ISO Topic Category, and Modified Date. The parameters for ISO Topic and Modified Date are for use within the geoportal web application alone, and do not need to be specified for use with the CSW Clients.









    

  • 
2.The CSW Clients interpret the generic XML, and applies a transformation according to the GetRecords_Request.xslt that translates the generic XML into a CS-W GetRecordsRequest so the catalog service can interpret the search criteria.
    • 

  • 
3.The transformed xml is passed as a GetRecordsRequest to the catalog service.
    • 

  • 
4.The catalog service responds with a list of records that match the search criteria, formatted in CS-W syntax.
    • 

  • 
5.The CSW Client applies the GetRecords_Response.xslt to translate the catalog service response into resulting records for display by the CSW Client interface. Abstract, Footprint information for the Footprint buttons, and if the records are Live Data are also returned for each record.
    • 




View Metadata and Download Metadata buttons





For the View Metadata and Download Metadata buttons, the CSW Clients do not need to apply stylesheets to interpret user input or display the catalog service's response. Instead, the CSW Clients use the catalog service's native GetRecordById requests and responses to retrieve the metadata. This communication flow is shown in the diagram below, and an explanation of the numbered steps follows.



view_download_communication_csw.png







    

  1. When a user clicks the View Metadata or Download Metadata buttons, the CSW Clients request the full metadata document for the record using the catalog service's innate GetRecordById request defined in its GetCapabilities.
    2. 

  2. The catalog service responds with a GetRecordById response, and the full metadata is returned to the user interface.
    3. 




Add to Map button





An additional transformation, called the GetRecordByID_Response.xslt, comes into play when the user clicks the Add to Map button. The communication flow is shown in the diagram below, and an explanation of the numbered steps follows.



get_record_by_id_csw.png








    

  1. When a user clicks the Add to Map or Add Footprints button, the CSW Clients retrieve the GetRecordByID response from the catalog service.
    2. 

  2. The CSW Clients then apply the GetRecordByID_Response.xslt to the response to extract the URL that is used for the live service.
    3. 

  3. The URL is then sent to the user interface for Add to Map, or the footprint of the metadata as defined by the envelope information in the metadata.
    4. 




How to Configure Additional Catalogs






The CSW Clients are preconfigured to search Geospatial OneStop - the GOS2 OGC Core catalog in the search interface - by default. But if you want to search a different catalog service than Geospatial OneStop, it is possible by registering the catalog service in the CSW Clients' Configure tab.





How to register a catalog service for use in the CSW Clients










    

  • Start by clicking the Configure tab. On this tab you will see three input fields and three buttons. You will enter information into these fields that define the connection to the catalog service and provide the name for the service in the user interface.
    • 

  • Click the New button new_csw_profile.png to clear the form for your new catalog service entry.
    • 

  • In the Catalog Service URL input box, type the GetCapabilities URL of the service you wish to add. If you are registering your Geoportal Server catalog service, the format for the URL will be similar to the following:
    • 



 <code>http://serverName/geoportal/csw/discovery?Request=GetCapabilities&Service=CSW&Version=2.0.2</code>











    

  • In the Profile drop-down list, specify the profile that the catalog service uses. It is sometimes possible to find this information by pasting the GetCapabilities URL in a web browser and reading the resulting response for clues. If you cannot determine the profile from looking at the GetCapabilities response, you may have to contact the catalog service's host organization and ask about the profile. If you are registering a Geoportal Server catalog service, the profile will be the ArcGIS Server Geoportal Extension profile. If the catalog service uses a profile that is not in the default dropdown list, you can add the profile. See #How to Author and Add a New Profile for instructions.
    • 

  • Provide a display name for the catalog service by typing a name in the Display Name field.
    • 

  • Click the Save button save_csw_profile.png to add the new catalog to the catalog list.
    • 

  • Now, activate the Find tab. Your newly registered catalog service should appear in the In Catalog drop-down list.
    • 




How to update an existing catalog service from the list











    

  • Click the Configure tab.
    • 

  • Highlight the catalog service that is going to be updated in the Catalogs list. The Catalog Service URL, Profile, and Display Name will be loaded into the interface.
    • 

  • Make your changes to these fields.
    • 

  • Click the Save button.
    • 




How to delete an existing catalog service from the list











    

  • Click the Configure tab.
    • 

  • Highlight the catalog service that you want to delete from the registered catalog list.
    • 

  • Click the Delete button delete_csw_profile.png.
    • 

  • The system will display a confirmation dialog box. Click Yes to confirm the delete.
    • 




How to Author and Add a New Profile





If you want to register a catalog service that does not use one of the profiles that the CSW Clients provide by default, then you will need to author the three xslt's used for retrieving the search results and extracting the URL used to add live data to the map. These three files were referenced in the #How the CSW Clients Work section. After authoring these three xslt files, you must reference them with a new profile entry in the CSWProfiles.xml file. The section below provides details about how to author each xslt, and then how to add the reference to the CSWProfiles.xml file.





Author the GetRecords_Request.xslt





Remember that the CSW Clients apply a transformation that translates the generic XML from the CSW Clients user interface into a CS-W GetRecordsRequest that the catalog service can interpret. The code snippet below shows a generic GetRecords_Request.xslt with annotation in the commented sections describing details for important parts of the file. Copy this text into a text editor such as Notepad, and make the adjustments described in the comments.



 <code>
 <?xml version="1.0" encoding="UTF-8"?>
 <xsl:stylesheet version="1.0"
 xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
 <xsl:output method="xml" indent="no" encoding="UTF-8"
 omit-xml-declaration="yes"/>
 <xsl:template match="/">
 <xsl:element name="csw:GetRecords"
 use-attribute-sets="GetRecordsAttributes"
 xmlns:csw="http://www.opengis.net/cat/csw/2.0.2"
 xmlns:ogc="http://www.opengis.net/ogc"
 xmlns:dc="http://purl.org/dc/elements/1.1/"
 xmlns:gml="http://www.opengis.net/gml">
 <csw:Query typeNames="csw:Record">
 <csw:ElementSetName>full</csw:elementsetname>
 <csw:Constraint version="1.0.0">
 <ogc:Filter xmlns="http://www.opengis.net/ogc">
 <ogc:And>
 
   
 <xsl:apply-templates select="/GetRecords/KeyWord"/>
   
 <xsl:apply-templates select="/GetRecords/LiveDataMap"/>
   
 <xsl:apply-templates select="/GetRecords/Envelope"/>
   
 <xsl:call-template name="tmpltDate"/>
 </ogc:and>
 </ogc:filter>
 </csw:constraint>
 </csw:query>
 </xsl:element>
 </xsl:template>
  
 <xsl:template match="/GetRecords/KeyWord"
 xmlns:ogc="http://www.opengis.net/ogc">
 <xsl:if test="normalize-space(.)!=''">
 <ogc:PropertyIsLike wildCard="" escape=""
 singleChar="">
 <ogc:PropertyName>AnyText</ogc:propertyname>
 <ogc:Literal>
 <xsl:value-of select="."/>
 </ogc:literal>
 </ogc:propertyislike>
 </xsl:if>
 </xsl:template>
 
 <xsl:template match="/GetRecords/LiveDataMap"
 xmlns:ogc="http://www.opengis.net/ogc">
 <xsl:if test="translate(normalize-space(./text()),'true',
 'TRUE') ='TRUE'">
 <ogc:PropertyIsEqualTo>
 <ogc:PropertyName>Format</ogc:propertyname>
 <ogc:Literal>liveData</ogc:literal>
 </ogc:propertyisequalto>
 </xsl:if>
 </xsl:template>
 
 <xsl:template match="/GetRecords/Envelope"
 xmlns:ogc="http://www.opengis.net/ogc">
 
 <xsl:if test="./MinX and ./MinY and ./MaxX and ./MaxY">
 <ogc:BBOX xmlns:gml="http://www.opengis.net/gml">
 <ogc:PropertyName>Geometry</ogc:propertyname>
 <gml:Box
 srsName="http://www.opengis.net/gml/srs/epsg.xml#4326">
 <gml:coordinates>
 <xsl:value-of select="MinX"/>,<xsl:value-of
 select="MinY"/>,<xsl:value-of
 select="MaxX"/>,<xsl:value-of select="MaxY"/>
 </gml:coordinates>
 </gml:box>
 </ogc:bbox>
 </xsl:if>
 </xsl:template>
 
 <xsl:template name="tmpltDate"
 xmlns:ogc="http://www.opengis.net/ogc">
 <xsl:if
 test="string-length(normalize-space(/GetRecords/FromDate/text()))
 &gt; 0">
 <ogc:PropertyIsGreaterThanOrEqualTo>
 <ogc:PropertyName>Modified</ogc:propertyname>
 <ogc:Literal><xsl:value-of
 select="normalize-space(/GetRecords/FromDate/text())"/>
 </ogc:literal>
 </ogc:propertyisgreaterthanorequalto>
 </xsl:if>
 <xsl:if
 test="string-length(normalize-space(/GetRecords/ToDate/text()))
 &gt; 0">
 <ogc:PropertyIsLessThanOrEqualTo>
 <ogc:PropertyName>Modified</ogc:propertyname>
 <ogc:Literal><xsl:value-of
 select="normalize-space(/GetRecords/ToDate/text())"/></ogc:literal>
 </ogc:propertyislessthanorequalto>
 </xsl:if>
 </xsl:template>
 <xsl:attribute-set name="GetRecordsAttributes">
 <xsl:attribute
 name="version">2.0.2</xsl:attribute>
 <xsl:attribute name="service">CSW</xsl:attribute>
 <xsl:attribute
 name="resultType">RESULTS</xsl:attribute>
 <xsl:attribute name="startPosition">
 <xsl:value-of select="/GetRecords/StartPosition"/>
 </xsl:attribute>
 <xsl:attribute name="maxRecords">
 <xsl:value-of select="/GetRecords/MaxRecords"/>
 </xsl:attribute>
 </xsl:attribute-set>
 </xsl:stylesheet></code>




When you have finished editing the text, save the file as GetRecords_Request.xslt.





Author the GetRecords_Response.xslt





Remember that the CSW Clients apply a transformation that translates the catalog service response to the submitted search criteria into resulting records for display by the CSW Client interface. The code snippet below shows a generic GetRecords_Response.xslt with annotation in the commented sections describing details for important parts of the file. Copy this text into a text editor and make the adjustments described in the comments. Note that where specific metadata elements are referenced in select statements in this example, you need to verify the metadata schema that your catalog service uses and that the selected elements comply with that schema. For example, in the  element below, the example shows that the dc:identifier element will be selected. This is correct if the catalog service's response is based on Dublin Core. But if your catalog service's response is based on ISO 19139, the  element's select statement should be changed to gmd:fileIdentifier/gco:CharacterString instead.



 <code>
 <?xml version="1.0" encoding="UTF-8"?>
 <xsl:stylesheet version="1.0"
 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
 xmlns:csw="http://www.opengis.net/cat/csw/2.0.2"
 xmlns:dct="http://purl.org/dc/terms/"
 xmlns:ows="http://www.opengis.net/ows"
 xmlns:dc="http://purl.org/dc/elements/1.1/"
 exclude-result-prefixes="csw dc dct ows">
 <xsl:output method="xml" indent="no" encoding="UTF-8"
 omit-xml-declaration="yes" />
 <xsl:template match="/">
 <xsl:choose>
 
 <xsl:when test="/ows:ExceptionReport">
 <exception>
 <exceptionText>
 <xsl:for-each
 select="/ows:ExceptionReport/ows:Exception">
 <xsl:value-of select="ows:ExceptionText"/>
 </xsl:for-each>
 </exceptiontext>
 </exception>
 </xsl:when>
 <xsl:otherwise>
 <Records>
 <xsl:attribute name="maxRecords">
 <xsl:value-of
 select="/csw:GetRecordsResponse/csw:SearchResults/@numberOfRecordsMatched"/>
 </xsl:attribute>
 <xsl:for-each
 select="/csw:GetRecordsResponse/csw:SearchResults/csw:Record |
 /csw:GetRecordsResponse/csw:SearchResults/csw:BriefRecord |
 /csw:GetRecordByIdResponse/csw:Record |
 /csw:GetRecordsResponse/csw:SearchResults/csw:SummaryRecord">
 <Record>
 <ID>
 <xsl:choose>
 <xsl:when
 test="string-length(normalize-space(dc:identifier[@scheme='urn:x-esri:specification:ServiceType:ArcIMS:Metadata:DocID']/text()))
 > 0">
 <xsl:value-of
 select="normalize-space(dc:identifier[@scheme='urn:x-esri:specification:ServiceType:ArcIMS:Metadata:DocID'])"/>
 </xsl:when>
 <xsl:otherwise>
 <xsl:value-of select="normalize-space(dc:identifier)"/>
 </xsl:otherwise>
 </xsl:choose>
 </id>
 <Title>
 <xsl:value-of select="dc:title"/>
 </title>
 <Abstract>
 <xsl:value-of select="dct:abstract"/>
 </abstract>
 <Type>
 <xsl:value-of select="dc:type"/>
 </type> 
 <LowerCorner>
 <xsl:value-of
 select="ows:WGS84BoundingBox/ows:LowerCorner"/>
 </lowercorner>
 <UpperCorner>
 <xsl:value-of
 select="ows:WGS84BoundingBox/ows:UpperCorner"/>
 </uppercorner>
 <MaxX>
 <xsl:value-of
 select="normalize-space(substring-before(ows:WGS84BoundingBox/ows:UpperCorner,
 ' '))"/>
 </maxx>
 <MaxY>
 <xsl:value-of
 select="normalize-space(substring-after(ows:WGS84BoundingBox/ows:UpperCorner,
 ' '))"/>
 </maxy>
 <MinX>
 <xsl:value-of
 select="normalize-space(substring-before(ows:WGS84BoundingBox/ows:LowerCorner,
 ' '))"/>
 </minx>
 <MinY>
 <xsl:value-of
 select="normalize-space(substring-after(ows:WGS84BoundingBox/ows:LowerCorner,
 ' '))"/>
 </miny>
 <ModifiedDate>
 <xsl:value-of select="./dct:modified"/>
 </modifieddate>
 
 <References>
 <xsl:for-each select="./dct:references">
 <xsl:value-of select="."/>
 <xsl:text>&#x2714;</xsl:text>
 <xsl:value-of select="@scheme"/>
 <xsl:text>&#x2715;</xsl:text>
 </xsl:for-each>
 </references>
 
 <Types>
 <xsl:for-each select="./dc:type">
 <xsl:value-of select="."/>
 <xsl:text>&#x2714;</xsl:text>
 <xsl:value-of select="@scheme"/>
 <xsl:text>&#x2715;</xsl:text>
 </xsl:for-each>
 </types>
 </record>
 </xsl:for-each>
 </records>
 </xsl:otherwise>
 </xsl:choose>
 </xsl:template>
 </xsl:stylesheet></code>




When you have finished editing the text, save the file as 'GetRecords_Response.xslt'.





Author the GetRecordByID_Response.xslt





Remember that the CSW Clients apply the GetRecordByID_Response.xslt to a GetRecordsByID response from the catalog service only to extract the URL that is used to display a live service in the interface. The code snippet below shows a generic GetRecordsByID_Response.xslt. The important part of customizing this is to identify where in the CS-W response information about a live service would be found. This should be defined in the <xsl:template></xsl:template> section with select statements. The example shown below is for a Dublin Core catalog service, and we see that the xpath to the service information can be found at the csw:record/dct:references element. For examples that use ArcIMS CS-W connectors or ISO 19139-based connectors, open other GetRecordByID_Response xslt's within the \\CSWClients\Data folder and look for an example that is similar to the standard that your catalog service uses.



 <code> &lt;?xml version&#61;&quot;1.0&quot; encoding&#61;&quot;UTF&#45;8&quot;?&gt; 
 &lt;xsl&#58;stylesheet version&#61;&quot;1.0&quot; xmlns&#58;xsl&#61;&quot;http&#58;//www.w3.org/1999/XSL/Transform&quot; xmlns&#58;csw&#61;&quot;http&#58;//www.opengis.net/cat/csw/2.0.2&quot; xmlns&#58;dct&#61;&quot;http&#58;//purl.org/dc/terms/&quot; xmlns&#58;ows&#61;&quot;http&#58;//www.opengis.net/ows&quot; exclude&#45;result&#45;prefixes&#61;&quot;csw dct&quot;&gt;
 &lt;xsl&#58;output method&#61;&quot;text&quot; indent&#61;&quot;no&quot; encoding&#61;&quot;UTF&#45;8&quot;/&gt; 
 &lt;xsl&#58;template match&#61;&quot;/&quot;&gt; 
 &lt;xsl&#58;choose&gt;
 &lt;xsl&#58;when test&#61;&quot;/ows&#58;ExceptionReport&quot;&gt;
 &lt;exception&gt;
 &lt;exceptionText&gt;
 &lt;xsl&#58;for&#45;each select&#61;&quot;/ows&#58;ExceptionReport/ows&#58;Exception&quot;&gt;
 &lt;xsl&#58;value&#45;of select&#61;&quot;ows&#58;ExceptionText&quot;/&gt; 
 &lt;/xsl:for-each&gt; &lt;/exceptiontext&gt;
 &lt;/exception&gt;
 &lt;/xsl:when&gt; 
 &lt;xsl&#58;otherwise&gt;
 &lt;xsl&#58;apply&#45;templates select&#61;&quot;//csw&#58;Record/dct&#58;references&quot;/&gt;
 &lt;/xsl:otherwise&gt;
 &lt;/xsl:choose&gt;
 &lt;/xsl:template&gt;
 &lt;xsl&#58;template match&#61;&quot;//csw&#58;Record/dct&#58;references&quot;&gt; 
 &lt;xsl&#58;value&#45;of select&#61;&quot;.&quot;/&gt;
 &lt;xsl&#58;text&gt;&amp;&#35;x2714&#59;&lt;/xsl:text&gt;
 &lt;xsl&#58;value&#45;of select&#61;&quot;@scheme&quot;/&gt;
 &lt;xsl&#58;text&gt;&amp;&#35;x2715&#59;&lt;/xsl:text&gt;
 &lt;/xsl:template&gt;
 &lt;/xsl:stylesheet&gt;</code>




When you have finished editing the text, save the file as 'GetRecordByID_Response.xslt'.





Add your profile to the CSWProfiles.xml file





After you have authored the three xslt's, you need to reference them in the CSWProfiles.xml file.





    

  • Decide on a prefix that will distinguish your xslt's from the others found in the \\CSWClients\Data directory. Change the names of your three xslt's to include this prefix. For example, GetRecords_Request.xslt becomes MyOrganizationName_GetRecords_Request.xslt.
    • 

  • Navigate to the \\CSWClients\Data folder and open the CSWProfiles.xml file in a text editor.
    • 

  • Copy the following text into an entry at the top of the file, just below the  tag. Update the commented sections to reference the name of your new profile and the three xslt's that you have authored.
    • 



 &lt;Profile&gt;
 
 &lt;ID&gt;urn&#58;ogc&#58;CSW&#58;2.0.2&#58;HTTP&#58;YourProfile &lt;/id&gt; 
  
 &lt;Name&gt; Unique name for display of Profile &lt;/name&gt;
  
 &lt;CswNamespace&gt; http&#58;//www.opengis.net/cat/csw/2.0.2 &lt;/cswnamespace&gt; 
 &lt;Description /&gt;
 &lt;GetRecords&gt; 
 &lt;XSLTransformations&gt;
 
 &lt;Request&gt;MyOrganizationName_GetRecords_Request.xslt &lt;/request&gt;
 
 &lt;Response&gt; MyOrganizationName_GetRecords_Response.xslt &lt;/response&gt;
 &lt;/xsltransformations&gt;
 &lt;/getrecords&gt;
 &lt;GetRecordByID&gt;
 &lt;RequestKVPs&gt;
 
 &lt;&#33;&#91;CDATA&#91;service&#61;CSW&amp;request&#61;GetRecordById&amp;version&#61;2.0.2&amp;ElementSetName&#61;full&#93;&#93;&gt;
 &lt;/requestkvps&gt; 
 &lt;XSLTransformations&gt; 
  
 &lt;Response&gt;MyOrganizationName_GetRecordByID_Response.xslt &lt;/response&gt;
 &lt;/xsltransformations&gt;
 &lt;/getrecordbyid&gt;
  
 &lt;SupportSpatialQuery&gt;True &lt;/supportspatialquery&gt; 
  
 &lt;SupportContentTypeQuery&gt; True &lt;/supportcontenttypequery&gt; 
 
 &lt;SupportSpatialBoundary&gt; True &lt;/supportspatialboundary&gt;
 &lt;/profile&gt;</code>











  • By default, when a user clicks the View Metadata button, the metadata XML is returned from the catalog service's GetRecordByID response without any styling applied. If you want to define the styling on the metadata document so it is easier to read, you can use the  tag instead of the  tag within the  section for your profile in the CSWProfiles.xml file. Do the following:
      

    • Author a stylesheet (.xsl) that will interpret and render the metadata returned from the GetRecordById response from the catalog service. Save the stylesheet in the same folder as your CSWProfiles.xml file.
      • 

    • In the CSWProfiles.xml file, scroll to the section that defines the profile to which you want to apply the styling. Within that section, find the  element. Within the  element, find the  element.

      • 

    • Replace the  element section with .
      • 

    • Within the  open and closed tags, type the name of the stylesheet that you created to render the GetRecordByID response. An example is shown below:
      • 

    



 <code> &lt;GetRecordByID&gt;
 &lt;RequestKVPs&gt;
 &lt;&#33;&#91;CDATA&#91;service&#61;CSW&amp;request&#61;GetRecordById&amp;version&#61;2.0.2&amp;ElementSetName&#61;full&amp;outputSchema&#61;original&#93;&#93;&gt;
 &lt;/requestkvps&gt;
 &lt;XSLTransformations&gt; 
 &lt;StyleResponse&gt;Custom_Render.xsl&lt;/styleresponse&gt; 
 &lt;/xsltransformations&gt;
 &lt;/getrecordbyid&gt;</code>





  • Save the CSWProfiles.xml file. The next time you open the CSW Clients in ArcMap or ArcGIS Explorer, you should see your profile listed.


              


          



  
          

            


            
Clone this wiki locally