Skip to content

ACL Conventies

Joris Joppe edited this page Mar 20, 2017 · 6 revisions

rda logo 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:

Voor het ACL project

  • 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

Voor veld- en andere namen

  • 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)

Voor het opbouwen van de importscripts en workspaces:

  • hanteren van velddefinities volgens auditfile standaard
  • veldlengte en type is belangrijk voor het goed functioneren van analyses scripts (zoals bijvoorbeeld bij APPEND en RELATE. Voor zover deze niet voorgeschreven in de auditfile standaard wordt aangehouden wat is gedefinieerd in het bestand wsp_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.

Clone this wiki locally