KVS:Standaard versies overzicht opvragen: verschil tussen versies
k |
(add cat handleiding) |
||
| (5 tussenliggende versies door 2 gebruikers niet weergegeven) | |||
| 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 = |
+ | == 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). |
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). |
||
| Regel 11: | Regel 10: | ||
{| class="wikitable" |
{| class="wikitable" |
||
|Stap 1 |
|Stap 1 |
||
| − | |Documentbron stuurt een |
+ | |Documentbron stuurt een verzoek naar KVS voor lijst met versies. |
|- |
|- |
||
|Stap 2 |
|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 |
||
| ⚫ | |||
|} |
|} |
||
| Regel 40: | Regel 27: | ||
|- |
|- |
||
|input |
|input |
||
| ⚫ | |||
| − | |dossier |
||
| ⚫ | |||
| − | |dossier (in xml formaat) inclusief attachments |
||
| − | |- |
||
| − | |input |
||
| − | |standaardversie (optioneel) |
||
| ⚫ | |||
|- |
|- |
||
|output |
|output |
||
| + | |lijst met versies |
||
| − | |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 |
||
|} |
|} |
||
| + | == Logging == |
||
| − | |||
| + | {{:KVS:Logging}} |
||
| − | |||
[[Categorie:Kennisnet Validatie Service]] |
[[Categorie:Kennisnet Validatie Service]] |
||
| + | [[Categorie:Handleiding]] |
||
Huidige versie van 23 mei 2014 om 10:02
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 verzoek naar KVS voor lijst met versies. |
| Stap 2 | Het KVS retourneert de lijst met versies. |
Preconditie
- De betrokken leverancier van Documentbron heeft een bewerkingsovereenkomst afgesloten met Kennisnet.
- Documentbron heeft toegang tot KVS
Aanroep parameters
| I/O | Parameter | Opmerkingen |
|---|---|---|
| input | ||
| output | lijst met versies | versies waartegen dossiers gevalideerd kunnen worden |
Logging
Het KVS registreert gebeurtenissen met betrekking tot het valideren van overstapdossiers. Deze registratie is aanvullend op de 'normale' logging van de systemen waarop het KVS is gehost. Het KVS registreert de volgende acties:
Deze registraties wordt gebruikt om een rapportage voorziening binnen Kennisnet te voorzien van gegevens om de dienst KVS de kunnen besturen en verbeteren. In deze rapportages en in de registraties worden GEEN persoonsgegevens of delen van overstapdossiers overgenomen. Alleen metagegevens over de controle (uitkomst, aanbiedend systeem, controleschema, etc.) worden gebruikt.