"Fossies" - the Fresh Open Source Software Archive

Member "user/community/csw-iso/tutorial.html" (22 Nov 2019, 18237 Bytes) of package /linux/www/geoserver-2.16.1-htmldoc.zip:


The requested HTML page contains a <FORM> tag that is unusable on "Fossies" in "automatic" (rendered) mode so that page is shown as HTML source code syntax highlighting (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    2   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-US">
    4 <head>
    5   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    6   
    7   <title>Catalog Services for the Web (CSW) ISO Metadata tutorial &mdash; GeoServer 2.16.1 User Manual</title>
    8   <link rel="stylesheet" href="../../_static/blueprint/screen.css" type="text/css" media="screen, projection" />
    9   <link rel="stylesheet" href="../../_static/blueprint/print.css" type="text/css" media="print" /> 
   10   <!--[if IE]>
   11   <link rel="stylesheet" href="../../_static/blueprint/ie.css" type="text/css" media="screen, projection" />
   12   <![endif]-->
   13   <link rel="stylesheet" href="../../_static/default.css" type="text/css" />
   14   <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
   15   <script type="text/javascript">
   16     var DOCUMENTATION_OPTIONS = {
   17         URL_ROOT:    '../../',
   18         VERSION:     '2.16.1',
   19         COLLAPSE_MODINDEX: false,
   20         FILE_SUFFIX: '.html'
   21     };
   22   </script>
   23   <script type="text/javascript" src="../../_static/jquery.js"></script>
   24   <script type="text/javascript" src="../../_static/doctools.js"></script>
   25   <script type="text/javascript" src="../../_static/searchtools.js"></script>
   26   <script type="text/javascript" src="../../searchindex.js"></script>
   27   <link rel="shortcut icon" href="../../_static/geoserver.ico"/>
   28       <link rel="search" title="Search" href="../../search.html" />
   29       <link rel="top" title="GeoServer 2.16.1 User Manual" href="../../index.html" />
   30       <link rel="up" title="Catalog Services for the Web (CSW) - ISO Metadata Profile" href="index.html" />
   31       <link rel="next" title="Tutorials" href="../../tutorials/index.html" />
   32       <link rel="prev" title="CSW ISO Metadata Profile Mapping File" href="mapping.html" />
   33 </head>
   34 <body class="community/csw-iso/tutorial">
   35   <div id="header" class="selfclear">
   36     <div class="wrap selfclear">
   37       <div id="logo"><a href="../../index.html">GeoServer 2.16.1 User Manual</a></div>
   38       <ul id="top-nav">
   39         <li class="first"><a href="http://geoserver.org/about">About</a></li>
   40         <li><a href="http://blog.geoserver.org/">Blog</a></li>
   41         <li><a href="http://geoserver.org/download">Download</a></li>
   42         <!--<li><a href="../../index.html">Documentation</a></li>-->
   43       </ul>
   44         <form id="quick-search" action="../../search.html" method="get">
   45           <fieldset>
   46             <input type="hidden" name="check_keywords" value="yes" />
   47             <input type="hidden" name="area" value="default" />
   48             <input id="quick-search-query" type="text" name="q" accessKey="q" name="searchQuery.queryString" size="25" value="Search Documentation&hellip;" size="20" tabindex="3" onblur="if(this.value=='') this.value='Search Documentation&hellip;';" onfocus="if(this.value=='Search Documentation&hellip;') this.value='';" />
   49             <input id="quick-search-submit" type="image" value="Search" src="../../_static/chrome/search_icon_green.png" />
   50           </fieldset>
   51         </form>
   52     </div><!-- /.wrap -->
   53   </div><!-- /#header -->
   54   <div id="main">
   55     <div class="wrap selfclear">
   56       <div id="content-left" class="content-border"></div>
   57       <div id="content">
   58 <ul id="breadcrumbs">
   59   
   60   <li><a href="../../index.html">GeoServer 2.16.1 User Manual</a> &raquo;</li>
   61   <li><a href="../index.html" accesskey="U">Community modules</a> &raquo;</li>
   62   <li><a href="index.html" accesskey="U">Catalog Services for the Web (CSW) - ISO Metadata Profile</a> &raquo;</li>
   63   <li>Catalog Services for the Web (CSW) ISO Metadata tutorial</li>
   64 </ul>
   65 <ul id="relatedlinks" class="selfclear">
   66   <li class="first">
   67     <a href="../../py-modindex.html" title="Python Module Index"
   68        accesskey="">modules</a></li>
   69   <li>
   70     <a href="../../tutorials/index.html" title="Tutorials"
   71        accesskey="N">next</a>|</li>
   72   <li>
   73     <a href="mapping.html" title="CSW ISO Metadata Profile Mapping File"
   74        accesskey="P">previous</a>|</li>
   75 </ul>
   76         
   77   <div class="section" id="catalog-services-for-the-web-csw-iso-metadata-tutorial">
   78 <span id="csw-iso-tutorial"></span><h1>Catalog Services for the Web (CSW) ISO Metadata tutorial<a class="headerlink" href="#catalog-services-for-the-web-csw-iso-metadata-tutorial" title="Permalink to this headline"></a></h1>
   79 <p>This tutorial will show how to use the CSW module with the ISO Metadata Profile scheme. It assumes a fresh installation of GeoServer with the <a class="reference internal" href="../../services/csw/installing.html#csw-installing"><span class="std std-ref">CSW ISO Metadata Profile module installed</span></a>.</p>
   80 <div class="section" id="configuration">
   81 <h2>Configuration<a class="headerlink" href="#configuration" title="Permalink to this headline"></a></h2>
   82 <p>In the <code class="file docutils literal notranslate"><span class="pre">&lt;data_dir&gt;/csw</span></code> directory, create a new file named <code class="file docutils literal notranslate"><span class="pre">MD_Metadata</span></code> (ISO Metadata Profile mapping file) with the following contents:</p>
   83 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span>@fileIdentifier.CharacterString=prefixedName
   84 identificationInfo.AbstractMD_Identification.citation.CI_Citation.title.CharacterString=title
   85 identificationInfo.AbstractMD_Identification.descriptiveKeywords.MD_Keywords.keyword.CharacterString=keywords
   86 identificationInfo.AbstractMD_Identification.abstract.CharacterString=abstract
   87 $dateStamp.Date= if_then_else ( isNull(&quot;metadata.date&quot;) , &#39;Unknown&#39;, &quot;metadata.date&quot;)
   88 hierarchyLevel.MD_ScopeCode.@codeListValue=&#39;http://purl.org/dc/dcmitype/Dataset&#39;
   89 $contact.CI_ResponsibleParty.individualName.CharacterString=&#39;John Smith&#39;
   90 </pre></div>
   91 </div>
   92 </div>
   93 <div class="section" id="services">
   94 <h2>Services<a class="headerlink" href="#services" title="Permalink to this headline"></a></h2>
   95 <p>With GeoServer running (and responding on <code class="docutils literal notranslate"><span class="pre">http://localhost:8080</span></code>), test GeoServer CSW in a web browser by querying the CSW capabilities as follows:</p>
   96 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span>http://localhost:8080/geoserver/csw?service=csw&amp;version=2.0.2&amp;request=GetCapabilities
   97 </pre></div>
   98 </div>
   99 <p>We can request a description of our Metadata record:</p>
  100 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span>http://localhost:8080/geoserver/csw?service=CSW&amp;version=2.0.2&amp;request=DescribeRecord&amp;typeName=gmd:MD_Metadata
  101 </pre></div>
  102 </div>
  103 <p>This yields the following result:</p>
  104 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span>&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
  105 &lt;csw:DescribeRecordResponse xmlns:csw=&quot;http://www.opengis.net/cat/csw/2.0.2&quot; xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot; xsi:schemaLocation=&quot;http://www.opengis.net/cat/csw/2.0.2 http://localhost:8080/geoserver/schemas/csw/2.0.2CSW-discovery.xsd&quot;&gt;
  106 &lt;csw:SchemaComponent targetNamespace=&quot;http://www.opengis.net/cat/csw/2.0.2&quot; schemaLanguage=&quot;http://www.w3.org/XML/Schema&quot;&gt;
  107 &lt;xs:schema xmlns:xs=&quot;http://www.w3.org/2001/XMLSchema&quot; xmlns:xlink=&quot;http://www.w3.org/1999/xlink&quot; xmlns:gco=&quot;http://www.isotc211.org/2005/gco&quot; xmlns:gmd=&quot;http://www.isotc211.org/2005/gmd&quot; targetNamespace=&quot;http://www.isotc211.org/2005/gmd&quot; elementFormDefault=&quot;qualified&quot; version=&quot;2012-07-13&quot;&gt;
  108       &lt;!-- ================================= Annotation ================================ --&gt;
  109       &lt;xs:annotation&gt;
  110               &lt;xs:documentation&gt;Geographic MetaData (GMD) extensible markup language is a component of the XML Schema Implementation of Geographic Information Metadata documented in ISO/TS 19139:2007. GMD includes all the definitions of http://www.isotc211.org/2005/gmd namespace. The root document of this namespace is the file gmd.xsd. This identification.xsd schema implements the UML conceptual schema defined in A.2.2 of ISO 19115:2003. It contains the implementation of the following classes: MD_Identification, MD_BrowseGraphic, MD_DataIdentification, MD_ServiceIdentification, MD_RepresentativeFraction, MD_Usage, MD_Keywords, DS_Association, MD_AggregateInformation, MD_CharacterSetCode, MD_SpatialRepresentationTypeCode, MD_TopicCategoryCode, MD_ProgressCode, MD_KeywordTypeCode, DS_AssociationTypeCode, DS_InitiativeTypeCode, MD_ResolutionType.&lt;/xs:documentation&gt;
  111       &lt;/xs:annotation&gt;
  112       ...
  113 </pre></div>
  114 </div>
  115 <p>Query all layers as follows:</p>
  116 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span>http://localhost:8080/geoserver/csw?service=CSW&amp;version=2.0.2&amp;request=GetRecords&amp;typeNames=gmd:MD_Metadata&amp;resultType=results&amp;elementSetName=full&amp;outputSchema=http://www.isotc211.org/2005/gmd
  117 </pre></div>
  118 </div>
  119 <p>Request a particular layer by ID…:</p>
  120 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span>http://localhost:8080/geoserver/csw?service=CSW&amp;version=2.0.2&amp;request=GetRecordById&amp;elementsetname=summary&amp;id=CoverageInfoImpl--4a9eec43:132d48aac79:-8000&amp;typeNames=gmd:MD_Metadata&amp;resultType=results&amp;elementSetName=full&amp;outputSchema=http://www.isotc211.org/2005/gmd
  121 </pre></div>
  122 </div>
  123 <p>…or use a filter to retrieve it by Title:</p>
  124 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span>http://localhost:8080/geoserver/csw?service=CSW&amp;version=2.0.2&amp;request=GetRecords&amp;typeNames=gmd:MD_Metadata&amp;resultType=results&amp;elementSetName=full&amp;outputSchema=http://www.isotc211.org/2005/gmd&amp;constraint=Title=%27mosaic%27
  125 </pre></div>
  126 </div>
  127 <p>Either case should return:</p>
  128 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span>&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
  129 &lt;csw:GetRecordsResponse xmlns:xml=&quot;http://www.w3.org/XML/1998/namespace&quot; xmlns=&quot;http://www.opengis.net/cat/csw/apiso/1.0&quot; xmlns:csw=&quot;http://www.opengis.net/cat/csw/2.0.2&quot; xmlns:gco=&quot;http://www.isotc211.org/2005/gco&quot; xmlns:gmd=&quot;http://www.isotc211.org/2005/gmd&quot; xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot; version=&quot;2.0.2&quot; xsi:schemaLocation=&quot;http://www.opengis.net/cat/csw/2.0.2 http://localhost:8080/geoserver/schemas/csw/2.0.2/record.xsd&quot;&gt;
  130   &lt;csw:SearchStatus timestamp=&quot;2013-06-28T13:41:43.090Z&quot;/&gt;
  131   &lt;csw:SearchResults numberOfRecordsMatched=&quot;1&quot; numberOfRecordsReturned=&quot;1&quot; nextRecord=&quot;0&quot; recordSchema=&quot;http://www.isotc211.org/2005/gmd&quot; elementSet=&quot;full&quot;&gt;
  132     &lt;gmd:MD_Metadata&gt;
  133       &lt;gmd:fileIdentifier&gt;
  134         &lt;gco:CharacterString&gt;CoverageInfoImpl--4a9eec43:132d48aac79:-8000&lt;/gco:CharacterString&gt;
  135       &lt;/gmd:fileIdentifier&gt;
  136       &lt;gmd:dateStamp&gt;
  137         &lt;gco:Date&gt;Unknown&lt;/gco:Date&gt;
  138       &lt;/gmd:dateStamp&gt;
  139       &lt;gmd:identificationInfo&gt;
  140         &lt;gmd:MD_DataIdentification&gt;
  141           &lt;gmd:extent&gt;
  142             &lt;gmd:EX_Extent&gt;
  143               &lt;gmd:geographicElement&gt;
  144                 &lt;gmd:EX_GeographicBoundingBox crs=&quot;urn:x-ogc:def:crs:EPSG:6.11:4326&quot;&gt;
  145                   &lt;gmd:westBoundLongitude&gt;36.492&lt;/gmd:westBoundLongitude&gt;
  146                   &lt;gmd:southBoundLatitude&gt;6.346&lt;/gmd:southBoundLatitude&gt;
  147                   &lt;gmd:eastBoundLongitude&gt;46.591&lt;/gmd:eastBoundLongitude&gt;
  148                   &lt;gmd:northBoundLatitude&gt;20.83&lt;/gmd:northBoundLatitude&gt;
  149                 &lt;/gmd:EX_GeographicBoundingBox&gt;
  150               &lt;/gmd:geographicElement&gt;
  151             &lt;/gmd:EX_Extent&gt;
  152           &lt;/gmd:extent&gt;
  153         &lt;/gmd:MD_DataIdentification&gt;
  154         &lt;gmd:AbstractMD_Identification&gt;
  155           &lt;gmd:citation&gt;
  156             &lt;gmd:CI_Citation&gt;
  157               &lt;gmd:title&gt;
  158                 &lt;gco:CharacterString&gt;mosaic&lt;/gco:CharacterString&gt;
  159               &lt;/gmd:title&gt;
  160             &lt;/gmd:CI_Citation&gt;
  161           &lt;/gmd:citation&gt;
  162           &lt;gmd:descriptiveKeywords&gt;
  163             &lt;gmd:MD_Keywords&gt;
  164               &lt;gmd:keyword&gt;
  165                 &lt;gco:CharacterString&gt;WCS&lt;/gco:CharacterString&gt;
  166               &lt;/gmd:keyword&gt;
  167               &lt;gmd:keyword&gt;
  168                 &lt;gco:CharacterString&gt;ImageMosaic&lt;/gco:CharacterString&gt;
  169               &lt;/gmd:keyword&gt;
  170               &lt;gmd:keyword&gt;
  171                 &lt;gco:CharacterString&gt;mosaic&lt;/gco:CharacterString&gt;
  172               &lt;/gmd:keyword&gt;
  173             &lt;/gmd:MD_Keywords&gt;
  174           &lt;/gmd:descriptiveKeywords&gt;
  175         &lt;/gmd:AbstractMD_Identification&gt;
  176       &lt;/gmd:identificationInfo&gt;
  177       &lt;gmd:contact&gt;
  178         &lt;gmd:CI_ResponsibleParty&gt;
  179           &lt;gmd:individualName&gt;
  180             &lt;gco:CharacterString&gt;John Smith&lt;/gco:CharacterString&gt;
  181           &lt;/gmd:individualName&gt;
  182         &lt;/gmd:CI_ResponsibleParty&gt;
  183       &lt;/gmd:contact&gt;
  184       &lt;gmd:hierarchyLevel&gt;
  185         &lt;gmd:MD_ScopeCode codeListValue=&quot;http://purl.org/dc/dcmitype/Dataset&quot;/&gt;
  186       &lt;/gmd:hierarchyLevel&gt;
  187     &lt;/gmd:MD_Metadata&gt;
  188   &lt;/csw:SearchResults&gt;
  189 &lt;/csw:GetRecordsResponse&gt;
  190 </pre></div>
  191 </div>
  192 <p>We can request the domain of a property. For example, all values of “Title”:</p>
  193 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span>http://localhost:8080/geoserver/csw?service=csw&amp;version=2.0.2&amp;request=GetDomain&amp;propertyName=Title
  194 </pre></div>
  195 </div>
  196 <p>This should yield the following result:</p>
  197 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span>&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
  198 &lt;csw:GetDomainResponse xmlns:csw=&quot;http://www.opengis.net/cat/csw/2.0.2&quot; xmlns:dc=&quot;http://purl.org/dc/elements/1.1/&quot; xmlns:dct=&quot;http://purl.org/dc/terms/&quot; xmlns:ows=&quot;http://www.opengis.net/ows/1.1&quot; xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot; xsi:schemaLocation=&quot;http://www.opengis.net/cat/csw/2.0.2 http://localhost:8080/geoserver/schemas/csw/2.0.2/CSW-discovery.xsd&quot;&gt;
  199   &lt;csw:DomainValues type=&quot;csw:Record&quot;&gt;
  200       &lt;csw:PropertyName&gt;Title&lt;/csw:PropertyName&gt;
  201       &lt;csw:ListOfValues&gt;
  202         &lt;csw:Value&gt;A sample ArcGrid file&lt;/csw:Value&gt;
  203         &lt;csw:Value&gt;Manhattan (NY) landmarks&lt;/csw:Value&gt;
  204         &lt;csw:Value&gt;Manhattan (NY) points of interest&lt;/csw:Value&gt;
  205         &lt;csw:Value&gt;Manhattan (NY) roads&lt;/csw:Value&gt;
  206         &lt;csw:Value&gt;North America sample imagery&lt;/csw:Value&gt;
  207         &lt;csw:Value&gt;Pk50095 is a A raster file accompanied by a spatial data file&lt;/csw:Value&gt;
  208         &lt;csw:Value&gt;Spearfish archeological sites&lt;/csw:Value&gt;
  209         &lt;csw:Value&gt;Spearfish bug locations&lt;/csw:Value&gt;
  210         &lt;csw:Value&gt;Spearfish restricted areas&lt;/csw:Value&gt;
  211         &lt;csw:Value&gt;Spearfish roads&lt;/csw:Value&gt;
  212         &lt;csw:Value&gt;Spearfish streams&lt;/csw:Value&gt;
  213         &lt;csw:Value&gt;Tasmania cities&lt;/csw:Value&gt;
  214         &lt;csw:Value&gt;Tasmania roads&lt;/csw:Value&gt;
  215         &lt;csw:Value&gt;Tasmania state boundaries&lt;/csw:Value&gt;
  216         &lt;csw:Value&gt;Tasmania water bodies&lt;/csw:Value&gt;
  217         &lt;csw:Value&gt;USA Population&lt;/csw:Value&gt;
  218         &lt;csw:Value&gt;World rectangle&lt;/csw:Value&gt;
  219         &lt;csw:Value&gt;mosaic&lt;/csw:Value&gt;
  220         &lt;csw:Value&gt;sfdem is a Tagged Image File Format with Geographic information&lt;/csw:Value&gt;
  221       &lt;/csw:ListOfValues&gt;
  222   &lt;/csw:DomainValues&gt;
  223 &lt;/csw:GetDomainResponse&gt;
  224 </pre></div>
  225 </div>
  226 </div>
  227 </div>
  228 
  229 
  230       <div class="selfclear pagination-nav">
  231           <div class="leftwise"><strong>Previous</strong>: <a href="mapping.html" title="previous chapter">CSW ISO Metadata Profile Mapping File</a></div>
  232           <div class="rightwise"><strong>Next</strong>: <a href="../../tutorials/index.html" title="next chapter">Tutorials</a></div>
  233       </div>
  234       </div><!-- /#content> -->
  235       <div id="content-right" class="content-border"></div>
  236   <div id="sidebar" class="contrast">
  237       <div id="toc" class="section">
  238         <h3 class="pngfix">Table Of Contents</h3>
  239         <ul>
  240 <li><a class="reference internal" href="#">Catalog Services for the Web (CSW) ISO Metadata tutorial</a><ul>
  241 <li><a class="reference internal" href="#configuration">Configuration</a></li>
  242 <li><a class="reference internal" href="#services">Services</a></li>
  243 </ul>
  244 </li>
  245 </ul>
  246 
  247         <div class="section-footer"></div>
  248       </div>
  249         <div class="section">
  250           <h3>Continue Reading</h3>
  251           <ul>
  252             <li>Previous: <a href="mapping.html" title="previous chapter">CSW ISO Metadata Profile Mapping File</a></li>
  253             <li>Next: <a href="../../tutorials/index.html" title="next chapter">Tutorials</a></li>
  254           </ul>
  255         </div>
  256         <div class="section">
  257         <h3>This Page</h3>
  258         <ul class="this-page-menu">
  259                 
  260         <li><a href="https://github.com/geoserver/geoserver/tree/master/doc/en/user/source/community/csw-iso/tutorial.rst">Edit</a></li>
  261         </ul>
  262         </div>
  263   </div><!-- /#sidebar -->
  264   </div><!-- /.wrap> -->
  265 </div><!-- /#main -->
  266 <div id="footer">
  267   <div class="wrap">
  268     &copy; Copyright 2019, Open Source Geospatial Foundation. License <a href="http://creativecommons.org/licenses/by/3.0/">Creative Commons Attribution</a>.
  269     Last updated on Nov 22, 2019.
  270     Created using <a href="http://sphinx.pocoo.org/">Sphinx</a>.
  271   </div><!-- /.wrap> -->
  272 </div><!-- /#footer -->
  273   </body>
  274 </html>