Editor de formularios adaptables introduction-to-authoring-adaptive-forms

Adobe recomienda utilizar la captura de datos moderna y ampliable Componentes principalespara crear un nuevo formulario adaptableo añadir formularios adaptables a páginas de AEM Sites. Estos componentes representan un avance significativo en la creación de formularios adaptables, lo que garantiza experiencias de usuario impresionantes. Este artículo describe un enfoque más antiguo para crear Formularios adaptables con componentes de base.

Versión
Vínculo del artículo
AEM 6.5
Haga clic aquí
AEM as a Cloud Service
Este artículo

Información general overview

Los formularios adaptables le permiten crear formularios atractivos, interactivos, dinámicos y adaptables. AEM Forms proporciona una interfaz de usuario intuitiva y componentes predeterminados para crear y trabajar con formularios adaptables. Puede elegir crear un formulario adaptable en base a un modelo o esquema de formulario o sin un modelo de formulario. Es importante elegir cuidadosamente un modelo del formulario que no solo se adapte a sus necesidades, sino que amplíe sus inversiones y activos de infraestructura existentes. Puede elegir entre las siguientes opciones para crear un formulario adaptable:

  • Uso de un modelo de datos de formulario (FDM)
    La integración de datos le permite integrar entidades y servicios de distintos orígenes de datos en un modelo de datos de formulario (FDM) que se puede utilizar para crear formularios adaptables. Seleccione un modelo de datos de formulario si el formulario adaptable que está creando implica recuperar y escribir datos desde y hacia varias fuentes de datos.

  • Usar una plantilla de formulario XDP
    Es un modelo de formulario ideal si tiene inversiones en formularios XFA o XDP. Proporciona una forma directa de convertir los formularios basados en XFA en formularios adaptables. Cualquier regla XFA existente se conservará en el formulario adaptable asociado. El formulario adaptable resultante admitirá construcciones XFA, como validaciones, eventos, propiedades y patrones.

  • Usar una definición de esquema XML (XSD) o un esquema JSON
    Los esquemas XML y JSON representan la estructura en la que el sistema back-end de su organización produce o consume los datos. Puede asociar el esquema a un formulario adaptable y utilizar sus elementos para agregarle contenido dinámico. Los elementos del esquema estarán disponibles para su uso en la pestaña Objetos del modelo de datos del explorador de contenido al crear formularios adaptables.

  • Usar ninguno o no usar un modelo de formulario
    Los formularios adaptables creados con esta opción no utilizan ningún modelo de formulario. El XML de datos generado a partir de estos formularios tiene una estructura plana con campos y valores correspondientes.

    note note
    NOTE
    Puede modificar las propiedades del modelo de formulario desde el editor de formularios adaptables o el editor de plantillas de formulario adaptable. Para obtener más información, consulte Editar las propiedades del modelo de formulario de un formulario adaptable.

Para crear un formulario adaptable, consulte Creación de un formulario adaptable.

IU de creación de formularios adaptables adaptive-form-authoring-ui

La IU táctil para crear formularios adaptables es intuitiva y proporciona lo siguiente:

  • Funcionalidad de arrastrar y soltar
  • Componentes de formulario estándar
  • Repositorio integrado para recursos

Cuando crea un formulario adaptable nuevo o edita uno existente, utiliza los siguientes elementos de la IU:

Barra lateral sidebar

La barra lateral le permite

  • Buscar, ver y utilizar activos en su repositorio de administración de activos digitales de AEM (DAM).
  • Consultar el contenido del formulario, como paneles, componentes, campos y diseño.
  • Agregar componentes al formulario.
  • Editar las propiedades del componente.

Barra lateral

A. Explorador de contenido B. Explorador de propiedades C. Explorador de recursos D. Explorador de componentes

La barra lateral consta de los siguientes exploradores:

  • Explorador de contenido
    En el explorador de contenido, puede ver lo siguiente:

    • Objetos del formulario
      Muestra la jerarquía de objetos del formulario. El autor puede desplazarse a un componente específico del formulario al pulsar ese elemento en el árbol de objetos del formulario. El autor puede buscar objetos y reorganizarlos desde este árbol.

    • Objetos del modelo de datos
      Permite ver la jerarquía del modelo del formulario.
      Arrastrar y soltar elementos del modelo del formulario en el formulario adaptable. Los elementos agregados se convierten automáticamente en componentes de formulario y conservan sus propiedades originales. Puede ver objetos del modelo de datos cuando el formulario utilice un esquema XML, un esquema JSON o una plantilla XDP.

  • Explorador de propiedades

    Permite editar las propiedades de un componente. Las propiedades cambian según el componente. Para ver las propiedades del contenedor de formulario adaptable, haga lo siguiente:

    Seleccione un componente y, a continuación, seleccione nivel de campo > Contenedor de formulario adaptable y, a continuación, seleccione propiedades .

  • Explorador de recursos

    Segmenta contenido de distintos tipos, como imágenes, documentos, páginas, películas, etc.

  • Explorador de componentes

    Incluye componentes que puede utilizar para crear un formulario adaptable. Puede arrastrar componentes desde y hasta el formulario adaptable para agregar elementos de formulario y configurar los elementos agregados según los requisitos. En la siguiente tabla se describen los componentes enumerados en el explorador de componentes.

Componente
Funcionalidad
Bloque de Adobe Sign
Agrega un bloque de texto con marcadores de posición para que los campos se completen al firmar mediante Adobe Sign.
Botón
Agrega un botón, que puede configurar para realizar acciones como guardar, restablecer, ir al siguiente, ir al anterior, etc.
Captcha
Agrega la validación CAPTCHA mediante el servicio reCAPTCHA de Google.
Gráfico
Agrega un gráfico que puede usar en formularios adaptables y documentos para la representación visual de datos bidimensionales en paneles repetibles y filas de tabla.
Casilla de verificación
Agrega una casilla de verificación.
Campo de introducción de fecha
Utilice el componente Campo de introducción de fecha en el formulario para permitir a los clientes rellenar los campos de día, mes y año por separado en tres cuadros. Puede personalizar el aspecto del componente y cambiar el formato de la fecha. Por ejemplo, puede permitir que sus clientes introduzcan fechas en formato MM/DD/AAAA o DD/MM/AAAA.
Selector de fecha
Agrega un campo de calendario para elegir una fecha.
Fragmento de documento
Permite agregar componentes reutilizables de una correspondencia.
Grupo de fragmentos de documento
Permite agregar un grupo de fragmentos de documento relacionados que se pueden usar en una plantilla de carta como una sola unidad.
Lista desplegable
Agrega una lista desplegable: de selección única o múltiple
Correo electrónico

Agrega un campo para capturar la dirección de correo electrónico. El componente Correo electrónico, de forma predeterminada, valida las direcciones de correo electrónico con la siguiente expresión regular.

^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:.[a-zA-Z0-9-]+)*$

Archivo adjunto

Agrega un botón que permite a los usuarios examinar y adjuntar documentos de apoyo a un formulario.

Nota: El componente Archivo adjunto es compatible con un conjunto predefinido de formatos de archivo en formularios adaptables habilitados para Adobe Sign. Para obtener más información, consulte Formatos de archivo compatibles.

Lista de archivos adjuntos
Agrega un campo que enumera todos los archivos adjuntos cargados mediante el componente Archivo adjunto.
Pie de página
Agrega el encabezado que generalmente incluye el logotipo de una corporación, el título del formulario y el resumen.
Encabezado
Agrega el pie de página que generalmente incluye información sobre el copyright y vínculos a otras páginas.
Imagen
Insertar una imagen.
Opción de imagen
Permite a los clientes seleccionar una imagen para proporcionar información. Puede utilizar la información para proporcionar servicios personalizados a sus clientes.
Botón Siguiente
Agrega un botón para ir al siguiente panel en un formulario.
Cuadro numérico
Agrega un campo para capturar valores numéricos
Stepper numérico
Utilice Stepper numérico en el formulario para permitir que los clientes escriban un valor numérico, que puede aumentar o disminuir en función de un paso predefinido.
Panel

Agrega un panel o subpanel.

También puede agregar un componente de panel desde la barra de herramientas del panel principal mediante el botón Agregar panel secundario botón. |Del mismo modo, puede agregar una barra de herramientas específica de un panel mediante el botón Agregar barra de herramientas del panel botón. Puede configurar la posición de la barra de herramientas del panel mediante el cuadro de diálogo Editar panel.

Cuadro de contraseña
Agrega un campo para capturar una contraseña.
Botón Anterior
Agrega un botón que los usuarios necesitan para volver a la página o panel anterior.
Botón de opción
Agrega botones de radio.
Botón Restablecer
Agrega un botón para restablecer los campos del formulario.
Botón Guardar
Agrega un botón para guardar los datos del formulario.
Firma manuscrita
Agrega un campo para capturar firmas manuscritas.
Separador
Habilita la segregación visual de paneles en el formulario.
Paso de firma
Muestra la información proporcionada en el formulario y los campos de firma para que el usuario compruebe y firme el formulario.
Texto
Especificar texto estático.
Botón Enviar
Agrega un botón de envío para enviar el formulario a la acción de envío configurada.
Paso de resumen
Envía el formulario y muestra el texto de resumen que especifican los autores tras enviarlo.
Interruptor
Agrega un interruptor que realiza una acción de conmutación o de habilitar/deshabilitar. No se pueden agregar más de dos opciones en el componente Interruptor. Dado que un interruptor solo puede tener dos valores: Encendido o Apagado, la obligatoriedad no es aplicable. Se guarda al menos un valor independientemente de la entrada del usuario.
Tabla
Agrega una tabla que le permite organizar los datos en filas y columnas.
Teléfono

Agrega un campo para capturar el número de teléfono. El componente Teléfono permite a los autores configurar uno de los siguientes tipos de números de teléfono. Cada tipo está asociado con una expresión regular predeterminada para la validación.

  • La validación del tipo internacional la realiza ^[+][0-9]{0,14}$.
  • La validación del tipo USPhoneNumber la realiza {'+1 ('999') '999-9999}.
  • La validación del tipo UKPhoneNumber la realiza text{'+'99 999 999 9999}.
  • El tipo personalizado no proporciona ningún patrón de validación predeterminado. Toma el valor del último tipo de número de teléfono seleccionado. También puede especificar su propio patrón de validación personalizado.
Términos y condiciones
Agrega un campo que los autores pueden utilizar para especificar los términos y condiciones que deben revisar los usuarios antes de rellenar el formulario.
Cuadro de texto

Agrega un cuadro de texto en el que un usuario puede especificar la información necesaria.

De forma predeterminada, el componente Cuadro de texto solo acepta texto sin formato. Puede habilitar un componente Cuadro de texto para que acepte texto enriquecido. Un componente de texto enriquecido permite agregar encabezados, cambiar estilos de caracteres (negrita, cursiva, subrayado de caracteres), crear listas ordenadas y sin ordenar, cambiar el fondo y el color del texto y agregar hipervínculos. Para habilitar el texto enriquecido para un cuadro de texto, active la opción Permitir texto enriquecido en las propiedades del componente.

Título
Especifica un título para el formulario adaptable.
Paso de verificación

Agrega un marcador de posición para mostrar el formulario rellenado para la verificación del usuario.

Nota: El formulario adaptable que contiene el componente Verificar no admite usuarios anónimos. Además, no se recomienda utilizar el componente Verificar en un fragmento de formulario adaptable.

Barra de herramientas de la página page-toolbar

La barra de herramientas de la parte superior de la página ofrece opciones que permiten obtener una vista previa del formulario, cambiar las propiedades del formulario y editar el diseño del formulario. Puede obtener una vista previa del formulario cuando lo cree y realizar los cambios correspondientes. En la barra de herramientas de la página, verá lo siguiente:

  • Alternar panel lateral toggle-side-panel : permite mostrar u ocultar la barra lateral.

  • Información de la página theme-options : Permite ver las propiedades de página, publicar o cancelar la publicación de un formulario, iniciar un flujo de trabajo de un formulario y abrir el formulario en la IU clásica.

  • Emulador regla : Permite emular el aspecto del formulario para diferentes tamaños de visualización, como tabletas y teléfonos.

  • Editar: Permite seleccionar otros modos, como: Editar, Estilo, Desarrollador y Diseño.

    • Editar: Permite editar las propiedades del formulario y sus componentes. Por ejemplo, agregar un componente, soltar una imagen y especificar campos obligatorios.

    • Estilo: Permite aplicar estilo al aspecto de los componentes del formulario. Por ejemplo, en el modo Estilo, puede seleccionar un panel y especificar su color de fondo.

    • Desarrollador: Permite a un desarrollador lo siguiente:

      • Descubrir de qué se componen los formularios.

      • Depurar lo que sucede, dónde y cuándo, lo que a su vez ayuda a resolver problemas.

      • Diseño. Permite habilitar o deshabilitar componentes personalizados o componentes integrados que no aparecen en la barra lateral.

  • Vista previa: Permite obtener una vista previa del aspecto del formulario cuando se publica.

Barra de herramientas de los componentes component-toolbar

Barra de herramientas de componentes en la IU táctil

Al seleccionar un componente, aparece una barra de herramientas que le permite trabajar con él. Puede obtener opciones para cortar, pegar, mover y especificar propiedades de los componentes. Las opciones son las siguientes:

A.Configurar: al seleccione Configurar, las propiedades de los componentes se pueden ver en la barra lateral. La configuración de estas propiedades permite personalizar la experiencia de captura de datos. Puede cambiar el nombre del elemento del componente, especificar el texto de la etiqueta en el campo Título del componente. El nombre del elemento permite capturar los valores que introducen los usuarios mediante el componente. En las propiedades del componente, se especifica el comportamiento del componente y se administran los datos que haya introducido el usuario. Configure las propiedades en la barra lateral para capturar los datos de usuario y utilizarlos en un procesamiento posterior. Las propiedades del contenedor de formularios adaptables permiten especificar la configuración de bibliotecas de cliente, diseños, temáticas, documentos de registro, guardado, envío y metadatos.

B.Copiar: Puede utilizar la opción Copiar para copiar un componente y pegarlo en otros lugares del formulario. Al pegar un componente, este recibirá un nombre de elemento nuevo, pero conservará las propiedades del componente copiado.

C.Cortar: Puede utilizar la opción Cortar para mover un componente de un lugar a otro en el formulario adaptable.

D. Eliminar: Permite eliminar un componente del formulario.

E. Insertar: Permite insertar un componente sobre el componente seleccionado.

F. Pegar: Permite pegar el componente cortado o copiado mediante las opciones descritas anteriormente.

G. Editar reglas: Permite abrir el editor de reglas. Para obtener más información, consulte

H. Grupo: Permite seleccionar varios componentes si desea cortar, copiar o pegar más de un componente a la vez.

I. Principal: Permite seleccionar el elemento principal de un componente. Por ejemplo, un campo de texto se encuentra dentro de una subsección, que reside en una sección. La sección se encuentra en el panel raíz de la guía y el contenedor del formulario adaptable es el principal de un panel raíz de la guía. Puede ver todas las opciones de un componente con la jerarquía ordenada en la parte inferior.

Por ejemplo, si selecciona Principal en un cuadro de texto, podrá ver lo siguiente:

  • Subsección
  • Sección
  • guideRootPanel
  • Contenedor del formulario adaptable

J. Otros: Proporciona más opciones para trabajar con el componente seleccionado.

  • Ver expresión SOM
  • Guardar panel como fragmento (solo para paneles)
  • Agregar panel secundario (solo para paneles)
  • Agregar barra de herramientas del panel (solo para paneles)
  • Reemplazar (excepto para paneles)

Página del formulario adaptable af-page

La página Formulario adaptable es el formulario real. Es como cualquier otra página WCM modelada como componente WCM cq:Page. La siguiente imagen muestra la estructura de contenido de un formulario adaptable tradicional.

Estructura del contenido de una página WCM de formulario adaptable

La estructura del contenido suele contener los siguientes componentes principales:

  • guideContainer: La raíz de un formulario adaptable, que se marca como Inicio del formulario adaptable en la interfaz de usuario del formulario adaptable. En este componente, puede especificar lo siguiente:

    • Diseño móvil del formulario adaptable: Define el aspecto del formulario en dispositivos móviles.
    • Página de agradecimiento: Define la página a la que se redirige al usuario después de enviar el formulario.
    • Enviar acción: Define cómo se procesa el formulario en el servidor una vez que el usuario lo envía.
    • Estilo: Especifica la ruta al archivo CSS utilizado para personalizar el aspecto del formulario.
  • rootPanel: Panel raíz de un formulario adaptable. Puede contener subpaneles bajo el nodo de elementos. Cada panel, incluido el panel raíz, puede tener un diseño asociado. El diseño del panel dicta cómo se coloca el formulario. Por ejemplo, en el diseño Acordeón, los elementos se muestran como pasos de Acordeón.

  • barra de herramientas: Un contenedor del formulario adaptable tiene asociada una barra de herramientas global, que es global para el formulario. Esta barra de herramientas se puede agregar mediante la acción Agregar barra de herramientas en la barra de edición, que permite a los autores agregar acciones, como Enviar, Guardar, Restablecer, etc.

  • activos: Este nodo contiene información adicional utilizada para la creación de formularios. Por ejemplo, detalles del modelo del formulario, detalles de localización, etc.

Ver también see-also

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab