DocumentaciónAEM 6.4Guía de Forms

Fragmentos de documento document-fragments

Last update: Fri May 05 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • User
CAUTION
AEM 6.4 ha llegado al final de la compatibilidad ampliada y esta documentación ya no se actualiza. Para obtener más información, consulte nuestra períodos de asistencia técnica. Buscar las versiones compatibles here.

Fragmentos de documento document-fragments-1

Los fragmentos de documento son elementos o componentes reutilizables de una correspondencia mediante que se pueden utilizar para componer cartas o correspondencia. Los fragmentos del documento son de los siguientes tipos:

  • Texto: un recurso de texto es un fragmento de contenido que consta de uno o más párrafos de texto. Un párrafo puede ser estático o dinámico.
  • Lista: una lista es un grupo de fragmentos de documento que puede incluir texto, listas, condiciones e imágenes. El orden de los elementos de la lista puede ser fijo o editable. Al crear una carta, puede utilizar algunos o todos los elementos de una lista para replicar un patrón de elementos reutilizable.
  • Condición: las condiciones permiten definir qué contenido se incluye en el momento de la creación de la correspondencia en función de los datos suministrados. La condición se describe en términos de variables de control. Una variable de control puede ser un elemento de diccionario de datos o un marcador de posición.
  • Fragmento de diseño: un fragmento de diseño es un diseño que se puede utilizar en una o varias cartas. Un fragmento de diseño se utiliza para crear patrones repetibles, especialmente tablas dinámicas. La presentación puede contener campos de formulario típicos, como "Dirección" y "Número de referencia". También contiene subformularios vacíos que denotan áreas de destino. Los diseños (XDP) se crean en Designer y luego se cargan en AEM Forms.

Texto text

Un recurso de texto es un fragmento de contenido que consta de uno o más párrafos de texto. Un párrafo puede ser estático o dinámico. Un párrafo dinámico contiene referencias a elementos de datos, cuyos valores se proporcionan durante la ejecución. Por ejemplo, el nombre del cliente en el saludo de una carta podría ser un elemento de datos dinámico, y su valor estaría disponible durante la ejecución. Al cambiar estos valores, se puede utilizar la misma plantilla de carta para generar cartas para distintos clientes.

La solución de Administración de correspondencia admite dos tipos de elementos de datos dinámicos (datos variables):

  • Elementos de diccionario de datos: estos elementos están enlazados al diccionario de datos y obtienen sus valores de la fuente de datos proporcionada. Una variable de diccionario de datos puede estar protegida o desprotegida. Durante la creación de la correspondencia, el usuario puede modificar el valor predeterminado de las variables de diccionario de datos no protegidas, pero no puede modificar las protegidas.
  • Marcadores de posición: son variables que no están enlazadas a una fuente de datos back-end. Requieren que el usuario rellene un valor durante la creación de la correspondencia. Los marcadores de posición no están protegidos de forma predeterminada.
NOTE
Las plantillas de Administración de correspondencia no obligan a crear nombres únicos al crear marcadores de posición. Si se crean dos marcadores de posición con el mismo nombre, como un texto y una condición, y se utilizan ambos en una plantilla de carta, los valores del último marcador de posición insertado se utilizan para ambos marcadores. Si dos marcadores de posición tienen el mismo nombre, se comparan sus tipos. Si los tipos son diferentes, su tipo se convierte en Cadena. Sin embargo, dentro de un módulo no se pueden crear varios marcadores de posición con el mismo nombre.

Crear texto create-text

  1. Seleccione Forms > Fragmentos de documento.

  2. Toque Crear > Texto. O bien, seleccione un recurso de texto y pulse Editar.

  3. Especifique la siguiente información para el texto:

    • Título: (Opcional) introduzca el título del recurso de texto. Los títulos no tienen que ser únicos, y pueden contener caracteres especiales y caracteres que no sean de inglés. Se hace referencia a los textos por sus títulos (cuando están disponibles); por ejemplo en las miniaturas y las propiedades de recursos.
    • Nombre: el nombre único del recurso de texto. No pueden existir dos recursos (texto, condición o lista) con el mismo nombre en ningún estado. En el campo Nombre, solo se pueden introducir caracteres, números y guiones en inglés. El campo Nombre se rellena automáticamente en función del campo Título. Los caracteres especiales, espacios, números y caracteres que no sean de inglés introducidos en el campo Título se sustituyen por guiones en el campo Nombre. Aunque el valor del campo Título se copia automáticamente en Nombre, puede editarlo.
    • Descripción: escriba una descripción para el recurso.
    • Diccionario de datos: si lo desea, puede seleccionar el diccionario de datos que desea asignar al texto. Este atributo permite agregar referencias a elementos de diccionario de datos en el recurso de texto.
    • Etiquetas: si lo prefiere, puede crear una etiqueta personalizada introduciendo el valor en el campo de texto y pulsando Intro. Puede ver la etiqueta debajo del campo de texto de las etiquetas. Al guardar este texto, también se crean las etiquetas que acaba de agregar.

  4. Pulse Siguiente. Administración de correspondencia muestra la página Editor, donde puede agregar párrafos de texto y elementos de datos al texto.

    El corrector ortográfico predeterminado del explorador comprueba la ortografía en el Editor de texto. Para administrar la revisión ortográfica y gramatical, puede editar la configuración del corrector ortográfico del explorador o instalar complementos del explorador para revisar la ortografía y la gramática.

    También puede utilizar los distintos métodos abreviados de teclado en el Editor de texto para administrar, editar y dar formato al texto. Para obtener más información, consulte los métodos abreviados de teclado del Editor de texto en Métodos abreviados de teclado de Administración de correspondencia.

  5. Se abre el Editor de texto. Introduzca el texto. Utilice la barra de herramientas situada en la parte superior de la página para dar formato al texto e insertar condiciones, vínculos y saltos de página.

    Barra de herramientas

    Figura: Barra de herramientas

    • Vínculo: inserte un vínculo de hipertexto en el texto. Toque Vínculo, especifique el vínculo en la URL , elimine el nombre de objeto predeterminado del Texto alternativo y toque Guardar .
    • Repetir: Repetir imprime el elemento de colección en el diccionario de datos con un delimitador.
    • Condición: pulse esta opción para insertar una condición. Inserte texto basado en una condición. Si la condición es verdadera, el texto es visible en la carta; de lo contrario, no.
    • Agregar descripción: agregue anotaciones a un fragmento de texto. Es un metadato visible para el autor, pero no forma parte de la carta creada.
    • Salto de página: si establece el atributo de salto de página de un módulo de texto en False, el módulo de texto no se divide entre las páginas.

    Se abre un editor de texto. Introduzca el texto. La barra de herramientas cambia según el tipo de ediciones que decida realizar: Párrafo, Alineación o Lista:

    Seleccione el tipo de barra de herramientas

    Figura: Seleccionar tipo de barra de herramientas: Párrafo, alineación o lista

    Barra de herramientas Párrafo

    Figura: Barra de herramientas Párrafo

    Barra de herramientas de alineación

    Figura: Barra de herramientas Alineación

    Barra de herramientas de lista

    Figura: Barra de herramientas Listing

  6. Para reutilizar un párrafo de texto de otra aplicación, por ejemplo, de MS Word o páginas de HTML, copie y pegue el texto en el Editor de texto. El formato del texto copiado se mantiene en el Editor de texto.

    Puede copiar y pegar uno o varios párrafos de texto en un módulo de texto editable. Por ejemplo, es posible que tenga un documento de MS Word con una lista con viñetas de justificantes de domicilio aceptables como las siguientes:

    pastetextmsword

    Puede copiar y pegar directamente el texto del documento de MS Word en un módulo de texto editable. El formato, como la lista con viñetas, la fuente y el color del texto, se mantiene en el módulo de texto.

    pastetexttextmodule

    note note
    NOTE
    Sin embargo, el formato del texto pegado tiene algunas limitaciones.

  7. Si es necesario, inserte caracteres especiales en el fragmento de documento. Por ejemplo, puede utilizar la paleta Caracteres especiales para insertar:

    • Símbolos monetarios como €, ￥ y £
    • Símbolos matemáticos como ∑, √, ∂ y ^
    • Símbolos de puntuación como ‟ y ”

    specialcharacters

    Administración de correspondencia ha incorporado la compatibilidad con 210 caracteres especiales. El administrador puede agregar compatibilidad con caracteres especiales adicionales o personalizados usando la personalización.

  8. Para resaltar o hacer énfasis en determinados fragmentos de texto de un módulo en línea editable, seleccione el texto y pulse Color de resaltado.

    textbackgroundcolorapplied

    Puede pulsar directamente en un color básico [A] presentes en la paleta Colores básicos o pulsar Seleccionar después de usar el regulador [B] para elegir la sombra adecuada de color.

    Alternativamente, también puede ir a la pestaña Avanzado para seleccionar el tono, la luminosidad y la saturación adecuados [C] para crear el color preciso y, a continuación, pulsar Seleccionar [D] para aplicar el color para resaltar el texto.

    textbackgroundcolor

  9. Arrastre y suelte los elementos del diccionario de datos y el marcador de posición al texto en el panel de datos.

    A:

    • Agregue un elemento de diccionario de datos al texto: Para ello, seleccione un elemento de datos de la lista y pulse Insertar ( insertar ). Si selecciona Protegido, el elemento del diccionario de datos es de solo lectura y aparece en el Editor de cartas, pero no en la interfaz de usuario Crear correspondencia o Creador de correspondencia.
    • Agregue un elemento de marcador de posición en el texto; en el panel Elementos de datos, pulse Crear nuevo, introduzca los detalles del nuevo elemento de datos y pulse Crear para agregar el nuevo elemento a la lista. El nuevo marcador de posición se puede insertar en el texto del mismo modo que el elemento de diccionario de datos. Para editar un marcador de posición, seleccione un marcador y pulse Editar.

    Elementos de marcador de posición

    Figura: Elementos de marcador de posición tal como se especifica en el archivo de datos de ejemplo de un diccionario de datos

    Elementos de marcador de posición en una carta

    Figura: Los valores de los elementos del marcador de posición en la vista CCR se rellenan desde las variables del diccionario de datos, tal como se especifica en el archivo de datos de ejemplo

  10. Puede utilizar condiciones en línea y repeticiones para que la carta tenga un carácter altamente contextual y esté bien estructurada. Para obtener más información sobre las condiciones en línea y las repeticiones, consulte Condiciones en línea y repeticiones en cartas.

  11. Pulse Guardar.

Buscar y reemplazar texto searching-and-replacing-text

Cuando se trabaja con elementos de texto que contienen un gran cuerpo de texto, es necesario buscar una cadena de texto específica. También es posible que tenga que reemplazar una cadena de texto específica por una cadena alternativa.

La función Buscar y reemplazar permite buscar (y reemplazar) cualquier cadena de texto en un elemento de texto. La función también incluye una eficaz opción de búsqueda de expresiones regulares.

Búsqueda de texto en un módulo de texto to-search-text-in-a-text-module

  1. Abra el módulo de texto en el Editor de texto.

  2. Toque Buscar y reemplazar.

  3. Introduzca el texto que desea buscar en el cuadro de texto Buscar y pulse Buscar. El texto de búsqueda se resalta en el módulo de texto.

  4. Para buscar la siguiente instancia del texto, pulse de nuevo Buscar.

    Si continúa pulsando el botón Buscar, la búsqueda continuará hacia la parte inferior de la página. Después de buscar la última instancia del texto, el mensaje Se ha alcanzado el final del módulo indica que no se han encontrado más resultados de búsqueda.

    Sin embargo, si no se encuentra ninguna instancia del texto de búsqueda en el módulo de texto, se muestra el mensaje No se encontró ninguna coincidencia.

  5. Si vuelve a pulsar Buscar, la búsqueda continúa en la parte superior de la página.

Opciones de búsqueda search-options

Coincidir mayúsculas y minúsculas: la búsqueda devuelve únicamente resultados que coinciden exactamente, con mayúsculas y minúsculas, con el texto que desea buscar.

Palabra completa: la búsqueda devuelve únicamente palabras completas.

Nota: Si introduce caracteres especiales en el cuadro de texto Buscar, se desactivará la opción Palabra completa .

Expresiones regulares: la búsqueda utiliza expresiones regulares. Por ejemplo, la siguiente expresión regular busca direcciones de correo electrónico en un módulo de texto:

[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,4}

Buscar y reemplazar texto en un módulo de texto to-search-and-replace-text-in-a-text-module

  1. Abra el módulo de texto en el Editor de texto.

  2. Toque Buscar y reemplazar.

  3. Introduzca el texto que desea buscar en el cuadro de texto Buscar y el texto que reemplazará el texto de búsqueda, y pulse Reemplazar.

  4. Cuando se encuentra el texto de búsqueda, este se reemplaza por el texto del cuadro Reemplazar.

    • Cuando se encuentra otra instancia del texto de búsqueda, dicha instancia se resalta en el módulo de texto. Si vuelve a pulsar Reemplazar, se reemplazará la instancia resaltada y el cursor se desplazará hacia adelante si se encuentra una tercera instancia.
    • Si no se encuentra ninguna otra instancia, el cursor se detendrá en la última instancia reemplazada.

  5. Si vuelve a pulsar Buscar, la búsqueda continuará en la parte superior de la página.

    Utilice la opción Reemplazar todo para reemplazar todas las instancias de un texto en el módulo de texto. Si usa ``, se mostrará el número de reemplazos en forma de mensaje en el cuadro de diálogo Buscar y reemplazar.

Prácticas recomendadas, sugerencias y trucos para los módulos de texto best-practices-tips-and-tricks-for-text-modules

  • Utilice una convención de nomenclatura uniforme para evitar duplicaciones.

  • Utilice el enlace de diccionario de datos adecuado en los módulos de texto.

  • Al usar el Editor de texto para cambiar un recurso de texto, se aplican las siguientes reglas:

    • Adición de variable: permitido
    • Eliminación de variable: permitido
    • Actualización de propiedades: permitido
    • Cambio del diccionario de datos: permitido hasta que no se utilice el elemento de diccionario de datos. No se puede cambiar el diccionario de datos al actualizar.

Lista list

Una lista es un grupo de fragmentos de documento que puede incluir texto, (otras) listas, condiciones e imágenes. El orden de los elementos de la lista puede ser fijo o editable. Al crear una carta, puede utilizar algunos o todos los elementos de la lista para replicar un patrón de elementos reutilizable. Las listas se comportan básicamente como destinos que se pueden anidar dentro de otros destinos.

Implementación de listas implementing-lists

La implementación de listas consta de dos pasos:

  1. Definir las propiedades principales, como nombre, descripción o diccionario de datos.
  2. Establecer la sección de contenido que forma parte de la lista y, a continuación, definir propiedades como el orden de bloqueo y el acceso a la biblioteca para ella.

Crear una lista create-a-list

Una lista es un grupo de contenido relacionado que se puede utilizar en una plantilla de carta como una unidad individual. Es posible añadir cualquier tipo de contenido a una lista. Además, las listas también se pueden anidar. Los módulos de lista se pueden especificar de la siguiente forma:

  • ORDENADO: el orden no se puede cambiar durante el tiempo de ejecución de Crear correspondencia.
  • Acceso a la biblioteca: los usuarios pueden agregar módulos a la lista. Este indicador especifica si el acceso a la biblioteca está habilitado. Si está habilitado (abierto), el usuario puede agregar módulos a la lista mientras previsualiza la carta.
  • Al crear una lista, puede especificar un tipo, como, por ejemplo:
  • Sin formato: no se aplica ningún formato de estilo adicional a la lista.
  • Con viñetas: una lista con formato de viñeta simple.
  • Numerado: una lista numérica con las opciones Estándar (1, 2,…), Romano superior (I, II,…) y Romano inferior (i, ii,…).
  • Con letras: una lista alfabética con la opción de letras en minúsculas (a, b,…) y mayúsculas (A, B,…).
  • Personalizado: puede crear cualquier tipo Numerado/Con letras y los valores de prefijo y sufijo que desee.

  1. Seleccione Forms > Fragmentos de documento.

  2. Seleccione Crear > Lista.

  3. Especifique la siguiente información para la lista:

    • Título (opcional): introduzca un título para la lista. El título no tiene que ser único, y puede contener caracteres especiales y caracteres que no sean de inglés. Se hace referencia a las listas por sus títulos (cuando están disponibles); por ejemplo, en las miniaturas y las propiedades de recursos.
    • Nombre: el nombre único de la lista. No pueden existir dos recursos (texto, condición o lista) con el mismo nombre en ningún estado. En el campo Nombre, solo se pueden introducir caracteres, números y guiones en inglés. El campo Nombre se rellena automáticamente con el valor del campo Título. Los caracteres especiales, espacios, números y caracteres que no sean de inglés introducidos en el campo Título se sustituyen por guiones en el campo Nombre. Aunque el valor del campo Título se copia automáticamente en Nombre, puede editarlo.
    • Descripción (opcional): escriba una descripción para el recurso.
    • Diccionario de datos (opcional): si lo desea, puede seleccionar el diccionario de datos al que desea conectarse. Solo se pueden agregar a la lista recursos que utilicen el mismo diccionario de datos que la lista, o recursos que no tengan asignado ningún diccionario de datos. Asignar un diccionario de datos a una lista facilita a la persona que crea una plantilla de carta la tarea de encontrar la lista adecuada.
    • Etiquetas (opcional): seleccione las etiquetas que desee aplicar. También puede escribir el nombre de una etiqueta nueva y crearla. (La etiqueta nueva se crea al pulsar Guardar).

  4. Pulse Siguiente.

  5. Pulse Agregar recurso.

  6. Para añadir recursos a la lista, selecciónelos en la página Seleccionar recursos y luego pulse Listo.

    Seleccionar recursos para agregarlos a la lista

  7. Los recursos se agregan a la página Lista de elementos.

    Para cambiar el orden de los recursos de la lista, pulse y mantenga presionado el icono en forma de flechas ( arrastrar_y_soltar ), y después arrástrelo y suéltelo. Cuando el usuario abre una plantilla de carta en la interfaz de usuario Crear correspondencia, el contenido se organiza en el orden definido aquí.

    Reordenar y configurar recursos en una lista

  8. Puede seleccionar las siguientes opciones para especificar cómo se comporta la lista en la interfaz de usuario de CCR:

    • Acceso a la biblioteca: para habilitar el acceso a la biblioteca para agregar recursos, pulse Acceso a la biblioteca. Cuando el acceso a la biblioteca está habilitado, el Administrador de reclamaciones puede añadir más contenido a la lista. De lo contrario, el Administrador de reclamaciones se limita al contenido que haya definido para la lista.
    • Orden de bloqueo: para bloquear el orden de los recursos de la lista de modo que el Administrador de reclamaciones no pueda cambiarlo, pulse Bloquear orden. Si no selecciona esta opción, el Administrador de reclamaciones puede cambiar el orden de los artículos de la lista.
    • Agregar viñetas: utilice esta opción para aplicar una viñeta o un estilo de numeración al módulo. Puede utilizar un estilo de lista prediseñado o personalizado. También puede especificar el texto que se mostrará antes y después de cada uno de los elementos de la lista.
    • Salto de página: seleccione esta opción ( salto ) para agregar un salto de página entre los contenidos de la lista. Cuando esta opción no está seleccionada ( sin_salto ), si el contenido de la lista se desborda hasta la siguiente página, toda la lista pasa a esa página en lugar de insertar un salto de página en medio de la lista.
    • Configuración de asignación: utilice esta opción para especificar el número mínimo y máximo de recursos que se pueden agregar a la lista.

  9. Puede seleccionar las siguientes opciones para especificar el comportamiento de cada recurso en la lista durante la ejecución:

    • Editable: cuando se selecciona esta opción, el contenido se puede editar en la interfaz de usuario Crear correspondencia. (Esta opción no está disponible para los módulos Lista e Imagen).
    • Obligatorio: cuando se selecciona esta opción, el contenido es obligatorio en la interfaz de usuario Crear correspondencia.
    • Seleccionado: cuando se selecciona esta opción, el contenido se preselecciona en la interfaz de usuario Crear correspondencia.
    • Omitir estilo: cuando se selecciona esta opción, el contenido omite las viñetas y la numeración en la interfaz de usuario Crear correspondencia. (Esta opción no está disponible para los módulos Imagen. Además, no es posible aplicar conjuntamente las opciones Omitir estilo, Compuesto e Ignorar estilo de lista al mismo módulo. Puede utilizar una de ellas si selecciona Agregar viñetas en ese módulo).
    • Sangría: puede cambiar el nivel de sangría de cada módulo/contenido seleccionado como parte de la lista. La sangría se especifica en términos de Niveles (empezando por cero), de forma que cada nivel de sangría corresponde a un relleno de 36 puntos.
    • Compuesto: cuando se selecciona esta opción, la numeración compuesta se aplica como una combinación del estilo de la lista externa (principal) y su propio estilo. La numeración compuesta de esta lista anidada se basa en el orden en el que aparece en la lista externa.
    • Ignorar estilo de lista: si la opción Numeración compuesta no está seleccionada, se activa la opción Ignorar estilo de lista. Esta selección ignora el estilo de la lista anidada, y la numeración continúa desde la lista externa. Por lo tanto, los módulos de la lista anidada se tratan como parte de la propia lista externa, sin tener en cuenta los estilos especificados en la lista anidada. Si la opción Ignorar estilo de lista no está seleccionada para una lista anidada, los módulos que forman parte de esa lista tienen su propio estilo de numeración.
    • Mantener con siguiente: establece el salto de página de los recursos contenidos en una lista. Si establece la propiedad Mantener con siguiente del recurso de una lista en Activado, ese recurso y el siguiente permanecerán en la misma página. Eso significa que el contenido del recurso seleccionado y el del siguiente no se dividirán en varias páginas.

  10. Pulse Guardar.

Prácticas recomendadas, sugerencias y trucos best-practices-tips-and-tricks

  • Utilice una convención de nomenclatura uniforme para evitar duplicaciones.

  • Use un enlace de diccionario de datos adecuado.

  • Al usar el Editor de listas para cambiar una lista, se aplican las siguientes reglas:

    • Actualización de propiedades: permitido
    • Cambio del diccionario de datos: permitido hasta que no haya ningún elemento que utilice el diccionario de datos asociado a él. No se puede cambiar el diccionario de datos al actualizar.

Condiciones conditions

Las condiciones permiten definir qué contenido se incluye en el momento de la creación de la correspondencia o la carta en función de los datos suministrados. La condición se describe en términos de variables de control. Cuando agregue una condición, puede decidir si desea incluir un recurso en función del valor de la variable de control.

Dependiendo de las opciones que elija, solo se evaluará la primera expresión que resulte ser True en función de la variable de condición actual, o toda la condición. Al rellenar la carta en Crear correspondencia (CCR), las condiciones se comportan como “cuadros blancos”. Si una condición genera una lista, se muestran todos los elementos obligatorios y preseleccionados de esta. Si alguno de estos elementos es una condición o una lista, el contenido resultante de estos también se genera como una lista plana de texto y contenido de imagen en orden descendente y por profundidad. Los resultados de la condición pueden ser de cualquier tipo (texto, lista, condición o imagen).

Implementación de condiciones implementing-conditions

El Editor de condiciones viene con una interfaz de usuario llamada Generador de expresiones que admite la creación de expresiones utilizando varios marcadores de posición y elementos de diccionario de datos. Puede utilizar operandos comunes y funciones locales o globales en dichas expresiones. Cada expresión se puede asociar con un determinado contenido y, alternativamente, puede haber una sección predeterminada si ninguna de las expresiones se evalúa como True. Todas las expresiones se evalúan en la secuencia en la que se definen, se seleccionan las primeras expresiones que devuelven el valor True, y el contenido asociado a ellas se devuelve mediante ese módulo condicional.

Por ejemplo, si el texto de los términos y condiciones de una carta difiere según el estado en que se encuentre el cliente y el diccionario de datos contenga un elemento llamado "state", puede agregar la condición de la siguiente manera:
・ state = NY, seleccione el párrafo de texto T&C_NY
・ estado = CN, seleccione párrafo de texto T&C_NC

El Editor de condiciones permite especificar una condición predeterminada. Si el valor de las variables de control no coincide con ninguna de las condiciones, se utiliza el contenido asociado con la condición predeterminada. Después del ejemplo anterior, puede añadir esta fila de condición:
・ Predeterminado, seleccione T&C_Rest

Creación de una condición create-a-condition

  1. Seleccione Forms > Fragmentos de documento.

  2. Seleccione Crear > Condición.

  3. Especifique la siguiente información para la lista:

    • Título (opcional): introduzca el título de la condición. El título no tiene que ser único, y puede contener caracteres especiales y caracteres que no sean de inglés. Se hace referencia a las condiciones por sus títulos (cuando están disponibles); por ejemplo, en las miniaturas y las propiedades de recursos.
    • Nombre: el nombre único de la condición. No pueden existir dos recursos (texto, condición o lista) con el mismo nombre en ningún estado. En el campo Nombre, solo se pueden introducir caracteres, números y guiones en inglés. El campo Nombre se rellena automáticamente en función del campo Título. Los caracteres especiales, espacios, números y caracteres que no sean de inglés introducidos en el campo Título se sustituyen por guiones en el campo Nombre. Aunque el valor del campo Título se copia automáticamente en Nombre, puede editarlo.
    • Descripción (opcional): escriba una descripción para la condición.
    • Diccionario de datos (opcional): si lo desea, puede seleccionar el diccionario de datos al que desea conectarse. Solo se pueden agregar a la lista recursos que utilicen el mismo diccionario de datos que la condición, o recursos que no tengan asignado un diccionario de datos. Asignar un diccionario de datos a una lista facilita a la persona que crea una plantilla de carta la tarea de encontrar la condición adecuada.
    • Etiquetas (opcional): si lo desea, seleccione las etiquetas que desee aplicar. También puede escribir el nombre de una etiqueta nueva y crearla. (La etiqueta nueva se crea al pulsar Guardar).

  4. Pulse Siguiente.

  5. Pulse Agregar recurso.

  6. Para añadir un recurso a la condición, selecciónelo en la página Seleccionar recursos y pulse Listo. Los recursos se agregan al panel Expresión.

  7. Puede seleccionar las siguientes opciones para especificar el comportamiento de la condición durante la ejecución:

    • Desactivar evaluación de varios resultados\Habilitar evaluación de varios resultados: Cuando esta opción está habilitada (aparece como "Habilitar varios…"), todas las condiciones se evalúan y el resultado es la suma de todas las condiciones verdaderas. Si esta opción está desactivada (aparece como "Deshabilitar evaluación…"), solo se evalúa la primera condición que resulta ser True, y se convierte en el resultado de la condición.
    • Salto de página: seleccione esta opción ( salto ) para agregar un salto de página entre los módulos de las condiciones. Cuando esta opción no está seleccionada ( sin_salto ), si una condición se desborda hasta la siguiente página, toda la condición se pasa a esa página en lugar de insertar un salto de página en medio de la condición.

  8. Para cambiar el orden de los recursos de la condición, pulse y mantenga presionado el icono en forma de flechas ( arrastrar_y_soltar ), y después arrástrelo y suéltelo. Cuando el usuario abre una plantilla de carta en la interfaz de usuario Crear correspondencia, el contenido se organiza en el orden definido aquí.

  9. Pulse Eliminar para eliminar la fila. Si pulsa Eliminar para la fila predeterminada, solo se borra la información del recurso.

  10. Pulse Copiar para duplicar una fila.

  11. Pulse Editar para cambiar el recurso o editar la expresión.

    Además:

    • Para actualizar el recurso, pulse el icono en forma de carpeta de la columna Recurso.
    • Para abrir el Generador de expresiones e insertar una expresión, pulse el icono en forma de carpeta de la columna Expresión. Para obtener más información sobre el Generador de expresiones, consulte Generador de expresiones.

Prácticas recomendadas, sugerencias y trucos best-practices-tips-and-tricks-1

  • Utilice una convención de nombres uniforme para facilitar la búsqueda y evitar duplicaciones.

  • Las condiciones se comportan como instrucciones de caso, por lo que el orden de las condiciones es importante. Se devuelve la primera coincidencia.

  • Use un enlace de diccionario de datos adecuado.

  • Al usar el Editor de condiciones para editar una condición, se aplican las siguientes reglas:

    • Adición de variable: permitido
    • Eliminación de variable: permitido
    • Actualización de propiedades: permitido
    • Cambio del diccionario de datos: permitido hasta que no se utilice el elemento de diccionario de datos.

Fragmentos de diseños layoutfragments

Un fragmento de diseño se basa en XDP creados en Designer. Para crear fragmentos de diseño, debe crear los XDP y cargarlos en AEM Forms.

Uno o más fragmentos de diseño pueden constituir secciones de una carta y definir el diseño gráfico de esas secciones. Un fragmento de diseño puede contener campos de formulario comunes, como Dirección y Número de referencia, y subformularios vacíos que denotan áreas de destino. Además, los fragmentos de diseño permiten crear tablas e insertarlas en cartas.

Un caso de uso común es localizar patrones de diseño reutilizables en cartas y crear fragmentos de diseño para ellos; por ejemplo, las secciones del saludo, la dirección y el asunto de la carta, que aparece en el mismo orden en varias cartas. Otro ejemplo puede ser una tabla con un número similar de filas y columnas utilizadas en varias cartas.

Puede crear un fragmento de diseño basado en un XDP existente. Un fragmento de diseño puede estar compuesto por campos y áreas de destino o por una o más tablas. Las tablas de un diseño pueden ser estáticas o dinámicas. Se crea un XDP en Designer y se carga en AEM Forms. Un XDP puede conformar la estructura de un fragmento de diseño o de una carta. Más información sobre Diseño.

El uso de fragmentos enlazados a áreas de destino permite cambiar la carta en el momento de su creación. Se puede crear un fragmento de diseño con diferentes dimensiones, y el fragmento apropiado se puede enlazar al área de destino. Los fragmentos de diseño también permiten personalizar algunas de las propiedades de la tabla:

  1. Puede aumentar el número de filas y columnas.
  2. Puede especificar el texto del encabezado y el pie de página de más filas y columnas.
  3. Puede definir la proporción de anchura de las columnas de la tabla. En tiempo de ejecución, las columnas de la tabla cambian de tamaño según la proporción definida y el espacio disponible. La suma de la proporción de anchura debe ser 100. De lo contrario, no es aplicable.
  4. Si una tabla es un marcador de posición (contiene solo una celda en blanco), puede definir el tipo (área/campo de destino) de las nuevas columnas.
  5. Puede ocultar las filas de encabezado y pie de página.

Antes de realizar este procedimiento, cree un fragmento XFA con Designer. El fragmento puede contener tablas para organizar campos y áreas de destino. Designer permite la creación de dos tipos de tablas: estáticas y dinámicas. Las tablas estáticas contienen un número fijo de filas. Las tablas estáticas pueden contener campos y áreas de destino. Estos campos y áreas de destino no se pueden enlazar a DDE repetitivos. Una tabla dinámica también puede contener una sola fila. Los datos enlazados a celdas de tabla determinan el número de filas de las tablas dinámicas. Una tabla dinámica solo puede contener campos. Los DDE pueden ser repetitivos o no repetitivos.

Tenga en cuenta los siguientes puntos al diseñar tablas:

  1. Las tablas se pueden personalizar en el momento de crear el fragmento de diseño. Sin embargo, la opción de personalización solo está habilitada cuando el subformulario principal de la tabla tiene una posición variable.
  2. En las tablas dinámicas, todos los campos, filas y tablas repetibles utilizan el enlace "use name" para combinar los datos correctamente.
  3. En las tablas dinámicas, todos los DDE repetitivos enlazados a los campos de tabla forman parte de la misma jerarquía. En el caso de los DDE no repetitivos, no existe dicha restricción.
  4. En el momento de combinar el fragmento de diseño en las tablas de área de destino principales, se cambia el tamaño según el espacio disponible, pero este cambio solo se produce cuando el fragmento de diseño no contiene ningún área de destino o campo directamente en el subformulario de nivel superior. El área de destino y los campos están permitidos en la tabla.
  5. Puede crear tablas de marcador de posición. Las tablas de marcador de posición tienen una sola celda en blanco.

  • En este tipo de tablas, puede personalizar las siguientes propiedades en el momento de la creación del fragmento.

    • recuento de filas
    • recuento de columnas
    • encabezado y pie de página de cada columna
    • tipo (área/campo de destino) de cada columna
    • proporción de anchura de cada columna

  • En las tablas que no son de marcador de posición, puede personalizar las siguientes propiedades:

    • recuento de filas
    • recuento de columnas
    • encabezado y pie de página de una columna adicional
    • proporción de anchura de cada columna

Puede anidar fragmentos en una carta. Eso significa que puede agregar un fragmento dentro de otro. La solución Administración de correspondencia admite hasta cuatro niveles de anidación dentro de una carta: Carta->Fragmento->Fragmento->Fragmento->Fragmento.

Para ver un ejemplo detallado del uso de tablas estáticas y dinámicas en fragmentos de diseño, consulte Ejemplo con archivos de ejemplo: uso de tablas estáticas y dinámicas en una carta.

Creación de un fragmento de diseño creating-a-layout-fragment

  1. Seleccione Crear > Fragmento de diseño.

  2. Administración de correspondencia muestra los XDP disponibles. Seleccione el XDP en el que desea basar el fragmento de diseño y pulse Siguiente.

  3. Especifique la siguiente información para el diseño:

    • Título (opcional): introduzca el título del fragmento de diseño. El título no tiene que ser único, y puede contener caracteres especiales y caracteres que no sean de inglés. Se hace referencia a los fragmentos de diseño por sus títulos (cuando están disponibles); por ejemplo, en las miniaturas y las propiedades de recursos.
    • Nombre: el nombre único del fragmento de diseño. No pueden existir dos recursos (texto, condición o lista) con el mismo nombre en ningún estado. En el campo Nombre, solo se pueden introducir caracteres, números y guiones en inglés. El campo Nombre se rellena automáticamente en función del campo Título. Los caracteres especiales, espacios, números y caracteres que no sean de inglés introducidos en el campo Título se sustituyen por guiones en el campo Nombre. Aunque el valor del campo Título se copia automáticamente en Nombre, puede editarlo. Este nombre aparece en la lista de la interfaz de usuario Administrar recursos.
    • Descripción (opcional): la descripción que aparece en la lista de la interfaz de usuario Administrar recursos.
    • Etiquetas (opcional): si lo desea, seleccione las etiquetas que desea aplicar a la condición. También puede escribir el nombre de una etiqueta nueva y crearla.

  4. Pulse la pestaña Tabla y especifique la siguiente información para el diseño:

    • Configuración para: Seleccione la tabla que está configurando. Como sufijo del nombre de tabla en la lista desplegable es (estático) si la tabla es estática o (dinámica) si la tabla es dinámica. Las tablas estáticas contienen un número fijo de filas. Las tablas estáticas pueden contener campos y áreas de destino. Estos campos y áreas de destino no se pueden enlazar a DDE repetitivos. Los datos enlazados a celdas de tabla determinan el número de filas de las tablas dinámicas.
    • Filas: seleccione el número de filas del diseño. El recuento de filas configurado debe ser mayor o igual que el recuento de filas original.
    • Columnas: seleccione el número de columnas del diseño. El recuento de columnas configurado debe ser mayor o igual que el recuento de columnas original.

    Es necesario proporcionar los siguientes detalles para cada columna:

    • Encabezado: el texto que se mostrará en el encabezado.
    • Pie de página: el texto que se mostrará en el pie de página.
    • Tipo: el tipo de columna adicional. Campo o área de destino. El tipo está habilitado para tablas estáticas de marcador de posición. El tipo se puede definir en el nivel de columna y no en el de celda. Todas las celdas de una columna ampliada serán del mismo tipo. En las tablas dinámicas, todas las columnas son del tipo Campo. En las tablas que no son de marcador de posición, no se puede definir el tipo de columnas adicionales. En este caso, el tipo de celdas adicionales de la columna ampliada es el mismo que el tipo de la última columna de esa fila; y el tipo de celda de la fila adicional es el mismo que el tipo de la última celda de esa columna.
    • Proporción de anchura: la proporción de las anchuras de columna de la tabla.

    Para ver un ejemplo detallado del uso de tablas estáticas y dinámicas en fragmentos de diseño, consulte Ejemplo con archivos de ejemplo: uso de tablas estáticas y dinámicas en una carta.

  5. Pulse Guardar.

Cargar un XDP en Administración de correspondencia upload-an-xdp-to-correspondence-management

Para obtener instrucciones sobre cómo cargar/importar un XDP en Administración de correspondencia, consulte Importación y exportación de recursos a AEM Forms.

Prácticas recomendadas, sugerencias y trucos best-practices-tips-and-tricks-2

Establecimiento del enlace predeterminado del subformulario set-the-default-subform-binding

Al crear áreas de destino en Designer, es recomendable establecer el enlace predeterminado de todos los subformularios nuevos en "ninguno".

Para establecer el enlace predeterminado:

  1. En Designer, pulse Herramientas > Opciones > Enlaces de datos > Enlace de subformularios.

  2. En la lista Enlace predeterminado para nuevos subformularios, seleccione Sin enlace de datos.

Esto garantiza que a los subformularios insertados mediante el comando Insertar > Subformulario o arrastrando y soltando desde la paleta Objeto se les asigne como enlace la opción "ninguno" de forma predeterminada. Esto significa que, de forma predeterminada, cualquier nuevo subformulario es un área de destino a menos que se le agregue contenido, se cambie su configuración de enlace o se asigne un nombre al subformulario con el sufijo "_int".

Sección 508 - Cumplimiento section-compliance

Si la carta final creada en la interfaz de usuario Crear correspondencia se utiliza para rellenar un flujo de trabajo posterior, siga estas recomendaciones relacionadas con la Sección 508 durante la creación del diseño. En caso contrario, la carta PDF está destinada a su exhibición, y puede ignorar estas recomendaciones:

  • Todos los subformularios de área de destino y todos los campos del diseño tienen un orden de tabulación.
  • Los campos con pie de ilustración cumplen los requisitos establecidos por la Sección 508 de forma predeterminada. El atributo /field/help/speak@priority del campo está establecido en "personalizado" de forma predeterminada, lo que significa que, a menos que se proporcione texto personalizado para los lectores de pantalla, estos leerán el pie de ilustración del campo.
  • Los campos sin pie de ilustración especifican información sobre herramientas e indican que los lectores de pantalla leen esa información configurando

/field/assist/speak@priority="toolTip" y especificando el texto de la información sobre herramientas en /field/assist/toolTip.

Formatos de fecha en Designer y el Administrador de configuración de recursos date-formats-in-designer-and-asset-configuration-manager

Al diseñar un diseño en Designer, asegúrese de que los formatos de los campos de fecha coinciden con los formatos de fecha especificados en Formatos de visualización de datos en las Propiedades de configuración de Administración de correspondencia. Para obtener más información, consulte "Formato de valores de campo y uso de patrones" en la Ayuda de Designer.

Captura de intervalos de fechas capturing-date-ranges

Cuando se trata de una combinación de fechas, como startDate - endDate, utilice un solo subformulario para garantizar su correcta alineación en la carta final y minimizar el número de campos.

Configuración del enlace a nivel de formulario setting-form-level-binding

Cuando un diseño contiene un gran número campos y áreas de destino asignados a elementos XML únicos, utilice enlaces de nivel de formulario y cree un nodo independiente para cada elemento. Los campos enlazados en el nivel de formulario se omiten al asignar datos en Administración de correspondencia.

No utilice áreas de destino de subformulario en una página maestra do-not-use-subform-target-areas-in-a-master-page

Las áreas de destino de subformulario de una página maestra no son visibles en la interfaz de usuario de Administrar recursos, y no se pueden asignar datos a ellas.

Elección de posiciones y tipos adecuados para las áreas de destino choosing-appropriate-positions-and-types-for-target-areas

Al preparar el diseño, tenga cuidado al elegir los subformularios. Si la presentación contiene un solo subformulario, puede ser de tipo variable. Una vez colocados los campos en el subformulario, se puede ajustar en otro subformulario para que el subformulario ajustado también tenga posición variable y el diseño no se vea alterado.

Colocación de campos en páginas maestras placing-fields-on-master-pages

Tenga en cuenta lo siguiente cuando coloque un campo en una página maestra:

  • Establezca el enlace de los campos de la página maestra en Usar datos globales.
  • No coloque el campo directamente debajo de la raíz PageArea de la página maestra.
  • Ajuste el campo en un subformulario al que se le haya asignado un nombre y asegúrese de que el enlace de ese subformulario está definido en Usar nombre.

Creación de tablas mediante fragmentos de diseño creating-tables-using-layout-fragments

Muchas plantillas de carta contienen tablas. Las tablas pueden ser estáticas; por ejemplo, es el caso de las tablas de términos y condiciones, en las que cada fila representa una condición y cada fragmento se muestra en una columna independiente. Las tablas también pueden ser dinámicas; es el caso de la información de cuentas, que contiene información como el nombre del cliente, el ID de cuenta, el número de transacción y el importe.

  • Tablas estáticas: a veces, las tablas se crean con filas que tienen un número diferente de columnas, como las tablas de términos y condiciones, en las que cada fila representa una condición y cada condición puede tener diferentes subfragmentos. Cada fragmento se muestra en una columna independiente.
  • Tablas dinámicas: los fragmentos de diseño permiten enlazar los campos de una tabla dinámica a los DDE de colección. A la hora de crear la carta, las filas de la tabla se generan según el tamaño de los DDE de colección.

El DD tiene un elemento de colección denominado Nominee_details que tiene un elemento compuesto con tres elementos primitivos: Nominee_name, Nominee_address y Nominee_gender.
El XDP dinámico también tiene los mismos encabezados. Por lo tanto, puede asignar los campos XDP dinámicos a los campos de DD mencionados anteriormente.

Ejemplo con archivos de ejemplo: uso de tablas estáticas y dinámicas en una carta examplewithsamplefiles

En este ejemplo se muestra cómo crear una tabla dinámica y una tabla estática, cómo enlazar la tabla dinámica a DDE y, a continuación, cómo crear una carta que incluya esas dos tablas. Mientras trabaja con este ejemplo, puede crear los archivos desde cero o utilizar los archivos de entrada indicados en los pasos.

  1. Cree el diccionario de datos (DD) que desee usar en el ejemplo, tal como se muestra en el gráfico.

    A continuación, seleccione el DD y exporte los datos de ejemplo. El archivo XML que obtiene contiene datos de empleados y tres instancias para Nominee_details (de forma predeterminada, se descargan 3 instancias. Puede agregar más o eliminarlas según sus necesidades). Actualice los valores y, a continuación, importe los datos de prueba en el DD. El archivo CMP es el paquete y contiene el DD. Importe el DD en Administración de correspondencia.

    Para obtener más información sobre cómo trabajar con el diccionario de datos y los datos de prueba, consulte Diccionario de datos.

    Estructura del diccionario de datos

Obtener archivo

  1. Cree dos XDP (fragmentos de diseño) en Designer: una tabla dinámica y una tabla estática. En ambos diseños:

    • Agregue un subformulario a la columna de la tabla. Asegúrese de cambiar el diseño del subformulario principal de la tabla a De posición variable y de quitar los enlaces del subformulario de la tabla.
    • Agregue un subformulario a la celda de la tabla. Asegúrese de cambiar el diseño del subformulario principal de la tabla a De posición variable y de quitar los enlaces del subformulario de la tabla.

    También puede utilizar los XDP estáticos y dinámicos adjuntos a este paso.

    Para obtener más información sobre cómo trabajar con fragmentos de diseño, consulte Fragmentos de diseños.

    Para obtener más información sobre la creación de diseños, consulte Ayuda de Designer.

Obtener archivo

Obtener archivo

  1. Cargue los XDP en AEM Forms.

  2. Cree un fragmento de diseño basado en el XDP dinámico. La pestaña Tabla de las propiedades muestra que la tabla es dinámica (campo Configuración para). El número de filas (1) y columnas (3) se deriva del fragmento de diseño o XDP.

    Los campos de este diseño se enlazan posteriormente al DD importado y, en la carta, el número de filas se crea dinámicamente en función del número de registros del archivo de datos de prueba (el archivo de datos XML adjunto al DD).

    Pantalla Creación de un fragmento de diseño
    Haga clic para ampliar

  3. Cree un fragmento de diseño basado en el XDP estático. La ficha Tabla de las propiedades muestra que la tabla es estática (campo Configuración para ). El número de filas (1) y columnas (3) se deriva del fragmento de diseño o XDP.

    Aquí puede cambiar el número de columnas y filas. Según lo que elija en esta pantalla, el número de filas y columnas de la tabla estática permanecerán fijos en la carta que se crea con este diseño.
    Pantalla Creación de un fragmento de diseño
    Haga clic para ampliar

  4. Cree una carta utilizando ambos fragmentos de diseño. Cuando inserte el XDP dinámico en la carta, establezca el enlace de sus campos en los elementos de colección del diccionario de datos.

    Para obtener más información sobre la creación de cartas y plantillas de carta, consulte Crear carta.

  5. Guarde la carta y previsualícela. Cuando se previsualiza la carta, los valores del diccionario de datos se muestran en ella. En el caso de la tabla dinámica, hay tres filas. Esto se debe a que los datos de prueba tienen tres registros en estas filas.

    En el caso de la tabla estática, hay tantas filas y columnas como haya especificado al crear el fragmento de diseño.

    Tabla estática en la carta

    En la tabla dinámica, las tres filas aparecen según el número de registros del archivo de datos de prueba. Esto ocurre porque, al agregar el diseño a la carta, se crea un enlace entre los campos de la tabla dinámica y los elementos de colección del diccionario de datos. Los valores Nombre, Dirección y Sexo se rellenan desde el archivo de datos de prueba utilizado.

    Tabla dinámica en la carta

Creación de una copia de un fragmento de documento create-a-copy-of-a-document-fragment

Para crear rápidamente un fragmento de documento con propiedades y contenido similares a los de un fragmento de documento existente, puede copiarlo y pegarlo.

  1. Seleccione uno o varios fragmentos en la lista de fragmentos de documento. La interfaz de usuario muestra el icono Copiar.
  2. Pulse Copiar. La interfaz de usuario muestra el icono Pegar. Si lo desea, también puede abrir una carpeta antes de pegar el fragmento. Las carpetas pueden contener recursos con los mismos nombres. Para obtener más información sobre las carpetas, consulte Carpetas y organización de recursos.
  3. Pulse Pegar. Aparecerá el cuadro de diálogo Pegar. Si está copiando y pegando los fragmentos del documento en el mismo sitio, el sistema asignará automáticamente nombres y títulos a las nuevas copias de las cartas, pero podrá editarlos.
  4. Si es necesario, edite el Título y el Nombre con los que desea guardar la copia del fragmento de documento.
  5. Pulse Pegar. Se crea la copia del fragmento del documento.
recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da