31 Configuración del elemento

Ayuda de WebCenter Sites

La pantalla Elemento (CS Element) sirve para crear el elemento de CSElement, definir el tipo de archivo del elemento (XML, JSP o HTML), proporcionar la lógica del elemento y asignar un nombre al elemento. Por ejemplo:

El campo Crear elemento ofrece una selección de tipos de archivo XML, JSP o HTML para la lógica del elemento, y se utiliza para extraer el campo Lógica del elemento con código stub estándar (que debe incluirse en cualquier elemento que cree).
Cuando se utiliza el campo Crear elemento para crear, por ejemplo, un archivo .jsp, WebCenter Sites agrega sentencias taglib JSP y la etiqueta render.logdep al campo Lógica del elemento por defecto para que se registre la dependencia composicional entre este activo de CSElement y las páginas que se representan desde este elemento. Para otros tipos de archivos, WebCenter Sites agrega código específico del tipo de archivo. Hay que agregar el código propio al campo Lógica del elemento.

Para obtener información acerca de las dependencias, consulte Acerca de las dependencias. Para obtener ayuda acerca de la codificación de la lógica del elemento, consulte Codificación de elementos para plantillas y CSElements.
El campo Nombre de archivo/ruta de acceso de almacenamiento del elemento nombra el archivo que contiene la lógica del elemento y especifica la ruta de acceso al archivo.

Al guardar CSElement, los valores del campo en la pantalla Elemento se escriben en una fila (que representa el elemento) en la tabla ElementCatalog.

Nota:

Acerca de la selección de un elemento existente

En los siguiente pasos, vamos a suponer que va a crear un elemento nuevo para el activo CSElement. No obstante, si va a migrar activos de una versión de WebCenter Sites anterior y desea reutilizar un elemento existente, tiene que identificar el elemento correctamente para que WebCenter Sites lo encuentre y lo asocie al activo de CSElement.

Para seleccionar un elemento existente

(Opcional). En el campo Descripción de ElementCatalog, escriba una descripción del elemento.
En el campo Nombre de archivo/ruta de acceso de almacenamiento del elemento, introduzca un valor de acuerdo con la convención de Asignación de un nombre al CSElement.
Si el diseño del sitio lo requiere, introduzca los argumentos adecuados en los campos de los parámetros del elemento. Para obtener instrucciones, consulte el paso El texto del enlace no se puede resolver.
Guarde y vuelva a abrir el activo de CSElement.

WebCenter Sites comprueba la presencia de un elemento con el nombre correcto:

Si el elemento tiene el nombre correcto, WebCenter Sites reconoce el elemento y muestra su código en el campo Lógica del elemento.

Si el elemento con nombre no existe (o tiene un nombre incorrecto), WebCenter Sites no hace nada. Cuando se inspecciona o se edita el activo de CSElement, WebCenter Sites muestra un mensaje que indica que no hay ningún elemento raíz en la pantalla. En cuanto se codifica el elemento y se le asigna el nombre correcto, WebCenter Sites lo detecta y lo asocia al activo de CSElement.

Para configurar un elemento nuevo, introduzca los campos en la pantalla del elemento CSElement.

En el campo Crear elemento, realice una de las siguientes acciones:
- Para crear un archivo .xml, haga clic en XML. El código que se pega procede del elemento OpenMarket\Xcelerate\AssetType\CSElement\modelXML.xml y se puede modificar para utilizar la lógica por defecto personalizada.
- Para crear un archivo .jsp, haga clic en JSP. El código que se pega procede del elemento OpenMarket\Xcelerate\AssetType\CSElement\modelJSP.xml y se puede modificar para utilizar la lógica por defecto personalizada.
- Para crear un archivo .html, haga clic en HTML. El código que se pega procede del elemento OpenMarket\Xcelerate\AssetType\CSElement\modelHTML.xml y se puede modificar para utilizar la lógica por defecto personalizada.
WebCenter Sites rellena los siguientes campos:
- Campo Nombre de archivo/ruta de acceso de almacenamiento del elemento. No cambie el valor de este campo.
  
  El campo muestra el nombre de archivo del elemento precedido por la ruta de acceso al archivo de elemento. Por defecto, el archivo lleva el nombre del activo de CSElement (que se ha introducido en el paso ) seguido de la extensión del archivo:
  
  CSElementName.xml_or_jsp_or_html
  
  Cuando se guarda el activo de CSElement, el valor de este campo se escribe en la columna URL de la tabla ElementCatalog para la fila que representa el elemento.
- Campo Lógica del elemento con una cabecera y otra información.
  
  Por ejemplo, si hace clic en el botón JSP, WebCenter Sites define una directiva de biblioteca de etiquetas para algunas bibliotecas de etiquetas de JSP de WebCenter Sites comunes (asset, siteplan, render). WebCenter Sites también define las etiquetas cs:ftcs iniciales y finales, y una etiqueta RENDER.LOGDEP (render:logdep) para marcar una dependencia composicional entre el activo de CSElement y cualquier página o pagelet que representa el elemento.
El campo Rootelement se rellena previamente con el nombre del archivo del elemento (CSElementName.xml_or_jsp_or_html). No cambie el valor de este campo.

El elemento raíz se muestra por su nombre en la tabla ElementCatalog. Al crear código que llama a este elemento (RENDER.CALLELEMENT), este es el nombre que debe usar. Utiliza el nombre del activo CSElement por defecto.
(Opcional). En el campo ElementCatalogDescription, escriba una descripción del elemento.

Al guardar el activo CSElement, la información de este campo se escribe en la columna descripción para la entrada de elemento en la tabla ElementCatalog.
(Necesario). En el campo Lógica del elemento, codifique el elemento. Procure introducir todo el código antes de la etiqueta cs:ftcs final.

Si utiliza JSP, elimine los comentarios de las directivas taglib que describen las familias de etiquetas que está utilizando.

Para obtener ayuda con este paso, consulte Codificación de elementos para plantillas y CSElements.

Nota:

Garantía de uso compartido de la plantilla o un sitio replicable: Para compartir su CSElement o hacer que se replique el sitio actual, asegúrese de que la lógica del elemento de CSElement no hace referencia directamente a los activos, tipos de activos, nombres de atributos o nombres de plantillas. En su lugar, utilice la etiqueta render:lookup y las claves indicadas, como se explica en Uso compartido de plantillas y replicación de sitios. En Configuración de la asignación, asignará las claves a la información del activo al que se debe acceder para utilizarlo en la lógica del elemento.

Llamada a una plantilla: Las plantillas se deben llamar siempre mediante la etiqueta render:calltemplate y nunca mediante la etiqueta render:callelement o render:satellitepage.
El campo Parámetros del elemento y los campos Parámetros de elemento adicionales sirven para introducir variables o argumentos que se pueden pasar al elemento si el diseño del sitio los necesita.
- Campo Parámetros del elemento. WebCenter Sites rellena este campo con el ID de CSElement (eid), generado por WebCenter Sites como identificador único del activo de CSElement. No cambie ni suprima este valor.
  
  Este campo se corresponde con la columna resdetails1 de la tabla ElementCatalog. Cuando se guarda el CSElement, WebCenter Sites escribe el ID de CSElement en la columna resdetails1, en la fila que representa el CSElement.
- Campo Parámetros de elemento adicionales. WebCenter Sites deja este campo en blanco.
  
  Este campo se corresponde con la columna resdetails2 de ElementCatalog.
Si el diseño del sitio requiere que se utilicen variables además de eid, introduzca las variables en uno de los campos anteriores. Introdúzcalos como pares de nombre=valor con varios argumentos separados por el carácter ampersand (&). Por ejemplo:
```
MiArgumento=valor1&SuArgumento=valor2
```
Cada campo soporta hasta 255 caracteres.

Para obtener más información acerca de las variables de WebCenter Sites, incluido el ámbito y la prioridad, consulte Desarrollo de sitios web con tecnologías de etiquetas.
Haga clic en Continuar para abrir la pantalla Asignación.