ASSIGN-Befehl

Erstellt eine Variable und weist ihr einen Wert zu.

Syntax

ASSIGN Variablenname = Wert <IF Test>

Hinweis

Eine explizite Angabe des ASSIGN-Schlüsselworts wird empfohlen, weil Skripts dadurch einfacher zu lesen und zu verstehen sind. Sie können aber auch auf ASSIGN verzichten und einfach die folgende Syntax verwenden:

Variablenname = Wert

Parameter

Name Beschreibung
Variablenname

Der Name der Variablen, welcher der Wert zugewiesen werden soll. Wenn die Variable noch nicht vorhanden ist, wird diese erstellt. Wenn die Variable bereits vorhanden ist, wird sie mit dem neuen Wert aktualisiert.

In den Variablennamen für den Variablenersatz dürfen keine Zeichen verwendet werden, die nicht im englischen Alphabet vorkommen, wie beispielsweise é. Variablennamen, die solche Zeichen enthalten, lassen den Variablenersatz scheitern.

Hinweis

Variablennamen sind auf 31 alphanumerische Zeichen beschränkt. Der Name kann den Unterstrich beinhalten ( _ ), aber keine anderen Sonderzeichen oder Leerzeichen. Er kann nicht mit einer Ziffer beginnen.

Wert

Der Wert, welcher der Variablen zuzuweisen ist. Beim Erstellen einer neuen Variable beruht der Variablentyp auf dem Datentyp von Wert.

IF Test

Optional

Ein bedingter Ausdruck, der wahr sein muss, um die Variable zu erstellen oder den Wert der Variablen zuzuweisen.

Beispiele

Einer Variablen einen Wert zuweisen

Sie weisen den Wert des Felds Betrag im aktuellen Datensatz der Variablen v_aktueller_Betrag zu:

ASSIGN v_aktueller_Betrag = Betrag

Bedingtes Zuweisen eines Werts zu einer Variable

Sie möchten den Wert einer Variable namens v_Menge auf 1 aktualisieren, aber nur wenn der Wert einer anderen Variable namens v_Zähler unter 10 liegt.

Wenn v_Zähler größer oder gleich 10 ist, wird keine Zuweisung vorgenommen und der Wert von v_Menge bleibt unverändert.

Beachten Sie, dass das optionale Schlüsselwort ASSIGN ausgelassen wird:

v_Menge = 1 IF v_Zähler < 10

Bemerkungen

Detaillierte Informationen über den Einsatz von Variablen finden Sie unter Mit Variablen in ACLScript arbeiten.

Geltungsdauer von Variablen

Die Variablen bleiben lediglich für die Dauer der aktuellen Analytics-Sitzung in Kraft. Wenn Sie ein Analytics-Projekt schließen, werden normalerweise alle Variablen des Projekts automatisch gelöscht.

Wenn Sie möchten, dass eine Variable permanent mit einem Analytics-Projekt gespeichert wird, stellen Sie dem Variablennamen einen Unterstrich voraus:

ASSIGN Variablenname = Wert

Variablen neu zuweisen, die in einem Kalkulationsfeld oder einer GROUP verwendet werden

Wenn Sie einer bestehenden Variable in den folgenden Situationen einen Wert zuweisen, wird der neue Wert zwar zugewiesen, die Länge und die Anzahl der Dezimalstellen des vorigen Werts bleiben aber erhalten:

  • in Kalkulationsfeldern verwendete Variablen
  • in einer GROUP erneut zugewiesene Variablen

Die Länge des neuen Werts wird aufgefüllt oder gekürzt, und die Dezimalstellen werden gegebenenfalls angepasst.

Wenn Sie eine Variable in einem anderen Kontext neu zuweisen, werden der vorherige Wert ebenso wie die Länge und die Anzahl der Dezimalstellen überschrieben.

Durch Analytics-Befehle erstellte Variablen

Wenn Sie bestimmte Befehle ausführen, entweder durch Eingabe der Informationen in Dialogfeldern in Analytics oder durch die Ausführung von Skripts, werden automatisch Systemvariablen durch Analytics erstellt. Sie können diese Variablen und die darin enthaltenen Werte bei der Verarbeitung folgender Analytics-Befehle verwenden.

Wenn Sie denselben Befehl erneut ausführen, wird der Wert in einer Systemvariable durch einen aktualisierten Wert ersetzt.

Weitere Informationen finden Sie unter Durch Analytics-Befehle erstellte Systemvariablen.