Show Menu
TÓPICOS×

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

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 embutida exibe conteúdo específico com base na avaliação da condição sendo true ou false.
As condições executam cálculos nos valores de dados fornecidos pelo modelo de dados do formulário/Dicionário de dados ou pelos usuários finais. Usando condições em linha, você pode economizar tempo e reduzir erros humanos, ao mesmo tempo em que cria comunicações/letras interativas altamente contextuais e personalizadas.
Para obter mais informações, consulte:

Exemplo: Uso de regras para condicionar o texto em linha no Interative Communication

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 recipient dos EUA da Comunicação interativa.
Para obter mais informações, consulte Criar regra em texto em Textos em Comunicações Interativas.
Depois que você 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) dos recipient serão avaliados e o texto será mostrado somente para os recipient nos EUA.

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

É possível 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 com base no elemento DD Gênero. Usando etapas semelhantes, é possível criar outras condições.
Se os ativos existentes incluírem expressões de condição antiga/repetida (pré 6.2 SP1 CFP 4), os ativos exibirão a sintaxe antiga de condição e serão repetidos. No entanto, a condição antiga/repetição funciona. As expressões novas e antigas de condição/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 do texto que deseja condicionar e toque em Condição .
    A caixa de diálogo Condição é exibida com uma condição vazia.
    Não é possível salvar expressões condicionais vazias ou inválidas. Tem de haver uma expressão condicional válida dentro ${} para salvar a expressão.
  2. Faça o seguinte para criar uma condição para avaliar se o texto selecionado/condicionado aparece na carta e, em seguida, toque na marca de seleção para salvar a expressão:
    Toque no Duplo 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 Criar expressões e funções remotas com o expressão Builder no Expressão Builder . 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 visualização a condição. Você pode tocar na alça para visualização no menu pop-up da condição, que permite editar ou remover a condição.
  3. Insira uma condição semelhante selecionando o texto Ma'am .
    ${DD_creditcard_Gender == "Female"}
    
    
  4. Pré-visualização 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.

Repetir

Você pode ter informações dinâmicas em sua Comunicação/carta interativa, como transações em um demonstrativo de cartão de crédito, cuja instância ou ocorrência pode continuar alterando com cada carta gerada. Usando repetir, é possível formatar e estruturar essas informações dinâmicas no fragmento do documento de texto.
Além disso, você pode especificar a regra/condição dentro da construção repetida para condicionar as informações/entradas renderizadas na Comunicação interativa/letra.

Exemplo: Uso de 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 repetir 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 em modelo de dados de formulário, insira os objetos relevantes do modelo de dados de formulário (e o texto incorporado necessário para os rótulos, como neste exemplo):
    O conteúdo repetível deve incluir pelo menos uma propriedade do tipo Coleção.
  2. Selecione o conteúdo no qual aplicar repetição.
  3. Toque em Repetir.
    A caixa de diálogo Repetir é exibida.
  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.
    Este exemplo supõe 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.
  6. Salve a condição/regra e salve a repetição. A repetição condicional é aplicada ao conteúdo selecionado.
    Ao passar o mouse, 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 pré-visualização 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 forma na pré-visualização:

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 repetir para estruturar e renderizar as transações de cartão de crédito em uma carta. Usando etapas semelhantes, você pode usar repetir em um cenário diferente.
  1. Abra (ao editar ou criar) um módulo de texto que tenha elementos DD que renderizam dados repetidos/dinâmicos e incorporem o texto necessário ao redor dos elementos DD. Por exemplo, um módulo de texto tem os seguintes elementos DD para criar uma declaração de transações em um cartão de crédito:
    {^DD_creditcard_TransactionDate^} {^DD_creditcard_TransactionAmount^}
    {^DD_creditcard_TransactionType^}
    
    
    Estes elementos de DD renderizam uma lista das transações efetuadas no cartão de crédito com as seguintes informações:
    Data da transação, Quantia da transação e Tipo de transação (Débito ou Crédito)
  2. Incorpore o texto aos elementos DD para tornar a declaração mais legível, como a seguir:
    Date: {^DD_creditcard_TransactionDate^} Amount (USD): {^DD_creditcard_TransactionAmount^} Transaction Type: {^DD_creditcard_TransactionType^}
    
    
    No entanto, o trabalho de renderização de uma declaração bem formatada ainda não foi feito. Se você renderizar uma carta com base no trabalho feito até o momento, ela será exibida como a seguir:
    Para repetir o texto estático junto com os elementos DD, é necessário aplicar a repetição conforme explicado nas etapas seguintes.
  3. Selecione o texto estático e os elementos de DD que deseja repetir, conforme mostrado abaixo:
  4. Toque em Repetir . A caixa de diálogo Repetir é exibida com uma condição em linha vazia.
  5. Se necessário, insira uma condição para renderizar seletivamente as transações, como para renderizar quantias 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 repetida é ativado quando a janela de expressão repetida 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 salvar:
    • 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 visualização da construção repetida.
    Você pode tocar na alça para visualização no menu pop-up da repetição, o que permite que você edite ou remova a construção repetida.
  7. Pré-visualização a carta relevante e observe que o texto é renderizado de acordo com a repetição. Você pode inserir o valor dos 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.
    O texto estático se repete com os detalhes da transação. A repetição do texto estático é facilitada pela repetição aplicada ao texto neste procedimento. A condição, ${DD_creditcard_TransactionAmount > 0.5}, garante que as transações abaixo de USD.5 não sejam renderizadas na carta.
    Você pode inserir a 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 a 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 repetir o uso em uma condição. O Gerenciamento de correspondência permite usar a repetição 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 de 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.
Da mesma forma, de acordo com seu requisito, você pode 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 dentro de uma condiçã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.
No entanto, é recomendável que, se possível, você insira os elementos de texto e DD primeiro no módulo de texto com a formatação pretendida, como marcadores, e aplique uma condição em linha depois disso.