In dit artikel bespreken we hoe je een dataverzoek kan opstellen. Hierin nemen we je stap voor stap mee in het proces van het aanmaken, uitsturen, ontvangen en monitoren van de verzoeken.
Deze functionaliteit is te vinden in een tabje aan de linkerkant van het platform, genaamd "verzoeken".
Het aanmaken van een verzoek
Het aanmaken van een verzoek kan worden gedaan door iemand met de rol van 'analist'
Om een aanvraag aan te maken, ga naar de "verzoeken" pagina via de navigatie en klik op "+ Nieuw dataverzoek" om naar de volgende pagina te gaan.
Stap 1: Invullen van algemene informatie
Op deze nieuwe pagina zijn een aantal open velden. Hierin kan kan het verzoek een naam krijgen, een toelichting en een uiterste datum van aanlevering.
Stap 2: Selecteren van dataverstrekker(s)
Vervolgens kun je selecteren naar welke gebruikers het verzoek gestuurd gaat worden. Je kunt hier groepen of individuele gebruikers selecteren.
Stap 3: Definitie van data specificaties
De data specificatie regels zijn erg belangrijk. Deze regels zorgen ervoor dat de data in het juiste formaat aangeleverd wordt. De regels kunnen ingesteld worden op de kolomnaam, het data type, het toestaan van lege cellen en eventueel extra specificaties (bijvoorbeeld "de waarde moet groter zijn dan 1"). Hier volgt een kort overzicht van welke specificaties voor welke data-types mogelijk zijn:
Voor het data-type "Tekst"
- Gelijk aan
- Niet gelijk aan
- Lengte van tekst
- Voldoet aan eisen voor geldig BSN
- Regular expression (zie hieronder)
Voor het data-type "Geheel getal"
- Gelijk aan
- Ongelijk aan
- Tussen/bereik
- Minimaal
- Maximaal
Voor het data-type "Datum"
- Gelijk aan
- Niet gelijk aan
- Tussen/bereik
- Voor
- Na
Voor het data-type "Boolean"
- Gelijk aan waar/niet waar (true / false)
Voor het data-type "Kommagetal"
- Gelijk aan
- Ongelijk aan
- Tussen/bereik
- Minimaal
- Maximaal
Zorg ervoor dat minimaal één regel is ingesteld voordat je het verzoek verstuurt.
Stap 4: Versturen van verzoek
Voor het versturen van het verzoek klik je op de knop "Verstuur". Vervolgens komt er een pop-up ter bevestiging, waarin een samenvatting zichtbaar is. Wanneer deze is bevestigd, ontvangen alle geselecteerde dataverstrekkers een uitnodiging via e-mail.
Regular expression
Om een validatieregel in te stellen met behulp van een reguliere expressie, moet je ervoor zorgen dat de kolom van het gegevenstype tekst is, zodat je de regel kunt toevoegen. Vervolgens kun je een beschrijving invoeren om gebruikers aan te geven wat voor input verwacht wordt. De beschrijving kan een voorbeeld bevatten, zoals “E-mailadres (bijv. johndoe@gmail.com)”.
Voer in het veld 'Reguliere expressie' het validatiepatroon in. Reguliere expressies zijn patronen die worden gebruikt om specifieke tekenreeksen te matchen. Om bijvoorbeeld een e-mailadres te valideren, zou je ^[\w.-]+@[a-zA-Z\d.-]+.[a-zA-Z]{2,6}$ kunnen gebruiken. Dit patroon zorgt ervoor dat de e-mail letters, cijfers, punten of koppeltekens bevat, gevolgd door een '@', een domein en een geldige extensie.
Je kunt ook 'Hoofdlettergevoelig' selecteren als je reguliere expressie gevoelig moet zijn voor hoofdletters en kleine letters. Deze optie is over het algemeen niet aangevinkt voor algemene validaties zoals e-mails, telefoonnummers of postcodes, maar kan nuttig zijn voor meer specifieke gevallen.
Gebruik het veld 'Test je expressie' om je expressie uit te proberen. Dit kan door voorbeeldgegevens in te voeren om te zien of deze overeenkomt, aangezien de input van gebruikers hierdoor gevalideerd zal worden.
Ter referentie staan hieronder een aantal veelvoorkomende patronen die je als regex kunt gebruiken:
- Mobiel nummer (NL):
^\+31\s?6\s?\d{8}$(e.g., "+31 6 12345678") - Postcode (NL):
^\d{4}\s?[A-Z]{2}$(e.g., "1234 AB") - Email adres:
^(([^<>()\[\]\\.,;:\s@"]+(\.[^<>()\[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$(e.g., "example@example.com") - IBAN (NL):
^[A-Z]{2}\d{2}[A-Z\d]{4}\d{7}([A-Z\d]?){0,16}$(e.g., "NL91ABNA0417164300")
Tip! Als je regexes wil uitproberen kan de volgende website handig zijn: https://regexr.com/
Vraag: Is het mogelijk om verzoeken zowel aan te maken als te ontvangen?
Antwoord: Ja, dat kan! Als je de juiste toestemming hebt van de beheerder is het mogelijk om verzoeken aan te maken en te ontvangen.