Condizione in linea e ripetizione in Comunicazioni interattive e lettere

Utilizzando le condizioni in linea e ripetendo in comunicazioni interattive e lettere, potete creare comunicazioni altamente contestuali e ben strutturate.

Condizioni in linea

AEM Forms consente di utilizzare le condizioni in linea nei moduli di testo per automatizzare il rendering del testo che dipende dal contesto o dai dati associati al modello dati del modulo (in Comunicazione interattiva) o al dizionario dati (in lettere). La condizione in linea visualizza contenuto specifico in base alla valutazione della condizione che sia vera o falsa.

Le condizioni eseguono calcoli sui valori dei dati forniti dal modello dati/Dizionario dati del modulo o dagli utenti finali. Utilizzando le condizioni in linea, potete risparmiare tempo e ridurre gli errori umani, creando al contempo lettere e comunicazioni interattive altamente contestuali e personalizzate.

Per ulteriori informazioni, vedere:

Esempio: Utilizzo di regole per la condizionale del testo in linea nella comunicazione interattiva

Per condizionalizzare una frase, un paragrafo o una stringa di testo in una comunicazione interattiva, è possibile creare una regola nel frammento di documento di testo appropriato. Nell'esempio seguente viene utilizzata una regola per visualizzare un numero verde solo per i destinatari statunitensi della comunicazione interattiva.

Per ulteriori informazioni, vedi Creare una regola nel testo in Testi in Comunicazioni interattive.

Dopo aver incluso il frammento di testo in una comunicazione interattiva e l'agente utilizza l'interfaccia utente agente per preparare una comunicazione interattiva, i dati (modello dati modulo) per i destinatari vengono valutati e il testo viene mostrato solo ai destinatari negli Stati Uniti.

Esempio: Utilizzo della condizione in linea in una lettera per eseguire il rendering dell'indirizzo appropriato

È possibile inserire una condizione in linea in una lettera inserendo la condizione in linea nel modulo di testo appropriato. L'esempio seguente utilizza due condizioni per valutare e visualizzare l'indirizzo appropriato, Signore o Signora, in una lettera basata sull'elemento DD Genere. Con passaggi simili, potete creare altre condizioni.

NOTA

Se le risorse esistenti includono espressioni di condizione/ripetizione precedenti alla 6.2 SP1 CFP 4, le risorse visualizzeranno una vecchia sintassi di condizione e si ripeteranno. Tuttavia, la vecchia condizione/ripetizione funziona. Le espressioni nuove e vecchie di condizione/ripetizione sono compatibili tra loro per creare un mix nidificato di espressioni vecchie e nuove di condizione/ripetizione.

  1. Nel modulo di testo pertinente, selezionare la parte di testo da condizionare e toccare Condition.

    1_selectText

    La finestra di dialogo Condizione viene visualizzata con una condizione vuota.

    2_conditionDialog

    NOTA

    Impossibile salvare un'espressione condizionale vuota o non valida. Per salvare l'espressione, è necessario che all'interno di ${} sia presente un'espressione condizionale valida.

  2. Effettuate le seguenti operazioni per creare una condizione per valutare se il testo selezionato/condizionalizzato sia visualizzato nella lettera, quindi toccate il segno di spunta per salvare l'espressione:

    Toccate due volte un elemento DD per inserirlo nella condizione. Inserire l'operatore appropriato e creare la seguente condizione nella finestra di dialogo.

    ${DD_creditcard_Gender=="Male"}
    

    Per ulteriori informazioni sulla creazione dell'espressione, vedere Creazione di espressioni e funzioni remote con il generatore di espressioni in Generatore di espressioni. Il valore specificato nell'espressione deve essere supportato per l'elemento nel dizionario dati. Per ulteriori informazioni, vedere Dizionario dati.

    Una volta inserita la condizione, è possibile passare il mouse sulla maniglia a sinistra della condizione per visualizzare la condizione. Toccate la maniglia per visualizzare il menu a comparsa della condizione, che consente di modificare o rimuovere la condizione.

    3_hoverhandle 4_editionaseconditionpopup

  3. Inserire una condizione simile selezionando il testo Ma'am.

    ${DD_creditcard_Gender == "Female"}
    
  4. Visualizzate l'anteprima della lettera e notate che il testo viene rappresentato in base alla condizione in linea. Puoi inserire il valore dell'elemento DD Genere utilizzando:

    • Un file di dati XML di esempio creato in base al dizionario dati pertinente durante la visualizzazione in anteprima della lettera con dati di esempio.
    • Un file di dati XML allegato al dizionario dati pertinente.

    Per ulteriori informazioni, vedere Dizionario dati.

    5_letteroutput

Ripeti

È possibile che l'utente disponga di informazioni dinamiche nella comunicazione/lettera interattiva, come le transazioni in un rendiconto della carta di credito, la cui istanza o occorrenza può continuare a cambiare con ogni lettera generata. La ripetizione consente di formattare e strutturare tali informazioni dinamiche nel frammento di documento di testo.

Inoltre, è possibile specificare regola/condizione all'interno del costrutto di ripetizione per condizionalizzare le informazioni/voci di cui viene eseguito il rendering nella comunicazione interattiva/lettera.

Esempio: Utilizzo della ripetizione in una comunicazione interattiva per formattare, strutturare e visualizzare un elenco delle transazioni con carta di credito

L'esempio seguente illustra i passaggi per utilizzare la ripetizione per strutturare ed eseguire il rendering delle transazioni con carta di credito in una comunicazione interattiva.

  1. In un frammento di documento di testo basato su modello di dati modulo, inserire gli oggetti del modello di dati del modulo pertinenti (e il testo incorporato richiesto per le etichette, come in questo esempio):

    1_elementstext

    NOTA

    Il contenuto ripetibile deve includere almeno una proprietà del tipo Collection.

  2. Selezionare il contenuto sul quale applicare la ripetizione.

    2_selection

  3. Toccate Ripeti.

    Viene visualizzata la finestra di dialogo Ripeti.

    3_repeat, finestra di dialogo

  4. Selezionare Interruzione di riga come separatore e, se necessario, toccare Aggiungi condizione per creare una regola. È inoltre possibile utilizzare il testo come separatore e specificare i caratteri di testo da utilizzare come separatore.

    Viene visualizzata la finestra di dialogo Crea regola.

  5. Crea una regola per visualizzare le transazioni con data successiva al 28 febbraio 2018 per includere le transazioni solo per il mese di marzo nella comunicazione interattiva.

    NOTA

    Nell'esempio si presuppone che l'agente creerà l'istruzione alla fine di marzo 2018. In caso contrario, è possibile creare un'altra regola per includere le transazioni prima del 2018-04-01 per escludere le transazioni dopo marzo 2018.

    4_createrule

  6. Salvare la condizione/regola, quindi salvare la ripetizione. Al contenuto selezionato viene applicata la ripetizione condizionale.

    5_onmouseovercondid, regola

    Quando si passa il mouse sul frammento del documento di testo, vengono visualizzati la condizione e il separatore utilizzati per la ripetizione applicata al contenuto.

  7. Salvare il frammento del documento di testo e visualizzare in anteprima la comunicazione interattiva pertinente. A seconda dei dati nel modello dati del modulo, la ripetizione applicata agli elementi rende i dettagli della transazione simili a quelli riportati di seguito nell'anteprima:

    screen_shot_2018-03-09at155516copy

Esempio: Utilizzo della ripetizione in una lettera per formattare, strutturare e visualizzare un elenco delle transazioni con carta di credito

L'esempio seguente illustra i passaggi per utilizzare la ripetizione per strutturare ed eseguire il rendering delle transazioni con carta di credito in una lettera. Con passaggi simili, è possibile utilizzare la ripetizione in uno scenario diverso.

  1. Aprite (durante la modifica o la creazione) un modulo di testo con elementi DD che eseguono il rendering di dati ripetuti/dinamici e incorporano il testo richiesto intorno agli elementi DD. Ad esempio, un modulo di testo ha i seguenti elementi DD per creare un rendiconto delle transazioni su una carta di credito:

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

    Questi elementi DD forniscono un elenco delle transazioni effettuate sulla carta di credito con le seguenti informazioni:

    Data transazione, importo transazione e tipo di transazione (debito o credito)

  2. Incorporare il testo all'interno degli elementi DD per rendere l'istruzione più leggibile, ad esempio:

    1_repeat

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

    Il processo di rendering di un'istruzione in formato corretto, tuttavia, non è ancora stato eseguito. Se esegui il rendering di una lettera in base al lavoro svolto finora, viene visualizzata come segue:

    1_1rendersenza ripetizione

    Per ripetere il testo statico insieme agli elementi DD, è necessario applicare la ripetizione come spiegato nei passaggi successivi.

  3. Selezionate il testo statico e gli elementi DD da ripetere, come illustrato di seguito:

    2_repeat_selectext

  4. Toccate Repeat. Viene visualizzata la finestra di dialogo Ripeti con una condizione in linea vuota.

    3_repeat_dialog

  5. Se necessario, inserire una condizione per eseguire selettivamente il rendering delle transazioni, ad esempio per rendere gli importi delle transazioni superiori a 50 centesimi:

    ${DD_creditcard_TransactionAmount > 0.5}
    

    In caso contrario, se non è necessario eseguire il rendering selettivo delle informazioni (qui transazioni), mantenere vuota la condizione eliminando quanto segue nella finestra di dialogo: ${}. Il salvataggio di un'espressione di ripetizione viene attivato quando la finestra dell'espressione di ripetizione è vuota (senza ${} quando non è necessaria alcuna ripetizione) o quando contiene una condizione valida per la ripetizione.

  6. Selezionate un separatore per formattare il testo dinamico e toccate il segno di spunta da salvare:

    • Interruzione riga: Inserisce un'interruzione di riga dopo ogni voce di transazione nella lettera di output.
    • Testo: Inserisce il carattere di testo specificato dopo ogni voce di transazione nella lettera di output.

    Una volta inserita la condizione, il testo con ripetizione viene evidenziato in rosso e una maniglia viene visualizzata a sinistra. Per visualizzare il costrutto di ripetizione, posizionate il puntatore del mouse sulla maniglia a sinistra della ripetizione.

    4_repeat_hoverdetail

    Toccate la maniglia per visualizzare il menu a comparsa della ripetizione, che consente di modificare o rimuovere il costrutto di ripetizione.

    5_ripeteditremove

  7. Visualizzate l’anteprima della lettera e notate che il testo viene riprodotto in base alla ripetizione. È possibile inserire il valore degli elementi DD utilizzando:

    • Un file di dati XML di esempio creato in base al dizionario dati pertinente durante la visualizzazione in anteprima della lettera con dati di esempio.
    • Un file di dati XML allegato al dizionario dati pertinente.

    Per ulteriori informazioni, vedere Dizionario dati.

    6_ripetoutputpreview

    Il testo statico si ripete con i dettagli della transazione. Il testo statico ripetuto è facilitato dalla ripetizione applicata al testo in questa procedura. La condizione, ${DD_creditcard_TransactionAmount > 0.5}, assicura che il rendering delle transazioni sotto USD .5 non venga eseguito nella lettera.

    NOTA

    È possibile inserire una condizione e ripeterla solo durante la creazione o la modifica del modulo di testo pertinente. Durante l'anteprima della lettera, anche se è possibile apportare modifiche al modulo di testo, non è possibile inserire condizioni o ripetere.

Utilizzo di condizioni in linea e ripetizione - alcuni casi d'uso

Ripeti nella condizione

Potrebbe essere necessario utilizzare la ripetizione in una condizione. Gestione corrispondenza consente di utilizzare la ripetizione all'interno di un costrutto di condizione in linea.

Ad esempio, quanto segue viene ripetuto (formattato in rosso) all'interno di una condizione (formattato in verde).

Mentre la ripetizione esegue il rendering delle transazioni con carta di credito, la condizione ${DD_creditcard_nooftransaction > 0} garantisce che il costrutto di ripetizione venga rappresentato solo se è presente almeno una transazione.

ripetwitincondition

Analogamente, in base alle vostre esigenze, potete creare:

  • Una o più condizioni in una condizione
  • Una o più condizioni in una ripetizione
  • Una combinazione di condizioni e ripetersi in una condizione o ripetere

Condizione inline vuota

Potrebbe essere necessario inserire condizioni in linea vuote e incorporare testo ed elementi DD in un secondo momento. Gestione della corrispondenza consente di farlo.

emptycondition

Tuttavia, si consiglia di inserire il testo e gli elementi DD prima nel modulo di testo con la formattazione prevista, come ad esempio gli elenchi puntati, e di applicare successivamente una condizione in linea.

In questa pagina