Condição embutida e repetição em Comunicações interativas e letras

Usando a condição em linha e a repetição em Comunicações interativas e cartas, você pode criar comunicações que são altamente contextuais e bem estruturadas.

Condições em linha

O AEM Forms permite usar condições em linha em módulos de texto para automatizar a renderização do texto que depende do contexto ou dos dados associados ao modelo de dados de formulário (em Comunicação interativa) ou ao dicionário de dados (em letras). A condição em linha exibe o conteúdo específico com base na avaliação da condição ser verdadeiro ou falso.

As condições executam cálculos em valores de dados fornecidos pelo modelo de dados de formulário/Dicionário de dados ou pelos usuários finais. Usando condições em linha, você pode economizar tempo e reduzir erros humanos, enquanto cria comunicações/cartas altamente contextuais e personalizadas interativas.

Para obter mais informações, consulte:

Exemplo: Uso de regras para condicionar texto em linha na Comunicação Interativa

Para condicionalizar uma frase, parágrafo ou string de texto em uma Comunicação interativa, é possível criar uma regra no fragmento de documento de texto apropriado. O exemplo a seguir usa uma regra para exibir um número gratuito somente para os recipients dos EUA da Comunicação interativa.

Para obter mais informações, consulte Criar regra no texto em Textos em Comunicações interativas.

Depois de incluir o fragmento de texto em uma Comunicação interativa e o Agente usar a interface do usuário do agente para preparar uma Comunicação interativa, os dados (modelo de dados de formulário) para os recipients são avaliados e o texto é mostrado somente para os recipients nos EUA.

Exemplo: Uso da condição em linha em uma carta para renderizar o endereço apropriado

Você pode inserir uma condição em linha em uma carta inserindo a condição em linha no módulo de texto apropriado. O exemplo a seguir usa duas condições para avaliar e exibir o endereço apropriado, Senhor ou Senhora, em uma carta baseada no elemento DD Gênero. Usando etapas semelhantes, você pode criar outras condições.

OBSERVAÇÃO

Se os ativos existentes incluírem expressões de condição antiga/repetição (pré 6.2 SP1 CFP 4), os ativos exibirão a sintaxe antiga de condição e repetição. No entanto, a condição antiga/repetição funciona. As expressões condição nova e antiga/repetição são compatíveis entre si para criar uma combinação aninhada de expressões antigas e novas de condição/repetição.

  1. No módulo de texto relevante, selecione a parte de texto que deseja condicionar e toque em Condition.

    1_select_text

    A caixa de diálogo Condição é exibida com uma condição vazia.

    Caixa de diálogo 2_condições

    OBSERVAÇÃO

    Não é possível salvar uma expressão condicional vazia ou inválida. Tem de haver uma expressão condicional válida dentro de ${} para guardar a expressão.

  2. Faça o seguinte para criar uma condição para avaliar se o texto selecionado/condicionado aparece na letra e toque na marca de seleção para salvar a expressão:

    Toque duas vezes em um elemento DD para inseri-lo na condição. Insira o operador apropriado e construa a seguinte condição na caixa de diálogo.

    ${DD_creditcard_Gender=="Male"}
    

    Para obter mais informações sobre como criar a expressão, consulte Criação de expressões e funções remotas com o construtor de expressões em Construtor de expressões. O valor especificado na expressão deve ser suportado para o elemento no dicionário de dados. Para obter mais informações, consulte Dicionário de dados.

    Depois que a condição é inserida, você pode passar o mouse sobre a alça à esquerda da condição para visualizá-la. Toque na alça para exibir o menu pop-up da condição, que permite editar ou remover a condição.

    3_hoverhandle 4_editConditionremoveconditionpopup

  3. Insira uma condição semelhante selecionando o texto Ma'am.

    ${DD_creditcard_Gender == "Female"}
    
  4. Pré-visualize a letra relevante e observe que o texto é renderizado de acordo com a condição em linha. Você pode inserir o valor do elemento DD Gênero usando:

    • Um arquivo de dados XML de amostra criado com base no dicionário de dados relevante ao visualizar a carta com dados de amostra.
    • Um arquivo de dados XML anexado ao dicionário de dados relevante.

    Para obter mais informações, consulte Dicionário de dados.

    5_letteroutput

Repetir

Você pode ter informações dinâmicas em sua Comunicação/carta interativa, como transações em uma declaração de cartão de crédito, cuja instância ou ocorrência pode continuar mudando com cada carta gerada. Usando a repetição, você pode formatar e estruturar essas informações dinâmicas no fragmento do documento de texto.

Além disso, você pode especificar a regra/condição na construção de repetição para condicionar as informações/entradas renderizadas na Comunicação/letra interativa.

Exemplo: Usando a repetição em uma Comunicação Interativa para formatar, estruturar e exibir uma lista de transações de cartão de crédito

O exemplo a seguir fornece as etapas para usar repetição para estruturar e renderizar as transações de cartão de crédito em uma Comunicação Interativa.

  1. Em um fragmento de documento de texto baseado no modelo de dados de formulário, insira os objetos de modelo de dados de formulário relevantes (e o texto incorporado necessário para os rótulos, como neste exemplo):

    1_elementstext

    OBSERVAÇÃO

    O conteúdo repetível deve incluir pelo menos uma propriedade do tipo Collection.

  2. Selecione o conteúdo no qual aplicar repetição.

    2_selection

  3. Toque em Repetir.

    A caixa de diálogo Repetir é exibida.

    Caixa de diálogo 3_repetições

  4. Selecione Quebra de linha como separador e, se necessário, toque em Adicionar condição para criar uma regra. Também é possível usar o texto como separador e especificar os caracteres de texto a serem usados como separador.

    A caixa de diálogo Criar regra é exibida.

  5. Crie uma regra para exibir transações datadas de 28 de fevereiro de 2018 para incluir as transações somente para o mês de março na Comunicação interativa.

    OBSERVAÇÃO

    Este exemplo assume que o Agente criará a declaração no final de março de 2018. Caso contrário, você poderá criar outra regra para incluir transações antes de 2018-04-01 para excluir transações após março de 2018.

    4_createrule

  6. Salve a condição/regra e salve a repetição. A repetição condicional é aplicada ao conteúdo selecionado.

    5_onmouseoverConditionrule

    Ao passar o mouse sobre ele, o fragmento do documento de texto exibe a Condição e o separador usado na repetição aplicada ao conteúdo.

  7. Salve o fragmento do documento de texto e visualize a Comunicação interativa relevante. Dependendo dos dados no modelo de dados de formulário, a repetição aplicada nos elementos renderiza os detalhes da transação da seguinte maneira na visualização:

    screen_shot_2018-03-09at155516copy

Exemplo: Usar a repetição em uma carta para formatar, estruturar e exibir uma lista de transações de cartão de crédito

O exemplo a seguir fornece as etapas para usar a repetição para estruturar e renderizar as transações com cartão de crédito em uma carta. Usando etapas semelhantes, você pode usar a repetição em um cenário diferente.

  1. Abra (ao editar ou criar) um módulo de texto que tenha elementos de DD que renderizem dados repetidos/dinâmicos e incorporem o texto necessário ao redor dos elementos de DD. Por exemplo, um módulo de texto tem os seguintes elementos de DD para criar um demonstrativo de transações em um cartão de crédito:

    {^DD_creditcard_TransactionDate^} {^DD_creditcard_TransactionAmount^}
    {^DD_creditcard_TransactionType^} 
    

    Esses elementos de DD renderizam uma lista das transações feitas no cartão de crédito com as seguintes informações:

    Data da transação, Valor da transação e Tipo de transação (Débito ou Crédito)

  2. Incorpore o texto dentro dos elementos de DD para tornar a declaração mais legível, como a seguir:

    1_repetir

    Date: {^DD_creditcard_TransactionDate^} Amount (USD): {^DD_creditcard_TransactionAmount^} Transaction Type: {^DD_creditcard_TransactionType^} 
    

    O trabalho de renderização de uma declaração bem formatada, no entanto, ainda não foi feito. Se você renderizar uma carta com base no trabalho feito até o momento, ela aparecerá da seguinte maneira:

    1_1renderwithoutrepeat

    Para repetir o texto estático junto com os elementos DD, é necessário aplicar a repetição conforme explicado nas etapas adicionais.

  3. Selecione o texto estático, bem como os elementos de DD que deseja repetir, conforme mostrado abaixo:

    2_repeat_select

  4. Toque em Repetir. A caixa de diálogo Repetir é exibida com uma condição em linha vazia.

    3_Caixa_de_diálogo

  5. Se necessário, insira uma condição para renderizar seletivamente as transações, por exemplo, para renderizar valores de transação maiores que 50 centavos:

    ${DD_creditcard_TransactionAmount > 0.5}
    

    Caso contrário, se você não precisar renderizar as informações (aqui as transações) seletivamente, mantenha a condição vazia, excluindo o seguinte na caixa de diálogo: ${}. Salvar uma expressão de repetição é ativado quando a janela de expressão de repetição está vazia (sem ${} quando nenhuma repetição é necessária) ou quando contém uma condição válida para repetição.

  6. Selecione um separador para formatar o texto dinâmico e toque na marca de seleção para guardar:

    • Quebra de linha: Insere quebra de linha após cada entrada de transação na carta de saída.
    • Texto: Insere o caractere de texto especificado após cada entrada de transação na letra de saída.

    Depois que a condição é inserida, o texto com repetição é realçado em vermelho e uma alça é exibida à esquerda. Você pode passar o mouse sobre a alça à esquerda da repetição para exibir a construção repetida.

    4_repeat_hoverdetail

    Toque no identificador para exibir o menu pop-up da repetição, o que permite editar ou remover a construção repetida.

    5_repetieditremove

  7. Visualize a carta relevante e observe que o texto é renderizado de acordo com a repetição. Você pode inserir o valor de elementos DD usando:

    • Um arquivo de dados XML de amostra criado com base no dicionário de dados relevante ao visualizar a carta com dados de amostra.
    • Um arquivo de dados XML anexado ao dicionário de dados relevante.

    Para obter mais informações, consulte Dicionário de dados.

    6_repetioutputpreview

    O texto estático se repete com os detalhes da transação. O texto estático repetido é facilitado pela repetição aplicada ao texto no presente procedimento. A condição, ${DD_creditcard_TransactionAmount > 0.5}, garante que as transações abaixo de USD.5 não sejam renderizadas na carta.

    OBSERVAÇÃO

    Você pode inserir uma condição e repetir somente ao criar ou editar o módulo de texto relevante. Ao visualizar a carta, embora seja possível fazer edições no módulo de texto, não é possível inserir uma condição ou repetir.

Uso de condição em linha e repetição - alguns casos de uso

Repetir dentro da condição

Pode ser necessário usar a repetição em uma condição. O Gerenciamento de correspondência permite usar repetições em uma construção de condição em linha.

Por exemplo, a seguir é repetida (formatada em vermelho) em uma condição (formatada em verde).

Enquanto a repetição renderiza as transações do cartão de crédito, a condição ${DD_creditcard_nooftransactions > 0} garante que a construção repetida seja renderizada somente se houver pelo menos uma transação.

repetiwitincondition

Da mesma forma, de acordo com seu requisito, é possível criar:

  • Uma ou mais condições em uma condição
  • Uma ou mais condições em uma repetição
  • Uma combinação de condições e repetição de uma situação ou repetição

Condição em linha vazia

Talvez seja necessário inserir condições em linha vazias e incorporar texto e elementos DD posteriormente. O Gerenciamento de correspondência permite fazer isso.

emptycondition

No entanto, é recomendável que, se possível, você insira os elementos text e DD primeiro no módulo de texto com a formatação pretendida, como marcadores, e aplique uma condição em linha depois.

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now