Struttura del Data Base SGML

I documenti definitivi in formato sgml rappresentano un vero e proprio db. La costruzione, manutenzione e sfruttamento di questo db è lo scopo del sistema dar.

Il data base è composto da due entità logiche: il documento e il link. Sono indicate inoltre quattro chiavi di accesso ai dati: la chiave primaria per dcl e name sui documenti; la chiave per owner sui documenti; la chiave from e to sui link e infine la chiave to e from sui link.

Il documento è il componente base della documentazione. Un documento ha un formato, denominato dtd, che ne definisce la struttura del contenuto. E' caratterizzato da un dcl che definisce l'argomento trattato. E' identificato dal dcl e dal name. Questa coppia viene indicata con la forma "dcl.name". Appartiene ad un gruppo di documenti che fanno capo ad un "owner".

Un documento può citare, richiamare o linkare altri documenti.

Ciascun collegamento è rappresentato da un singolo link. Il link riporta le chiavi di due documenti: il documento from e il documento to. L'insieme dei link che hanno lo stesso documento "from" fornisce l'elenco dei documenti citati. L'insieme dei link che hanno il medesimo documento "to" fornisce l'elenco dei documenti citanti. Questi link definiscono le relazioni uses e used by.

Ad ogni documento possono essere associate due liste di documenti. Liste che vengono ricavate dall'esame dei link. La prima lista comprende i documenti citati dal documento di riferimento. La seconda i documenti che citano il documento di riferimento.

Owner

Come abbiamo detto tutti i documenti hanno un documento owner. Il tipo di relazione dipende dal dcl del documento.

Esistono tre diverse relazioni di ownership:

1. Tra un documento categoria e i documenti che appartengono a quella categoria. Ambedue questi documenti appartengono allo stesso dcl. Questa relazione è presente per i dcl: req, dsg, man, dst, sys, dsu, amm, qcl, ris.
2. Tra un sistema sys e i componenti del medesimo. I componenti previsti di un sistema sono caratterizzati dai seguenti dcl: daf, dat, cla, fun, kon, job, rpt, uui.
3. Tra una classe cla e i suoi componenti. I componenti di una classe hanno i seguenti dcl: dat, fun, kon.

Sorgenti

I documenti automatici vengono generati a fronte dei sorgenti del sistema. Dunque il sorgente, inteso come contenitore, definisce o contiene uno o più documenti tecnici. I dcl automatici sono: daf, dat, cla, fun, kon, job, rpt, uui.