Componente del contenedor de formularios

El componente principal Contenedor de formularios permite crear formularios de envío simples.

Uso

El Componente del contenedor de formularios permite crear formularios y funciones de envío de información sencillos mediante la compatibilidad de formularios WCM simples y el uso de una estructura anidada para permitir componentes de formulario adicionales.

Al utilizar el cuadro de diálogo de configuración el editor de contenido puede definir la acción desencadenada por el envío del formulario, la URL que debe administrar el envío y si se debe activar un flujo de trabajo. El autor de la plantilla puede utilizar el cuadro de diálogo de diseño para definir los componentes permitidos y las asignaciones similares a él para el contenedor de diseño estándar en el editor de plantillas.

Versión y compatibilidad

La versión actual del componente del contenedor de formularios es la versión 2, que se introdujo con la versión 2.0.0 de los componentes principales en enero de 2018 y se describe en este documento.

La siguiente tabla detalla todas las versiones compatibles del componente, las versiones de AEM con las que son compatibles las versiones del componente y los vínculos a la documentación de versiones anteriores.

Para obtener más información sobre las versiones y publicaciones de los componentes principales, consulte el documento Versiones de los componentes principales.

Salida del componente de ejemplo

Para obtener más información sobre el componente del contenedor de formularios, así como ejemplos de sus opciones de configuración, y sobre la salida HTML y JSON, visite la Biblioteca de componentes.

Detalles técnicos

La documentación técnica más reciente sobre el componente Contenedor de formularios se encuentra en GitHub.

Puede encontrar más información sobre el desarrollo de componentes principales en la documentación para desarrolladores de componentes principales.

Cuadro de diálogo de configuración

El cuadro de diálogo de configuración permite al autor del contenido definir qué acciones se realizan cuando se envía el componente.

Según el Tipo de acción seleccionado, cambiarán las opciones disponibles dentro del contenedor. Los tipos de acción disponibles son:

• Publicar datos de formulario
• Correo
• Almacenar contenido

Independientemente del tipo, existen configuraciones generales que se aplican a cada acción.

Publicar datos de formulario

Cuando se envía el formulario, el tipo de acción de publicación de datos de formulario pasa los datos enviados a un tercero como JSON para su procesamiento.

• Punto de conexión: el servicio HTTPS completo que procesará los datos
• Mensaje de error: mensaje que se muestra si el envío no se ha realizado correctamente

Correo

Cuando se envía el formulario, el tipo de acción de correo envía un correo electrónico a los destinatarios designados.

• Asunto: el asunto del correo electrónico que se enviará junto con el formulario
• Desde: la dirección de correo electrónico de origen desde la que se enviará el formulario
• Hasta: las direcciones de los destinatarios que recibirán un correo electrónico al enviar el formulario
  • Pulse o haga clic en el botón Añadir para añadir direcciones adicionales
  • Pulse o haga clic en el botón Eliminar para eliminar una dirección de correo electrónico
• CC: las direcciones de los destinatarios que recibirán una copia del correo electrónico enviado al enviar el formulario.
  • Pulse o haga clic en el botón Añadir para añadir direcciones adicionales
  • Pulse o haga clic en el botón Eliminar para eliminar una dirección de correo electrónico

Almacenar contenido

Cuando se envíe el formulario, su contenido se almacenará en una ubicación designada del repositorio.

• Ruta de contenido: ruta del repositorio de contenido donde se almacena el contenido enviado
• Ver datos: pulse o haga clic en esta opción para ver los datos enviados almacenados como JSON
• Iniciar flujo de trabajo: configúrelo para iniciar un flujo de trabajo con el contenido almacenado como carga útil tras el envío del formulario

Configuración general

Independientemente del tipo de acción seleccionado, siempre se puede definir una página de agradecimiento.

• Página de agradecimiento: se redirigirá al usuario a la página especificada tras completar el envío del formulario.
  • Utilice el cuadro de diálogo de selección para seleccionar un recurso dentro de AEM.
  • Si la página de agradecimiento no está en AEM, especifique la dirección URL absoluta. Las direcciones URL no absolutas se interpretarán en relación con AEM.
  • Déjela vacía para volver a visualizar el formulario tras el envío.
• ID: esta opción permite controlar el identificador único del componente del HTML y de la capa de datos.
  • Si se deja en blanco, se generará automáticamente un ID único que se puede encontrar inspeccionando la página resultante.
  • Si se especifica un ID, es responsabilidad del autor asegurarse de que sea único.
  • Cambiar el ID puede afectar al seguimiento de CSS, JS y de la capa de datos.

Cuadro de diálogo de diseño

El cuadro de diálogo de diseño permite que el autor de la plantilla defina los componentes permitidos y sus asignaciones para el contenedor de forma similar al cuadro de diálogo de diseño para el contenedor de diseño estándar en el editor de plantillas.

Pestaña Estilos

El componente del contenedor de formularios es compatible con el sistema de estilos de AEM.