Condición en línea y repetición en comunicaciones interactivas y letras

Con las condiciones en línea y la repetición en comunicaciones interactivas y letras, puede crear comunicaciones que sean muy contextuales y estén bien estructuradas.

Condiciones en línea

AEM Forms permite utilizar condiciones en 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 Comunicación interactiva) o el diccionario de datos (en letras). La condición en línea muestra contenido específico en función de que la evaluación de condiciones sea verdadera o falsa.

Las condiciones realizan cálculos en valores de datos proporcionados por el modelo de datos de formulario/el diccionario de datos o por usuarios finales. Con las condiciones en línea, puede ahorrar tiempo y reducir los errores humanos, al tiempo que crea comunicaciones/letras interactivas personalizadas y altamente contextuales.

Para obtener más información, consulte:

Ejemplo: Uso de reglas para condicionalizar el texto en línea en la comunicación interactiva

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

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

Una vez que se incluye el fragmento de texto en una comunicación interactiva y el agente utiliza la interfaz de usuario del agente para preparar una comunicación interactiva, se evalúan los datos (modelo de datos de formulario) de los destinatarios y el texto se muestra únicamente a los destinatarios de EE.UU.

Ejemplo: Utilizar una condición en línea en una carta para representar la dirección adecuada

Puede insertar una condición en línea en una letra insertando la condición en línea en el módulo de texto correspondiente. El siguiente ejemplo utiliza dos condiciones para evaluar y mostrar la dirección adecuada, Sir o Ma'am, en una carta basada en el elemento DD Sexo. Con pasos similares, puede crear otras condiciones.

Nota

Si los recursos existentes incluyen expresiones de estado o repetición antiguas (anteriores a 6.2 SP1 CFP 4), los recursos mostrarán una sintaxis antigua de condición y se repetirán. Sin embargo, la condición o repetición anterior funciona. Las expresiones de repetición/condición nuevas y antiguas son compatibles entre sí para crear una combinación anidada de expresiones de repetición/condición antiguas y nuevas.

  1. En el módulo de texto relevante, seleccione la parte del texto que desea condicionalizar y toque Condición.

    1_selecttext

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

    2_conditiondialog

    Nota

    No se puede guardar la expresión condicional vacía o no válida. Debe haber una expresión condicional válida dentro ${} para guardar la expresión.

  2. Para crear una condición para evaluar si el texto seleccionado/condicionalizado aparece en la letra y, a continuación, toque la marca de verificación para guardar la expresión, haga lo siguiente:

    Toque con el doble un elemento DD para insertarlo en la condición. Inserte el operador adecuado y cree la siguiente condición en el cuadro de diálogo.

    ${DD_creditcard_Gender=="Male"}

    Para obtener más información sobre la creación de la expresión, consulte Creación de expresiones y funciones remotas con el creador de expresiones en el Generador deExpresiones. 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 situar el cursor sobre el controlador situado a la izquierda de la condición para vista de la condición. Puede tocar el control para vista del menú emergente de la condición, que le permite editar o eliminar la condición.

    3_hoverhandle 4_editconditionremoveconditionpopup

  3. Inserte una condición similar seleccionando el texto Ma'am.

    ${DD_creditcard_Gender == "Female"}

  4. Previsualización la letra pertinente y observe que el texto se presenta según la condición en línea. Puede introducir el valor del elemento DD Sexo mediante:

    • Un archivo de datos XML de ejemplo creado en función del diccionario de datos relevante al obtener una vista previa de la carta con datos de ejemplo.
    • Un archivo de datos XML adjunto al diccionario de datos correspondiente.

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

    5_letteroutput

Repetir

Puede tener información dinámica en la comunicación/carta interactiva, como las transacciones en un extracto de tarjeta de crédito, cuya instancia o incidencia puede seguir cambiando con cada carta generada. Si utiliza la opción de repetición, puede dar formato y estructurar dicha información dinámica en el fragmento de documento de texto.

Además, puede especificar una regla o condición dentro de la construcción repetida para condicionalizar la información o las entradas que se procesan en la comunicación o letra interactiva.

Ejemplo: Uso de repetir en una comunicación interactiva para dar formato, estructurar y mostrar una lista de las transacciones con tarjeta de crédito

En el siguiente ejemplo se muestran los pasos para usar la opción de repetición para estructurar y procesar las transacciones de tarjetas de crédito en una comunicación interactiva.

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

    1_elementstext

    Nota

    El contenido repetible debe incluir al menos una propiedad del tipo Colección.

  2. Seleccione el contenido en el que desea aplicar la repetición.

    2_selección

  3. Toque Repetir.

    Aparecerá el cuadro de diálogo Repetir.

    3_repetidialog

  4. Seleccione Salto de línea como separador y, si es necesario, toque Añadir 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 que muestre las transacciones con fecha posterior al 28 de febrero de 2018 para incluir las transacciones solo para el mes de marzo en la Comunicación interactiva.

    Nota

    En este ejemplo se asume que el agente creará la sentencia a finales de marzo de 2018. De lo contrario, puede crear otra regla para incluir las transacciones anteriores al 2018-04-01 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 aplica al contenido seleccionado.

    5_onmouseoverconditionrule

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

  7. Guarde el fragmento de documento de texto y previsualización de la comunicación interactiva pertinente. Según los datos del modelo de datos de formulario, la repetición aplicada a los elementos procesa los detalles de la transacción de forma similar a la siguiente en la previsualización:

    screen_shot_2018-03-09at155516copy

Ejemplo: Usar la opción de repetición en una carta para dar formato, estructurar y mostrar una lista de las transacciones con tarjeta de crédito

En el siguiente ejemplo se proporcionan los pasos para utilizar la opción de repetición 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 incorporen el texto requerido alrededor de los elementos DD. Por ejemplo, un módulo de texto tiene los siguientes elementos DD para crear un estado de transacciones en una tarjeta de crédito:

    {^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, Importe 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 declaración sea más legible, como por ejemplo:

    1_repeat

    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 se ha realizado. Si procesa una carta basada en el trabajo realizado hasta ahora, aparece como sigue:

    1_1renderwithoutrepeat

    Para repetir el texto estático junto con los elementos DD, debe aplicar la repetición tal como se explica en los pasos posteriores.

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

    2_repeat_selecttext

  4. Toque Repetir. El cuadro de diálogo Repetir aparece con una condición en línea vacía.

    3_repeat_dialog

  5. Si es necesario, inserte una condición para que las transacciones se procesen de manera selectiva, como para que las cantidades de las transacciones superen los 50 centavos:

    ${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 eliminando lo siguiente del cuadro de diálogo: ${}. Guardar una expresión de repetición se activa cuando la ventana de expresión de repetición está vacía (sin ${} cuando no se necesita repetir) o cuando contiene una condición válida para la repetición.

  6. Seleccione un separador para dar formato al texto dinámico y toque 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 letra de salida.
    • Texto: Inserta el carácter de texto especificado después de cada entrada de transacción en la letra de salida.

    Una vez insertada la condición, el texto con repetición se resalta en rojo y aparece un indicador a la izquierda. Puede situar el ratón sobre el controlador de la izquierda de la repetición para aplicar la vista a la construcción repetida.

    4_repeat_hoverdetail

    Puede tocar el control para vista del menú emergente de la repetición, que le permite editar o eliminar la construcción repetida.

    5_reitereditremove

  7. Previsualización la letra pertinente y observe que el texto se presenta de acuerdo con una repetición. Puede introducir el valor de los elementos DD mediante:

    • Un archivo de datos XML de ejemplo creado en función del diccionario de datos relevante al obtener una vista previa de la carta con datos de ejemplo.
    • Un archivo de datos XML adjunto al diccionario de datos correspondiente.

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

    6_reiteroutputpreview

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

    Nota

    Puede insertar una condición y repetirla solo mientras crea o edita el módulo de texto relevante. Al obtener una vista previa de la carta, aunque puede realizar modificaciones en el módulo de texto, no puede insertar condición ni repetir.

Uso de condiciones en línea y repetición - algunos casos de uso

Repetir dentro de la condición

Es posible que deba utilizar la opción de repetición dentro de una condición. La Administración de correspondencia le permite utilizar la función de repetición dentro de una construcción de condiciones en línea.

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

Mientras que la repetición procesa las transacciones con tarjeta de crédito, la condición ${DD_creditcard_nooftransaction > 0} garantiza que la construcción repetida se procese solamente si hay al menos una transacción.

repewitincondition

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

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

Condición en línea vacía

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

emptycondition

Sin embargo, 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 aplique una condición en línea después.

En esta página