Generar documento de registro para formularios adaptables o fragmentos de formularios adaptables generate-document-of-record-for-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.
Información general overview
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 un Forms adaptable o un fragmento de formulario adaptable.
Tipos de formularios adaptables y sus documentos de registro adaptive-form-types-and-their-documents-of-record
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:- Asociar una plantilla XFA al documento de registro. Asegúrese de que la plantilla XFA asociada utiliza el mismo esquema XML que el formulario adaptable
- Generar automáticamente un documento de registro
-
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.
Documento de registro generado automáticamente automatically-generated-document-of-record
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:
- Se encarga del enlace de datos.
- Oculta automáticamente los campos marcados que se excluirán del documento de registro en el momento del envío. No se requiere ningún esfuerzo adicional.
- Permite ahorrar tiempo a la hora de diseñar la plantilla del documento de registro.
- Permite probar diferentes estilos y apariencias utilizando diferentes plantillas base y elegir el mejor estilo y la mejor apariencia para el documento de registro. La apariencia de cada estilo es opcional y, si no se especifica el estilo, el sistema de estilos se establece de forma predeterminada.
- Permite garantizar que cualquier cambio realizado en el formulario se verá reflejado inmediatamente en el documento de registro.
Componentes para generar automáticamente un documento de registro components-to-automatically-generate-a-document-of-record
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.
Fragmento de formulario adaptable: fragmento de formulario adaptable para el que 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
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.
Asignación de elementos de formulario adaptable mapping-of-adaptive-form-elements
Las siguientes secciones describen cómo se muestran los elementos de formulario adaptable en el documento de registro.
Campos fields
Contenedores containers
Componentes estáticos static-components
Tablas tables
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.
Plantilla base de un documento de registro base-template-of-a-document-of-record
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 la plantilla base.
Convenciones de plantilla base base-template-conventions
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 nombreAF_MASTERPAGE
a la página maestra. -
La página maestra con el nombre
AF_MASTERPAGE
que se encuentra en el subformulario raízAF_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 estilo en los campos del documento de registro, la plantilla base proporciona campos en el subformulario
AF_FIELDSSUBFORM
bajo el subformulario raízAF_METATEMPLATE
. -
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 serAF_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
- Si no se aplica ningún estilo a los campos de la plantilla base, es aconsejable quitar esos campos de la plantilla para que todas las actualizaciones en esta se reflejen automáticamente.
- Al modificar la plantilla base, no elimine, agregue ni modifique scripts.
Configuración de la plantilla de un documento de registro document-of-record-template-configuration
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, seleccione Modelo de formulario.
También puede seleccionar un modelo de formulario al crear un formulario.note note NOTE 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 plantilla de 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.
note note NOTE 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: code language-none * 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.
Personalizar la información de marca en el documento de registro customize-the-branding-information-in-document-of-record
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 luego seleccione .
-
Seleccione . 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.
Propiedades de la página maestra (#master-page-properties)
En función de si selecciona una plantilla predeterminada o personalizada, algunas o todas las siguientes propiedades de página maestra aparecen en la pestaña Documento de registro, como se muestra en la imagen anterior. Especifíquelas correctamente:
-
Imagen del logotipo: puede elegir usar la imagen del logotipo en el formulario adaptable, elegir una de DAM o cargar una desde el equipo.
-
Título del formulario
-
Texto de encabezado
-
Etiqueta de la exención de responsabilidad
-
Exención de responsabilidad
-
Texto de la exención de responsabilidad
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.
note note NOTE 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: code language-xml <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, seleccione Listo.
Diseños de tablas y columnas para paneles del documento de registro table-and-column-layouts-for-panels-in-document-of-record
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
Configuración del documento de registro document-of-record-settings
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.
- Posición > Después del anterior: coloca el panel después del objeto anterior en el panel principal.
- Posición > En el área de contenido > Nombre del área de contenido: coloca el panel en el área de contenido especificada.
- Posición > Parte superior de la siguiente área de contenido: coloca el panel en la parte superior de la siguiente área de contenido.
- Posición > Parte superior del área de contenido > Nombre del área de contenido: coloca el panel en la parte superior del área de contenido especificada.
- Posición > En la página > Nombre de la página maestra: coloca el panel en la página especificada. Si no se inserta automáticamente un salto de página, AEM Forms añade uno.
- Posición > Parte superior de la siguiente página: coloca el panel en la parte superior de la siguiente página. Si no se inserta automáticamente un salto de página, AEM Forms añade uno.
- Posición > Parte superior de la página > Nombre de la página maestra: coloca el panel en la parte superior de la página cuando se representa la página especificada. Si no se inserta automáticamente un salto de página, AEM Forms añade uno.
-
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:
- Después > Continuar relleno principal: continúa combinando los datos de todos los objetos que quedan por rellenar en el panel principal.
- Después > Ir a la siguiente área de contenido: comienza a rellenar la siguiente área de contenido después de colocar el panel.
- Después > Ir al área de contenido > Nombre del área de contenido: comienza a rellenar el área de contenido especificada después de colocar el panel.
- Después > Ir a la página siguiente: comienza a rellenar la página siguiente después de colocar el panel.
- Después > Ir a la página > Nombre de la página: comienza a rellenar la página especificada después de colocar el panel.
-
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:
- Desbordamiento > Ninguno: comienza a rellenar la página siguiente. Si no se inserta automáticamente un salto de página, AEM Forms añade uno.
- Desbordamiento > Ir al área de contenido > Nombre del área de contenido: comienza a rellenar el área de contenido especificada.
- Desbordamiento > Ir a la página > Nombre de la página: comienza a rellenar la página especificada.
note note NOTE La propiedad Paginación no está disponible para fragmentos de formulario adaptables.
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
-
BÁSICO
-
Plantilla: Puede seleccionar la plantilla Predeterminada o Personalizada.
-
Color de énfasis: Puede predefinir el color de plantilla del documento de registro.
-
Familia de fuentes: Seleccione el tipo de fuente para los textos de Documento de registro.
-
Incluir campos no enlazados en el documento de registro: Al establecer la propiedad, se incluyen los campos no enlazados del formulario adaptable basado en esquema en Documento de registro. De forma predeterminada, es True.
-
Excluir campos del documento de registro si están ocultos: Establezca la propiedad para excluir los campos ocultos del documento de registro al enviar el formulario. Cuando habilita Revalidar en el servidor, el servidor vuelve a calcular los campos ocultos antes de excluir esos campos del Documento de registro
-
-
PROPIEDADES DEL CAMPO DE FORMULARIO
-
Si marca la opción Para el componente Casilla de verificación y Botón de radio, mostrar solo los valores seleccionados, se generará la salida del documento de registro (DoR) con solo los valores seleccionados.
-
Puede seleccionar Separador para varios valores seleccionados o puede elegir cualquier otro tipo de separador.
-
Alineación de opciones
- Vertical
- Horizontal
- Igual que el formulario adaptable
note note NOTE La alineación vertical y horizontal solo es aplicable para Botón de opción y casilla de verificación * **PROPIEDADES DE PÁGINA MAESTRA** Haga clic para obtener más información sobre [propiedades de página maestra](#master-page-properties-master-page-properties)
-
Aplicar un salto de página en un documento de registro apply-page-breaks-in-dor
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:
-
Seleccione el panel y seleccione
-
Expanda Documento de registro para ver las propiedades.
-
En la sección Paginación, seleccione en el campo Lugar.
-
Seleccione Parte superior de la siguiente página y seleccione Seleccionar. También puede seleccionar Parte superior de la página, seleccionar la página maestra y seleccionar Seleccionar para aplicar el salto de página.
-
Seleccione para guardar las propiedades.
El panel seleccionado se traslada a la página siguiente.
Aplicar varias páginas maestras a un documento de registro apply-multiple-master-pages-dor
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:
- Seleccione el panel al que aplicar la segunda página maestra y seleccione .
- En la sección Paginación, seleccione en el campo Lugar.
- Seleccione En la página, seleccione la segunda página maestra y seleccione Seleccionar.
AEM Forms aplica la segunda página maestra al panel y a todos los paneles posteriores del formulario adaptable. - En la sección Paginación, seleccione en el campo Después.
- Seleccione Ir a la página, seleccione la tercera página maestra y seleccione Seleccionar.
- Seleccione
para guardar las propiedades.
AEM Forms aplica la tercera página maestra al panel y a todos los paneles posteriores del formulario adaptable.
Consideraciones clave al trabajar con el documento de registro key-considerations-when-working-with-document-of-record
Tenga en cuenta las siguientes consideraciones y limitaciones al trabajar en el documento de registro de los formularios adaptables.
- Las plantillas de documento de registro no admiten texto enriquecido. Por lo tanto, todo el texto enriquecido del formulario adaptable estático o de la información rellenada por el usuario final aparece como texto sin formato en el documento de registro.
- Los fragmentos de documento de un formulario adaptable no aparecen en el documento de registro. Sin embargo, sí se admiten fragmentos de formularios adaptables.
- No se admiten enlaces de contenido en los documentos de registro generados para formularios adaptables basados en el esquema XML.
- La versión localizada del documento de registro se crea bajo demanda para una configuración regional cuando el usuario solicita la representación del documento de registro. La localización del documento de registro se realiza de forma paralela a la localización del formulario adaptable. Para obtener más información sobre la localización de documentos de registro y formularios adaptables, consulte Usar el flujo de trabajo de traducción de AEM para localizar formularios adaptables y documentos de registro.
Usar un archivo XCI personalizado
Un archivo XCI ayuda a establecer varias propiedades de un documento. : puede utilizar un archivo XCI personalizado para anular una o más propiedades predeterminadas especificadas en el archivo XCI existente. Por ejemplo, puede optar por incrustar una fuente en un documento o habilitar la propiedad etiquetada para todos los documentos. La siguiente tabla especifica las opciones de XCI:
Utilizar un archivo XCI personalizado en el entorno de desarrollo local de Forms
- Cargue el archivo XCI en su entorno de desarrollo local.
- Abra el administrador de configuración .
- Busque y abra la configuración del canal web de comunicaciones interactivas y formularios adaptables.
- Especifique la ruta del archivo XCI y haga clic en Guardar.