Le impostazioni di Contenuto per il Web Content Viewer
consentono all'utente di specificare quale contenuto della libreria di contenuto Web
visualizzare nel visualizzatore.
Nota: se non viene selezionato alcun contenuto nella configurazione per il visualizzatore,
il visualizzatore esegue il rendering del contenuto specificato dall'associazione
del contenuto Web sulla pagina che contiene il visualizzatore. Per aggiungere
o modificare le associazioni del contenuto Web di una pagina, modificare le impostazioni del contenuto Web
nelle proprietà della pagina dalla barra degli strumenti del sito.
Importante: solo il contenuto pubblicato
può essere visualizzato con il Web Content Viewer. Il contenuto bozza non può essere visualizzato e non può essere selezionato
quando si configura un Web Content Viewer.
Campi
- Tipo di contenuto
- Indica il tipo di contenuto Web di cui il visualizzatore esegue il rendering. È possibile
selezionare i seguenti tipi di contenuto:
- Elemento di contenuto
- Componente
- Elemento
Quando si seleziona un tipo di contenuto, nella finestra delle impostazioni vengono visualizzati
solo i campi relativi al tipo di contenuto selezionato.
- Comportamento del contenuto
- È possibile fare riferimento al contenuto con i seguenti metodi:
- Seleziona contenuto e percorso
- Questa impostazione fa riferimento al contenuto direttamente.
- Seleziona contenuto e utilizza l'associazione contenuto della pagina corrente
- Con questa impostazione il visualizzatore crea il percorso del contenuto di riferimento
relativo all'associazione di contenuto Web della pagina che contiene il
visualizzatore. Se per la pagina non è definita un'associazione di contenuto, questa
opzione non è disponibile.
- Quando questo portlet viene aggiunto ad una pagina
- Quando il visualizzatore esegue il rendering del contenuto, è possibile specificare che il visualizzatore
faccia riferimento al contenuto esistente o che crei il contenuto ed esegua
il rendering del nuovo contenuto. Questo campo è disponibile solo nella modalità Configura
del visualizzatore e non può essere utilizzato quando si fa riferimento a componenti.
- Visualizza contenuto esistente
- Con questa impostazione il visualizzatore esegue il rendering del contenuto esistente,
definito dal percorso del contenuto nel campo Contenuto.
- Crea contenuto (in base alla selezione)
- Questa impostazione crea una copia del contenuto presente nel campo Contenuto
e quindi esegue il rendering del nuovo contenuto nel visualizzatore. Quando si utilizza questa opzione
con una pagina template, il contenuto a cui fa riferimento il template viene copiato
quando viene creata una nuova pagina dal template. Il contenuto viene copiato
nell'area del sito specificata, che viene definita automaticamente come
associazione di contenuto sulla nuova pagina.
- Contenuto
- Questa impostazione identifica il percorso del contenuto di cui è stato eseguito il rendering. Il percorso è composto di due parti:
- La libreria del contenuto Web che contiene il contenuto
- La gerarchia dell'area del sito in cui si trova il contenuto
È possibile specificare
il percorso del contenuto modificando l'impostazione.
Se il contenuto non viene selezionato esplicitamente,
per individuare il contenuto viene utilizzata l'area del sito identificata dall'associazione
di contenuto Web della pagina.Quando si esegue il rendering
di un componente, l'elemento di contenuto selezionato fornisce al componente
un contesto. Ad esempio, si potrebbe selezionare un elemento di contenuto denominato "news"
come contesto per un navigatore. In questo caso, quando la pagina viene inizialmente aperta,
il navigatore considera "news" come l'elemento di contenuto corrente.
- Componente
- Questa impostazione identifica il componente di cui il visualizzatore deve eseguire il rendering.
- Elemento
- Questa impostazione identifica l'elemento nel contenuto selezionato di cui il visualizzatore deve
eseguire il rendering. Per utilizzare questa impostazione, è necessario che sia presente un elemento
nel contenuto a cui fa riferimento il campo Contenuto.
- Template di presentazione alternativo
- Questa impostazione identifica un template di presentazione alternativo
da utilizzare quando l'elemento di contenuto di cui è stato eseguito il rendering. Se non è selezionata una presentazione alternativa,
l'elemento di contenuto di cui è stato eseguito il rendering con il
template di presentazione predefinito.
Contesto della pagina
Se la pagina
corrente ha un contesto di pagina attivo, l'elemento o l'elemento di contenuto configurato
non è visibile se il portlet è configurato per ricevere i
link da altri portlet. Un contesto di pagina esiste sempre quando un portlet ha
precedentemente trasmesso un elemento di contenuto a questa pagina. È possibile eliminare un contesto di pagina attivo
facendo clic su Cancella contesto di pagina.
Impostazioni bloccate
È possibile
bloccare le impostazioni nella modalità Configura del
visualizzatore. Quando un'impostazione viene bloccata, viene visualizzata un'icona lucchetto
nella modalità Modifica impostazioni condivise del visualizzatore,
e il link Modifica non è disponibile.
Percorsi di contenuto e ID univoci
Quando si configura il visualizzatore,
i percorsi del contenuto vengono rappresentati come percorsi leggibili
che includono la libreria e le aree del sito che contengono il
contenuto.
Tuttavia, nella configurazione del visualizzatore, l'ubicazione di un
elemento di contenuto viene in genere memorizzata come ID univoco dell'elemento. L'utilizzo dell'ID
univoco è utile in quanto il visualizzatore può ancora eseguire il rendering
del contenuto anche se l'elemento viene ridenominato o spostato.
Se si configura
il visualizzatore con l'interfaccia di configurazione XML (xmlaccess),
si può scegliere di specificare l'ubicazione del contenuto con il percorso del contenuto,
invece dell'ID univoco. Con il percorso del contenuto, non è necessario
determinare l'ID univoco dell'elemento di contenuto. Ma se l'elemento di contenuto in seguito viene spostato
o ridenominato, il visualizzatore non può più eseguire il rendering del
contenuto.
Se un visualizzatore è stato configurato per utilizzare i percorsi del contenuto,
viene visualizzata un'icona percorso (
) dopo il percorso del titolo. Se si modifica la
configurazione in modo che faccia riferimento ad un contenuto diverso, l'ubicazione del nuovo
elemento di contenuto continua a essere memorizzata come percorso del contenuto.
Se si desidera invece memorizzare l'ubicazione come ID univoco, è necessario
fare clic su Cancella prima di selezionare il nuovo contenuto.
Viene rimossa anche l'icona percorso per indicare che il percorso del contenuto non viene
più utilizzato.