CS:Metadata Aanbieden: verschil tussen versies

Uit Kennisnet Developers Documentatie
Ga naar: navigatie, zoeken
k
(Aansluitingsproces)
Regel 1: Regel 1:
Een partij kan metadata aanbieden door deze via de {{Standaard|ECK-DT}} standaard aan te bieden, en een harvest verzoek in te dienen via onze {{servicedesk}}.
+
Een partij kan standaard '''metadata aanbieden''' volgens de {{Standaard|ECK-DT}} standaard. In bepaalde gevallen kan hierop een uitzondering worden gemaakt.
   
  +
== Aanleveren catalogusinformatie op basis van de ECK DT standaard ==
* Wij kunnen ECK-DT CatalogusService versies 2.1.1 en 2.2 harvesten.
 
  +
* Wij harvesten door middel van een WSDL definitie.
 
  +
=== Aansluitingsproces ===
* Wij kunnen alleen maar data harvesten die valide is conform de geleverde XSD's. Valideer de uitvoer voordat het harvestverzoek ingediend wordt.
 
  +
==== Ondersteunde versies van de standaard ====
  +
[[CS:Versies|Lees meer]] over welke ECK-DC standaardversie we ondersteunen. <br/>
  +
Momenteel kunnen wij ECK-DT CatalogService versies 2.1.1 en 2.2 harvesten. We gaan binnenkort ondersteuning bieden voor versies 2.2 en 2.3.
  +
  +
==== Harvester ====
  +
Wij harvesten door middel van een WSDL definitie. <br/>
  +
Er hoeft slechts één WSDL te worden gemaakt voor alle records.
  +
  +
We hebben een template, waarbij alleen de <nowiki>{{SERVICE_ENDPOINT_URI}}</nowiki> vervangen moet worden met de eigen SOAP endpoint locatie:
  +
<syntaxhighlight lang="xml">
  +
<soap:address location="{{SERVICE_ENDPOINT_URI}}"/>
  +
</syntaxhighlight>
  +
Voor elke versie van de standaard moet een afzonderlijk eindpunt worden gemaakt.
  +
{| class="wikitable"
  +
|-
  +
!
  +
!template
  +
|-
  +
|Versie 2.2
  +
|[https://wsdl.kennisnet.nl/eck/ECK-DT2-CatalogService-v2.2.wsdl https://wsdl.kennisnet.nl/eck/ECK-DT2-CatalogService-v2.2.wsdl]
  +
|-
  +
|Versie 2.3
  +
|[https://wsdl.kennisnet.nl/eck/ECK-DT2-CatalogService-v2.3.wsdl https://wsdl.kennisnet.nl/eck/ECK-DT2-CatalogService-v2.3.wsdl]
  +
  +
|}
  +
  +
=== SOAP endpoint ===
  +
Via een SOAP endpoint worden alle records aangeboden volgens de specificaties van de standaard.
  +
Lees meer [[Standaarden:ECK-DT#SOAP]]
  +
  +
=== Validatie ===
  +
Catalogus Service Harvester kunt alleen maar data harvesten die valide is conform de geleverde XSD's. [[Standaarden:ECK-DT#Documentatie]]<br/>
  +
Een gratis software https://www.soapui.org/ kan worden gebruikt om het WSDL / SOAP-eindpunt te valideren.<br/>
  +
Valideer de uitvoer voordat het harvestverzoek ingediend wordt.
  +
  +
=== Harvestverzoek ===
  +
  +
Een harvestverzoek kunt u indienen via onze {{servicedesk}}.
  +
  +
== Aanleveren catalogusinformatie op basis van een CSV ==
  +
We hebben het voor de '''gespecialiseerde''' uitgevers mogelijk gemaakt om relatief eenvoudig catalogusinformatie in te dienen.<br/>
  +
Het gaat in principe om een relatief klein aantal records die lange tijd ongewijzigd blijven. <br/>
  +
Of een uitgever in aanmerking komt voor een dergelijke uitzondering, moet worden besproken met onze Relatiemanagers.
  +
  +
=== Aansluitingsproces ===
  +
Er wordt geen gebruik gemaakt van de ECK DT standaard. Een gespecialiseerde uitgever hoeft dus geen webservice te bouwen.<br/>
  +
De catalogusinformatie moet in een Excel / CSV-bestand worden geplaatst.<br/>
  +
Een werkend CSV voorbeeld bestand is [https://csv-converter.catalogusservice.edurep.nl/valid.csv hier te downloaden].
  +
  +
[https://csv-converter.catalogusservice.edurep.nl '''Via deze website'''] is een CSV bestand met Catalogus service record informatie te '''converteren''' naar een ECK-DT versie 2.2 XML formaat.<br/> ([[CS:Versies|Lees meer]] over welke ECK-DC standaardversie we momenteel ondersteunen)
  +
  +
{| class="wikitable"
  +
|-
  +
!
  +
!link
  +
|-
  +
|Edurep Catalogus Service: CSV naar XML '''Converter'''
  +
|[https://csv-converter.catalogusservice.edurep.nl https://csv-converter.catalogusservice.edurep.nl]
  +
|-
  +
|Read me
  +
|[https://csv-converter.catalogusservice.edurep.nl/readme.php https://csv-converter.catalogusservice.edurep.nl/readme.php]
  +
  +
|}
  +
=== Verzoek ===
  +
  +
Een verzoek kunt u indienen via onze {{servicedesk}}

Versie van 19 mrt 2020 om 16:30

Een partij kan standaard metadata aanbieden volgens de ECK-DT standaard. In bepaalde gevallen kan hierop een uitzondering worden gemaakt.

Aanleveren catalogusinformatie op basis van de ECK DT standaard

Aansluitingsproces

Ondersteunde versies van de standaard

Lees meer over welke ECK-DC standaardversie we ondersteunen.
Momenteel kunnen wij ECK-DT CatalogService versies 2.1.1 en 2.2 harvesten. We gaan binnenkort ondersteuning bieden voor versies 2.2 en 2.3.

Harvester

Wij harvesten door middel van een WSDL definitie.
Er hoeft slechts één WSDL te worden gemaakt voor alle records.

We hebben een template, waarbij alleen de {{SERVICE_ENDPOINT_URI}} vervangen moet worden met de eigen SOAP endpoint locatie:

<soap:address location="{{SERVICE_ENDPOINT_URI}}"/>

Voor elke versie van de standaard moet een afzonderlijk eindpunt worden gemaakt.

template
Versie 2.2 https://wsdl.kennisnet.nl/eck/ECK-DT2-CatalogService-v2.2.wsdl
Versie 2.3 https://wsdl.kennisnet.nl/eck/ECK-DT2-CatalogService-v2.3.wsdl

SOAP endpoint

Via een SOAP endpoint worden alle records aangeboden volgens de specificaties van de standaard. Lees meer Standaarden:ECK-DT#SOAP

Validatie

Catalogus Service Harvester kunt alleen maar data harvesten die valide is conform de geleverde XSD's. Standaarden:ECK-DT#Documentatie
Een gratis software https://www.soapui.org/ kan worden gebruikt om het WSDL / SOAP-eindpunt te valideren.
Valideer de uitvoer voordat het harvestverzoek ingediend wordt.

Harvestverzoek

Een harvestverzoek kunt u indienen via onze servicedesk.

Aanleveren catalogusinformatie op basis van een CSV

We hebben het voor de gespecialiseerde uitgevers mogelijk gemaakt om relatief eenvoudig catalogusinformatie in te dienen.
Het gaat in principe om een relatief klein aantal records die lange tijd ongewijzigd blijven.
Of een uitgever in aanmerking komt voor een dergelijke uitzondering, moet worden besproken met onze Relatiemanagers.

Aansluitingsproces

Er wordt geen gebruik gemaakt van de ECK DT standaard. Een gespecialiseerde uitgever hoeft dus geen webservice te bouwen.
De catalogusinformatie moet in een Excel / CSV-bestand worden geplaatst.
Een werkend CSV voorbeeld bestand is hier te downloaden.

Via deze website is een CSV bestand met Catalogus service record informatie te converteren naar een ECK-DT versie 2.2 XML formaat.
(Lees meer over welke ECK-DC standaardversie we momenteel ondersteunen)

link
Edurep Catalogus Service: CSV naar XML Converter https://csv-converter.catalogusservice.edurep.nl
Read me https://csv-converter.catalogusservice.edurep.nl/readme.php

Verzoek

Een verzoek kunt u indienen via onze servicedesk