Inline-Bedingung und Wiederholung in der interaktiven Kommunikation und in Briefen

Inline-Bedingungen

AEM Forms ermöglicht es Ihnen, Inline-Bedingungen in Textmodulen zu verwenden, um das Rendern von Text zu automatisieren, der vom Kontext oder den Daten abhängt, die mit dem Fomulardatenmodell (in interaktiver Kommunikation) oder dem Datenwörterbuch verknüpft sind. Inline-Bedingung zeigt den spezifischen Inhalt an, der auf der Bedingungsbewertung basiert, die „true“ oder „false“ ist.

Bedingungen führen Berechnungen zu Datenwerten durch, die vom Datenmodell/Datenwörterbuch oder von Endbenutzern bereitgestellt werden. Wenn Sie Inline-Bedingungen verwenden, sparen Sie Zeit und verringern menschliches Versagen, während Sie hochgradige kontextabhängige und personalisierte interaktive Kommunikation/Briefe erstellen.

Weitere Informationen finden Sie unter:

Beispiel: Verwenden von Regeln, um Inline-Text in der interaktiven Kommunikation Bedingungen festzulegen

Um einen Satz, einen Absatz oder eine Textzeichenfolge in einer interaktiven Kommunikation mit Bedingungen zu versehen, können Sie im entsprechenden Textdokumentfragment eine Regel erstellen. Im folgenden Beispiel wird eine Regel verwendet, um eine gebührenfreie Nummer nur für die US-Empfänger der interaktiven Kommunikation anzuzeigen.

Weitere Informationen finden Sie unter „Regel im Text erstellen“ in Texte in interaktiven Kommunikationen.

Sobald Sie das Textfragment in eine interaktive Kommunikation eingefügt haben und der Agent die Benutzeroberfläche des Agenten verwendet, um eine interaktive Kommunikation vorzubereiten, werden die Daten des Formulardatenmodells für die Empfänger ausgewertet, und der Text wird nur für Empfänger in den USA angezeigt.

Beispiel: Wenn die Inline-Bedingung in einem Brief verwendet wird, um die entsprechende Adresse zu rendern

Sie können Inline-Bedingungen in einen Brief einfügen, indem Sie die Inline-Bedingung in das entsprechende Textmodul einzufügen. Im folgenden Beispiel werden zwei Bedingungen verwendet, um die entsprechende Anrede, Herr oder Frau, in einem Brief zu evaluieren, basierend auf dem DD-Element „Geschlecht“. Unter Verwendung ähnlicher Schritte können Sie andere Bedingungen erstellen.

HINWEIS

Wenn Ihre vorhandenen Assets alte Bedingungs-/Wiederholungsausdrücke einbeziehen (vor 6.2 SP1 CFP 4), zeigen die Assets die alte Syntax der Bedingung und Wiederholung an. Allerdings funktioniert die Bedingung oder Wiederholung. Die neuen und alten Bedingungs- oder Wiederholungsausdrücke sind miteinander kompatibel, um eine verschachtelte Mischung aus alten und neuen Bedingungs-/Wiederholungsausdrücken erstellen zu können.

  1. Wählen Sie im entsprechenden Textmodul den Textteil aus, für den Sie Bedingungen festlegen möchten, und tippen Sie auf Bedingung.

    1_selecttext

    Das Dialogfeld „Bedingung“ wird mit einer leeren Bedingung angezeigt.

    2_condition_dialog

    HINWEIS

    Leerer oder ungültiger Bedingungsausdruck kann nicht gespeichert werden. Damit der Ausdruck gespeichert werden kann, muss ${} einen gültigen Bedingungsausdruck enthalten.

  2. Führen Sie folgende Schritte aus, um eine Bedingung für die Bewertung zu konstruieren, ob ausgewählter Text oder Text, für den Bedingungen erstellt werden, im Brief angezeigt wird, und tippen Sie auf das Häkchen, um den Ausdruck zu speichern:

    Doppeltippen Sie auf ein DD-Element, um es in die Bedingung einzufügen. Fügen Sie den entsprechenden Operator ein und erstellen Sie die folgende Bedingung im Dialogfeld.

    ${DD_creditcard_Gender=="Male"}
    

    Weitere Informationen zum Erstellen eines Ausdrucks finden Sie unter Erstellen von Ausdrücken und Remote-Funktionen mit dem Ausdrucksgenerator im Ausdrucksgenerator. Der im Ausdruck angegebene Wert muss für das Element im Datenwörterbuch unterstützt werden. Weitere Informationen finden Sie unter Datenwörterbuch.

    Nachdem Sie die Bedingung eingefügt haben, können Sie den Mauszeiger über den Ziehgriff links neben der Bedingung bewegen, um die Bedingung anzuzeigen. Alternativ dazu können Sie auf den Ziehgriff tippen, um das Popupmenü der Bedingung anzuzeigen, die es Ihnen ermöglicht, die Bedingung zu bearbeiten oder zu entfernen.

    3_hoverhandle 4_editcondition_removeconditionpopup

  3. Fügen Sie ähnliche Bedingungen ein, indem Sie den Text Ma'am auswählen.

    ${DD_creditcard_Gender == "Female"}
    
  4. Zeigen Sie den relevanten Brief in der Vorschau an und Sie werden bemerken, dass der Text gemäß der Inline-Bedingung gerendert wurde. Sie können den Wert des DD-Elements „Geschlecht“ wie folgt eingeben:

    • Eine XML-Beispieldatendatei, die basierend auf dem relevanten Datenwörterbuch erstellt wurde, während der Brief mit Beispieldaten in der Vorschau angezeigt wird.
    • Eine XML-Datendatei, am relevanten Datenwörterbuch angehängt ist.

    Weitere Informationen finden Sie unter Datenwörterbuch.

    5_letteroutput

Wiederholen

Sie haben möglicherweise dynamische Daten in Ihren interaktiven Kommunikationen/Briefen, z. B. Transaktionen in einem Kreditkartenauszug, in der Instanz oder Vorkommen, die sich mit jedem erstellten Brief ändern können. Mit der Wiederholungsfunktion können Sie solche dynamische Daten in Ihrem Textdokumentenfragment formatieren und strukturieren.

Außerdem können Sie eine Regel/Bedingung innerhalb des Wiederholungskonstrukts angeben, um die Daten/Einträge mit einer Bedingung zu versehen, die in der interaktiven Kommunikation/im Brief gerendert werden.

Beispiel: Verwenden der Wiederholungsfunktion in einem Brief, um eine Liste von Kreditkartentransaktionen zu formatieren, strukturieren und anzuzeigen

Das folgende Beispiel zeigt die Schritte für die Verwendung der Wiederholungsfunktion, um die Kreditkartentransaktionen in einer interaktiven Kommunikation zu strukturieren und zu rendern.

  1. Fügen Sie in einem formulardatenmodellbasierten Textdokumentfragment die relevanten Formulardatenmodellobjekte (und eingebetteten Text, der für die Beschriftungen erforderlich ist, wie in diesem Beispiel gezeigt wird) ein:

    1_elementstext

    HINWEIS

    Der wiederholbare Inhalt muss mindestens eine Eigenschaft des Typs „Sammlung“ enthalten.

  2. Wählen Sie den Inhalt aus, auf den die Wiederholungsfunktion angewendet werden soll.

    2_selection

  3. Tippen Sie auf „Wiederholen“.

    Das Dialogfeld „Wiederholung“ wird angezeigt.

    3_repeatdialog

  4. Wählen Sie Zeilenumbruch als Trennzeichen und tippen Sie ggf. auf „Bedingung hinzufügen“, um eine Regel zu erstellen. Sie können auch Text als Trennzeichen verwenden und die Textzeichen angeben, die als Trennzeichen verwendet werden sollen.

    Das Dialogfeld „Regel erstellen“ wird angezeigt.

  5. Erstellen Sie eine Regel, um die Transaktionen anzuzeigen, die nach dem 28. Februar 2018 datiert sind, damit nur die Transaktionen für den Monat März in die interaktive Kommunikation einbezogen werden.

    HINWEIS

    In diesem Beispiel wird davon ausgegangen, dass der Agent die Anweisung Ende März 2018 erstellt. Andernfalls können Sie eine andere Regel erstellen, um Transaktionen vor dem 01.04.2018 einzubeziehen, um Transaktionen nach März 2018 auszuschließen.

    4_createrule

  6. Speichern Sie die Bedingung/Regel und dann die Wiederholung. Die bedingte Wiederholung wird auf den ausgewählten Inhalt angewendet.

    5_onmouseoverconditionrule

    Wenn Sie mit der Maus darüber fahren, zeigt das Textdokumentfragment die Bedingung und das Trennzeichen an, die bzw. das in der auf den Inhalt angewendeten Wiederholung verwendet wurde.

  7. Speichern Sie das Textdokumentfragment und zeigen Sie die relevante interaktive Kommunikation in der Vorschau an. Abhängig von den Daten im Formulardatenmodell werden die Transaktionsdetails durch die Wiederholung, die auf die Elemente angewendet wird, ähnlich wie in der folgenden Vorschau dargestellt:

    screen_shot_2018-03-09at155516copy

Beispiel: Verwenden der Wiederholen-Funktion in einem Brief, um eine Liste von Kreditkartentransaktionen zu formatieren, strukturieren und anzuzeigen

Das folgende Beispiel zeigt die Schritte für die Verwendung der Wiederholen-Funktion, um die Kreditkartentransaktionen in einem Brief zu strukturieren und zu rendern. Durch ähnliche Schritte können Sie die Wiederholen-Funktion in einem anderen Szenario verwenden.

  1. Öffnen Sie (bei der Bearbeitung oder Erstellung) ein Textmodul, das DD-Elemente enthält, die die Wiederholungs-/dynamischen Daten rendern und den erforderlichen Text und die DD-Elemente einbetten. Beispielsweise hat ein Textmodul die folgenden DD-Elemente, um eine Umsatzabrechnung auf einer Kreditkarte zu erstellen:

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

    Diese DD-Elemente rendern eine Liste der Transaktionen, die auf der Kreditkarte vorgenommen wurden, mit den folgenden Informationen:

    Transaktionsdatum, Transaktionsbetrag und Transaktionstyp (Debit oder Kredit)

  2. Betten Sie den Text innerhalb der DD-Elemente ein, um die Umsatzabrechnung lesbarer zu machen, wie folgt:

    1_repeat

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

    Das Rendern einer gut formatierten Umsatzabrechnung ist jedoch noch nicht abgeschlossen. Wenn Sie einen Brief rendern, basierend auf bereits ausgeführten Schritten, wird er wie folgt angezeigt:

    1_1renderwithoutrepeat

    Um den statischen Text zusammen mit den DD-Elementen zu wiederholen, müssen Sie die Wiederholen-Funktion anwenden, wie in den weiteren Schritten erläutert wird.

  3. Wählen Sie den statischen Text sowie die DD-Elemente, die Sie wiederholen möchten, wie unten gezeigt:

    2_repeat_selecttext

  4. Tippen Sie auf Wiederholen. Das Dialogfeld „Wiederholung“ wird mit einer leeren Inline-Bedingung angezeigt.

    3_repeat_dialog

  5. Falls erforderlich, fügen Sie eine Bedingung ein, um Transaktionen selektiv zu rendern, zum Beispiel um Transaktionsbeträge größer als 50 Cent zu rendern:

    ${DD_creditcard_TransactionAmount > 0.5}
    

    Andernfalls, wenn Sie die Informationen (hier Transaktionen) nicht selektiv rendern müssen, lassen Sie die Bedingung leer, indem Sie im Dialogfeld Folgendes löschen: ${}. Das Speichern eines Wiederholungsausdrucks wird aktiviert, wenn das Fenster für den Wiederholungsausdruck entweder leer ist (ohne ${}, wenn keine Wiederholung erforderlich ist) oder wenn es eine gültige Bedingung für die Wiederholung enthält.

  6. Wählen Sie ein Trennzeichen für die Formatierung von dynamischen Texten aus und tippen Sie auf das Häkchen, um die zu speichern:

    • Zeilenumbruch: Einfügen eines Zeilenumbruchs nach jedem Transaktionseintrag im Ausgabebrief.
    • Text: Fügt das angegebene Textzeichen nach jedem Transaktionseintrag in den Ausgabebrief ein.

    Nachdem Sie die Bedingung eingefügt haben, wird der Text mit Wiederholung rot hervorgehoben und ein Ziehgriff wird auf der linken Seite angezeigt. Sie können die Maus über dem Ziehgriff auf der linken Seite der Wiederholung bewegen, um das Wiederholungskonstrukt anzuzeigen.

    4_repeat_hoverdetail

    Sie können auf den Griff tippen, um das Popup-Menü der Wiederholung anzuzeigen, das es Ihnen ermöglicht, das Wiederholungskonstrukt zu bearbeiten oder zu entfernen.

    5_repeateditremove

  7. Zeigen Sie den relevanten Brief in der Vorschau an und Sie werden bemerken, dass der Text gemäß der Wiederholen-Funktion gerendert wird. Sie können den Wert der DD-Elemente mit Folgendem eingeben:

    • Eine XML-Beispieldatendatei, die basierend auf dem relevanten Datenwörterbuch erstellt wurde, während der Brief mit Beispieldaten in der Vorschau angezeigt wird
    • Eine XML-Datendatei, am relevanten Datenwörterbuch angehängt ist.

    Weitere Informationen finden Sie unter Datenwörterbuch.

    6_repeatoutputpreview

    Die statischen Textwiederholungen mit den Transaktionsdetails. Das Wiederholen von statischem Text wird durch die Wiederholung, die auf den Text in diesem Prozess angewendet wird, erleichtert. Die Bedingung ${DD_creditcard_TransactionAmount > 0.5} stellt sicher, dass die Transaktionen unter USD .5 nicht in dem Brief gerendert werden.

    HINWEIS

    Sie können die Bedingung und Wiederholung nur beim Erstellen oder Bearbeiten des relevanten Textmoduls einfügen. Beim Anzeigen des Briefs in der Vorschau können Sie keine Bedingung oder Wiederholung einfügen, obwohl Sie Bearbeitungen am Textmodul durchführen können.

Verwenden der Inline-Bedingung und Wiederholung - einige Anwendungsfälle

Wiederholen innerhalb der Bedingung

Sie müssen die Bedingung möglicherweise innerhalb einer Bedingung verwenden. Correspondence Management ermöglicht es Ihnen, die Wiederholung innerhalb eines Inline-Bedingungskonstruktes zu verwenden.

Zum Beispiel ist Folgendes eine Wiederholung (rot formatiert) innerhalb einer Bedingung (grün formatiert).

Während die Wiederholung die Kreditkartentransaktionen rendert, stellt die Bedingung ${DD_creditcard_nooftransactions > 0} sicher, dass das Wiederholungskonstukt nur dann gerendert wird, wenn es mindestens eine Transaktion gibt.

repeatwitincondition

Entsprechend Ihren Anforderungen können Sie auch Folgendes erstellen:

  • Eine oder mehrere Bedingungen innerhalb einer Bedingung
  • Eine oder mehrere Bedingungen innerhalb einer Wiederholung
  • Eine Kombination von Bedingungen und Wiederholungen innerhalb einer Bedingung oder Wiederholung

Leere Inline-Bedingung

Möglicherweise müssen Sie leere Inline-Bedingungen einfügen und Text und DD-Elemente später einbetten. Correspondence Management ermöglicht es Ihnen.

emptycondition

Es wird jedoch empfohlen, dass Sie, wenn möglich, den Text und die DD-Elemente zuerst in das Textmodul mit der beabsichtigten Formatierung einfügen, wie Aufzählungspunkte, und danach eine Inline-Bedingung anwenden.

Auf dieser Seite