|
|
|
# Inhoud #
|
|
|
|
- [Inleiding](/Gebruikershandreiking)
|
|
|
|
- [Instructies voor lokaal gebruik](/Gebruikshandreiking/Instructies-voor-gebruik)
|
|
|
|
- [Instructies voor centraal gebruik](/Gebruikshandreiking/Instructies-centraal-gebruik)
|
|
|
|
- [Gebruikersscenario's](/Gebruikshandreiking/Gebruikersscenario's)
|
|
|
|
|
|
|
|
# Voor wie zijn deze instructies? #
|
|
|
|
Houdt u zich bezig met het vastleggen van indicatoren voor het kwaliteitsregister? Dan zult u gebruik gaan maken van de KIK-Starter decentraal.
|
|
|
|
|
|
|
|
# Uitgangspunten #
|
|
|
|
Voor een optimaal gebruik van de decentrale KIK-Starter moet worden voldaan aan de volgende punten:
|
|
|
|
- U bent bekend met het concept van de ontologie.
|
|
|
|
- U beschikt over een digitale versie van de globale VPH ontologie, zodat validatiecriteria uitvoerbaar zijn.
|
|
|
|
- U weet hoe u data uit uw bronsysteem kunt (laten) omzetten naar linked data.
|
|
|
|
- U heeft de decentrale KIK-Starter geïnstalleerd conform de instructies op deze website.
|
|
|
|
|
|
|
|
# Hoe gebruik ik de decentrale KIK-Starter? #
|
|
|
|
Hieronder wordt stap voor stap toegelicht hoe u de decentrale KIK-Starter gebruikt. U heeft de decentrale KIK-Starter binnen uw netwerkomgeving geïnstalleerd volgens de instructies op deze website. Daarbij heeft u rekening gehouden met het aantal gebruikers en de minimale beveiligingsmaatregelen die op deze website zijn voorgesteld. Zie installatiehandleiding.
|
|
|
|
|
|
|
|
## Stap 1: extractie/export data uit bronsysteem ##
|
|
|
|
U dient uw data als triples (RDF-formaat) aan te leveren. Extraheer uw data vanaf uw bronsysteem. Verwerk de data tot RDF-data op basis van de KIK-V Verpleeghuisontologie en eventueel op basis van uw lokale ontologie. Daarbij moet uw lokale ontologie in lijn zijn met de KIK-V Verpleeghuisontologie.
|
|
|
|
De data moet in RDF-ondersteunend formaat worden aangeleverd: Turtle, JSON-LD of RDF/XML.
|
|
|
|
|
|
|
|
## Stap 2a: uploaden ontologie en RDF ##
|
|
|
|
Open vanaf uw browser de decentrale KIK-Starter op het adres dat binnen uw netwerkomgeving daarvoor is gereserveerd.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Ontologie en triples ###
|
|
|
|
Upload een ontologie in een OWL-bestand samen met de RDF-data.
|
|
|
|
Voor testdoeleinden [download hier](/Gebruikshandreiking/Instructies-voor-gebruik#) een OWL-bestand.
|
|
|
|
|
|
|
|
Zodra u de bestanden heb gekozen, druk op de knop "Upload".
|
|
|
|
|
|
|
|
|
|
|
|
## Stap 2b: Bestaande data ##
|
|
|
|
Indien u eerder een ontologie met RDF-data heeft geüpload dan kunt u die selecteren. Dit is alleen mogelijk voor zolang uw applicatie actief is. Zodra u de applicatie deactiveert in Docker, is de data niet langer beschikbaar. Dit moet de volgende keer opnieuw worden ingeladen.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Stap 3: Valideren ##
|
|
|
|
U kiest de juiste versie gegevensset/ontologie en geeft aan dat het systeem de data moet valideren. Het systeem gebruikt vervolgens de gespecificeerde validatieregels en toont het resultaat.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Kies de versie van de ontologie.
|
|
|
|
|
|
|
|
Klik op de knop "Valideer". En de decentrale KIK-Starter toont de resultaten van de validatie in een tabel met welk element is gecontroleerd en wat er fout aan is. Betekenis van rondje met kruisje is dat het een fout betreft, dus blokkerend voor verwerking van dat gegeven. Dat gegeven zal dus in een latere uitvraag niet worden meegenomen. Het is echter niet blokkerend voor het uploaden van de gegevens. Dit heeft echter wel gevolgen voor de mate van compleetheid van het queryresultaat.
|
|
|
|
Het symbool met driehoek is een waarschuwing. Dit heeft echter geen gevolgen voor de compleetheid en is niet blokkerend.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
U kunt de resultaten downloaden in Excel-bestand. Daarvoor klikt u op de knop "Download als Excel".
|
|
|
|
|
|
|
|
## Stap 4: Raadplegen ##
|
|
|
|
Het is mogelijk om een standaard query toe te passen voor uw raadpleging. Tevens kunt u uw eigen SPARQL-query invoeren.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Stap 5: Uitkomst query exporteren ##
|
|
|
|
Net zoals bij de uitkomst van het valideren van de data, is het ook mogelijk de uitkomst van een query te exporteren.
|
|
|
|
Klik daarvoor op de knop "Download als Excel".
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Converteren naar linked data
|
|
|
|
Indien u uw data heeft geexporteerd uit uw bronsysteem in de vorm van relationele data, dan kunt u met de KIK-Starter decentraal de relationele data omzetten naar linked data.
|
|
|
|
Hiervoor moet de relationele data wel overeenkomen met een sjabloon of referentieontwerp. Indien dat niet het geval is, dan moet er mogelijk een sjabloon voor de conversie op maat worden gemaakt.
|
|
|
|
|
|
|
|
Kies bij "Conversie*" voor "Upload".
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Kies bestand met specificaties hoe de conversie moet worden uitgevoerd.
|
|
|
|
Kies het bestand met de juiste ontologie.
|
|
|
|
Kies het databestand met ruwe data uit het bronsysteem
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Download het bestand en geef het een herkenbare naam zodat het later kan worden ingelezen in de KIK-Starter.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Ga naar tabblad "Uploaden data".
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Kies bestand met de juiste ontologie. Kies het bestand dat u hiervoor heeft geconverteerd (Converteren naar linked data).
|
|
|
|
|
|
|
|
Klik op upload. Daarmee leest u de data in de KIK-Start Decentraal. Dit is iets anders dan het uploaden van de query resultaten.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Het is zichtbaar (donkere weergave en statusbalk) dat de toepassing aan het werk is om de linked data in te lezen.
|
|
|
|
|
|
|
|
U kunt de data nu raadplegen, valideren en de query resultaten uploaden naar KIK-Starte Centraal.
|
|
|
|
|
|
|
|
# Uploaden query resultaten
|
|
|
|
Indien de standaard query resultaten geeft, dan kunt u ervoor kiezen de resultaten te uploaden naar de KIK-Starter decentraal. Let op: zodra u de standaard query wijzigt, en het niet meer standaard is, dan is het ook niet meer mogelijk de resultaten daarvan te uploaden. |
|
|
\ No newline at end of file |
