Personalizar plantillas para componentes del portal de formularios customizing-templates-for-forms-portal-components
Requisitos previos prerequisites
Administrar metadatos de formulario
Conocimientos prácticos de HTML y CSS
Información general overview
La interfaz de usuario de AEM Forms permite agregar metadatos a cualquier formulario. Los metadatos personalizados pueden mejorar la experiencia del usuario al enumerar y buscar formularios de su organización.
El portal de formularios permite utilizar metadatos personalizados en listas de formularios. Al crear plantillas personalizadas para los recursos, puede modificar su diseño y utilizar metadatos personalizados con el conjunto de estilos CSS.
Siga estos pasos para crear una plantilla personalizada para varios componentes de portal de formularios.
Crear una plantilla personalizada creating-a-nbsp-custom-template
-
Cree el nodo sling:Folder en */apps *
Agregue la propiedad “fpContentType”. Especifique los valores adecuados para la propiedad en función del componente para el que defina la plantilla personalizada.
-
Componente Buscar y listar: “/libs/fd/fp/formTemplate”
-
Componente Borradores y envíos:
- Sección Borradores: /libs/fd/fp/draftsTemplate
- Sección Envíos: /libs/fd/fp/submissionsTemplate
-
Componente de vínculo: /libs/fd/fp/linkTemplate
Agregue un título que desee que se muestre al seleccionar plantillas de diseño.
*Nota: El título puede ser diferente del nombre de nodo de sling:Folder que ha creado. *
La siguiente imagen muestra la configuración del componente Buscar y listar. -
-
Cree un archivo template.html en esta carpeta para que sirva como plantilla personalizada.
-
Escriba la plantilla personalizada y utilice metadatos personalizados como se describe a continuación.
Ejemplo práctico working-example
A continuación se muestra una implementación de ejemplo de una plantilla personalizada en la que el portal de formularios adquiere un diseño de tarjeta de gobierno personalizado de Geometrixx para el componente Buscar y listar.
<div class="__FP_boxes-container __FP_single-color">
<div class="boxes __FP_boxes __FP_single-color" data-repeatable="true">
<div class="__FP_boxes-thumbnail">
<img src ="${path}/jcr:content/renditions/cq5dam.thumbnail.319.319.png"/>
</div>
<h3 class="__FP_single-color" title="${name}" tabindex="0">${name}</h3>
<p>${description}</p>
<div class="boxes-icon-cont __FP_boxes-icon-cont">
<div class="op-dow">
<a href="${formUrl}" target="_blank" class="__FP_button ${htmlStyle}" title="${config-htmlLinkText}">${localize-Apply}</a>
<a href="${pdfUrl}" class="__FP_button ${pdfStyle}" title="${config-pdfLinkText}">${localize-Download}</a>
</div>
</div>
</div>
</div>
Especificaciones técnicas de las plantillas personalizadas technical-specifications-for-custom-templates
Una plantilla personalizada para cualquier componente del portal de formularios incluye entradas repetibles y no repetibles. Las entradas repetibles son entidades básicas para las listas. Ejemplos de entradas repetibles son los componentes Buscar y listar, Borradores y envíos y Vínculo.
El portal de formularios proporciona una sintaxis para que los marcadores de posición muestren metadatos personalizados/OOTB. Los marcadores de posición se rellenan después de mostrar los resultados de los formularios, borradores o envíos.
Para incluir una entrada repetible, configure el valor del atributo data-repeatable a true.
*En el ejemplo analizado, hay dos elementos Div presentes en la parte superior de la plantilla personalizada. El primero, con la clase CSS “__FP_boxes-container” funciona como un elemento de contenedor para los formularios que se enumeran. El segundo, con la clase CSS “__FP_boxes” es una plantilla para las entidades básicas, en este caso un formulario. El atributo data-repeatable presente en el elemento Div tiene el valor true.
Cada marcador de posición tiene un conjunto de metadatos OOTB exclusivo. Para mostrar metadatos personalizados en un lugar determinado del formulario, agregue la variable $metadata_prop, propiedad en el lugar.
En el ejemplo, la propiedad metadata se utiliza en varias instancias. Por ejemplo, se utiliza en descripción,nombre,formUrl,htmlStyle,pdfUrl,pdfStyle y ruta de la manera prescrita.
Metadatos predeterminados out-of-the-box-metadata
Varios componentes del portal de formularios proporcionan conjuntos exclusivos de metadatos OOTB que puede utilizar para incluirlos en la lista.
Componente Buscar y listar search-amp-lister-component
-
Título: título del formulario
-
nombre: nombre del formulario (la mayoría es el mismo que el título)
-
descripción: descripción del formulario
-
formUrl: URL para procesar el formulario como HTML
-
pdfUrl: URL para procesar el formulario como PDF
-
assetType: tipo de recurso. Los valores válidos incluyen Formulario, Formulario PDF, Imprimir formulario y Formulario adaptable
-
htmlStyle y pdfStyle: estilo de visualización de los iconos HTML y PDF respectivamente utilizados para el procesamiento. Los valores válidos son "__FP_display_none" o blank
Nota: Recuerde utilizar la clase __FP_display_none en la hoja de estilo personalizada
-
downloadUrl: URL para descargar un recurso.
Compatibilidad con la localización, clasificación y uso de propiedades de configuración en la interfaz de usuario (solo Buscar y listar):
-
Compatibilidad con localización: Para localizar cualquier texto estático, utilice el atributo ${localize-YOUR_TEXT} y haga que el valor localizado esté disponible, si no existe todavía.
En el ejemplo analizado, los atributos ${localize-Apply} y ${localize-Download} se utilizan para localizar el texto Aplicar y Descargar.
-
Compatibilidad con la ordenación: haga clic en el elemento HTML para ordenar los resultados de la búsqueda. Para implementar la ordenación en un diseño de tablas, agregue el atributo “data-sortKey” en el encabezado de tabla concreto. Además, agregue su valor como metadatos para los que desea ordenar.
Por ejemplo, para el encabezado “Título” en la vista de cuadrícula, el valor del encabezado “data-sortKey” es “título”. Haga clic en el encabezado para ordenar los valores de una columna en particular.
-
Usar las propiedades de configuración: el componente Buscar y listar tiene varias configuraciones que puede utilizar en la interfaz de usuario. Por ejemplo, para mostrar el texto de información del objeto del HTML guardado a través del cuadro de diálogo de edición, utilice el Atributo ${config-htmlLinkText}. Del mismo modo, para el texto de información del objeto del PDF, utilice la variable ${config-pdfLinkText} atributo.
Componente Vínculo link-component
- Título: título del formulario
- formUrl: URL para procesar el formulario como HTML
- destino: atributo de destino del vínculo. Los valores válidos son "_blank" y "_self".
- linkText: pie de ilustración del vínculo
Componente Borradores y envíos drafts-amp-submissions-component
- Ruta: ruta del nodo de metadatos de borradores/envíos. Utilícelo con la extensión .HTML como URL para abrir un borrador o un envío.
- contextPath: ruta de contexto de la instancia de AEM
- firstLetter: primera letra (mayúscula) del título del formulario adaptable, que se guardó como borrador o se envió.
- formName: título del formulario adaptable, que se guardó como borrador o se envió.
- DraftID: ID del borrador que aparece en la lista (utilícelo solamente en la plantilla de la sección Borrador).
- submitID: ID del envío que aparece en la lista (utilícelo solamente en la plantilla de la sección Envío).
- estado: estado del formulario enviado. (Se utiliza solo en la plantilla de la sección Envío).
- descripción: descripción del formulario adaptable asociado al borrador o al envío.
- diffTime: diferencia entre la hora actual y la última acción de guardado del borrador. Alternativamente, la diferencia entre la hora actual y la última acción de envío para el envío.
- iconClass: la clase CSS utilizada para mostrar la primera letra del borrador/envío. El portal de formularios incluye las siguientes clases, que proporcionan distintos fondos de colores.
- propietario: usuario que ha creado el borrador/envío.
- Hoy: fecha de creación del borrador o de la presentación en formato DDAAAA.
- TimeNow: momento de creación del borrador o del envío en formato de 24 horas HHSS
Nota:
-
Para la opción de eliminación de la sección Borradores del componente Borradores y envíos, asigne a la clase CSS el nombre “__FP_deleteDraft”. Además, incluya el atributo “DraftID” con el valor ${draftID}, que es el ID borrador del borrador correspondiente.
-
Al crear vínculos para abrir borradores y envíos, puede especificar $path.html como el valor de la variable href para la etiqueta de anclaje.
A. Elemento Contenedor
B. Metadatos de “ruta” con una jerarquía fija para obtener la miniatura almacenada para cada formulario.
C. Atributo repetible de datos utilizado en la sección de la plantilla para cada formulario
D. Localizar la cadena “Aplicar”
E. Usar la propiedad de configuración pdfLinkText
F. Usar los metadatos “pdfUrl”
Sugerencias, trucos y problemas conocidos tips-tricks-and-known-issues
- No utilice comillas simples (') en ninguna plantilla personalizada.
- Para los metadatos personalizados, almacene esta propiedad solamente en el nodo jcr:content/metadata. Si lo almacena en cualquier otro lugar, el portal de formularios no podrá mostrar los metadatos.
- Asegúrese de que el nombre de cualquier metadato personalizado o existente no incluya dos puntos (:). Si es así, no se podrá mostrar en la interfaz de usuario.
- data-repeatable no tiene ningún significado para un componente Vínculo. Adobe recomienda evitar utilizar esta propiedad en la plantilla para un componente Vínculo.
Artículos relacionados
- Habilitar componentes del portal de formularios
- Creación de una página del portal de formularios
- Enumerar formularios en una página web mediante API
- Usar el componente Borradores y envíos
- Personalizar el almacenamiento de borradores y formularios enviados
- Ejemplo para integrar el componente Borradores y envíos con la base de datos
- Personalizar plantillas para componentes del portal de formularios
- Introducción a la publicación de formularios en un portal