Condición y repetición dentro de la línea en comunicaciones interactivas y cartas inline-condition-and-repeat-in-interactive-communications-and-letters

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.

Si usa condición dentro de la línea y repetir en comunicaciones interactivas y cartas, puede crear comunicaciones que sean muy contextuales y estén bien estructuradas.

Condiciones dentro de la línea inline-conditions

AEM Forms permite utilizar condiciones dentro de la línea en módulos de texto para automatizar la representación de texto que depende del contexto o los datos asociados con el modelo de datos de formulario (en comunicaciones interactivas) o el diccionario de datos (en cartas). La condición dentro de la línea muestra contenido específico en función de que la evaluación de la condición sea true o false.

Las condiciones realizan cálculos sobre los valores de datos proporcionados por el modelo de datos de formulario/el diccionario de datos o por los usuarios finales. Con las condiciones dentro de la línea, puede ahorrar tiempo y reducir los errores humanos, a la vez que crea comunicaciones interactivas/cartas muy contextuales y personalizadas.

Para obtener más información, consulte:

Ejemplo: Usar reglas para condicionar el texto dentro de la línea en comunicaciones interactivas example-using-rules-to-conditionalize-inline-text-in-interactive-communication

Para condicionar una frase, párrafo o cadena de texto en una comunicación interactiva, puede crear una regla en el fragmento de documento de texto correspondiente. El siguiente ejemplo utiliza una regla para mostrar un número gratuito solo a los destinatarios de EE. UU. de la comunicación interactiva.

Para obtener más información, consulte Crear regla en el texto en Textos en comunicaciones interactivas.

Una vez que se incluya el fragmento de texto en una comunicación interactiva y el agente utilice la interfaz de usuario de Agente para preparar una comunicación interactiva, los datos (modelo de datos de formulario) de los destinatarios se evaluarán y el texto solo se mostrará a los destinatarios en Estados Unidos.

Ejemplo: Usar una condición dentro de la línea en una carta para procesar la dirección adecuada example-using-inline-condition-in-a-letter-to-render-the-appropriate-address

Puede insertar una condición dentro de la línea en una carta si inserta la condición en el módulo de texto correspondiente. El siguiente ejemplo utiliza dos condiciones para evaluar y mostrar la dirección adecuada, Sr. o Sra., en una carta basada en el elemento DD Género. Con pasos similares, puede crear otras condiciones.

NOTE
Si los recursos existentes incluyen expresiones antiguas/repetidas (anteriores a la versión 6.2 SP1 CFP4), los recursos mostrarán la sintaxis antigua de condición y se repetirán. Sin embargo, la condición o repetición antigua funcionará. Las expresiones de condición/repetición nuevas y antiguas son compatibles entre sí para crear una mezcla anidada de expresiones de condición/repetición antiguas y nuevas.
  1. En el módulo de texto correspondiente, seleccione la parte del texto que desee condicionar y pulse Condición.

    1_selecttext

    El cuadro de diálogo Condición aparecerá con una condición vacía.

    2_conditiondialog

    note note
    NOTE
    No se puede guardar una expresión condicional vacía o no válida. Debe haber una expresión condicional válida dentro de ${} para guardar la expresión.
  2. Realice lo siguiente para construir una condición para evaluar si el texto seleccionado/condicional aparece en la carta y, a continuación, pulse la marca de verificación para guardar la expresión:

    Pulse dos veces un elemento DD para insertarlo en la condición. Inserte el operador adecuado y construya la siguiente condición en el cuadro de diálogo.

    code language-java
    ${DD_creditcard_Gender=="Male"}
    

    Para obtener más información sobre la creación de expresiones, consulte Crear expresiones y funciones remotas con el generador de expresiones en Generador de expresiones. El valor especificado en la expresión debe ser compatible con el elemento del diccionario de datos. Para obtener más información, consulte Diccionario de datos.

    Una vez insertada la condición, puede situarse sobre el controlador de la izquierda de la condición para ver la condición. Puede pulsar el controlador para ver el menú emergente de la condición, que le permite editarla o quitarla.

    3_hoverhandle 4_editconditionremoveconditionpopup

  3. Insertar condición similar al seleccionar el texto Ma'am.

    code language-java
    ${DD_creditcard_Gender == "Female"}
    
  4. Previsualice la carta correspondiente y observe que el texto se procesa según la condición dentro de la línea. Puede introducir el valor del elemento DD Género al utilizar:

    • Un archivo de datos XML de ejemplo creado en función del diccionario de datos pertinente mientras se previsualiza la carta con datos de ejemplo.
    • Un archivo de datos XML adjunto al diccionario de datos pertinente.

    Para obtener más información, consulte Diccionario de datos.

    5_letteroutput

Repetir repeat

Es posible que tenga información dinámica en la comunicación interactiva/carta, como transacciones en una instrucción de extracto de tarjeta de crédito, cuya instancia o incidencia puede cambiar con cada carta generada. Al utilizar Repetir, puede dar formato y estructurar esa información dinámica en el fragmento del documento de texto.

Además, puede especificar la regla/condición dentro de la construcción repetida para condicionar la información/entradas que se representan en la comunicación interactiva/carta.

Ejemplo: Usar Repetir en una comunicación interactiva para dar formato, estructurar y mostrar una lista de transacciones de tarjeta de crédito example-using-repeat-in-an-interactive-communication-to-format-structure-and-display-a-list-of-credit-card-transactions

El siguiente ejemplo le muestra los pasos para utilizar Repetir para estructurar y procesar las transacciones de tarjetas de crédito en una comunicación interactiva.

  1. En un fragmento de documento basado en modelos de datos de formulario, inserte los objetos correspondientes del modelo de datos de formulario (y el texto incrustado requerido para las etiquetas, como en este ejemplo):

    1_elementstext

    note note
    NOTE
    El contenido repetible debe incluir al menos una propiedad del tipo Colección.
  2. Seleccione el contenido en el que desea aplicar Repetir.

    2_selection

  3. Pulse Repetir.

    Aparecerá el cuadro de diálogo Repetir.

    3_repeatdialog

  4. Seleccione Salto de línea como separador y, si es necesario, pulse Agregar condición para crear una regla. También puede utilizar el texto como separador y especificar los caracteres de texto que se utilizarán como separadores.

    Aparecerá el cuadro de diálogo Crear regla.

  5. Cree una regla para mostrar las transacciones con fecha posterior al 28 de febrero de 2018 a fin de incluir las transacciones solo para el mes de marzo en la comunicación interactiva.

    note note
    NOTE
    En este ejemplo se supone que el agente creará la instrucción a finales de marzo de 2018. De lo contrario, puede crear otra regla para incluir las transacciones anteriores al uno de abril de 2018 para excluir las transacciones posteriores a marzo de 2018.

    4_createrule

  6. Guarde la condición/regla y, a continuación, guarde la repetición. La repetición condicional se aplicará al contenido seleccionado.

    5_onmouseoverconditionrule

    Al pasar el ratón por encima, el fragmento del documento de texto mostrará la condición y el separador utilizados en la repetición aplicada al contenido.

  7. Guarde el fragmento del documento de texto y previsualice la comunicación interactiva correspondiente. Según los datos del modelo de datos de formulario, la repetición aplicada a los elementos procesará los detalles de transacción de forma similar a los siguientes en la vista previa:

    screen_shot_2018-03-09at155516copy

Ejemplo: Usar Repetir en una carta para dar formato, estructurar y mostrar una lista de transacciones con tarjeta de crédito example-using-repeat-in-a-letter-to-format-structure-and-display-a-list-of-credit-card-transactions

En el siguiente ejemplo se proporcionan los pasos para utilizar Repetir para estructurar y procesar las transacciones de tarjetas de crédito en una carta. Con pasos similares, puede utilizar Repetir en un escenario diferente.

  1. Abra (mientras edita o crea) un módulo de texto que tenga elementos DD que procesen datos repetidos/dinámicos e incrusten el texto requerido alrededor de los elementos DD. Por ejemplo, un módulo de texto tiene los siguientes elementos DD para crear una instrucción de transacciones en una tarjeta de crédito:

    code language-none
    {^DD_creditcard_TransactionDate^} {^DD_creditcard_TransactionAmount^}
    {^DD_creditcard_TransactionType^}
    

    Estos elementos DD presentan una lista de las transacciones realizadas en la tarjeta de crédito con la siguiente información:

    Fecha de transacción, Cantidad de transacción y Tipo de transacción (débito o crédito)

  2. Incruste el texto dentro de los elementos DD para que la instrucción sea más legible, como por ejemplo:

    1_repeat

    code language-none
    Date: {^DD_creditcard_TransactionDate^} Amount (USD): {^DD_creditcard_TransactionAmount^} Transaction Type: {^DD_creditcard_TransactionType^}
    

    Sin embargo, el trabajo de procesar una instrucción con buen formato aún no ha finalizado. Si procesa una carta basada en el trabajo realizado hasta el momento, aparecerá de la siguiente manera:

    1_1renderwithoutrepeat

    Para repetir el texto estático junto con los elementos DD, debe aplicar Repetir como se explica en los pasos adicionales.

  3. Seleccione el texto estático así como los elementos DD que desee repetir, como se muestra a continuación:

    2_repeat_selecttext

  4. Pulse Repetir. El cuadro de diálogo Repetir aparecerá con una condición vacía dentro de la línea.

    3_repeat_dialog

  5. Si es necesario, inserte una condición para procesar selectivamente las transacciones, como para representar importes de transacciones superiores a 50 céntimos:

    code language-none
    ${DD_creditcard_TransactionAmount > 0.5}
    

    De lo contrario, si no necesita procesar la información (aquí transacciones) de forma selectiva, mantenga la condición vacía al eliminar lo siguiente en el cuadro de diálogo: ${}. Guardar una expresión repetida se habilita cuando la ventana de expresiones repetidas está vacía (sin ${} cuando no se necesita repetir) o cuando contiene una condición válida para repetir.

  6. Seleccione un separador para dar formato al texto dinámico y pulse la marca de verificación para guardar:

    • Salto de línea: inserta un salto de línea después de cada entrada de transacción en la carta de salida.
    • Texto: inserta el carácter de texto especificado después de cada entrada de transacción en la carta de salida.

    Una vez insertada la condición, el texto con repetición se resaltará en rojo y aparecerá un controlador a la izquierda. Puede situarse sobre el controlador de la izquierda de la repetición para ver la construcción de repetición.

    4_repeat_hoverdetail

    Puede pulsar el controlador para ver el menú emergente de la repetición, que le permite editar o quitar la construcción repetida.

    5_repeateditremove

  7. Previsualice la carta correspondiente y observe que el texto se represente de acuerdo con la repetición. Puede introducir el valor de los elementos DD mediante lo siguiente:

    • Un archivo de datos XML de ejemplo creado en función del diccionario de datos pertinente mientras se previsualiza la carta con datos de ejemplo.
    • Un archivo de datos XML adjunto al diccionario de datos pertinente.

    Para obtener más información, consulte Diccionario de datos.

    6_repeatoutputpreview

    El texto estático se repite con los detalles de la transacción. La repetición de texto estático se facilita con la repetición aplicada al texto en este procedimiento. La condición, ${DD_creditcard_TransactionAmount > 0,5}, garantiza que las transacciones por debajo de 0,5 dólares no se mostrarán en la carta.

    note note
    NOTE
    Puede insertar una condición y repetirla solo mientras crea o edita el módulo de texto correspondiente. Al previsualizar la carta, aunque puede realizar modificaciones en el módulo de texto, no puede insertar condiciones ni repetir.

Usar condición dentro de la línea y repetir: algunos casos de uso using-inline-condition-and-repeat-some-use-cases

Repetir dentro de una condición repeat-within-condition

Es posible que deba utilizar Repetir dentro de una condición. Administración de correspondencia le permite utilizar Repetir dentro de una construcción de condiciones dentro de la línea.

Por ejemplo, a continuación se repite (con formato rojo) dentro de una condición (con formato verde).

Mientras que la repetición procesa las transacciones de tarjetas de crédito, la condición ${DD_creditcard_nooftransactions > 0} garantiza que la construcción repetida se represente solo si hay al menos una transacción.

repeatwitincondition

Del mismo modo, según sus necesidades, puede crear lo siguiente:

  • Una o más condiciones dentro de una condición
  • Una o más condiciones dentro de una repetición
  • Una combinación de condiciones y repeticiones dentro de una condición o repetición

Una condición vacía dentro de la línea empty-inline-condition

Es posible que deba insertar condiciones vacías dentro de la línea e incrustar texto y elementos DD más adelante. Administración de correspondencia le permite hacer eso.

emptycondition

Pero se recomienda que, si es posible, inserte primero el texto y los elementos DD en el módulo de texto con el formato deseado, como las viñetas y que aplique después una condición dentro de la línea.

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da