Content Expression Language (CEL)

Operatoren

In der folgenden Tabelle wird die Vorrangstellung für Operatoren von der höchsten bis zur niedrigsten Vorrangstellung gezeigt.

Bedienername	Beschreibung
( )	Funktionsparameterbegrenzer
( )	Gruppierung
+, -	Monadisch
*, /, %	Multiplikation, Division, Modulo
+, -	Addition, Subtraktion
==, !=, >, >=, <, <=	Relational
(implizit)	Verknüpfung

Beispiel:f(3+x)*5 ist f(3+x) multipliziert mit 5.

Sprache

Muster	Musterbeispiel	Echtes Beispiel	Ergebnis
Verknüpfung	'Zeichenfolge1' 'Zeichenfolge2'	'a' func 'b'	aVARb wenn func='VAR'
Vergleichsausdrücke	func1 [Vergleichsoperator] func2	func1 > func2	Wahr, wenn func1=5 und func2=1
Bedingung or	or(Ausdruck1,Ausdruck2,....)	or(a>100,a==0,b==1)	Wahr, wenn ein beliebiger Ausdruck wahr ist.
Bedingung and	and(Ausdruck1,Ausdruck2,...)	and(a>3,a<10)	Wahr, wenn alle Ausdrücke wahr sind.
Bedingung not	not(Ausdruck1)	not(a==b)	Wahr, wenn alle Ausdrücke falsch sind.
Entscheidung	if(relationaler_Ausdruck,wahrer_Ausdruck,falscher_Ausdruck)	if(a>v,1,0)	Wenn der Vergleichsausdruck wahr ist, wird der Wert auf trueexpr gesetzt. Wenn der Vergleichsausdruck falsch ist, wird der Wert auf falseexpr gesetzt.
Entscheidung	if(Wert,wahrer_Ausdruck,falscher_Ausdruck)	if(func2,'true','false')	Wenn func2 einen numerischen Wert, der ungleich 0 ist, oder einen Zeichenfolgewert hat, der ungleich der leeren Zeichenfolge ist, ist das Zeichenfolgeliteral wahr, andernfalls ist es falsch.

Äquivalente Anweisungen

Basis	Äquivalent	Kommentare
a	a()	Die Variablen sind Funktionen ohne ().
'*' a	'*'a()	Für die Verknüpfung sind keine Leerzeichen zwischen Eingaben erforderlich, und die Funktion a kann auf eine der beiden Arten dargestellt werden.

EBNF-Sprachendefinition

In dieser erweiterten Backus-Naur-Form (EBNF) wird ein CEL-Ausdruck durch die Produktion expr ausgedrückt. Die relationalen und numerischen Operationen verhalten sich wie ihre Gegenstücke in der Programmiersprache C. Aufeinanderfolgende Ausdrücke werden zusammengekettet, um ein Ergebnis zu produzieren.

expr = "(", expr, ")" | catenation | numexpr | relexpr | ("+" | "-"), expr | function call | string | number;catenation = expr, expr;numexpr = expr, ("+" | "-" | "*" | "/" | "%"), expr;relexpr = expr, ("==" | "!=" | "<" | ">" | "<=" | ">="), expr;function call = identifier, [ "(", parameters, ")" ];parameters = expr, { ",", expr };identifier = (alpha | "_"), { (alpha | "_" | digit ) };string = "'", (* sequence of characters, with standard \\ escapes *), "'";number = (digit { digit }) | ({ digit } . {digit});

Hinweis: Es gibt keine Variablen, nur Funktionsaufrufe. Ein Funktionsaufruf ohne Parameterangabe sieht genau wie eine Variable aus und verhält sich auch so.

Integrierte Kontextfunktionen

Funktionsname	Syntax	Beschreibung
substr	substr(f,Start [,Länge])	start ist eine Position vom Ende der Zeichenkette. start ist nullbasiert. start kann negativ sein.
trim	trim(Zeichenfolge [, Zu_löschende_Zeichen])	Leerzeichen (oder die in Zu_löschende_Zeichen angegebene Zeichenliste) links und rechts von der Zeichenfolge löschen.
rtrim	rtrim(Zeichenfolge [, Zu_löschende_Zeichen])	Leerzeichen (oder die in Zu_löschende_Zeichen angegebene Zeichenliste) rechts von der Zeichenfolge löschen.
ltrim	ltrim(Zeichenfolge [, Zu_löschende_Zeichen])	Leerzeichen (oder die in Zu_löschende_Zeichen angegebene Zeichenliste) links von der Zeichenfolge löschen.
indexof	indexof(Zeichenfolge, substr [, Start ])	Startindexposition der Unterzeichenfolge innerhalb der Zeichenfolge zurückgeben. Wird substr nicht gefunden, wird -1 zurückgegeben.
fmt	fmt(formatString [,values]... )	Die Werte unter Verwendung von Formatierzeichenfolge formatieren.
tr	tr(Zeichenfolge, von_Zeichen [, in_Zeichen])	Zeichen, die mit von_Zeichen in der Zeichenfolge übereinstimmen, in das entsprechende in_Zeichen umsetzen. Wenn das Zeichen von_Zeichen kein entsprechendes Zeichen in in_Zeichen (Positionsübereinstimmung) hat, wird das von_Zeichen aus der Eingabezeichenfolge entfernt. Wird in_Zeichen weggelassen, werden alle in von_Zeichen aufgeführten Zeichen in dem Rückgabewert entfernt.
bin	bin(Zeichenfolge [, wahres_Zeichen])	Die Eingabezeichenfolge wird unter Verwendung von wahres_Zeichen als Ein-Bit in eine Zahl konvertiert. Wird wahres_Zeichen weggelassen, ist "1" das Ein-Bit.
fmtbase	fmtbase(Wert, Nummernzeichen [, Basiszeichenfolge ])	Wenn baseString weggelassen wird, wird angenommen, dass es für "0123456789ABCDEF" steht, was nach der Konvertierung des Wertes in die durch baseString dargestellte Basis die ganz rechten numChars zurückgibt. baseString kann eine beliebige Liste von Zeichen sein, wobei angenommen wird, dass das ganz linke Zeichen Null und das ganz rechte den höchsten Wert des Basissystems darstellt, in das konvertiert wird.
exists	exists(Wert)	Wird als "wahr" bewertet, wenn der Wert als "wahr" bewertet wird. (Diese Funktion entspricht der Funktion defined.)
Definition	defined(Wert)	Wird als "wahr" bewertet, wenn der Wert als "wahr" bewertet wird. Wenn der Wert ein RICOH ProcessDirector-Merkmalname ist, gibt diese Funktion "wahr" zurück, sofern das Merkmal in der Datenbank definiert ist. Ist ein Merkmal in der Datenbank definiert, können Sie in anderen CEL-Funktionen darauf verweisen.
len	len(Zeichenfolge)	Gibt die Anzahl von Zeichen in der Eingabezeichenfolge zurück.
nil	nil	Gibt einen Wert zurück, den Sie in CEL-Funktionen zur Darstellung eines Nullwerts verwenden können.
aggr	[aggr=sum] [aggr=max] [aggr=min]	Gibt die Summe, den Maximalwert oder den Minimalwert eines Ausdrucks (expr) zurück, der anhand aller Dokumente im Job ausgewertet wurde. Wenn Sie über das Kuvertierungseinheiten-Feature verfügen, können Sie diese Funktion in der Regeldatei für den Headersatz der Kuvertiereinheiten-Steuerdatei verwenden.

Satzkontextfunktionen

Funktionsname	Syntax	Beschreibung
Feldname	Feldname oder Feldname()	Der Wert des Feldes für den aktuellen Satz in dem Kontext.
recnum	recnum oder recnum()	Die Satznummer des aktuellen Satzes, der in dem Kontext benutzt wird.

Kontextfunktionen für Satz-Caching

Funktionsname	Syntax	Beschreibung
Feldname	Feldname oder Feldname(relative_Position)	Ist relative_Position 0 oder nicht vorhanden, der Wert des Feldes für den aktuellen Satz in dem Kontext. Ist relative_Position eine positive Zahl, der Wert des Feldes für die relative_Position des Satzes davor. Ist relative_Position eine negative Zahl, der Wert des Feldes für die relative_Position des Satzes dahinter. Die maximale Anzahl von Sätzen für das Caching dahinter liegt derzeit bei 10. Die Anzahl von Sätzen für das Caching davor kann ein beliebiger Wert sein und wird bei der Verarbeitung dynamisch festgelegt.
recnum	recnum oder recnum()	Die Satznummer des aktuellen Satzes, der in dem Kontext benutzt wird.

Beispiele

Ausdruck	Erläuterung
if(or(a>100,a==0),1,0)	Wenn der Wert von `a` größer als 100 oder gleich 0 ist, wird dieser Ausdruck als 1 bewertet; andernfalls wird er als 0 bewertet.
if(and(a>3,a<10),1,0)	Wenn der Wert von `a` größer als 3 oder kleiner als 10 ist, wird dieser Ausdruck als 1 bewertet; andernfalls wird er als 0 bewertet.
if(fld,fld,'')	Behandelt einen fehlenden Wert als leere Zeichenfolge. Andernfalls wird der fehlende Wert als undefiniert behandelt, was sich von einem Leerwert unterscheidet.
fmtbase(if(output_bin=='2',1,0) + if(output_bin=='3',2,0) + if(meter == '1', 4,0) , 1)	Gibt eine Hexadezimalzahl zurück, wobei das niederwertige Bit (von rechts) angibt, ob `output_bin` auf 2 gesetzt ist, das zweite Bit angibt, ob `output_bin` auf 3 gesetzt ist und das dritte Bit angibt, ob `meter` auf 1 gesetzt ist.
fmtbase(if(meter=='2',1,0) + if(substr(mch_isrt_bins,0,1)=='Y',2,0) + if(substr(mch_isrt_bins,1,1)=='Y',4,0) , 1 )	Gibt eine Hexadezimalzahl zurück, wobei das niederwertige Bit (von rechts) angibt, ob `meter` auf 2 gesetzt ist, das zweite Bit angibt, ob das erste Zeichen von `mch_isrt_bins` auf 'Y' gesetzt ist, und das dritte Bit angibt, ob das zweite Zeichen von `mch_isrt_bins` auf 'Y' gesetzt ist.
fmtbase(63,2,"0123456789ABCDFGHJKLMNPQRSTVWXYZ")	Konvertiert 63 in "1Z". Als Basis kann eine beliebige Zeichenfolge benutzt werden.
tr('abc', 'b')	Entfernt alle Zeichen 'b'.
tr('00101', '01', 'NY')	Konvertiert '0' in 'N' und '1' in 'Y'. Führt zu 'NNYNY'.
tr('00101', '0123456789Y', 'YYYYYYYYYYN') == 'YYYYY'	Wird als wahr ausgewertet, wenn alle Zeichen in "00101" Ziffern sind. "00101" kann durch einen Funktionswert von 5 Zeichen ersetzt werden.
len(tr('00101','0'))	Bewertung mit 2. Entfernt alle Nullen aus der Eingabezeichenfolge und gibt die Länge der restlichen Zeichen zurück. Zählt effektiv die Anzahl der Einsen in der Eingabezeichenfolge.
[expr=Doc.TotalSheets] [aggr=sum]	Gibt die Summe aller Werte im Merkmal Doc.TotalSheets in allen Dokumenten des Auftrags zurück.
[expr=Doc.TotalSheets] [aggr=max]	Gibt den Maximalwert im Merkmal Doc.TotalSheets in allen Dokumenten des Auftrags zurück.
[expr=Doc.TotalSheets] [aggr=min]	Gibt den Minimalwert im Merkmal Doc.TotalSheets in allen Dokumenten des Auftrags zurück.
[expr=recnum>1]	Ignorieren Sie die erste Zeile der Datei. (Lesen Sie nur Satznummern größer 1.)

RICOH ProcessDirector™ für Linux