PM 1(6) Geodataportalen - Metadata -CSW - Utbyte av metadata, maskin till maskin
PM 2(6) 1 Innehållsförteckning 1 Innehållsförteckning... 2 2 Inledning... 3 3 Kataloggränssnitt för metadata... 3 3.1 Översikt... 3 3.2 Att söka via CSW... 3 3.3 DescribeRecord... 6
PM 3(6) 2 Inledning Detta dokument är en handledning för hantering av katalogtjänsten i Geodataportalen.. Dokumentet beskriver olika vägar att använda gränssnittet. Samt några exempelfrågor mot den nationella katalogen. Senaste versionen av detta dokument kan återfinnas på: www.geodata.se/ 3 Kataloggränssnitt för metadata 3.1 Översikt Geodataportalen har ett gränssnitt för användare som vill söka efter information. Om istället en annan applikation vill söka i katalogen så finns det ett standardiserat gränssnitt för sådana dator till dator sökningar.. Detta gränssnitt heter CSW (Catalogue Service Web). Just nu är det version CSW 2.02 som är aktuell version. 3.2 Att söka via CSW CSW stöder några olika operationer. Dessa är GetCapabilities GetRecords GetRecordById DescribeRecord Specifikationen för CSW 2.02 är följande: OpenGIS Catalogue Services Specification 2.0.2 - ISO Metadata Application Profile (1.0.0) Där kan man finna mer detaljerad information om hur man tex kan söka på olika kriterier. 3.2.1 Katalogtjänsten för Geodata.se Denna katalogtjänst kan nås på: http://www.geodata.se/geonetwork/srv/se/csw 3.2.2 GetCapabilities
PM 4(6) GetCapabilities är en obligatoriskt operation som alla CSW-tjänster måste uppfylla. getcapabilities ger en klient möjligheten att fråga en CSW-tjänst vad den kan svara på för frågor. Det katalogtjänsten ger som svar är ett xml-dokument som beskriver vad tjänsten kan. För att anropa katalogtjänsten kan man använda nedanstående anrop http://www.geodata.se/geonetwork/srv/en/csw? Request=GetCapabilities& Service=CSW& Version=2.0.2 <?xml version="1.0" encoding="utf-8"?> <csw:getcapabilities xmlns:csw="http: // www.opengis.net/cat/csw/2.0.2" service="csw"> <ows:acceptversions xmlns:ows="http://www.opengis.net/ows"> <ows:version>2.0.2</ows:version> </ows:acceptversions> <ows:acceptformats xmlns:ows="http://www.opengis.net/ows"> <ows:outputformat>application/xml</ows:outputformat> </ows:acceptformats> </csw:getcapabilities> 3.2.3 GetRecords The obligatoriska operationen GetRecords ger möjlighet att söka i data på olika sätt samt presentera resultatet enligt olika modeller. Frågan som skickas specificeras i två stycken parametrar. Constraint och typename. Constraint definierar urvals kriterier för de objekt som skall returneras. typenames definierar på vilka objettyper i metadatamodellen som frågor skall ställas mot. Resultatet som returneras styrs av följande argument: outputschema anger vilken xml-schema som resultatet returneras i ElementName/ElementSetName anger vilken del av xml-schemat som angivits i outputschema som skall returneras för varje post. Nedanstående fråga till katalogen frågar efter alla poster som innehåller texten GSD http://www.geodata.se/geonetwork/srv/en/csw? request=getrecords& service=csw& version=2.0.2& namespace=xmlns(csw=http://www.opengis.net/cat/csw)&
PM 5(6) resulttype=results& outputschema=csw:isorecord& outputformat=application/xml& maxrecords=10& typenames=csw:isorecord& elementsetname=summary& constraintlanguage=cql_text&constraint_language_version=1.1.0&constraint=anytext LIKE '%gsd%' <?xml version="1.0" encoding="utf-8"?> <csw:getcapabilities xmlns:csw="http: // www.opengis.net/cat/csw/2.0.2" service="csw"> <ows:acceptversions xmlns:ows="http://www.opengis.net/ows"> <ows:version>2.0.2</ows:version> </ows:acceptversions> <ows:acceptformats xmlns:ows="http://www.opengis.net/ows"> <ows:outputformat>application/xml</ows:outputformat> </ows:acceptformats> </csw:getcapabilities> 3.2.4 GetRecordById Operationen GetRecordByID returnerar metadata för en eller flera poster genom att ange dess identifierare. Normalt används denna operation i kombination med GetRecord. i ett första steg söks ett antal poster ut med GetRecord. Därefter hämtas de aktuella posterna med GetRecordById. http://www.geodata.se/geonetwork/srv/en/csw?request=getrecordbyid&service=csw&versi on=2.0.2&elementsetname=full&id= 35afbd3a-fa94-4b52-97d9-659593d89ae8&outputSchema=csw:IsoRecord http://www.geodata.se/geonetwork/srv/en/csw? request=getrecordbyid& service=csw& version=2.0.2& elementsetname=full& id= 35afbd3a-fa94-4b52-97d9-659593d89ae8& outputschema=csw:isorecord <?xml version="1.0" encoding="utf-8"?> <csw:getrecordbyid xmlns:csw="http://www.opengis.net/cat/csw/2.0.2" service="csw" version="2.0.2"
PM 6(6) elementsetname="breif" outputschema="csw:isorecord"> <csw:id>2696920f-e712-4dbe-9844-5ef525db26cb</csw:id> </csw:getrecordbyid> 3.3 DescribeRecord DescribeRecord är en obligatorisk funktion som beskriver katalogtjänstens informationsmodell htttp://www.geodata.se/geonetwork/srv/en/csw? request=describerecord& service=csw& version=2.0.2 <csw:describerecord xmlns:csw="http://www.opengis.net/cat/csw/2.0.2" service="csw" version="2.0.2" outputformat="application/xml" schemalanguage="http://www.w3.org/xml/schema" />