GENERACIÓ DE PLANTILLES D'EXPORTACIÓ

Les plantilles són fitxers en format HTML que poden contenir els textos, imatges i vincles habituals en qualsevol document HTML i, per tant, poden ser generades amb qualsevol editor HTML com per exemple FrontPage® o Dreamweaver®. També poden ser plantilles en format XML, en aquest cas poden contenir els elements típics d'aquest format.

La seva particularitat és que contenen claus específiques dins de comentaris HTML (mai no són visibles des dels exploradors) que permeten al programa interpretar-los i substituir-los per les metadades indicades. Hi ha una clau per gairebé cada una de les diferents entrades del fitxer de metadades i relacions, de manera que amb aquestes claus, l'usuari pot indicar amb precisió quina és la informació que desitja mostrar.

El programa llegeix la plantilla i substitueix les claus per la informació sol·licitada (a partir de les metadades de la capa a considerar), generant un document HTML totalment estàndard que pot ser inclòs, per exemple, en una web de cartografia, o servir com a sistema d'exportació a altres usuaris, o com alternativa al XML; o un document XML.

Per a facilitar l'ús d'aquesta funcionalitat es proporcionen les següents plantilles (situades al directori "Plantill" del directori d'instal·lació del MiraMon):

Per a més informació sobre les claus específiques consulteu Glossari de comandes per a generar les plantilles de metadades.

TIPUS I SINTAXI DE LES CLAUS ESPECÍFIQUES

Les claus es poden agrupar en diferents tipus:

ReadClauText
STB
MAJ
SiNoBuida
Tractament per a claus repetides

ReadClauText

Aquesta clau serveix per mostrar una entrada de metadades o relacions. La seva sintaxi és la següent:

<!-- ##ReadClauText:???## --> on ??? és qualsevol de les claus del Glossari indicades als apartats ReadClauText.

Exemple: Si escrivim, <!-- ##ReadClauText:IDENTIFICATION:DatasetTitle## --> el resultat que s'obtindrà, en el cas que l'entrada contingui informació, serà el títol de la base: "Model Digital d'Elevacions d'Europa".

STB

Aquesta clau serveix per mostrar títols fixos o noms de la informació que es mostrarà. La seva sintaxi és la següent:

<!-- ##STB:???## --> on ??? és qualsevol descriptor stb del GeM+ o del general. Podem obtenir un llistat dels descriptors stb que poden usar obrint metadata.stb o general.stb (al directori del MiraMon) amb un editor de text.

Exemple: Si escrivim, <!-- ##STB:FitxerMetadades## --> el resultat que s'obtindrà serà: "Fitxer de metadades".

MAJ

Aquesta clau serveix per mostrar un text en majúscules, ja sigui el valor d'una entrada o un text provinent d'un missatge general o de metadades. La seva sintaxi és la següent:
<!-- ##STB:MAJ???## --> o <!-- ##ReadClauText:MAJ???## --> on ??? és qualsevol descriptor stb del GeM+ o del general o una de les claus que fan referència a una entrada de metadades.

Exemple: Si escrivim, <!-- ##STB:MAJ:FitxerMetadades## --> el resultat que s'obtindrà serà: "FITXER DE METADADES".
Exemple: Si escrivim, <!-- ##ReadClauText:MAJ:IDENTIFICATION:DatasetTitle## --> el resultat que s'obtindrà serà: "MODEL DIGITAL D'ELEVACIONS D'EUROPA".

SiNoBuida

Aquesta clau serveix per no mostrar determinats parts de la plantilla si una entrada és buida o no aplica. D'aquesta manera, en cas que el valor d'una entrada sigui buit, tot el que hi hagi entre les claus de un SiNoBuida no es mostrarà. La seva sintaxi és la següent:

<!-- ##SiNoBuida:???## --> i <!-- ##FiSiNoBuida## --> on ??? és qualsevol de les claus del Glossari indicades a la secció ReadClauText i SiNoBuida.

Entre la clau <!-- ##SiNoBuida:???## --> i la clau <!-- ##FiSiNoBuida## --> es pot posar les claus <!-- ##STB:???## --> i <!-- ##ReadClauText:???## --> que volem, així com text o claus pròpies del llenguatge HTML.

Les comandes <!-- ##SiNoBuida:???## --> i <!-- ##FiSiNoBuida## --> es poden niar, amb l'única restricció que en una mateixa línia de la plantilla no hi pot haver més d'un <!-- ##SiNoBuida:???## --> i d'un <!-- ##FiSiNoBuida## -->.

Exemple: Si a la plantilla hi ha:

<!-- ##SiNoBuida:IDENTIFICATION:DatasetTitle## -->
<i><!-- ##STB:T_DatasetTitle## -->:</i>
<!-- ##ReadClauText:IDENTIFICATION:DatasetTitle## --><BR>
<!-- ##FiSiNoBuida## -->

es comprovarà que la clau IDENTIFICATION:DatasetTitle contingui alguna informació, i en cas de en tingui es mostrarà tot el que hi hagi entre la clau SiNoBuida i la clau FiSiNoBuida, que en aquest cas serà el següent:

Títol de la base: Model Digital d'Elevacions d'Europa

Tractament per a claus repetides

Algunes entrades de metadades admeten una cardinalitat de tipus N, és a dir més d'un valor per aquella entrada de metadades. Per exemple per a una mateixa base es poden definir un o més títols alternatius o una taula de la base de dades pot tenir més d'un camp que cal descriure.

Per aquest motiu a les plantilles és necessari definir com cal mostrar UN d'aquests elements i el programa repeteix aquesta estructura tantes vegades con sigui necessari per a mostrar tots els valors de l'entrada de metadades. Existeixen comandes específiques que permeten definir l'inici i el final del codi HTML per mostrar cada un dels elements (vegeu apartats "Claus per a Repeticions" del Glossari de comandes).

Exemple: En el cas dels títol alternatius (secció Identificació) les claus per a repeticions són:

<!-- ##IDENTIFICATION:TITOLSALTERNATIUS## -->
<!-- ##FiIDENTIFICATION:TITOLSALTERNATIUS## -->


de manera que el codi HTML de la plantilla podria ser:

<HR><DL><i><!-- ##STB:T_TitolAlternatiu## -->:</i>
<!-- ##IDENTIFICATION:TITOLSALTERNATIUS## -->
<DD><!-- ##ReadClauText:IDENTIFICATION:AlternateTitle## -->
<!-- ##FiIDENTIFICATION:TITOLSALTERNATIUS## -->
</DL><HR>

i això generaria el codi HTM:

<HR><DL><i>Títol alternatiu:</i>
<DD>IEFC
<DD>Inventari Forestal
</DL><HR>

que es visualitza com:


Títol alternatiu:
IEFC
Inventari Forestal

Noteu que el text "Títol alternatiu" (obtingut a partir de la comanda STB) es troba fora de les comandes d'inici i fi de claus repetides i per aquest motiu el resultat el conté tan sols una vegada. En cas que el codi HTM hagués estat:

<HR>
<!-- ##IDENTIFICATION:TITOLSALTERNATIUS## -->
<B><!-- ##STB:T_TitolAlternatiu## -->:</B>
<!-- ##ReadClauText:IDENTIFICATION:AlternateTitle## --><br>
<!-- ##FiIDENTIFICATION:TITOLSALTERNATIUS## -->
<HR>

el fitxer HTML de metadades tindria l'aspecte:


Títol alternatiu: IEFC
Títol alternatiu: Inventari Forestal