Base URL references resource describing server

94 Copyright © 2010 Open Geospatial Consortium, Inc. Under the directory URL http:schemas.opengis.net , lower level directories should be used for each specific OWS. Under the directory for each specific OWS, lower level directories should be used to contain the schemas for each specific version of that OWS. EXAMPLES http:schemas.opengis.netwms1.3.0capabilities.xsd http:schemas.opengis.netwcs1.0.1wcsCapabilities.xsd A server may reference an exact copy of these schemas located elsewhere, as long as they are readily accessible by clients. For example, it may be desirable to place the referenced schemas on the same network server as the OWS server, since that decreases the number of points of possible network failure. Such local copies of schemas should be organized into directories similar to http:schemas.opengis.net . The server owner should insure that any such local copies are kept up-to-date with respect to the authoritative files at http:schemas.opengis.net .

12.5 Base URL references resource describing server

Each base URL of an OWS server should reference a resource containing server information, when a HTTP GET request is made to that base URL. The resources referenced by base URLs can be HTML web pages or clients for accessing OWS server metadata. A base URL is the basis for access to an OWS server. This base URL is dependant upon the HTTP method used to access the server. For an HTTP POST operation request, the base URL is the URL to which the request is sent. For HTTP GET operation requests, the base URL is the URL from which KVP encoded requests to an OWS are derived. EXAMPLE 1 If a HTTP GET operation request is KVP encoded as http:www.owsserver.comows?service=WFSversion=1.0.0request=getfeaturetypename=Cities, the base URL for this operation is http:www.owsserver.comows . EXAMPLE 2 If a HTTP POST operation request is sent to http:www.owsserver.comows , this target is the base URL for this operation. When more than one base URL is used by one OWS server, at least the URL for HTTP GET transfer of the GetCapabilities operation request should reference a resource containing server metadata. If the same base URL is used for more that one server, that resource should contain information on all the servers using that base URL. A web page referenced by a base URL can be the top of a tree of web pages containing server metadata. These web pages can include but are not limited to information included in the Capabilities document. These web pages should contain summary information about that server, such as: a Hyperlinks to the relevant Implementation Specification documents b List all implemented operations c Summary of the functions performed by each operation d Some examples of possible operation requests Copyright © 2010 Open Geospatial Consortium, Inc. 95 e Hyperlink URLs may include example operation requests f Hyperlink URL that is a complete KVP-encoded basic GetCapabilities operation request, included in a manner that allows a CSW catalogue to find it. NOTE 1 A CSW catalogue can then use this GetCapabilities operation request to harvest server metadata. One possible approach is to record this basic GetCapabilities operation request in an anchor A element with the ―type‖ attribute value of ―GetCapabilities‖. EDITOR’S QUESTIONS The goal is to allow a CSW catalogue to automatically harvest all the servers andor services referenced on a HTML web page. How should the basic GetCapabilities operation request be encoded on such a HTML web page, to make it easy for a CSW catalogue to easily find it? How else could these HTML web pages reference XML documents that a CSW catalog might harvest to obtain server metadata? NOTE 2 An added benefit to this approach is that web indexing tools based on web crawlers or other information discovery and indexing mechanisms will eventually contain references to this data and thus serve to locate and advertise OWS-compliant services. EDITOR’S QUESTION How should this subclause be modified to support SOAP encoding of operation requests and responses?

12.6 Valid URLs in operation requests and responses