Impactanalyse Samenwerkende Catalogi 4.0. Wat zijn de wijzigingen met de komst van SC 4.0 ten opzichte van SC 2.1

Transcriptie

1 Impactanalyse Samenwerkende Catalogi 4.0 Wat zijn de wijzigingen met de komst van SC 4.0 ten opzichte van SC 2.1 Versie 1.0 Datum 19 april 2012

2 Colofon Projectnaam Samenwerkende Catalogi 4.0 Versienummer 1.0 Organisatie Logius Postbus JE Den Haag Bijlage(n) Documentbeheer Datum Versie Auteur Opmerkingen Referenties Verwijzing Naam Locatie Versie R1 IPM SC4.0 Deel A R2 IPM SC4.0 Deel B Pagina 2 van 10

3 Inhoud Colofon... 2 Referenties... 2 Inhoud... 3 Inleiding Wijzigingen Wijzigingen Zoekdienst bevragen Authenticatie Zoekdienst resultaat Aanpassen zoekscherm Standaard zoekscherm Migratieperiode Meer informatie Pagina 3 van 10

4 Inleiding Samenwerkende Catalogi 4.0 is de nieuwe versie die na de migratie als standaard geldt. Tot juni 2013 zal de oude versie van Samenwerkende Catalogi, versie 2.1 ondersteund worden. Na deze datum wordt alleen de nieuwe versie, versie 4.0 nog geaccepteerd. Met de komst van Samenwerkende Catalogi 4.0 (verder SC4.0 genoemd) vinden er wijzigingen plaats die een impact hebben op de aangesloten deelnemers van Samenwerkende Catalogi. Dit document geeft inzicht in deze wijzigingen. Dit document is dan ook bestemd voor reeds aangesloten deelnemers en hun leveranciers. Bij het schrijven van dit document is aangenomen dat de lezer bekend is met de basisprincipes van Samenwerkende Catalogi. Documentatie met betrekking tot Samenwerkende Catalogi wordt beschreven in het Informatie Publicatie Model (IPM). De naam IPM zegt het al: in de eerste plaats is Samenwerkende Catalogi een model voor publicatie van informatie. Een overheidsorganisatie publiceert via Samenwerkende Catalogi metadata over haar producten en diensten, zodat deze bruikbaar is op andere plaatsen binnen de e-overheid. Om het voor afnemers eenvoudig te maken de metadata te verwerken, is de wijze waarop deze wordt vormgegeven en gepubliceerd gestandaardiseerd. De Standaard voor Samenwerkende Catalogi schrijft voor welke informatie gepubliceerd moet worden en in welke vorm. Het Informatie Publicatiemodel (IPM) Samenwerkende Catalogi 4.0 bestaat uit twee delen, te weten Deel A: Functionele beschrijving Deel B: Technische beschrijving Deel A (R1) is speciaal geschreven om de lezer te voorzien van meer informatie over de standaard, zonder dat hij over technische kennis hoeft te beschikken. Deel B (R2) beschrijft op welke manier overheidsorganisaties hun producten dienstinformatie dienen te publiceren om te voldoen aan de standaard van Samenwerkende Catalogi. Dit document is met name bestemd voor leveranciers en voor overheidsorganisaties die zelfstandig aansluiten op de standaard. Pagina 4 van 10

5 1 Wijzigingen De wijzigingen aan de standaard beslaan zowel aanpassingen aan de wijze waarop een XML Indexfeed is opgebouwd, als de wijze waarop de centrale zoekdienst wordt bevraagd en antwoord geeft. In de hierop volgende paragrafen zal hier verder in detail op worden ingegaan. De zoekdienst voor Samenwerkende Catalogi ondersteunt tot juni 2013 ook de oude versie 2.1. Dat houdt in dat zowel versie 2.1 als versie 4.0 indexfeeds kunnen worden aangeboden, en dat de zoekdienst bevraagd kan worden met zowel versie 2.1 als versie 4.0. De zoekdienst zorgt vervolgens voor de vertaling. Daar waar nodig vult de zoekdienst ontbrekende waarden met een standaardwaarde in (bijvoorbeeld abstract, onlineaanvragen en Onderwerp1) zodat het resultaatbericht toch technisch valide is. In de onderstaande figuur wordt de ondersteuning voor de overgangsperiode na de introductie van SC4.0 weergegeven. 1.1 Wijzigingen De opbouw en inhoud van de SC XML Indexfeed berichten wijzigt met de nieuwe versie van de standaard. De grootste wijziging is de aanpassing van de SC XML schrijfwijze naar de OWMS-schrijfwijze, alle informatie hierover staat in IPM 4.0 Deel B (R2). Pagina 5 van 10

6 Onderstaande tabel geeft een globaal beeld over de inhoudelijke wijzigingen aan het SC XML Indexfeed bericht. Meer gedetailleerde informatie zoals de exacte invulling, verplicht/niet verplicht en kardinaliteit van de velden is terug te vinden in het IPM 4.0 Deel B (R2). SC2.1 XML Auteur publicerendeorganisatie productnaam inhoud (HTML gefilterd, optioneel) SC4.0 XML authority (waarde) authority (referentie) title abstract (geen HTML toegestaan, verplicht) producthtml (wel HTML) spatial mutatiedatum modified Onderwerp1 (vervalt) Onderwerp2 (vervalt / samenvoegen met Onderwerp 3) subject Onderwerp3 (vervalt / samenvoegen met Onderwerp 2) doelgroep taal url productid onlineaanvragen/online (optioneel) onlineaanvragen/aanvraagurl audience language identifier productid onlineaanvragen ( verplicht) aanvraagurl eenmaligaanmelden contactpunt uniformeproductnaam gerelateerdproduct Voor bestaande aansluitingen betekent dit dat de manier waarop XML Indexfeed berichten worden opgebouwd, wijzigt. Veelal zal een leverancier hiervoor technische aanpassingen moeten plegen aan het CMS of informatiesysteem. 1.2 Zoekdienst bevragen Zoekvragen worden in versie 4.0 aangeboden in de vorm van een URL met parameters. In de vorige versie, versie 2.1, was deze bevraging in de vorm van XML. Pagina 6 van 10

7 Bij een zoekvraag conform SC4.0 is de zoekvraag een URL aangevuld met zoekparameters. Deze URL is opgebouwd conform de SRU standaard. De bevragings-url is opgebouwd uit een vast deel en een variabel deel. Het vaste deel luidt als volgt: sion=1.2&operation=searchretrieve&xconnection=sc&startrecord=1&maximumrecords=10&query= De parameters version, operation en x-connection dienen meegegeven te worden om te zorgen dat de juiste collectie doorzocht wordt en vraag en antwoord conform deze specificaties zijn vormgegeven. De URL parameters startrecord en maximumrecords zijn optioneel. Deze worden doorgaans in combinatie gebruikt om een beperkte set resultaten op te vragen, bijvoorbeeld resultaat van de in totaal 600 zoekresultaten. Met startrecord wordt aangegeven vanaf welk record resultaten moeten worden teruggegeven (in geval van het voorbeeld: 1) en met maximumrecords hoeveel er totaal moeten terugkomen (in het voorbeeld: 10). Achter de 'query' parameter volgt de daadwerkelijke zoekvraag in de vorm van een 'CQL query'. Een voorbeeld van een CQL query met postcode en organisatietype is: query=(postcode=4501 and organisatietype=provincie or organisatietype=ministerie or organisatietype=waterschap) and (keyword= water ) Deze query zou resultaten moeten geven met de tekst 'water' van de provincie Zeeland, waterschap Scheldestromen en van ministeries. Een vergelijkbaar voorbeeld met gebruik van gemeentenaam is: query=(organisatie= Sluis and organisatietype=provincie or organisatietype=ministerie or organisatietype=waterschap) and (keyword= water ) Een voorbeeld van een volledige zoekvraag: sion=1.2&operation=searchretrieve&xconnection=sc&startrecord=1&maximumrecords=10&query=((title = "paspoort") not (title = "verloren")) sortby modified/sort.descending Voor bestaande aansluitingen betekent dit dat de werking van het zoekscherm op de eigen website aangepast dient te worden. Meer informatie over SRU is terug te vinden in IPM SC4.0 Deel B (R2) Authenticatie Voor de bevraging van de zoekdienst werd bij versie SC2.1 gebruik gemaakt van authenticatie. Hiermee wordt bedoeld dat iedere deelnemer de zoekdienst bevraagt met behulp van een username en password. Na de migratie is authenticatie niet meer nodig. Bij zowel SC2.1 als SC4.0 hoeft de authenticatie niet meer plaats te vinden. Pagina 7 van 10

8 1.3 Zoekdienst resultaat Een antwoord van de zoekdienst komt in de nieuwe versie als een XML bericht terug. De opbouw van dit bericht is anders dan een SC2.1 antwoord. Net zoals de zoekvraag wordt het antwoordbericht opgebouwd conform de SRU specificaties met hierin SC4.0 (OWMS) resultaten verwerkt. Voor bestaande aansluitingen betekent dit dat de werking van het zoekscherm op de eigen website aangepast dient te worden. Meer informatie over SRU en OWMS is terug te vinden in IPM SC4.0 Deel B (R2). 1.4 Aanpassen zoekscherm Een zoekscherm van een deelnemer zal geschikt gemaakt moeten worden om de nieuwe zoekantwoorden correct weer te kunnen geven. Dit betekent dat het zoekscherm zowel zoekvragen als antwoorden conform de SRU specificaties moet kunnen ondersteunen. Meer informatie over de SRU specificaties is terug te vinden in het IPM SC4.0 Deel B (R2). 1.5 Standaard zoekscherm Enkele deelnemers maken gebruik van het standaard zoekscherm van SC2.1. Het standaard zoekscherm wordt tot EIND 2012 nog ondersteund, daarna is het standaard zoekscherm niet meer te gebruiken. Deelnemers die gebruik maken van het standaard zoekscherm dienen zelfstandig aan te sluiten op de webservice van Samenwerkende Catalogi 4.0. Dit betekent niet dat ze ook al een XML bestand moeten aanleveren in SC4.0. Dit kan tot juni 2013 ook nog SC2.1 zijn. Meer informatie over het aansluiten op Samenwerkende Catalogi is terug te vinden in IPM SC4.0 deel A (R1) en IPM SC4.0 deel B (R2). Pagina 8 van 10

9 2 Migratieperiode Om er voor te zorgen dat de migratie soepel kan verlopen, is er voor gekozen om de zoekdienst tijdelijk zowel SC2.1 als SC4.0 te laten ondersteunen. Tot juni 2013 worden SC2.1 XML Indexfeeds nog geaccepteerd door de zoekdienst. Daarna worden ze verwijderd uit de collectie. Zoekvragen aan de zoekdienst kunnen tot juni 2013 in beide formaten worden gesteld. Let op, het standaard zoekscherm voor SC2.1 wordt alleen nog in 2012 ondersteund. Het is mogelijk om een SC4.0 XML Indexfeed aan te bieden en nog steeds de zoekdienst te bevragen op de 'oude' SC2.1 methode; het antwoord zal ook teruggezonden worden in het SC2.1 formaat. Zodra er een SC4.0 zoekvraag naar de zoekdienst wordt gestuurd, wordt er een SC4.0 antwoord verzonden (zie onderstaande tabel). Aanbieden Bevraging Antwoord SC2.1 XML Indexfeed SC4.0 XML Indexfeed SC2.1 XML Post SC4.0 SRU URL SC2.1 XML Post SC4.0 SRU URL SC2.1 XML SC4.0 SRU SC2.1 XML SC4.0 SRU Om te kunnen migreren dienen er een aantal stappen te worden uitgevoerd: SC XML Indexfeed aanbieden conform de SC4.0 specificatie Zoekvragen opbouwen volgens SRU zoekvraag Zoekscherm compatibel maken met SRU zoekresultaat Tot juni 2013 kunnen er zowel SC2.1 als SC4.0 zoekvragen worden verzonden. Pagina 9 van 10

10 3 Meer informatie Alle relevante schema s die noodzakelijk zijn voor een goede implementatie van dit project zijn te downloaden vanaf de site Op de site is het nieuwe IPM SC4.0 te vinden alsmede additionele informatie zoals nuttige FAQ s. Heeft uw organisatie of uw leverancier vragen over het implementatietraject, neem dan direct contact op met Servicecentrum Logius T (10 ct p/m) servicecentrum@logius.nl Vanzelfsprekend houden wij ons aanbevolen om commentaar te ontvangen dat bijdraagt aan een verdere verbetering van dit document. Ook als er onderwerpen zijn die in dit document niet (voldoende) zijn geadresseerd vernemen wij dat graag. Pagina 10 van 10