DokumentationCampaignCampaign Web-Benutzeroberfläche

JavaScript-Code javascript-code

Last update: Tue Oct 08 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Die JavaScript-Code-Aktivität ist eine Daten-Management-Aktivität. Verwenden Sie diese Aktivität, um ein JavaScript-Skript im Kontext eines Workflows auszuführen. Auf diese Weise können Sie Informationen aus der Datenbank erfassen oder andere komplexe Vorgänge durchführen.

Konfigurieren der JavaScript-Code-Aktivität javascript-code-configuration

Führen Sie die folgenden Schritte aus, um die Aktivität JavaScript-Code zu konfigurieren:

  1. Fügen Sie eine Aktivität JavaScript-Code zu Ihrem Workflow hinzu.

  2. Legen Sie fest, welche Art von Aktivität erstellt werden soll:

    note note
    NOTE
    Bei der Campaign Web-Benutzeroberfläche haben wir zwei Aktivitäten zu einer zusammengefasst, indem wir die einfachen und erweiterten JavaScript-Code-Funktionen zusammengeführt haben. Diese Zusammenführung wirkt sich in keiner Weise auf die Funktionalität der Aktivität aus.

  3. Klicken Sie dann auf die Schaltfläche Code bearbeiten, um den Ausdruckseditor zu öffnen. Der linke Bereich enthält vordefinierte Syntaxen, die Sie zur Erstellung Ihres Codes verwenden können, einschließlich Ereignisvariablen. Informationen dazu, wie Sie mit Ereignisvariablen und dem Ausdruckseditor arbeiten.

  4. Konfigurieren Sie im Abschnitt Ausführung die Verzögerung so, dass die Aktivität nach einer bestimmten Ausführungsdauer beendet wird. Standardmäßig darf die Ausführungsphase nicht länger als eine Stunde dauern. Nach dieser Verzögerung wird der Vorgang mit einer Fehlermeldung abgebrochen und die Ausführung der Aktivität schlägt fehl. Um diese Begrenzung zu ignorieren, setzen Sie den Wert auf 0.

  5. Aktivieren Sie die Option Fehler verarbeiten, um während der Skriptausführung auftretende Fehler in einer zusätzlichen ausgehenden Transition zu belassen.

Erweiterte JavaScript-Code-Aktivitäten advanced

Mit erweiterten JavaScript-Aktivitäten können Sie komplexe Vorgänge ausführen. Sie haben folgende Möglichkeiten:

  • Ausführen von zwei verschiedenen Code-Snippets. Das erste Code-Snippet wird ausgeführt, wenn der Workflow zum ersten Mal gestartet wird. Jedes Mal, wenn der Workflow erneut ausgeführt wird, wird das im zweiten Aufruf definierte Code-Snippet ausgeführt.
  • Fügen Sie mehrere ausgehende Transitionen hinzu, mit denen Sie mithilfe eines Skripts dynamisch interagieren können.

Gehen Sie wie folgt vor, um eine erweiterte JavaScript-Code-Aktivität zu konfigurieren:

  1. Wählen Sie Erweitert aus und konfigurieren Sie dann die auszuführenden Code-Snippets:

    • Klicken Sie auf die Option Ersten Aufruf-Code bearbeiten, um das Skript zu definieren, das beim ersten Aufruf ausgeführt werden soll.
    • Klicken Sie auf die Option Nächsten Aufruf-Code bearbeiten, um das Skript zu definieren, das bei den nächsten Aufrufvorgängen des Workflows ausgeführt werden soll (optional).

  2. Um eine oder mehrere ausgehende Transitionen hinzuzufügen, klicken Sie auf die Schaltfläche Transitionen hinzufügen und geben Sie für jede Transition einen Titel und einen internen Namen an.

    In diesem Beispiel haben wir zwei Transitionen konfiguriert, die vom Skript im Code-Snippet basierend auf bestimmten Bedingungen aktiviert werden.

  3. Schließen Sie die Konfiguration der Aktivität ab und starten Sie den Workflow.

Beispiel javascript-code-example

Initialisieren von Variablen basierend auf der Eingangspopulation example1

Dieses Beispiel zeigt, wie eine Variable basierend auf der Anzahl der Profile initialisiert wird, auf die in einem Workflow abgezielt wird.

Die Zielgruppe im vorliegenden Beispiel sind VIP-Profile aus unserer Datenbank. Wir möchten die Variable „channel“ mit einem Wert erstellen, der von der Anzahl der Profile abhängt, auf die die Aktivität „Zielgruppe erstellen“ abzielt:

  • Werden mehr als 1000 Profile angesprochen, initialisieren Sie die Variable mit dem Wert „email“.
  • Initialisieren Sie die Variable anderenfalls mit dem Wert „sms“.

Gehen Sie dazu wie folgt vor:

  1. Fügen Sie eine JavaScript-Code-Aktivität vom Typ Einfach nach der Aktivität Zielgruppe erstellen hinzu.

  2. Klicken Sie auf Code bearbeiten und konfigurieren Sie das Code-Snippet wie folgt:

    code language-none 
    if (vars.recCount > 1000)
    vars.channel ="email"
else
    vars.channel = "sms"

  3. Starten Sie den Workflow. Die Variable „channel“ wird je nach Anzahl der Profile, auf die die Aktivität Zielgruppe erstellen abzielt, mit dem Wert „email“ oder „sms“ erstellt.

Auslösen von Transitionen basierend auf dem Wert einer Variablen example2

Dieses Beispiel zeigt, wie eine Transition basierend auf dem Wert einer Variablen ausgelöst wird.

Hier beginnt der Workflow mit einer Aktivität Externes Signal, in die eine Variable (interest) von einem anderen Workflow übergeben wird. Der Wert der Variablen ist je nach den im ersten Workflow durchgeführten Filtervorgängen entweder „running“ oder „yoga“.

Wir möchten verschiedene Transitionen im Workflow basierend auf dem Wert der Variablen auslösen.

Gehen Sie dazu wie folgt vor:

  1. Fügen Sie eine Aktivität JavaScript-Code nach der Aktivität „Externes Signal“ mit dem Typ Erweitert hinzu.

  2. Fügen Sie zwei Transitionen hinzu: eine für jeden möglichen Variablenwert („running“, „yoga“).

  3. Klicken Sie auf die Option zum Bearbeiten des ersten Aufruf-Codes und konfigurieren Sie das Code-Snippet wie folgt:

    code language-none 
    if (vars.interest=="running")
    task.postEvent(task.transitionByName("running"));
else
    task.postEvent(task.transitionByName("yoga"));

  4. Schließen Sie die Konfiguration jeder Transition entsprechend Ihren Anforderungen ab und starten Sie dann den Workflow. Es wird eine der beiden ausgehenden Transitionen je nach Wert der Variable interest aktiviert, die über die Aktivität Externes Signal übergeben wurde.

recommendation-more-help
c39c2d00-ba9a-424b-adf9-66af58a0c34b