Elenco delle Processing Instruction note ad eXtraWay

Autore:
Tirabassi Roberto, Ritelli Walter

Introduzione

Nell'ambito del progetto eXtraWay, che basa tutta la gestione documenti sul formato nativo XML, sono state concepite alcune Processing Instruction aventi diverso ruolo.
Questo documento ha lo scopo di distinguere le diverse tipologie di Processing Instruction (di seguito P.I.) e descriverne lo scopo.

Di seguito l'elenco delle Processing Instruction disponibili.

  1. <?xw-sr?>...<?xw-er?>
  2. <?xw-ar ...?>
  3. <?xw-nest [numero]?>
  4. <?xw-sk [numero]?> ovvero <?xw-nsk [numero]?>
  5. <?xw-meta ...?>
  6. <?xw-crc [tipo]=[valore]?>

<?xw-sr?>...<?xw-er?>

Le processing instruction...

<?xw-sr?>...<?xw-er?>

...vengono utilizzate da eXtraWay per decorare i documenti selezionati.
Se la ricerca conduce alla selezione di un documento per mezzo di una chiave reperita in un elemento, il documento XML caricato e tornato al chiamante deve mettere lo stesso in condizione di poter dare evidenza del fatto che in quel particolare elemento è presente un termine che è stato significativo per la selezione. Il termine singificativo viene quindi preceduto dalla P.I. <?xw-sr?> e seguito P.I. <?xw-er?> (Start Reverse ed End Reverse) così da isolare il termine rilevante.

Queste P.I. sono dinamiche, ovvero aggiunte dal server in virtù della selezione effettuata solo in fase di caricamento documenti a seguito di una ricerca.
Non è previto che venga tornata al server in nessun caso.

<?xw-ar ...?>

La processing instruction...

<?xw-ar [nome attributo]?>

...viene utilizzata da eXtraWay per decorare i documenti selezionati.
Se la ricerca conduce alla selezione di un documento per mezzo di una chiave reperita in un attributo, il documento XML caricato e tornato al chiamante deve mettere lo stesso in condizione di poter dare evidenza del fatto che quel particolare attributo è stato significativo per la selezione. L'elemento che contiene quell'attributo, quindi, viene seguito dalla P.I. suddetta nella quale figura il nome dell'attributo che contiene il termine rilevante.

Questa P.I. è dinamica, ovvero aggiunta dal server in virtù della selezione effettuata solo in fase di caricamento documenti a seguito di una ricerca.
Non è previto che venga tornata al server in nessun caso.

<?xw-nest [numero]?>

La processing instruction...

<?xw-nest [numero]?>

...viene utilizzata dal server quando viene caricato un documento che ne nidifica al suo interno degli altri. Essa, quindi, viene prodotta dinamicamente dal server in applicazioni dove i documenti sono organizzati gerarchicamente anche nell'XML e non solo tramite legami logici tra loro.
La P.I. viene messa nei punti in cui, per il documento dato, si andranno ad innestare i rami di figli di questo documento (con la loro generazione di altri documenti ulteriormente nidificati e così via). Ciò consente al server di ricostruire, all'atto del salvataggio del documento, la giusta gerarchia di documenti e rappresentarli correttamente anche nel file XML.

Questa P.I. è dinamica, ovvero aggiunta dal server in fase di caricamento documenti. Parimenti è attesa dal server in fase di salvataggio in modifica del documento in esame.

<?xw-sk [numero]?> ovvero <?xw-nsk [numero]?>

In particolari applicazioni si parla disuddivisione di un singolo documento in parti note con la denominazione di Prunable Branches. Questi rami di potatura sono parti integranti del documento, non documenti in esso nidificati, ma per semplificare l'uso dei documenti soprattutto se sono di ampie dimensioni, si provvede a non tornare al chiamante l'intero documento ma solo la parte che risulta essere di suo interesse. Il documento sarà quindi caricato tornandone l'ossatura principale ed i soli Prunable Branches utili (secondo algoritmi non discussi in questa sede).

Al pari delle P.I. di cui al precedente paragrago (Vds. <?xw-nest [numero]?>) anche queste vengono prodotte dinamicamente all'atto del caricamento del documento ma non si prevede che vengano tornate al server in alcun caso (in caso di modifica di un simile documento esso va inviato per intero). Ogni punto in cui ha origine un Prunable Branche il server imposta, dando loro un ordine numerico progressivo, la P.I. <?xw-sk [numero]?> se questo ramo è stato potato e <?xw-nsk [numero]?> se questo ramo non è stato potato.

<?xw-meta ...?>

eXtraWay Server incorpora nei documenti da esso prodotti o inseriti una serie di Meta Dati atti ad identificare la struttura organizzativa che si occupa dei dati, il software usato e così via.
Per un chiarimento esaustivo in proposito confrontare Uso e significato dei Meta Dati in eXtraWay.

<?xw-crc [tipo]=[valore]?>

Ogni unità informativa prodotta o manutenuta tramite il server eXtraWay viene siglata con un checksum che auita il server, nei successivi accessi al documento, a comprendere se esso sia stato maldestramente modificato a mano o comunque al di fuori del controllo del server stesso.
Il Checksum viene calcolato seguendo un algoritmo noto ad eXtraWay e riportato nel documento, solitamente in coda. Sono disponibili più tipi di algoritmi per il calcolo di questo Checksum quindi la P.I. comprende anche un'identificazione dell'algoritmo utilizzato. In proposito confrontare Il codice di controllo.

Date
2006/04/06 16:20:02

Torna a Indice delle voci


HighWay/eXtraWay Project - Frequently Asked Questions (Doxygen 1.6.1)