Im folgenden Anwendungsbeispiel wird gezeigt, wie Sie einen Workflow mit Parametern innerhalb Ihrer Workflows abrufen können.
Dabei soll ein Workflow durch einen API-Aufruf mit externen Parametern ausgelöst werden. Durch diesen Workflow werden aus einer Datei Daten in Ihre Datenbank geladen und eine entsprechende Audience erstellt. Nach der Erstellung der Audience wird ein zweiter Workflow ausgelöst, durch den eine Nachricht gesendet wird, die mit den externen, im API-Aufruf definierten Parametern personalisiert wurde.
Führen Sie dazu folgende Aktionen aus:
Vor dem Konfigurieren des Workflows müssen Workflow 1 und 2 jeweils mit der Aktivität Externes Signal erstellt werden. Auf diese Weise können Sie diese Signalaktivitäten auswählen, wenn Sie die Workflows aufrufen.
Führen Sie einen API-Aufruf aus, um Workflow 1 mit Parametern auszulösen. Weiterführende Informationen zur Syntax des API-Aufrufs finden Sie in der Dokumentation zu Campaign Standard-REST-APIs.
In diesem Beispiel soll der Workflow mit den unten stehenden Parametern aufgerufen werden:
-X POST https://mc.adobe.io/<ORGANIZATION>/campaign/<TRIGGER_URL>
-H 'Authorization: Bearer <ACCESS_TOKEN>'
-H 'Cache-Control: no-cache'
-H 'X-Api-Key: <API_KEY>'
-H 'Content-Type: application/json;charset=utf-8'
-H 'Content-Length:79'
-i
-d {
-d "source:":"API",
-d "parameters":{
-d "fileToTarget":"profile.txt",
-d "discountDesc":"Running shoes"
-d }
Workflow 1 wird folgendermaßen erstellt:
Führen Sie zur Konfiguration des Workflows die folgenden Schritte aus:
Deklarieren Sie die im API-Aufruf definierten Parameter. Öffnen Sie dazu die Aktivität Externes Signal und fügen Sie dann die Namen und Typen der Parameter hinzu.
Fügen Sie die Aktivität Dateiübertragung hinzu, um Daten in die Datenbank zu importieren. Ziehen Sie dazu die Aktivität in den Arbeitsbereich, öffnen Sie sie und wählen Sie den Tab Protokoll aus.
Wählen Sie die Option Dynamischen Dateipfad verwenden aus und verwenden Sie dann den Parameter fileToTarget als die zu übertragende Datei:
$(vars/@fileToTarget)
Laden Sie die Daten aus der Datei in die Datenbank.
Ziehen Sie dazu die Aktivität Datei laden in den Workflow und konfigurieren Sie sie nach Bedarf.
Fügen Sie Daten aus der importierten Datei in die Datenbank ein und aktualisieren Sie die Datenbank.
Ziehen Sie dazu die Aktivität Daten-Update in den Arbeitsbereich und wählen Sie den Tab Identifizierung aus, um ein Abstimmkriterium hinzuzufügen (in diesem Fall das Feld E-Mail).
Wählen Sie den Tab Zu aktualisierende Felder aus und spezifizieren Sie die in der Datenbank zu aktualisierenden Felder (in diesem Fall die Felder Vorname und E-Mail).
Überprüfen Sie, ob die Daten aus der Datei abgerufen wurden. Ziehen Sie dazu die Aktivität Test in den Workflow und wählen Sie die Schaltfläche Element hinzufügen aus, um eine Bedingung hinzuzufügen.
Benennen und definieren Sie die Bedingung. In diesem Fall soll getestet werden, ob die ausgehende Transition Daten mit der unten stehenden Syntax enthält.
$long(vars/@recCount)>0
Wenn Daten abgerufen werden, speichern Sie sie in einer Audience. Fügen Sie zu diesem Zweck die Aktivität Audience-Speicherung zur Transition Target not empty hinzu und öffnen Sie sie.
Wählen Sie die Option Dynamischen Titel verwenden aus und fügen Sie dann den Parameter fileToTarget als den Titel der Audience ein:
$(vars/@fileToTarget)
Ziehen Sie die Aktivität Ende in den Arbeitsbereich. Dadurch wird Workflow 2 mit Parametern aufgerufen. Öffnen Sie dann die Aktivität.
Wählen Sie den Tab Externes Signal aus und spezifizieren Sie den auszulösenden Workflow sowie die damit verknüpfte Signalaktivität.
Definieren Sie die in Workflow 2 zu verwendenden Parameter sowie deren Werte.
In diesem Fall sollen die Parameter übermittelt werden, die ursprünglich im API-Aufruf definiert wurden (fileToTarget und discountDesc), sowie der zusätzlichen Parameter segmentCode mit einem konstanten Wert ("20 % Rabatt").
Workflow 1 ist somit konfiguriert. Erstellen Sie jetzt Workflow 2. Weiterführende Informationen hierzu finden Sie in diesem Abschnitt.
Workflow 2 wird folgendermaßen erstellt:
Führen Sie zur Konfiguration des Workflows die folgenden Schritte aus:
Deklarieren Sie die in Workflow 1 definierten Parameter.
Öffnen Sie dazu die Aktivität Externes Signal, und fügen Sie dann den Namen und den Typ eines jeden Parameters hinzu, der in der Aktivität Ende von Workflow 1 definiert wurde.
Verwenden Sie die in Workflow 1 gespeicherte Audience. Platzieren Sie zu diesem Zweck die Aktivität Audience lesen in den Workflow und öffnen Sie sie.
Wählen Sie die Option Dynamische Audience verwenden aus und verwenden Sie den Parameter fileToTarget als den Namen der zu lesenden Audience:
$(vars/@fileToTarget)
Benennen Sie die ausgehende Transition entsprechend dem Parameter segmentCode.
Wählen Sie dazu den Tab Transition und danach die Option Dynamischen Segmentcode verwenden aus.
Verwenden Sie den Parameter segmentCode als den Namen der ausgehenden Transition:
$(vars/@segmentCode)
Platzieren Sie die Aktivität E-Mail-Versand in den Workflow, um eine Nachricht an die Audience zu senden.
Identifizieren Sie die in der Nachricht zu verwendenden Parameter, um sie mit dem Parameter discountDesc zu personalisieren. Öffnen Sie dazu die erweiterten Optionen der Aktivität und fügen Sie den Namen und den Wert des Parameters hinzu.
Sie können die Nachricht jetzt konfigurieren. Öffnen Sie die Aktivität und wählen Sie Wiederholende E-Mail aus.
Wählen Sie die zu verwendende Vorlage aus und definieren Sie die E-Mail-Eigenschaften entsprechend Ihren Anforderungen.
Verwenden Sie den Parameter discountDesc als ein Personalisierungsfeld. Wählen Sie das Feld dazu aus der Liste der Personalisierungsfelder aus.
Jetzt können Sie die Konfiguration der Nachricht abschließen und diese wie üblich versenden.
Nach dem Erstellen der Workflows können diese ausgeführt werden. Achten Sie darauf, dass die beiden Workflows gestartet werden, bevor der API-Aufruf ausgeführt wird.