-
Notifications
You must be signed in to change notification settings - Fork 31
ACL Conventies
Joris Joppe edited this page Mar 20, 2017
·
6 revisions
De interpretatie en het efficiënt gebruik van ACL wordt in belangrijke mate vergroot als scripts op een consistente wijze tot worden geschreven. De scripts die onderdeel uit maken van de RDA zullen daarom zoveel als mogelijk de volgende conventies hanteren:
- tabellen gebruik voor de analyse worden ingelezen en in het ACL project opgeslagen in een input-folder
- gegenereerde output wordt in het ACL project opgeslagen in een ouput-folder
- eventueel gecreëerde tussenbestanden worden na afronding van het script geautomatiseerd verwijderd
- waar mogelijk worden veldnamen zoals gedefinieerd in de importroutine gehanteerd. Dit zullen, zoveel als mogelijk de veldnamen uit de auditfile definitie zijn
- nieuw aangemaakte velden krijgen een duidelijke naam met een prefix a_
- in scripts aangemaakte variabelen krijgen een prefix v_
- indien een analyse bestaat uit meerdere scripts (bijvoorbeeld bij een DO ... WHILE .... loop) worden verwijzen de bij elkaar behorende batchbestanden naar elkaar en blijkt uit de naamgeving duidelijk dat deze bij elkaar horen (de meest geëigende manier hiervoor is het gebruik van een suffix en adequate documentatie in de scripts zelf)
- hanteren van velddefinities volgens auditfile standaard
- veldlengte en type is belangrijk voor het goed functioneren van analyses scripts (zoals bijvoorbeeld bij
APPENDenRELATE. Voor zover deze niet voorgeschreven in de auditfile standaard wordt aangehouden wat is gedefinieerd in het bestandwsp_master.wsp. - velden die in een bronbestand niet bestaan of niet herleidbaar zijn uit andere velden (bijvoorbeeld straat en huisnummer die gecombineerd zijn in 1 veld) worden gevuld met de waarde NaN.
De code behorende bij de referentieset data-analyse en andere content in deze repository worden beschikbaar gesteld onder de voorwaarden van de Apache License 2.0. Lees er hier meer over.