OSO:2017/Inhoudelijke Eisen: verschil tussen versies

Uit Kennisnet Developers Documentatie
Ga naar: navigatie, zoeken
(Selectief uitleveren)
k (Telefoonnummer validatie)
Regel 22: Regel 22:
 
==Telefoonnummer validatie==
 
==Telefoonnummer validatie==
 
Bij het invoeren of wijzigen van een telefoonnummer in een ‘telefoon veld’ (communicatiesoort == ‘telefoon”) in OSO, dient een systeem:
 
Bij het invoeren of wijzigen van een telefoonnummer in een ‘telefoon veld’ (communicatiesoort == ‘telefoon”) in OSO, dient een systeem:
#Het nummer gecontroleerd mbv de Google library ‘libphonenumber’
+
#Het nummer gecontroleerd mbv de [https://github.com/googlei18n/libphonenumber Google library ‘libphonenumber’]
 
#Alleen nummers die door deze library als ‘valid’ worden beschouwd mogen geaccepteerd
 
#Alleen nummers die door deze library als ‘valid’ worden beschouwd mogen geaccepteerd
 
#Het nummer wordt vervolgens in het ‘'''E164’ formaat''' opgeslagen (output van library)<br>
 
#Het nummer wordt vervolgens in het ‘'''E164’ formaat''' opgeslagen (output van library)<br>

Versie van 27 feb 2017 om 12:39

Toepassen EduStandaard OSO Gegevensset

Dossiers verstuurd via de OSO infrastructuur moeten altijd voldoen aan de EduStandaard OSO gegevensset.

Dossier-formaat en -controle

Binnen OSO wordt gewerkt met één gestandaardiseerd formaat voor het Dossier; in OSO'17 wordt de Standaardversie: 2017.1.1 gebruikt.

Eis aan Bronsysteem

Een Bronsysteem moet voorafgaand aan verzending controleren dat het Dossier hieraan voldoet.

Eis aan Doelsysteem

  • Een ontvangend systeem mag voorafgaand aan het importeren een Dossier valideren tegen de correcte versie van de Standaard. Dit is niet verplicht.
  • Bij de verdere verwerking en import van het Dossier moet een ontvangend systeem dusdandig robuust zijn dat subversies van het Dossier verwerkt kunnen worden. Met subversies worden alle versies achter onder de hoofdversie bedoelt, dus bij een hoofdversie 2017.1 moeten zowel Dossiers van versie 2017.1.0 én 2017.1.1 worden geaccepteerd.)

Selectief uitleveren

Om bronscholen in staat te stellen de inhoud van een dossier aan te passen, zodanig dat de inhoud recht doet aan het doel van de overdracht (doelbinding) en daarbij rekening te houden met zowel de administratieve last voor de school als de impact hiervan voor systeembouwers. Er is gekozen om te gaan werken met profielen in combinatie met blokken van velden. Per profiel wordt aangegeven welke blokken verplicht, verboden dan wel optioneel zijn. De indeling per profiel is terug te vinden in de beschrijving van de OSO gegevensset.

Een school kan optionele blokken van velden uit het dossier verwijderen, zodat deze niet meegestuurd worden. De ontvangende school kan in het dossier zien of blokken bewust uitgezet zijn. Dit wordt door de pdf-viewer (door Kennisnet geleverd) ondersteund; ontvangende systemen zijn niet verplicht dit binnen hun systeem te tonen

In de gegevensset wordt in OSO’17 gewerkt met profielen. Een profiel verdeelt de gegevensset in blokken van velden. Per type uitwisseling (POVO, POPO, etc.) wordt aangegeven of een blok verplicht of optioneel is.

Zie ook: Selectief samenstellen Dossier.


Telefoonnummer validatie

Bij het invoeren of wijzigen van een telefoonnummer in een ‘telefoon veld’ (communicatiesoort == ‘telefoon”) in OSO, dient een systeem:

  1. Het nummer gecontroleerd mbv de Google library ‘libphonenumber’
  2. Alleen nummers die door deze library als ‘valid’ worden beschouwd mogen geaccepteerd
  3. Het nummer wordt vervolgens in het ‘E164’ formaat opgeslagen (output van library)

Bij het opslaan van het telefoonnummer wordt bij voorkeur/aanbevolen om de volgende structuur toe te passen: <telefoonnummer (E164 formaat)><spatie><aanvullende informatie>.

Op die manier kan er wel aanvullende informatie worden toegevoegd bij een telefoonnummer en wordt het interpreteren en controleren van telefoonnummers eenduidiger.