Show Menu
TEMAS×

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

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 al modelo de datos de formulario (en Comunicación interactiva) o al 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 solo 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 Comunicaciones interactivas.
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 los 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.
Si los recursos existentes incluyen expresiones antiguas/repetidas (anteriores a 6.2 SP1 CFP 4), los recursos muestran una sintaxis antigua de condición y se repiten. Sin embargo, la condición o repetición anterior funciona. Las expresiones de condición/repetición nuevas y antiguas son compatibles entre sí para crear una combinación anidada de expresiones de condición/repetición antiguas y nuevas.
  1. En el módulo de texto relevante, seleccione la parte del texto que desea condicionalizar y toque Condición .
    El cuadro de diálogo Condición aparece con una condición vacía.
    No se puede guardar una expresión condicional vacía o no válida. Debe haber una expresión condicional válida en el interior ${} 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:
    Toque dos veces 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 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 situar el cursor sobre el controlador a la izquierda de la condición para ver la condición. Puede tocar el control para ver el menú emergente de la condición, que le permite editar o eliminar la condición.
  3. Inserte una condición similar seleccionando el texto Ma'am .
    ${DD_creditcard_Gender == "Female"}
    
    
  4. Obtenga una vista previa de la letra pertinente y observe que el texto se representa 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 .

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 del 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 transacciones de 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 basado en modelo de datos de formulario, inserte los objetos del modelo de datos de formulario relevantes (y el texto incrustado requerido para las etiquetas, como en este ejemplo):
    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.
  3. Toque Repetir.
    Aparecerá el cuadro de diálogo Repetir.
  4. Seleccione Salto de línea como separador y, si es necesario, toque 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.
    Aparece 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.
    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.
  6. Guarde la condición/regla y, a continuación, guarde la repetición. La repetición condicional se aplica al contenido seleccionado.
    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 del documento de texto y obtenga una vista previa 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 transacción de forma similar a la siguiente en la vista previa:

Ejemplo: Usar la opción de repetición en una carta para dar formato, estructurar y mostrar una lista de 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:
    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:
    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:
  4. Toque Repetir . El cuadro de diálogo Repetir aparece con una condición en línea vacía.
  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 ver la construcción repetida.
    Puede tocar el control para ver el menú emergente de la repetición, que le permite editar o eliminar la construcción repetida.
  7. Obtenga una vista previa de la letra pertinente y observe que el texto se representa de acuerdo con la 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 .
    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.
    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.
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.
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.