[[TOC(heading=Structuur)]]
[[TOC(heading=Omgeving, sectionindex, compact, depth=3, allactive, Documentatie/Ontwikkelaar/Omgeving/)]]
[[TOC(heading=Ontwikkelaar, sectionindex, compact, depth=2, allactive, Documentatie/Ontwikkelaar/)]]
[[TOC(heading=Documentatie, sectionindex, compact, depth=1, allactive, Documentatie/)]]

= Structuur =

Deze pagina beschrijft de structuur-bestanden van OpenAC. De bestanden heten `structuur.tsv` en zijn tab-gescheiden bestanden die voorkomen in alle kern- en adaptatie-modules van OpenAC. Ze beschrijven de structuur van de gegevens waar OpenAC mee werkt, en worden gebruikt om de database in te richten en om de weergave op het scherm te bepalen.

Gerelateerde onderwerpen:
 - [wiki:Documentatie/Beheerder/Schermen/Datamodel/Layout layout-taal] voor box en opties kolommen bij velden
 - Technische Documentatie (de oude)

== Structuurbestanden ==

Het complete datamodel is een combinatie van de structuurbestanden van alle geladen modules, en is dus pas bekend nadat alle modules zijn geladen. Omdat niet alle adaptaties van OpenAC dezelfde modules geladen hebben, kan het datamodel van verschillende adaptaties er dus ook verschillend uitzien.

Structuurbestanden zijn TSV-bestanden, dus zijn ze tabgescheiden. Elke regel beginnend met een hekje (#) is een commentaarregel en wordt genegeerd bij het inlezen van het bestand. De eerste niet-commentaarregel bevat de kolomnamen, de overige regels zijn dataregels. 

||= Kolom =||= Omschrijving =||= Voorbeeld =||
||tabel-veld||De naam van een tabel, of de naam van een veld met de naam van de tabel als prefix, waarbij tabelnaam en veldnaam zijn gescheiden door een dubbele punt.||'''Tabel:''' `medewerker`[[br]]'''Veld:''' `medewerker:code`||
||type||Informatie over het type van het de tabel of het veld.||Zie onder.||
||box||Voor velden geeft box de groepering op het scherm aan. Voor tabellen kan bij box een kleur worden opgegeven. In invoerschermen en het datamodel wordt een tabel afgebeeld in de opgegeven kleur.||Zie [wiki:Documentatie/Beheerder/Schermen/Datamodel/Layout layout-taal].||
||layout||De layout specificatie voor de presentatie van tabellen en velden op het scherm. Voor tabellen bepaalt layout de velden die worden opgenomen in de lijst view en de sortering van de lijst. Voor velden bepaalt layout de afmetingen van het veld en het bijbehorend label.||Zie [wiki:Documentatie/Beheerder/Schermen/Datamodel/Layout layout-taal].||
||opties||Opties voor een tabel of veld.||Zie onder.||
||enkelvoud||Weergave op het scherm – lidwoord plus enkelvoud.||
||meervoud||Weergave op het scherm – meervoud||||
||tooltip||Omschrijving die de gebruiker helpt bij het invullen||||

== Veldopties ==

De beschikbare veldopties worden vastgelegd in het bestand `tv_optie.tsv` in de kernmodule `d010_systeem`. Daarin staat een korte omschrijving van iedere optie. Hier staat de langere uitleg van de opties.

 - ''negatief'' Deze optie is alleen van toepassing op velden van het type ''getal''. Normaal staat OpenAC alleen positieve getallen toe, maar in een enkel geval moet het mogelijk zijn om ook een negatief getal in te voeren. Deze optie maakt dat mogelijk.
 - ''systeem'' Een systeemveld wordt niet geanonimiseerd bij het indienen van een anonieme backup; dit wordt gebruikt bij velden die geen een koppeling naar een andere tabel bevatten (maar die niet op een andere manier als zodanig zijn gemarkeerd).

== Tabelopties ==

De beschikbare tabelopties worden vastgelegd in het bestand `tv_optie.tsv` in de kernmodule `d010_systeem`. Daarin staat een korte omschrijving van iedere optie. Hier staat de langere uitleg van de opties.

 - ''zoekindex''
 - ''cached''
 - ''koppeltabel''
 - ''systeem''
 - ''logline'' Deze optie is alleen van toepassing op toptabellen. Een toptabel krijgt automatisch velden ''created'', ''modified'' en ''accessed'' die bij (bijna) elke bewerking worden aangepast. Deze worden bij sommige bewerkingen bijgewerkt. Voor sommige toptabellen is het van belang dat elke bewerking genoteerd wordt. Als de optie ''logline'' wordt toegevoegd, wordt bij elke handeling met entries uit de toptabel de administratie bijgewerkt. Dit brengt wel extra database-transacties met zich mee, vandaar dat het niet default aan staat.