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:

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