Komponente 'Gespeichertes Verfahren'
Ein gespeichertes Verfahren ist eine Subroutine, die für alle Anwendungen verfügbar ist, die auf ein relationales Datenbanksystem zugreifen. Typische Anwendungsfälle für gespeicherte Verfahren sind Datenprüfung und -speicherung sowie die Zentralisierung von Logik. Wenn Sie zur Datenverwaltung innerhalb einer Journey keine Lookup-Komponenten, Entscheidungskomponenten oder Datenkomponenten verwenden können, können Sie sich eines benutzerdefinierten gespeicherten Verfahrens bedienen.
Ein gespeichertes Verfahren kann nach Eingabewerten zur Berechnung fragen (Eingabeparameter) und die Ergebnisse der Berechnungen in Ausgabeparametern übermitteln. Werte können von der Journey zum gespeicherten Verfahren für die Eingabeparameter übermittelt werden. Und die Werte der Ausgabeparameter des gespeicherten Verfahrens können daraufhin für die Journey-Komponenten oder zur Anzeige auf einer darauffolgenden Seite verwendet werden. Genau wie gepostete Formularwerte sind die Ausgabewerte eines gespeicherten Verfahrens nur während einer Abfrage verfügbar, bis zur nächsten Seite. Nach dieser Seite gehen die Daten verloren.
Ein einfaches Beispiel stellt eine Umfrage dar. Ein Kontakt kann für seine Lieblingsfarbe abstimmen: Gelb, Grün, Blau oder Rot. Seine Abstimmung wird gespeichert und auf der nächsten Seite werden die Umfrageergebnisse angezeigt. Die Abstimmung eines Kontakts lässt sich einfach mithilfe einer Datenkomponente speichern. Die Umfrageergebnisse lassen sich jedoch nicht mit einer Standard-Komponente in der Journey berechnen. Wir müssen berechnen, wie viele Abstimmungen für jede der Umfrage-Optionen vorliegen, und diese mit der Gesamtzahl an Abstimmungen vergleichen.
Wir haben uns dazu entschlossen, auch die Werte des Kontakts zusammen mit dem gespeicherten Verfahren zu speichern und keine zusätzliche Datenkomponente vor der Komponente 'Gespeichertes Verfahren' zu verwenden. Dazu benötigt das gespeicherte Verfahren einige Werte: die ID des Kontakts, seine Abstimmung aus dem vorausgegangenen Formular sowie die Tabellen-ID der Tabelle zum Speichern der Abstimmung des Kontakts.
Nach der Berechnung übermittelt das gespeicherte Verfahren die gesamten Werte sowie den Wert für jede Umfrage-Option. Diese Werte sind auf der Ergebnisseite anzuzeigen. Wir können für die Werte in den Eigenschaften der Komponente 'Gespeichertes Verfahren' Namen festlegen, die auf der darauffolgenden Seite verwendet werden. So wird zum Beispiel der Wert @total auf der Ergebnisseite mit ~@total~ angezeigt (im Editor).
Ereignisse
Die Komponente liefert zwei Ereignisse:
- OnSuccess (wenn erfolgreich): Das Verfahren wurde erfolgreich ausgeführt.
- OnFailed (wenn fehlgeschlagen): Die Ausführung des Verfahrens ist fehlgeschlagen.
Eigenschaften
Allgemein
1. Geben Sie einen Namen und eine Beschreibung für die Komponente ein. Der Name wird auf der Arbeitsoberfläche der Journey angezeigt.
2. Wählen Sie den Namen des gespeicherten Verfahrens aus dem Auswahlmenü aus. Dieses Verfahren wird in der Selligent-Datenbank als 'Registriertes gespeichertes Verfahren' gespeichert.
3. Klicken Sie auf 'Laden'. Selligent erkennt die Eingabeparameter und Ausgabeparameter für dieses gespeicherte Verfahren automatisch.
4. Wenn das gespeicherte Verfahren Informationen im Kontaktprofil ändert, ist es erforderlich, diese Optionen auszuwählen, um das Kontaktprofil nach dem Ausführen dieses gespeicherten Verfahrens neu zu laden.
Eingabeparameter
Die Tabelle mit Eingabeparametern wird automatisch beim Laden des gespeicherten Verfahrens definiert.
Geben Sie die Werte ein, die den Parametern zugewiesen werden müssen.
Beispiel:
Mögliche Eingabeparameter sind:
* Ein geposteter Parameter aus einem Formular oder aus einer Input Komponente: @VALUE
* Ein Feld im Kontaktprofil, z. B. GENDER
* Ein Feld im erweiterten Profil, z. B. CONTEST1.ANSWER
* Ein Systemwert, z. B. SYSTEM.LISTID
* Ein String oder eine Zahl. Verwenden Sie einfache Anführungszeichen für die Strings, z. B. 'Spring 20'
* Selligent-Funktionen
Ausgabeparameter
Die Ausgabeparameter werden von Selligent Campaign automatisch beim Laden des gespeicherten Verfahrens erkannt. Im Parameter @return_value wird immer mindestens ein Parameter gespeichert. Dies ist ein numerischer Wert, der den Status des gespeicherten Verfahrens angibt.
Technischer Hinweis:
Um die Ausgabeparameter verwenden zu können, müssen in der rechten Spalte die Namen eingetragen werden, die Sie im nächsten Schritt in der Journey verwenden wollen.
Für den Parameter @VOUCHER_CODE können zum Beispiel @VOUCHER_CODE, @VOUCHERCODE, @VC oder ein beliebiger anderer Name eingegeben werden. Verwenden Sie im nächsten Schritt den ausgewählten Namen.
