DULT-koppeling stappenplan

Inleiding

Dit stappenplan helpt u om de toetsresultaten van de leerlingen in Cito LOVS over te zetten naar ESIS.
Het is raadzaam dit stappenplan door te lezen voor u start met de Dultkoppeling!

Dit artikel bestaat uit de volgende onderdelen:

Stappen eerste inrichting.
Uitleg matchstatus.
Werkwijze volgende keren.
Mogelijke problemen.

DULT is een afkorting voor Digitale Uitwisseling van Leerlinggegevens en Toetsresultaten. Via de Dultkoppeling komen de gegevens uit het Cito LOVS geautomatiseerd en gebruiksvriendelijk in ESIS-B. Hiermee is de Dultkoppeling een belangrijk hulpmiddel voor scholen die met het Cito LOVS en met ESIS-B werken.

Kenmerken:

• De toetsresultaten vanuit het Cito LOVS worden geautomatiseerd overgezet naar ESIS-B.
• De toetsresultaten die overgezet worden met behulp van de Dultkoppeling, bevatten ook de resultaten van de digitale toetsen.
• Cito biedt de resultaten aan op toetsniveau; dit wil zeggen dat itemscores of categoriescores niet overgezet worden met behulp van de Dultkoppeling.
• De Dultkoppeling is alleen beschikbaar voor scholen die jaarlijks een onderhoudscontract met Cito afsluiten.

Samenvatting van de te doorlopen stappen:
De stappen wanneer u voor de eerste keer gebruik gaat maken van de Dultkoppeling:

1. Koppel in ESIS de rol Dultwebservices aan de gebruiker die systeembeheerder is in Cito LOVS.
2. Zorg dat in ESIS de gebruiker die de Dultkoppeling in ESIS gaat uitvoeren, het recht hiertoe heeft.
3. Controleer in ESIS of de toetsen die u in Cito LOVS gebruikt “aan” staan.
4. Controleer in ESIS de Instellingen-Koppelingen zoals deze standaard staan ingesteld.
5. Pas alleen indien nodig deze instellingen aan.
6. In Cito LOVS vult de systeembeheerder onder Beheer>Opties-Koppelingen-DULT de benodigde gegevens in om de Dultkoppeling tot stand te brengen.
7. Test de verbinding in Cito LOVS.
8. Schoon de leerlinggegevens in Cito LOVS op door het verzonden EDEXML-bestand in te lezen.
9. Verzend het totaalbestand vanuit Cito LOVS naar DULT.
10. In ESIS verwerkt u dit ontvangen bestand.
11. Maak een keuze welke schooljaren u wilt verwerken.
12. Match de leerlingen.
13. Verwerk de toetsresultaten in ESIS.

Gebruik van de Dultkoppeling voor alle volgende keren:

1. Na een aanpassing in Cito LOVS wordt bij het afsluiten van Cito LOVS door de systeembeheerder automatisch één keer per week een jaarbestand verzonden naar DULT.
2. In ESIS verwerkt u dit ontvangen bestand.
3. De leerlingen in dit jaarbestand waarvan de eerste keer nog geen match verwerkt is, worden in het Matchscherm getoond. Match deze leerlingen.
4. Verwerk de toetsresultaten in ESIS.

De stappen toegelicht
De eerste keer dat u de Dultkoppeling gebruikt, doorloopt u de volgende stappen: 

1. Voordat uw school bestanden met toetsresultaten kan uitwisselen met ESIS, dient u in ESIS de rol Dult Webservices te koppelen aan de gebruiker die in Cito LOVS systeembeheerder is. Op dit moment betekent dit dat deze gebruiker in ESIS  inlogt met de rol Dult Webservices. Deze gebruiker dient een andere rol te selecteren om deze menu-onderdelen te kunnen gebruiken.
   
   
2. Bij de eerste uitlevering van de Dultkoppeling door Rovict, wordt het recht voor de Dultkoppeling gekoppeld aan alle gebruikers die in hun rol het recht hebben op de Toetsbeheerfuncties (zoals een Intern Begeleider).
   
   
   De gebruiker met dit recht kan in ESIS bij Import-Export-Koppelingen > Dultkoppeling de bestanden met toetsresultaten verwerken in ESIS.
   Indien u het recht op Dultkoppeling bij een bepaalde rol wilt wijzigen, kunt u dit doen bij Inrichten >Gebruikers en rollen.
   
   
3. Controleer in ESIS bij Toetsen > Toetsen activeren of de toetsen die u in Cito LOVS gebruikt in ESIS “aan” staan. Mocht dit niet zo zijn, vink deze toetsen en toetsversies dan aan.
   
   
   Alleen dan kunt u deze toetsen selecteren bij Toetsoverzichten en bij Onderwijs > Toetsresultaten invoeren.
   
   
4. In uw Cito LOVS gaat u naar Beheer>Opties - Koppelingen - DULT. Vul hier de gegevens in die noodzakelijk zijn om te kunnen uitwisselen.
   
   
   
   Webservice
    - Koppeling met: Er kunnen één of meerdere DULT-koppelingen gemaakt worden.
   Meer koppelingen maken is alleen nodig als u vanuit Cito LOVS naar meer dan één ESIS-omgeving wilt koppelen.
   - URL: Per DULT-koppeling vult u hier in: 
        https://schakelpunt.rovictonline.nl/DULTService.asmx
   - Login-id en Wachtwoord: Hier vult u uw inlognaam en wachtwoord van ESIS in. Let op dat dit de inlognaam en wachtwoord is van de gebruiker die in ESIS de rol Dultwebservices heeft (zie stap 2).
   
   Let op:  Als de gebruiker die in ESIS de rol Dultwebservices heeft, zijn wachtwoord in ESIS aanpast, dient ook hier het wachtwoord aangepast te worden.
   
   - Broncode/ID: het BRINNUMMER is al door CITO gevuld.
   
   EDEXML Import
   - Webservice gebruiken: Rovict adviseert om deze op Automatisch te zetten. Op deze manier beschikt u elke dag over de meest recente EDEXML uit ESIS.
   - Interval: Wijzig de interval naar: Wekelijks.
   
   DULT-Export
   - Versturen: zet dit op Vragen en vink Versturen alleen door Beheerder aan.
   - Leerlingidentificatie: moet op Meenemen staan. 
   - Interval: zet deze op Wekelijks. Cito LOVS verzendt op deze manier één keer per week een bestand naar ESIS, mits er in die periode wijzigingen/toevoegingen zijn aangebracht in Cito LOVS.
   
   
5. Klik (in uw Cito LOVS) op <Test verbinding>. Het Cito LOVS geeft aan of er een succesvolle verbinding met DULT gemaakt kan worden. (Zie kopje 'Mogelijke problemen' in dit artikel  als verbinding maken niet lukt.)
   
   
6. Om goed met de Dultkoppeling te kunnen werken, is het noodzakelijk dat de leerlinggegevens in ESIS exact gelijk zijn aan die in het Cito LOVS. De matching zal goede resultaten opleveren als de leerlinggegevens van het huidige jaarbestand zijn overgezet van ESIS naar het Cito LOVS met behulp van een EDEXML export.
   Wij adviseren u om uw leerlinggegevens van het huidige schooljaar in het Cito LOVS op te schonen door een recent EDEXML-bestand uit ESIS in te lezen. Dit bestand is automatisch verzonden naar Cito LOVS door verbinding te maken tussen Cito LOVS en DULT (stap 7 uit dit stappenplan).
   
   
   
   Als u op het icoontje (driehoek) klikt, wordt de EDEX-export gestart. Het volgende scherm wordt in Cito LOVS getoond:
   
   
   
   U klikt op <Volgende>.
   
   
   
   Maak uw selectie en klik op <Voltooien>. Het volgende scherm wordt getoond:
   
   
   
   Tip: Het Cito LOVS heeft een opschoonfunctie (Beheer>Probleemoplosser>Leerlingen zoeken/ontdubbelen) om de leerlinggegevens bij te werken. In de handleiding bij het Cito LOVS kunt u meer lezen over deze functie.
   
   
7. In uw Cito LOVS gaat u naar Beheer>Opties - Koppelingen - DULT. Klik op <Verzend alles>. Daarmee wordt een totaal bestand van alle beschikbare schooljaren in Cito LOVS aan ESIS aangeboden. Sluit Cito LOVS af.
   LET OP: Bij het afsluiten uw Cito LOVS krijgt u een van beide pop-up schermen te zien:
   
   
   
   
   
   Beantwoord deze vraag met <NEE/NO>.
   
   
8. In ESIS gaat u naar Instellen >Dultkoppeling. U komt in het overzichtsscherm.
   
   
   
   
9. Het zojuist verzonden bestand heeft de status Wordt Ontvangen. De status van het bestand wijzigt vanzelf in Ontvangen.
   
   
10. Verwerk dit bestand door op <Verwerken> te klikken.
    
    
11. ESIS toont een scherm waarin u de schooljaren, waarvan u de toetsresultaten wilt verwerken, kunt selecteren. Standaard zijn de laatste acht schooljaren geselecteerd. Dit betekent dat voor een leerling in leerjaar 8 de toetsresultaten vanaf leerjaar 1 tot nu verwerkt kunnen worden.
    
    
    
    
12. Na selectie van de schooljaren klikt u op <OK>.
    
    
13. U komt nu in het Matchscherm van ESIS. Hier kunt u de leerlinggegevens in ESIS en Cito met elkaar matchen. ESIS zal alleen de toetsresultaten verwerken van leerlingen, die gematcht zijn of die u handmatig matcht.
    Standaard toont ESIS in het zoekresultaat alle leerlingen ongeacht het matchresultaat. Met het zoekfilter kunt u een andere zoekopdracht geven om bijvoorbeeld alle leerlingen te zien. (Zie kopje Uitleg statussen Match leerlinggegevens in dit document).
    
    
    
    
    
14. Beoordeel de leerlingen met de Matchstatus Matig door op <Beoordelen match> te klikken.
    
    
    
    Indien u akkoord gaat, klikt u op <Match akkoord>. De matchstatus wijzigt in Verwerkt. De leerling verdwijnt uit dit scherm. U kunt de leerling opzoeken door de selectie te wijzigen in Verwerkt Ja.
    
    
    
    Als u niet akkoord gaat, klikt u op <Match verwijderen>. De matchstatus wijzigt in Geen.
    
    
15. Leerlinggegevens met matchstatus Geen kunt u handmatig matchen door op <Handmatig leerling selecteren> te klikken. U kunt nu een leerling zoeken waarmee u de match wilt maken.
    
    
    
    Selecteer deze leerling en klik op <OK>. De matchstatus verandert in Verwerkt. De leerling verdwijnt uit dit scherm. U kunt de leerling opzoeken door de selectie te wijzigen in Verwerkt Ja.
    
    
    
    Indien geen leerling gevonden wordt om te matchen, klikt u op <Annuleren>. U komt terug in het matchscherm en de leerling heeft nog altijd de matchstatus Geen.
    
    
16. Na het klikken op <Volgende> komt u in het Controleverslag (scherm 64.02). In dit verslag toont ESIS hoeveel toetsresultaten er wel en niet verwerkt kunnen worden en de reden voor het niet kunnen verwerken.
    
    
17. U start de verwerking door op <Volgende> te klikken. ESIS toont het scherm waarin u de verwerking daadwerkelijk start door op <Gereed> te klikken. 
    
    
18. ESIS toont het overzichtsscherm (64.01) . De status van het bestand is gewijzigd in Gepland met de datum en tijdstip waarop verwerking ingepland staat.
    
    
19. Zodra het bestand verwerkt is, ontvangt de gebruiker die het bestand verwerkt heeft een e-mail.
    
    
20. De toetsresultaten (van de gematchte leerlingen) uit Cito LOVS zijn verwerkt in ESIS.
    
    
21. U kunt dit steekproefsgewijs controleren door in Cito LOVS een rapport te maken per leerling of per groep voor een aantal toetsen die u verzonden heeft. 
    
    
22. Als u in ESIS bij Onderwijs >Toetsresultaten invoeren deze toets opzoekt of via Onderwijs > Leerlingdossier de betreffende leerling opzoekt, ziet u dat de resultaten die via de Dultkoppeling zijn overgezet in ESIS, cursief getoond worden.
    In de toetsoverzichten (Overzichten en exporten > Toetsoverzichten) kunt u de resultaten die via de Dultkoppeling zijn overgezet in ESIS, ook terugvinden. Deze resultaten worden hier echter niet cursief getoond.

Uitleg statussen Match leerlinggegevens
Onderstaande tabel toont op basis van welke criteria de match status Goed, Voldoende en Matig vastgesteld wordt. Een <X> in de tabel betekent dat het gegeven in Cito LOVS overeen komt met ESIS.

Uitleg matchstatus Geen, Dubbel en Verwerkt

Alle volgende keren dat u via de Dultkoppeling de toetsresultaten wilt uitwisselen met ESIS, gaat u als volgt te werk:

1. In uw Cito LOVS zijn de toetsresultaten (wijzigingen) ingevoerd.
   LET OP:
   - Alléén wanneer u in Cito LOVS bij Beheer>Opties - Koppelingen - DULT de DULT-export Automatisch op Altijd heeft staan, wordt bij het afsluiten van Cito LOVS door de systeembeheerder automatisch één keer per week een jaarbestand verzonden naar DULT, mits er in die periode wijzigingen/toevoegingen zijn aangebracht in Cito LOVS.
   - Indien u in Cito LOVS bij Beheer>Opties - Koppelingen - DULT de DULT-export op Vragen heeft staan, krijgt de systeembeheerder bij het afsluiten een pop up-scherm te zien met de vraag of hij een DULT-export wil maken. 
   a. Deze beantwoordt u met Ja, als uw school die week in ESIS nog geen Cito-bestand via de Dultverwerking in ESIS heeft ontvangen of als uw school het ontvangen bestand nog niet klaar heeft staan voor verwerking in ESIS (Status Gepland).
   b. Deze beantwoordt u met Nee, als uw school die week in ESIS een ontvangen Cito-bestand klaar heeft gezet voor verwerking (Status Gepland).
   
   
2. In ESIS gaat u naar Import-Export-Koppelingen > Dultkoppeling. U komt in het overzichtsscherm.
   
   
3. Hier ziet u dat het zojuist verzonden bestand de status Wordt Ontvangen heeft.
   
   
4. Zodra de status van het koppelbestand is gewijzigd in Ontvangen kunt u deze verwerken.
   
   
5. U komt nu in het Matchingscherm van ESIS. Hier ziet u de leerlingen met toetsresultaten in het jaarbestand wat u vanuit Cito LOVS verzonden heeft, waarvan de match nog niet verwerkt is. De reeds eerder gematchte leerlingen staan onder Verwerkt Ja.
   
   
6. Matchen van deze leerlingen. (zie stappen 15-17).
   
   
7. Keuze om te verwerken of te annuleren. (zie stappen 15-17).
   
   
8. Als u kiest voor <Verwerken>, dan ziet u in het overzichtsscherm dat de status verandert in Gepland met de datum en tijdstip waarop de verwerking is ingepland.
   
   
9. Zodra het bestand verwerkt is, ontvangt u een e-mail.
   
   
10. De toetsresultaten (van de gematchte leerlingen) uit Cito LOVS zijn verwerkt in ESIS.
    
    
11. U kunt dit controleren door in Cito LOVS een rapport te maken per leerling of per groep voor de toetsen die u verzonden heeft.
    
    
12. Als u in ESIS bij Onderwijs >Toetsresultaten invoeren deze toets opzoekt of via Onderwijs > Leerlingdossier de betreffende leerling opzoekt, ziet u dat de resultaten die via de Dultkoppeling zijn overgezet in ESIS, cursief getoond worden.
    In de toetsoverzichten (Overzichten en Exporten > Toetsoverzichten) kunt u de resultaten die via de Dultkoppeling zijn overgezet in ESIS ook terugvinden. Deze resultaten worden hier echter niet cursief getoond.

Als u een aantal keren via de Dultkoppeling de toetsresultaten heeft uitgewisseld met ESIS, kunt u ervoor kiezen de verwerking automatisch te laten verlopen.

1. In Cito LOVS vult u de toetsresultaten in of wijzigt deze.
   Let op: Nu is het van belang dat u in Cito LOVS bij Beheer > Opties > Koppelingen > DULT de DULT-export op Automatisch Altijd heeft staan. Nu wordt bij het afsluiten van Cito LOVS door de gebruiker met beheerrechten automatisch één keer per week een jaarbestand verzonden naar DULT, mits er in die periode wijzigingen/toevoegingen zijn aangebracht in Cito LOVS.
   
   
2. Dit bestand wordt ontvangen in ESIS en de match van leerlinggegevens en het verwerken van de toetsresultaten gebeurt automatisch in ESIS. U hoeft dus geen handelingen meer uit te voeren voor de uitwisseling van de toetsresultaten van Cito LOVS naar ESIS.

Mogelijke problemen

1. Geen verbinding met DULT
   U heeft in Cito LOVS <Test verbinding> geklikt en u krijgt de terugkoppeling dat de verbinding niet gemaakt kan worden.
   - Controleer of de URL die u heeft ingetypt de juiste is.
   - Controleer of Login-ID en/of wachtwoord correct zijn.
   - Controleer of u bij Leerlingidentificatie Meenemen heeft geselecteerd.
   
   
2. Overgezette Toetsresultaten zijn niet juist
   U kunt dit op 2 manieren oplossen:
   - Het laatste verwerkte bestand terugdraaien. Alle gewijzigde, toegevoegde of verwijderde resultaten worden teruggezet naar de situatie voordat het bestand in ESIS verwerkt was.
   - U heeft een resultaat voor een toets niet goed ingevoerd in Cito LOVS. Pas deze in uw Cito LOVS aan en start het DULT-proces opnieuw. Bij verwerking in ESIS zal dit resultaat het "oude" resultaat in ESIS vervangen.
   
   
3. Het ontvangen bestand is niet juist
   U kunt een koppelbestand met status Ontvangen of Gepland verwijderen door op <Verwijderen> te klikken. Het koppelbestand krijgt de status Archief. De toetsresultaten zijn niet verwerkt in ESIS.
   
   

Matchproblemen oplossen
Een leerling staat in ESIS in het Match Overzichtscherm meerdere keren getoond. Hoe kan dit en hoe is dit op te lossen?
Zie het voorbeeld hieronder:



In Cito LOVS ziet u bij Beheer>Probleemoplosser>Leerlingen zoeken/ontdubbelen dat die leerling ontdubbeld moet worden. In de handleiding bij het Cito LOVS kunt u meer lezen over deze functie.



Als u op deze manier in Cito LOVS de leerlinggegevens heeft opgeschoond, zult u na het verzenden van een nieuw jaarbestand vanuit Cito LOVS in ESIS zien dat deze leerling één keer getoond wordt in het Match Overzichtscherm.

Uitzonderingssituaties
Instelling Koppelingen
De standaard Instellingen koppelingen zijn in ESIS zo ingericht dat het merendeel van de scholen daar goed mee kan werken.
Hieronder een schematisch overzicht wat de instellingen zijn.

In welke situaties moet u deze Instellingen aanpassen?

1. U heeft 2 Cito LOVS systemen en één ESIS: Instelling Alleen meest actuele bestand verwerken wijzigen in Nee. ESIS kan nu bestanden uit beide Cito Volgsystemen ontvangen.
2. U wilt niet dat de toetsresultaten uit Cito LOVS bewaard worden als in ESIS reeds resultaten zijn ingevoerd. Verander dan Wijze van verwerking van dubbele toetsresultaten in Handmatige invoer bewaren.
3. U wilt dat ESIS naast de toetsresultaten uit Cito LOVS ook de handmatig in ESIS ingevoerde resultaten bewaard. Verander dan de Wijze van verwerking van dubbele toetsresultaten in Beide bewaren.

Meer ESIS omgevingen en maar één Cito LOVS
Volgorde wordt dan:
- In uw Cito LOVS vult u bij de URL de URL met BRINnummer en vestigingsnummer (bekend in ESIS) in onder Beheer>koppelingen>DULT.
- Voorbeeld URL:
https://schakelpunt.rovictonline.nl/DULTService.asmx?brin=19QW&vestiging=00 § - - -- Maak een nieuw tabblad aan bij DULT. U vult nu bij Beheer>koppelingen>DULT het brinnummer /vestigingsnummer in van uw tweede ESIS omgeving.



- U start het DULT-proces door òf uw Cito LOVS af te sluiten òf door op <Verzend alles> te klikken. - In ESIS ontvangt u dit bestand en zult u zien dat de leerlingen die niet in deze ESIS-omgeving staan, niet herkend worden (Matchstatus is Geen). Deze leerlingen en hun resultaten zullen dus niet in deze ESIS-omgeving verwerkt worden.
- U gaat weer terug naar uw Cito LOVS. Start nogmaals het DULT-proces.
- U opent deze ESIS-omgeving. In het Matchscherm ziet u dat de leerlingen die tot de andere ESIS-omgeving behoren hier de status Geen hebben. De resultaten van deze leerlingen zullen in deze ESIS-omgeving dus niet verwerkt worden.

Resultaat: In beide ESIS-omgevingen zijn bij de leerlingen de toetsresultaten uit Cito LOVS opgenomen.