Guida di Lotus Domino Designer 8.5 - Inserimento di codice XML in un modulo o pagina

IMPOSTAZIONE DELLE APPLICAZIONI

Inserimento di codice XML in un modulo o pagina
Un modulo rappresenta il mezzo perfetto per l'uso di XML. È possibile immettere al loro interno i tag XML e inserire dei campi tra i tag per l'immisione dei dati. Il risultato è un documento XML contenente dati che assumono significato una volta inviati a un parser XML.

È inoltre possibile inserire XML all'interno di una pagina. In IBM® Lotus® Domino(TM) Designer, una pagina rappresenta un elemento di impostazione di un database che visualizza informazioni. È possibile usare una pagina per il tradizionale contenuto di un'applicazione o come home page, oppure utilizzare i tag XML per descrivere le caratteristiche dei dati contenuti in una pagina. Come descritto nella sezione sull'uso di XML in una vista, una pagina è utile anche per incorporare una vista e aggiungere i tag XML necessari per l'elaborazione della vista. Una pagina è utile inoltre per la creazione di fogli di stile estesi (XSL) o di fogli di stile a cascata (CSS) destinati a fornire a un server o un browser informazioni sul formato da assegnare ai dati descritti mediante i tag XML.

Definizione dei dati di un modulo con elementi XML

Quando si usano elementi XML in un modulo o una pagina, è necessario seguire le regole di costruzione di XML validi e assegnare ai tag XML il formato appropriato.

I tag XML sono molto simili ai tag HTML. Ci sono alcune regole diverse relative alla strutturazione dei tag XML che è necessario applicare durante la marcatura dei dati. Ad esempio, i requisiti per l'annidamento di XML sono più severi rispetto a quelli di HTML. Per informazioni relative alla marcatura dei dati con tag XML, andare al sito Web di IBM relativo a XML, http://www.ibm.com/xml

In un esempio sull'uso di XML in modulo riguardante informazioni su dei libri, le voci relative a ciascun libro all'interno di uno catalogo di libri on-line potrebbe apparire nel modo seguente:

<?xml version="1.0" encoding="UTF-8" ?>

<BOOK>

<bookTitle>Chess for the Master</bookTitle>

<bookCategory>Games</bookCategory>

<bookAuthor>Alice B. Charles</bookAuthor>

<bookPrice>10</bookPrice>

<bookListPrice>12</bookListPrice>

<bookISBN>0-980-38475-81</bookISBN>

<bookDatePublished>April 1997</bookDatePublished>

<bookAbstract>The authority on all the latest chess moves, including the entire Big Blue arsenal.</bookAbstract>

</BOOK>

Nota I tag XML sono sensibili alla grafia. I tag <book>, <Book> e <BOOK> sono quindi diversi l'uno dall'altro. Le maiuscole e minuscole nei tag di apertura e di chiusura devono corrispondere esattamente affinché XML sia formulato in maniera ottimale.

Per creare documenti in formato XML

1. Creare un nuovo modulo o una nuova pagina.

2. Immettere la document type declaration, ovvero:

<?xml version="1.0" ?>

È possibile, facoltativamente, aggiungere un riferimento a un codifica, come:

<?xml version="1.0" encoding="UTF-8" ?>

3. Immettere gli elementi XML (in genere, un elemento radice contenente sottoelementi).

4. Immettere i campi che conterranno i dati marcati con XML.

5. Scegliere Imposta - Proprietà del modulo.

6. Nella pagina Info, scegliere "Rendering HTML in Notes".

Questa proprietà indica a Domino di trasferire il testo dell'intero documento al richiedente HTTP senza generare tag HTML.

7. Salvare e chiudere il modulo.

8. Per visualizzare i documenti creati mediante il modulo, creare una vista che utilizzi una formula di modulo riferita al nome del modulo XML.

Formattazione di dati XML mediante fogli di stile

Una delle caratteristiche di XML è che si occupa solo della descrizione di dati e non del loro aspetto. L'aspetto non è importante in transazioni da computer a computer, a meno che non si debbano presentare questi dati a delle persone (ad esempio, inserendoli in un sito Web). I documenti XML, per determinare l'aspetto e la struttura dei dati, si basano generalmente su fogli di stile. Alcuni browser dispongono di stili predefiniti per gli elementi più comuni, come <Para>, <List> e <Item>, ma, di solito, è necessario usare un foglio di stile che definisca il formato dei dati. Esistono due tipi di fogli di stile che possono essere utilizzati con XML:

Fogli di stile di linguaggio estensibile (XSL), che definiscono le modalità di trasformazione di dati XML in HTML o in altre versioni di XML.
Fogli di stile a cascata (CSS) che assegnano lo stile di XML direttamente su browser Web che supportano CSS.

Per usare un foglio di stile, immettere il tag che cui si riferisce il foglio di stile immediatamente dopo la document type declaration e prima dell'elemento principale. Ad esempio:

<?xml version="1.0" encoding="UTF-8" ?>

<?xml-stylesheet type="text/css" href="bookdisplay.css"?>

<BOOK>

Se si crea un foglio di stile su una pagina, impostare la proprietà della pagina su "Usa contenuto della pagina come HTML".

Un foglio di stile XSL da utilizzare per trasformare informazioni su alcuni libri in HTML potrebbe essere:

<?xml version="1.0" ?>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/TR/WD-xsl" >

<xsl:template pattern="BOOK">

<HTML>

<HEAD>

<TITLE><xsl:value-of select="BOOKTITLE" /></TITLE>

</HEAD>

<BODY bgcolor="F0FFF8">

<B><xsl:value-of select="BOOKAUTHOR"/></B>

</BODY>

</HTML>

</xsl:template>

</xsl:stylesheet>

<?xml:stylesheet type="text/xsl" href="/roibooks.nsf/bookform.xsl"?>

Un foglio di stile a cascata (CSS), invece, non traduce XML in HTML, ma fornisce istruzioni sul formato di ciascun elemento XML direttamente al server. Un foglio di stile CSS relativo ai libri potrebbe essere:

BOOK {

display: block;

border: 1px solid #cccccc;

}

BOOKTITLE {

display: block;

float: left;

margin-right: 10px;

padding: 5px;

}

BOOKAUTHOR {

display: block;