Parameter
App-Parameter sind Konfigurationswerte, auf die in den Anzeige-Templates zugegriffen werden kann. Durch deren Nutzung können Werte und Dateien ohne Anpassung des Template-Codes geändert werden.
Erstellung von App-Parametern
Wählen Sie im Menu und klicken Sie anschließend in der linken Menüleiste auf Parameter und dann auf Hinzufügen, um einen App-Parameter anzulegen.
Im nun geöffneten Fenster sehen sie die Eingabeansicht Ihrer App-Parameter.
- Name
Hier muss ein eindeutiger Name für den App-Parameter festgelegt werden. Der Name darf nur Buchstaben, Ziffern und „_“ beinhalten. Über diesen Namen können sie in Ihren Templates auf den App-Parameter zugreifen.
- Typ
Wählen Sie hier den Typ Ihres Parameters.
BOOL Wahrheitswert (Ja/Nein)
INT Ganze Zahl (z.B.
2)NUMBER Zahl (z.B.
2.394)STR Text (z.B.
gurk)COLOR Farbe (z.B.
#ff0000)DATE Datum (z.B.
29.02.2000)DATETIME Datum/Uhrzeit (z.B.
29.02.2000 16:05:54)DATEDELTA Zeitraum im Tagen (z.B.
10)DATETIMEDELTA Zeitraum in Tagen/Stunden/Minuten/Sekunden (z.B. 5
days, 12:33:15)MONTHDELTA Zeitraum in Monaten (z.B.
6)Upload Dateien (z.B. ein Bild oder eine PDF-Datei)
App die entsprechende App kann hier ausgewählt werden.
- Wert
Je nach Typ des Parameters wird hier der Wert festgelegt. Beispiele siehe oben in der Klammer.
- Beschreibung
Die Beschreibung der Parameter ist nur intern sichtbar.
Zugriff in E-Mail- und Anzeige-Templates
Um auf die App-Parameter zugreifen zu können, muss im Template eine Datenquelle konfiguriert und in dieser bei Parameter? das Häkchen gesetzt werden.
In den E-Mail- und Anzeige-Templates kann auf die App-Parameter mittels des
Ausdrucks app.params.beispiel oder app.p_beispiel (Shortcut-Attribut)
zugegriffen werden. Wobei beispiel jeweils der Name des Parameters ist.
Auf den Wert kann direkt mit dem Shortcut-Attribut app.pv_beispiel
zugegriffen werden.
Der Wert des App-Parameters kann mit dem print-Statement:
<?printx app.pv_beispiel?>
ausgegeben werden.
Ist der App-Parameter vom Typ DATE kann das Datum in deutscher Schreibweise ausgegeben werden mit:
<?printx format(app.pv_beispiel, "%d.%m.%Y", "de")?>
Bei App-Parametern vom Typ Upload erhält man die URL, unter welcher die Datei zu finden ist mit:
<?printx app.pv_beispiel.url?>
Ist der App-Parameter vom Typ App, kann die App-ID ausgegeben werden mit:
<?printx app.pv_beispiel.id?>
Mehr Informationen zum App- und AppParameter-Objekt finden Sie unter
App und AppParameter.
Anwendungsbeispiel
Um die Anwendung der App-Parameter zu demonstrieren, wird wieder auf das Anwendungsbeispiel aus Kapitel 1 zurückgegriffen. Es soll ein App-Parameter angelegt werden, der als Überschrift des Anzeigetemplates eingesetzt werden soll.
Wählen Sie im Menü und klicken Sie anschließend in der linken Menüleiste auf Parameter und anschließend auf Hinzufügen.
Im nun geöffneten Fenster werden folgende Konfigurationen vorgenommen.
Der Name soll ueberschrift lauten. Damit können Sie im E-Mail-
oder Anzeigetemplate auf den App-Parameter zugreifen. Als Typ wird
STR (Text) ausgewählt. Bei Wert wird die Bezeichnung der
Überschrift - Teilnehmerliste eingegeben.
Wie Sie den App-Parameter in Ihren Templates ausgeben, können Sie im Abschnitt Zugriff in E-Mail- und Anzeige-Templates nachlesen.