Adobe recomienda utilizar la captura de datos moderna y ampliable Componentes principales para crear un nuevo Forms adaptable o adición de Forms adaptable a páginas de AEM Sites. Estos componentes representan un avance significativo en la creación de Forms adaptable, lo que garantiza experiencias de usuario impresionantes. Este artículo describe un enfoque más antiguo para crear Forms adaptable mediante componentes de base.
Versión | Vínculo del artículo |
---|---|
AEM as a Cloud Service | Haga clic aquí |
AEM 6.5 | Este artículo |
Después de enviar un formulario, normalmente los clientes desean guardar un registro —impreso o en formato de documento— de la información que han rellenado en el formulario para utilizarlo como referencia en el futuro. Este registro se denomina documento de registro.
Este artículo explica cómo generar un documento de registro para formularios adaptables.
La generación automática de documentos de registro no es compatible con los formularios adaptables basados en XFA. Sin embargo, puede utilizar el XDP utilizado para crear el formulario adaptable como documento de registro.
Al crear un formulario adaptable, puede seleccionar un modelo de formulario. Las opciones son las siguientes:
Plantillas de formulario
Permite seleccionar una plantilla XFA para el formulario adaptable. Al seleccionar una plantilla XFA, puede utilizar el archivo XDP asociado para el documento de registro como se ha descrito anteriormente.
Esquema XML
Permite seleccionar una definición de esquema XML para el formulario adaptable. Al seleccionar un esquema XML para el formulario adaptable, puede:
Ninguno
Permite crear un formulario adaptable sin un modelo de formulario. El documento de registro se genera automáticamente para el formulario adaptable.
Cuando seleccione un modelo de formulario, configure el documento de registro mediante las opciones disponibles en Configuración de la plantilla de un documento de registro. Configuración de la plantilla de un documento de registro.
Un documento de registro permite a los clientes conservar una copia del formulario enviado para su impresión. Cuando se genera automáticamente un documento de registro, este se actualiza inmediatamente cada vez que se modifica el formulario. Por ejemplo, se elimina el campo de edad de los clientes que seleccionan Estados Unidos de América como país. Cuando estos clientes generan un documento de registro, el campo de edad no es visible para ellos en el documento.
Un documento de registro generado automáticamente tiene las siguientes ventajas:
Para generar el documento de registro de un formularios adaptable, son necesarios los siguientes componentes:
Formulario adaptable: el formulario adaptable para el que se desea generar un documento de registro.
Plantilla base (recomendada): la plantilla XFA (archivo XDP) creada en AEM Designer. La plantilla base se utiliza para especificar la información de estilo y de personalización de marca de la plantilla del documento de registro.
Consulte Plantilla base de un documento de registro
La plantilla base de un documento de registro también se denomina metaplantilla del documento de registro.
Documento de plantilla de registro: la plantilla XFA (archivo XDP) generada a partir de un formulario adaptable.
Configuración de la plantilla de un documento de registro.
Datos de formulario: la información que rellena un usuario en el formulario adaptable. Se combina con la plantilla del documento de registro para generar el documento de registro.
Las siguientes secciones describen cómo se muestran los elementos de formulario adaptable en el documento de registro.
Componente de formulario adaptable | Componente XFA correspondiente | ¿Se incluye de forma predeterminada en la plantilla del documento de registro? | Notas |
---|---|---|---|
Botón | Botón | false | |
Casilla de verificación | Casilla de verificación | true | |
Selector de fecha | Campo de fecha y hora | true | |
Lista desplegable | Lista desplegable | true | |
Firma manuscrita | Firma manuscrita | true | |
Cuadro numérico | Campo numérico | true | |
Cuadro de contraseña | Campo de contraseña | false | |
Botón de opción | Botón de opción | true | |
Cuadro de texto | Campo de texto | true | |
Botón Restablecer | Botón Restablecer | false | |
Botón Enviar | Botón Enviar correo electrónico Botón Enviar HTTP |
false | |
Términos y condiciones | true | ||
Archivo adjunto | false | No disponible en la plantilla del documento de registro. Solo disponible en el documento de registro mediante archivos adjuntos. |
Componente de formulario adaptable | Componente XFA correspondiente | Notas |
---|---|---|
Panel |
Subformulario |
El panel repetible se asigna a un subformulario repetible. |
Componente de formulario adaptable | Componente XFA correspondiente | Notas |
---|---|---|
Imagen | Imagen | Los componentes TextDraw e Image, estén enlazados o no, siempre aparecen en el documento de registro de un formulario adaptable basado en XSD, a menos que se excluyan en la configuración del documento de registro. |
Texto | Texto |
En la IU clásica, se muestran diferentes pestañas para editar las propiedades de los campos.
Los componentes de las tablas de formularios adaptables, como el encabezado, el pie de página y la fila, se asignan a los componentes XFA correspondientes. Puede asignar paneles repetibles a tablas en el documento de registro.
La plantilla base proporciona al documento de registro información relativa al estilo y la apariencia. Permite personalizar el aspecto predeterminado del documento de registro generado automáticamente. Por ejemplo, puede utilizar la plantilla base para agregar el logotipo de su compañía en el encabezado y la información de copyright en el pie de página del documento de registro. La página maestra de la plantilla base se utiliza como página maestra de la plantilla del documento de registro. La página maestra puede incluir información como el encabezado de página, el pie de página y el número de página que puede aplicar al documento de registro. Puede aplicar dicha información al documento de registro mediante la plantilla base para generar automáticamente el documento de registro. El uso de una plantilla base permite cambiar las propiedades predeterminadas de los campos.
Asegúrese de seguir Convenciones de plantilla base al diseñar una plantilla base.
Se utiliza una plantilla base para definir el encabezado, el pie de página, el estilo y la apariencia de un documento de registro. El encabezado y pie de página pueden incluir información como el logotipo de la compañía y la información de copyright. La primera página maestra de la plantilla base se copia y se utiliza como página maestra del documento de registro, la cual contiene el encabezado, el pie de página, el número de página o cualquier otro tipo de información que deba aparecer en todas las páginas del documento. Si utiliza una plantilla base que no se ajusta a las convenciones de plantilla base, la primera página maestra de la plantilla se seguirá utilizando en la plantilla del documento de registro. Se recomienda encarecidamente que diseñe la plantilla base según sus convenciones y que la utilice para generar automáticamente el documento de registro.
Convenciones de la página maestra
En la plantilla base, asigne el nombre AF_METATEMPLATE
al subformulario raíz y el nombre AF_MASTERPAGE
a la página maestra.
La página maestra con el nombre AF_MASTERPAGE
que se encuentra en el subformulario raíz AF_METATEMPLATE
tiene preferencia a la hora de extraer la información de encabezado, pie de página y estilo.
Si AF_MASTERPAGE
no existe, se utiliza la primera página maestra presente en la plantilla base.
Convenciones de estilo para campos
Para aplicar un estilo a los campos del documento de registro, la plantilla base proporciona campos en la variable AF_FIELDSSUBFORM
subformulario en AF_METATEMPLATE
subformulario raíz.
Las propiedades de estos campos se aplican a los campos del documento de registro. Estos campos deben seguir la convención de nomenclatura de AF_<name of field in all caps>_XFO
. Por ejemplo, el nombre de campo de la casilla de verificación debe ser AF_CHECKBOX_XFO
.
Para crear una plantilla base, siga los siguientes pasos en AEM Designer.
Haga clic en Archivo > Nuevo.
Seleccione la opción Basado en una plantilla.
Seleccione la categoría Formulario - Documento de registro.
Seleccione Plantilla base de documento de registro.
Haga clic en Siguiente y proporcione la información requerida.
(Opcional) Modifique el estilo y el aspecto de los campos que desea aplicar en los campos del documento de registro.
Guarde el formulario.
Ahora puede utilizar el formulario guardado como plantilla base para el documento de registro.
No modifique ni elimine ningún script presente en la plantilla base.
Modificación de la plantilla base
Diseñe una plantilla base utilizando las convenciones y siguiendo estrictamente los pasos anteriores.
Configure la plantilla del documento de registro del formulario para que sus clientes puedan descargar una copia del formulario enviado fácil de imprimir. Un archivo XDP sirve como plantilla del documento de registro. El documento de registro que descargan los clientes de tiene un formato coherente el diseño especificado en el archivo XDP.
Siga los siguientes pasos para configurar un documento de registro para formularios adaptables:
En la instancia de autor de AEM, haga clic en Forms > Formularios y documentos.
Seleccione un formulario y haga clic en Ver propiedades.
En la ventana Propiedades, pulse Modelo de formulario.
También puede seleccionar un modelo de formulario al crear un formulario.
En la pestaña Modelo de formulario, asegúrese de seleccionar Esquema o Ninguno en la lista desplegable Seleccionar de. El documento de registro no es compatible con los formularios adaptables o basados en XFA con una plantilla de formulario como modelo de formulario.
En la sección Configuración de la plantilla de un documento de registro de la pestaña Modelo de formulario, seleccione una de las siguientes opciones.
Ninguno: seleccione esta opción si no desea configurar el documento de registro del formulario.
Asociar plantilla de formulario como plantilla de documento de registro: seleccione esta opción si tiene un archivo XDP que desea utilizar como plantilla para el documento de registro. Al seleccionar esta opción, se muestran todos los archivos XDP disponibles en el repositorio de AEM Forms. Seleccione el archivo apropiado.
El archivo XDP seleccionado se asocia con el formulario adaptable.
Generar documento de registro: seleccione esta opción para utilizar un archivo XDP como plantilla base para definir el estilo y la apariencia del documento de registro. Al seleccionar esta opción, se muestran todos los archivos XDP disponibles en el repositorio de AEM Forms. Seleccione el archivo apropiado.
Asegúrese de que el esquema utilizado para crear un formulario adaptable y el esquema (esquema de datos) del formulario XFA sea el mismo en los siguientes casos:
* El formulario adaptable se basa en esquemas.
* Utiliza la opción **Asociar plantilla de formulario como plantilla de documento de registro** para el documento de registro.
Haga clic en Listo.
Al generar un documento de registro, puede cambiar la información de marca del documento de registro en la pestaña Documento de registro. La pestaña Documento de registro incluye opciones como logotipo, apariencia, diseño, encabezado y pie de página, exención de responsabilidad legal, y si desea incluir o no opciones de casillas de verificación y botones de opción no seleccionados.
Para localizar la información de marca indicada en la pestaña Documento de registro, asegúrese de que ha establecido correctamente la configuración regional del explorador. Para personalizar la información de marca del documento de registro, siga estos pasos:
Seleccione un panel (panel raíz) en el documento de registro y, a continuación, pulse .
Pulse . Aparecerá la pestaña Documento de registro.
Seleccione la plantilla predeterminada o una plantilla personalizada para procesar el documento de registro. Si selecciona la plantilla predeterminada, aparece una vista previa en miniatura del documento de registro debajo de la lista desplegable Plantilla.
Si elige una plantilla personalizada, busque y seleccione un XDP en el servidor de AEM Forms. Si desea utilizar una plantilla que no esté ya en el servidor de AEM Forms, primero debe cargar el XDP en el servidor.
En función de si selecciona una plantilla predeterminada o personalizada, la pestaña Documento de registro muestra algunas o todas las propiedades que aparecen a continuación. Especifíquelas correctamente:
Si la plantilla XDP personalizada que selecciona incluye varias páginas maestras, las propiedades de esas páginas aparecerán en la sección Contenido de la pestaña Documento de registro.
Las propiedades de la página maestra incluyen Imagen de logotipo, Texto de encabezado, Título del formulario, Etiqueta de exención de responsabilidad legal y Texto de exención de responsabilidad legal. Puede aplicar propiedades de formulario adaptable o de plantilla XDP al documento de registro. AEM Forms aplica las propiedades de la plantilla al documento de registro de forma predeterminada. También puede definir valores personalizados para las propiedades de la página maestra. Para obtener información sobre cómo aplicar varias páginas maestras en un documento de registro, consulte Aplicar varias páginas maestras a un documento de registro.
Si está utilizando una plantilla de formulario adaptable creada con una versión de Designer anterior a la 6.3, para que las propiedades Color de énfasis y Familia de fuentes funcionen, asegúrese de que los siguientes elementos están presentes en el subformulario raíz de la plantilla de formulario adaptable:
<proto>
<font typeface="Arial"/>
<fill>
<color value="4,166,203"/>
</fill>
<edge>
<color value="4,166,203"/>
</edge>
</proto>
Para guardar los cambios de personalización de marca, pulse Listo.
El formulario adaptable puede ser largo y tener varios campos de formulario. Es posible que no desee guardar un documento de registro como una copia exacta del formulario adaptable. Ahora puede elegir un diseño de tabla o columna para guardar uno o más paneles de formulario adaptable en el documento de registro PDF.
Antes de generar un documento de registro, establezca el Diseño del documento de registro de cada panel como Tabla o Columna en la configuración de ese panel. Los campos del panel se organizan en consecuencia en el documento de registro.
Los campos de un panel se representan en forma de tabla en el documento de registro
Los campos de un panel se representan en forma de columna en el documento de registro
La configuración del documento de registro le permite elegir las opciones que desea incluir en dicho documento. Por ejemplo, un banco acepta el nombre, la edad, el número de la seguridad social y el número de teléfono en un formulario. El formulario genera un número de cuenta bancaria y detalles de sucursal. Puede elegir mostrar únicamente el nombre, el número de la seguridad social, la cuenta bancaria y los detalles de la sucursal en el documento de registro.
La configuración de del documento de registro de cada componente está disponible en sus propiedades. Para acceder a las propiedades de un componente, seleccione el componente y haga clic en en la superposición. Las propiedades se enumeran en la barra lateral y puede encontrar la siguiente configuración en ella.
Configuración del nivel de campo
Excluir del documento de registro: al establecer la propiedad en True, se excluye el campo del documento de registro. Se trata de una propiedad que puede ser script y que se llama excludeFromDoR
. Su comportamiento depende de la propiedad de nivel de formulario Excluir campos del documento de registro si están ocultos.
Mostrar panel como tabla: al establecer la propiedad, se muestra el panel como tabla en el documento de registro si el panel contiene menos de 6 campos. Solo aplicable para paneles.
Excluir título del documento de registro: al establecer la propiedad, se excluye el título del panel o la tabla del documento de registro. Aplicable solo para paneles y tablas.
Excluir descripción del documento de registro: al establecer la propiedad, se excluye la descripción del panel o la tabla del documento de registro. Aplicable solo para paneles y tablas.
Paginación > Posición: determina la posición seleccionada para el panel.
Paginación > Después: determina qué área se rellenará después de colocar un panel. Los campos siguientes están disponibles en la sección Después:
Paginación > Desbordamiento: define el desbordamiento de un panel o una tabla que ocupa varias páginas. Los campos siguientes están disponibles en la sección Desbordamiento:
Para obtener información sobre cómo aplicar saltos de página y aplicar varias páginas maestras en un documento de registro, consulte Aplicar un salto de página en un documento de registro y Aplicar varias páginas maestras a un documento de registro.
Configuración del nivel de formulario
Puede aplicar saltos de página en un documento de registro utilizando varios métodos.
Para aplicar un salto de página a un documento de registro:
Pulse el panel y seleccione
Expanda Documento de registro para ver las propiedades.
En la sección Paginación, pulse en el campo Posición.
Pulse Parte superior de la siguiente página y luego pulse Seleccionar. También puede pulsar Parte superior de la página, seleccionar la página maestra y pulsar Seleccionar para aplicar el salto de página.
Pulse para guardar las propiedades.
El panel seleccionado se traslada a la página siguiente.
Si la plantilla XDP personalizada que selecciona incluye varias páginas maestras, las propiedades de esas páginas aparecerán en la sección Contenido de la pestaña Documento de registro. Para obtener más información, consulte Personalizar la información de marca en el documento de registro.
Puede aplicar varias páginas maestras a un documento de registro aplicando diferentes páginas maestras a los componentes de un formulario adaptable. Utilice la sección Paginación de las propiedades del documento de registro para aplicar varias páginas maestras.
A continuación, se muestra un ejemplo de cómo aplicar varias páginas maestras a un documento de registro:
Carga una plantilla XDP que incluye cuatro páginas maestras en el servidor de AEM Forms. AEM Forms aplica las propiedades de la plantilla al documento de registro de forma predeterminada. AEM Forms también aplica las primeras propiedades de la página maestra de la plantilla al documento de registro.
Para aplicar las propiedades de la segunda página maestra a un panel y las propiedades de la tercera página maestra a los paneles siguientes, ejecute los pasos que aparecen a continuación:
Tenga en cuenta las siguientes consideraciones y limitaciones al trabajar en el documento de registro de los formularios adaptables.