Andamiaje

Última actualización: 2023-11-08

A veces, es posible que tenga que crear un gran conjunto de páginas que compartan estructura pero que tengan contenido diferente. A través de la interfaz estándar de Adobe Experience Manager AEM (), debe crear cada página, arrastrar los componentes adecuados a la página y rellenarlos individualmente.

Con el andamiaje, puede crear un formulario (un andamio) con campos que reflejen la estructura que desee para sus páginas y, a continuación, utilizar este formulario para crear fácilmente páginas basadas en esta estructura.

NOTA

Andamiaje (en la IU clásica) respeta la herencia de MSM.

Cómo funciona el andamiaje

Los andamios se almacenan en Herramientas consola del administrador del sitio.

  • Abra el Herramientas y haga clic en Andamiaje de página predeterminada.
  • En, haga clic en Geometrixx.
  • En Geometrixx, encontrará un página de andamio llamado Noticias. Haga doble clic para abrir esta página.

howscaffolds_work

El andamiaje consiste en un formulario con un campo para cada parte de contenido que conformará la página que se va a crear y cuatro parámetros importantes a los que se accede a través del Propiedades de página de la página andamiaje.

pageprops

Las propiedades de la página de andamiaje son:

  • Texto del título: Este es el nombre de la propia página de andamiaje. En este ejemplo, se llama "News".
  • Descripción: Aparece debajo del título en la página de andamiaje.
  • Plantilla de destino: Esta es la plantilla que utilizará este andamio cuando cree una página. En este ejemplo, es un Página de contenido de Geometrixx plantilla.
  • Ruta de destino: Esta es la ruta de la página principal por debajo de la cual este andamio creará páginas. En este ejemplo, la ruta es /content/geometrixx/en/news.

El cuerpo del andamio es la forma. Cuando un usuario desea crear una página con el andamio, rellena el formulario y hace clic en Crear, en la parte inferior. En el Noticias Un ejemplo sobre el formulario tiene los siguientes campos:

  • Título: Es el nombre de la página que se va a crear. Este campo siempre está presente en cada andamio.
  • Texto: este campo corresponde a un componente Texto en la página resultante.
  • Imagen: este campo corresponde a un Componente de imagen en la página resultante.
  • Imagen/Avanzado: Título: título de la imagen.
  • Imagen/Avanzado: Texto alternativo: el texto alternativo de la imagen.
  • Imagen/Avanzado: Descripción: la descripción de la imagen.
  • Imagen/Avanzado: Tamaño: El tamaño de la imagen.
  • Etiquetas/Palabras clave: metadatos que se asignarán a esta página. Este campo siempre está presente en cada andamio.

Creación de un andamio

Para crear un andamio, vaya al Herramientas consola, entonces Andamiaje de página predeterminada y cree una página. Hay disponible un tipo de plantilla de una sola página, la variable Plantilla de andamiaje.

Vaya a la Propiedades de página de la nueva página y configure el Texto del título, Descripción, Plantilla de destino, y Ruta de destino, tal como se ha descrito anteriormente.

A continuación, debe definir la estructura de la página que creará este andamio. Para ello, vaya a modo de diseño en la página andamiaje. Aparece un vínculo que le permite editar el andamio en la editor de diálogos.

cq5_dialog_editor

Con el editor de diálogos, se especifican las propiedades que se crearán cada vez que se cree una nueva página con este andamio.

La definición del cuadro de diálogo de un andamio funciona de manera similar a la de un componente (consulte Componentes). Sin embargo, se aplican algunas diferencias importantes:

  • Las definiciones de cuadros de diálogo de componentes se representan como cuadros de diálogo normales (como se muestra en el panel central del editor de cuadros de diálogo), mientras que las definiciones de cuadros de diálogo de andamios, aunque aparecen como cuadros de diálogo normales en el editor de cuadros de diálogo, se representan en la página de andamio como un formulario de andamio (como se muestra en la Noticias andamio arriba).
  • Los cuadros de diálogo de componentes proporcionan campos solo para aquellos valores necesarios para definir el contenido de un componente específico único. Un cuadro de diálogo de andamiaje debe proporcionar campos para cada propiedad en cada párrafo de la página que se va a crear.
  • Si hay cuadros de diálogo de componentes, el componente utilizado para procesar el contenido especificado es implícito y, por lo tanto, la variable sling:resourceType La propiedad del párrafo se rellena automáticamente cuando se crea el párrafo. Con un andamiaje, toda la información que defina el contenido y el componente asignado para un párrafo determinado debe proporcionarla el propio cuadro de diálogo. En los cuadros de diálogo de andamiaje, esta información debe proporcionarse utilizando Oculto campos para enviar esta información al crear la página.

Un vistazo al ejemplo Noticias el cuadro de diálogo andamiaje del editor de diálogos ayuda a explicar cómo funciona. Vaya al modo de diseño en la página del andamio y haga clic en el vínculo del editor de diálogos.

Ahora, haga clic en el campo de diálogo Cuadro de diálogo > Panel de pestañas > Texto > Texto, así:

textedit

La lista de propiedades de este campo aparece a la derecha del editor de diálogos, de esta manera:

list_of_properties

Observe la propiedad name de este campo. Tiene el valor

./jcr:content/par/text/text

Es el nombre de la propiedad en la que se escribirá el contenido de este campo cuando se utilice el andamio para crear una página. La propiedad se indica como una ruta relativa desde el nodo que representa la página que se va a crear. Especifica el texto de la propiedad, debajo del texto del nodo, que está debajo de la parte del nodo, que es a su vez un elemento secundario del nodo jcr:content debajo del nodo de la página.

Define la ubicación del almacenamiento de contenido para el texto que se introduce en este campo. Sin embargo, también es necesario especificar dos características más para este contenido:

  • El hecho de que la cadena que se almacena aquí debe interpretarse como texto enriquecido, y
  • qué componente debe utilizarse para procesar este contenido en la página resultante.

En un cuadro de diálogo de componente normal no tendría que especificar esta información porque está implícita en el hecho de que el cuadro de diálogo ya está enlazado a un componente específico.

Para especificar estos dos fragmentos de información, se utilizan campos ocultos. Haga clic en el primer campo oculto Cuadro de diálogo > Panel de pestañas > Texto > Oculto, así:

oculto

Las propiedades de este campo oculto son las siguientes:

hidden_list_props

La propiedad name de este campo oculto es

./jcr:content/par/text/textIsRich

Es una propiedad booleana que se utiliza para interpretar la cadena de texto almacenada en ./jcr:content/par/text/text.

Como sabemos que el texto debe interpretarse como texto enriquecido, vamos a especificar el value propiedad de este campo como true.

PRECAUCIÓN

El editor de diálogos permite al usuario cambiar los valores de existente propiedades en la definición del cuadro de diálogo. Para agregar una nueva propiedad, el usuario debe utilizar CRXDE Lite. Por ejemplo, cuando se agrega un nuevo campo oculto a una definición de cuadro de diálogo con el editor de diálogos, no tiene un valor propiedad (es decir, una propiedad con el nombre "value"). Si el campo oculto en cuestión requiere que se establezca una propiedad de valor predeterminada, esta propiedad debe agregarse manualmente con una de las herramientas CRX. El valor no se puede agregar con el propio editor de diálogos. Sin embargo, una vez que la propiedad está presente, su valor se puede editar con el editor de diálogos.

El segundo campo oculto se puede ver haciendo clic en él de esta manera:

hidden2

Las propiedades de este campo oculto son las siguientes:

hidden_list_props2

La propiedad name de este campo oculto es

./jcr:content/par/text/sling:resourceType

Y el valor fijo especificado para esta propiedad es

foundation/components/textimage

Esto especifica que el componente que se utilizará para representar el contenido de texto de este párrafo es el siguiente Imagen de texto componente. Uso de con isRichText especificado en el otro campo oculto, el componente puede procesar la cadena de texto real almacenada en ./jcr:content/par/text/text de la manera deseada.

Andamiaje con herencia MSM

En la IU clásica, el andamiaje está totalmente integrado con la herencia de MSM (cuando corresponda).

Cuando abre una página en Andamiaje modo (con el icono de la parte inferior de la barra de tareas), los componentes sujetos a herencia se indicarán de la siguiente manera:

  • un símbolo de bloqueo (para la mayoría de los componentes; por ejemplo, Texto y Título)
  • una máscara con el texto Haga clic para cancelar la herencia (para componentes de imagen)

Estos muestran que el componente no se puede editar hasta que se cancele la herencia.

chlimage_1

Al hacer clic en el símbolo de bloqueo o en el icono de imagen, puede interrumpir la herencia:

  • el símbolo cambia a un candado abierto.
  • una vez desbloqueado, puede editar el contenido.

chlimage_1-1

Después de desbloquear, puede restaurar la herencia haciendo clic en el símbolo de candado desbloqueado: esto perderá las ediciones que haya realizado.

NOTA

Si la herencia se cancela en el nivel de página (desde la pestaña LiveCopy de Propiedades de página), todos los componentes se pueden editar en Andamiaje modo (se muestran en estado desbloqueado).

En esta página