26 Configurazione dell'elemento del modello

Guida di WebCenter Sites

La schermata Elemento consente di creare l'elemento del modello, definire il tipo di file del modello (XML, JSP o HTML), fornire la logica dell'elemento e assegnare un nome all'elemento. Ad esempio:

Nel campo Crea elemento modello è possibile scegliere il tipo di file XML, JSP o HTML per la logica dell'elemento e popolare il campo Logica elemento con codice stub standard (da includere in qualsiasi elemento che si intende creare).

Se si utilizza il campo Crea elemento modello per creare, ad esempio, un file .jsp, WebCenter Sites aggiunge le istruzioni taglib JSP e la tag RENDER.LOGDEP al campo Logica elemento per impostazione predefinita, in modo che WebCenter Sites possa inserire nel log la dipendenza compositiva tra questo asset di modello e le pagine visualizzate da questo elemento. Per tutti gli altri tipi di file, WebCenter Sites aggiunge un codice specifico per il tipo di file. Il codice personalizzato può essere aggiunto nel campo Logica elemento.
Il campo Percorso/nome file di memorizzazione elemento consente di assegnare un nome al file che contiene la logica dell'elemento e di specificare il percorso del file.

Quando si salva l'asset di modello, i valori del campo nella schermata Elemento vengono scritti in una riga (che rappresenta l'elemento) della tabella ElementCatalog.

Nota:

Informazioni sulla selezione di un elemento esistente

Nel passi descritti di seguito si suppone che si stia creando un nuovo elemento per l'asset di modello. Se tuttavia si esegue la migrazione degli asset da una release di WebCenter Sites precedente e si desidera riutilizzare un elemento esistente, è necessario identificare correttamente l'elemento in modo che WebCenter Sites possa trovarlo e associarlo a questo asset di modello.

Per selezionare un elemento esistente, effettuare le operazioni riportate di seguito.

Nel campo Descrizione ElementCatalog, immettere una descrizione dell'elemento.
Nel campo Percorso/nome file di memorizzazione elemento immettere un valore in base alla convenzione di denominazione indicata nella tabella "Convenzioni di denominazione che utilizzano TemplateName" all'interno dell'argomento "Denominazione di un asset di modello" in Sviluppo con Oracle WebCenter Sites.
Nel campo Parametri elemento specificare le variabili o gli argomenti che è possibile passare all'elemento.
Salvare e riaprire l'asset di modello.

WebCenter Sites verifica l'esistenza dell'elemento denominato.

Se l'elemento è stato denominato in modo corretto, WebCenter Sites lo riconosce e ne visualizza il codice nel campo Logica elemento.

Se non esiste un elemento denominato o se è denominato in modo errato, WebCenter Sites non fa nulla. Quando si ispeziona o si modifica l'asset di modello, WebCenter Sites visualizza un messaggio che indica che il form non contiene elementi radice. Non appena si specifica un codice per l'elemento e si assegna il nome corretto all'elemento, WebCenter Sites lo rileva e lo associa con il modello.

Nella schermata Elemento effettuare le seguenti operazioni.

Nel campo Uso specificare l'uso previsto per il modello utilizzando le informazioni nella tabella come linee guida.

Opzione di utilizzo	Descrizione
Utilizzo non specificato	Specifica un modello per la generazione di HTML. Non è noto se il modello è un modello Body (vedere la riga 2 di questa tabella) o url (vedere la riga 3 di questa tabella).
L'elemento è usato all'interno di una pagina HTML	Specifica un modello utilizzato all'interno della tag `<BODY>...</BODY>` di una pagina HTML. Questa opzione caratterizza il modello come modello Body.
L'elemento viene utilizzato come layout.	Specifica un modello di layout che genera una pagina HTML completa e viene utilizzato per visualizzare gli asset in modalità Web.
L'elemento definisce un'intera pagina HTML e può essere richiamato esternamente.	Specifica un modello che genera una pagina HTML completa e può essere utilizzato in un URL. Questa opzione caratterizza il modello come modello URL.
L'elemento viene inviato come flusso di dati di tipo RAW	Specifica un modello che genera dati binari RAW di tipo sconosciuto diverso da HTML.

Nel campo Templates richiamati selezionare gli eventuali modelli che verranno richiamati da questo modello.
Nel campo Crea elemento modello effettuare una delle operazioni indicate di seguito.
- Per creare un file .xml, fare clic su XML. Il codice che viene incollato proviene dall'elemento OpenMarket\Xcelerate\AssetType\Template\modelXML.xml e può essere modificato in modo da utilizzare una logica predefinita personalizzata.
- Per creare un file .jsp, fare clic su JSP. Il codice che viene incollato proviene dall'elemento OpenMarket\Xcelerate\AssetType\Template\modelXML.xml e può essere modificato in modo da utilizzare una logica predefinita personalizzata.
- Per creare un file .html, fare clic su HTML. Il codice che viene incollato proviene dall'elemento OpenMarket\Xcelerate\AssetType\Template\modelXML.xml e può essere modificato in modo da utilizzare una logica predefinita personalizzata.
WebCenter Sites inserisce i valori nei seguenti campi.
- Nel campo Logica elemento immettere un'intestazione e altro codice autogenerato.
  
  Se ad esempio è stato selezionato il pulsante JSP, WebCenter Sites immette una direttiva della libreria di tag per ciascuna delle librerie di tag JSP di WebCenter Sites. WebCenter Sites imposta anche una tag RENDER.LOGDEP (render:logdep) per contrassegnare una dipendenza compositiva tra l'asset di modello e qualsiasi pagina o pagelet visualizzato con il modello.
- Campo Percorso/nome file di memorizzazione elemento. Non modificare il valore di questo campo.
  
  Questo campo visualizza il nome file dell'elemento preceduto dal percorso del file dell'elemento.
  
  Quando si salva l'asset di modello, il valore nel campo Percorso/nome file di memorizzazione elemento viene salvato nella colonna dell'URL della tabella ElementCatalog per la riga che rappresenta l'elemento.
Il campo Rootelement è prepopolato con il valore fornito nella tabella "Convenzioni di denominazione che utilizzano TemplateName". Non modificare il valore di questo campo. Se il valore predefinito viene modificato, il funzionamento di alcune tag che utilizzano il valore predefinito, come la tag render:calltemplate con l'attributo style impostato su element, verrà compromesso.
(Facoltativo). Nel campo Descrizione ElementCatalog, immettere una descrizione dell'elemento. Quando si salva l'asset di modello, le informazioni in questo campo vengono scritte nella colonna della descrizione per l'elemento immesso nella tabella ElementCatalog.
Nel campo Logica elemento, specificare un codice per l'elemento. Assicurarsi di immettere tutto il codice tra le due tag cs:ftcs.

Se si utilizza JSP, rimuovere i commenti dalle direttive taglib che descrivono le librerie di tag in uso.

Nota:

Verifica della condivisione dei modelli o della possibilità di replicare il sito

Per condividere l'asset di modello o rendere replicabile il sito corrente, assicurarsi che la logica dell'elemento del modello non faccia riferimento direttamente ad asset, tipi di asset, nomi di attributo o nomi di modello. Utilizzare, invece, la tag render:lookup e le chiavi prescritte come spiegato in "Condivisione dei modelli e replica del sito" in Sviluppo con Oracle WebCenter Sites. In Configurazione della mappa è possibile mappare le stesse chiavi alle informazioni dell'asset a cui è necessario accedere per utilizzarle nella logica dell'elemento.

Richiamo di un modello

I modelli devono sempre essere richiamati dalla tag render:calltemplate e mai dalla tag render:callelement o render:satellitepage.
Il campo Parametri elemento e i campi Parametri elemento aggiuntivi sono utilizzati per immettere variabili o argomenti da passare all'elemento, qualora lo richieda la progettazione del sito.
- Il campo Parametri elemento corrisponde alla colonna resdetails1 della tabella ElementCatalog. Quando si salva il modello, WebCenter Sites scrive l'ID modello (tid) in questo campo (ovvero nella colonna resdetails1).
- Il campo Parametri elemento aggiuntivi corrisponde alla colonna resdetails2 nella tabella ElementCatalog. WebCenter Sites lascia vuoto questo campo.
Se la struttura del sito richiede di utilizzare altre variabili oltre a tid nell'elemento del modello, immettere le variabili in uno dei campi precedenti. Immetterle come coppie name=value con più argomenti separati dal carattere di "e" commerciale (&). Ad esempio:
```
MyArgument=value1&YourArgument=value2
```
Ogni campo supporta fino a 255 caratteri.

Per ulteriori informazioni sulle variabili, vedere "Sviluppo del sito Web con le tecnologie delle tag" in Sviluppo con Oracle WebCenter Sites
Fare clic su Continua per aprire la schermata SiteEntry.