KVS:Standaard versies overzicht opvragen: verschil tussen versies

Uit Kennisnet Developers Documentatie
Naar navigatie springen Naar zoeken springen
k
k
Regel 1: Regel 1:
  +
= User Story =
 
Ik ben Deelnemer en wil een overzicht van versies van de Standaard opvragen, waartegen dossiers gevalideerd kunnen worden, zodat ik een correct validatie verzoek kan indienen.
  
Ik ben Deelnemer en wil een overzicht van versies van de Standaard opvragen, waartegen dossiers gevalideerd kunnen worden, zodat ik een correct validatie verzoek kan indienen.
  +
  +
= Beschrijving =
  +
De Kennisnet Validatie Service biedt de service om een lijst met [[KVS:Ondersteunde_versies_van_de_EduStandaard_OSO|ondersteunde versies van de EduStandaard OSO]] op te vragen. Op basis van deze lijst kan een deelnemer een dossier valideren tegen de huidige of eerdere/afwijkende versies/implementaties van deze standaard. De validatie bestaat uit een controle van de syntax (op basis van een xsd) en een aanvullende controle op semantiek (met behulp van een xslt).
  +
  +
Een overzicht van door het KVS ondersteunde versies met de bijbehorende xsd en xslt bestanden is ook hier te vinden.
  +
  +
== Scenario ==
  +
  +
{| class="wikitable"
  +
|Stap 1
  +
|Documentbron stuurt een document naar het KVS via de <LINK NAAR WSDL> validerenDocument.
  +
|-
  +
|Stap 2
  +
|Het KVS controleert of er een testversie gespecificeerd is. Indien dit niet het geval is, wordt validatie uitgevoerd tegen laatste versie.
  +
|-
  +
|Stap 3
  +
|Het KVS controleer of gespecificeerde testversie correct (beschikbaar als testset binnen KVS) is. Indien dit niet het geval is, voert het KVS geen validatie uit.
  +
|-
  +
|Stap 4
  +
|Het KVS controleert of de grootte van het dossier binnen de marges van de specificatie valt.Indien dit niet het geval is, voert het KVS geen verdere validatie uit.
  +
|-
  +
|Stap 5
  +
|Het KVS voert validatie uit.
  +
|-
  +
|Stap 6
  +
|Het KVS retourneert de uitkomst van de validatie.
  +
|}
  +
  +
=== Preconditie ===
  +
* De betrokken leverancier van Documentbron heeft een bewerkingsovereenkomst afgesloten met Kennisnet.
  +
* Documentbron heeft toegang tot KVS
  +
  +
=== Aanroep parameters ===
  +
{|class="wikitable"
  +
! style="text-align:left;"| I/O
  +
! style="text-align:left;"| Parameter
  +
! style="text-align:left;"| Opmerkingen
  +
|-
  +
|input
  +
|dossier
  +
|dossier (in xml formaat) inclusief attachments
  +
|-
  +
|input
  +
|standaardversie (optioneel)
  +
|versie waartegen dossier gevalideerd wordt
  +
|-
  +
|output
  +
|uitkomst validatie
  +
|valide/niet valide
  +
|-
  +
|output
  +
|foutmeldingen (optioneel)
  +
|zie [[KVS:DossierValidatie#Controles en foutwaarden|foutwaarden]]
  +
|-
  +
|output
  +
|controle waarde (optioneel)
  +
|hashwaarde (md5) van gevalideerd dossier
  +
|-
  +
|output
  +
|standaardversie
  +
|versie waartegen dossier gevalideerd is
  +
|}
  +
  +
  +
   
   

Versie van 10 apr 2014 08:51

User Story

Ik ben Deelnemer en wil een overzicht van versies van de Standaard opvragen, waartegen dossiers gevalideerd kunnen worden, zodat ik een correct validatie verzoek kan indienen.

Beschrijving

De Kennisnet Validatie Service biedt de service om een lijst met ondersteunde versies van de EduStandaard OSO op te vragen. Op basis van deze lijst kan een deelnemer een dossier valideren tegen de huidige of eerdere/afwijkende versies/implementaties van deze standaard. De validatie bestaat uit een controle van de syntax (op basis van een xsd) en een aanvullende controle op semantiek (met behulp van een xslt).

Een overzicht van door het KVS ondersteunde versies met de bijbehorende xsd en xslt bestanden is ook hier te vinden.

Scenario

Stap 1 Documentbron stuurt een document naar het KVS via de <LINK NAAR WSDL> validerenDocument.
Stap 2 Het KVS controleert of er een testversie gespecificeerd is. Indien dit niet het geval is, wordt validatie uitgevoerd tegen laatste versie.
Stap 3 Het KVS controleer of gespecificeerde testversie correct (beschikbaar als testset binnen KVS) is. Indien dit niet het geval is, voert het KVS geen validatie uit.
Stap 4 Het KVS controleert of de grootte van het dossier binnen de marges van de specificatie valt.Indien dit niet het geval is, voert het KVS geen verdere validatie uit.
Stap 5 Het KVS voert validatie uit.
Stap 6 Het KVS retourneert de uitkomst van de validatie.

Preconditie

  • De betrokken leverancier van Documentbron heeft een bewerkingsovereenkomst afgesloten met Kennisnet.
  • Documentbron heeft toegang tot KVS

Aanroep parameters

I/O Parameter Opmerkingen
input dossier dossier (in xml formaat) inclusief attachments
input standaardversie (optioneel) versie waartegen dossier gevalideerd wordt
output uitkomst validatie valide/niet valide
output foutmeldingen (optioneel) zie foutwaarden
output controle waarde (optioneel) hashwaarde (md5) van gevalideerd dossier
output standaardversie versie waartegen dossier gevalideerd is
Overgenomen van "https://developers.wiki.kennisnet.nl/index.php?title=KVS:Standaard_versies_overzicht_opvragen&oldid=1118"