CEL (Content Expression Language)
El CEL (Content Expression Language) de RICOH ProcessDirector permite definir expresiones para especificar el contenido y la colocación de las
mejoras (códigos de barras, texto y áreas ocultas) en documentos de archivos AFP.
Si tiene la característica Mecanismo de inserción, el CEL permite definir expresiones
en archivos de reglas de inserción que graban archivos de control de inserción y analizan
e interpretan archivos de resultados de inserción.
Operadores
En esta tabla se muestra el orden de prioridad de los operadores, de mayor a menor.
| Nombre del operador | Descripción |
|---|---|
| ( ) | Delimitador del parámetro de función |
| ( ) | Agrupación |
| +, - | Unario |
| *, /, % | Multiplicar, dividir, módulo |
| +, - | Adición, sustracción |
| ==, !=, >, >=, <, <= | Relacional |
| (implícito) | Concatenación |
Ejemplo:f(3+x)*5 es f(3+x) multiplicado por 5.
Idioma
| Patrón | Ejemplo de plantilla | Ejemplo real | Resultado |
|---|---|---|---|
| concatenación | 'serie1' 'serie2' | 'a' func 'b' | aVARb if func='VAR' |
| expresiones relacionales | func1 [operador_relacional] func2 | func1 [operador_relacional] func2 | True si func1=5 y func2=1 |
| Condición or | or(expr1,expr2,....) | or(a100,a==0,b==1) | True si cualquiera de las expresiones se evalúa en true |
| Condición and | and(expr1,expr2,...) | 5 1.1 5 A | True si cualquiera de las expresiones se evalúa en true |
| Condición not | not(expr1) | not(a==b) | True si todas las expresiones se evalúan como false |
| decisión | if(expresión_relacional,expr_true,expr_false) | if(av,1,0) | Si la expresión relacional es cierta, el valor se establece en trueexpr. Si la expresión relacional es falsa, el valor se establece en falseexpr. |
| decisión | if(valor,expr_true,expr_false) | if(func2,'true','false') | Si func2 tiene un valor numérico distinto de 0 o un valor de serie distinto a una serie vacía, el literal de serie es true; de lo contrario, es false. |
Sentencias equivalentes
| Base | Equivalente | Comentarios |
|---|---|---|
| a | a() | Las variables son funciones sin (). |
| '*' a | '*'a() | La concatenación no requiere espacios entre entradas de datos y la función a se puede representar de cualquier forma. |
Definición de lenguaje EBNF
En este EBNF ((Extended Backus-Naur Form), se representa una expresión CEL mediante la producción expr. Las operaciones relaciones y numéricas se comportan como sus equivalentes en lenguaje C. Las expresiones consecutivas se unen para generar un resultado.
expr = "(", expr, ")» | concatenación | expr_num | expr_rel | ("+" | "-"), expr | llamada_func | serie| número;concatenación = expr, expr;expr_num = expr, ("+" | "-" | "*" | "/" | "%"), expr;expr_rel = expr, ("==" | "!=" | "<" | ">" | "<=" | ">="), expr;llamada_func = identificador, [ "(", parámetros, ")" ];parámetros = expr, { ",", expr };identificador = (alfab | "_"), { (alfab | "_" | dígito ) };serie = "'", (* secuencia de caracteres, con escapes \\ estándar *), "'";número = (dígito { dígito }) | ({ dígito } . {dígito});
Nota: No hay variables, sólo llamadas a función; una llamada a función sin una especificación
de parámetro tiene el mismo aspecto que una variable y se comporta exactamente de
la misma manera.
Funciones de contexto incorporadas
| Nombre de la función | Sintaxis | Descripción |
|---|---|---|
| substr | substr(f,inicio [,longitud]) | inicio es una posición desde el final de la cadena. inicio está basado en cero. inicio puede ser negativo. |
| trim | trim(serie [, carParaElim]) | Elimina los espacios en blanco finales (o la lista de caracteres especificados en charsToTrim) situados a la izquierda y a la derecha de la serie. |
| rtrim | rtrim(serie [, carParaElim]) | Elimina los espacios en blanco (o la lista de caracteres especificados en charsToTrim) situados a la derecha de la serie. |
| ltrim | ltrim(serie [, carParaElim]) | Elimina los espacios en blanco (o la lista de caracteres especificados en charsToTrim) situados a la izquierda de la serie. |
| indexof | indexof(serie, substr [, inicio ]) | Devuelve la ubicación de índice de inicio de la subserie dentro de la serie. Si no se encuentra substr, se devuelve -1. |
| fmt | fmt(serieFormato [,valores]... ) | Formatea los valores utilizando serieFormato. |
| tr | tr(serie, carDesde [,carHasta]) | Convierte los caracteres que coinciden con carDesde de la serie con los carHasta correspondientes. Si el carácter carDesde no tiene un carácter correspondiente en carHasta (coincidencia de posición), fromChar se elimina de la serie de entrada. Si carHasta se omite, todos los caracteres que se muestran en carDesde se eliminan en el valor devuelto. |
| bandeja | bin(serie [, TrueChar]) | Utilizando TrueChar como bits de activación de la serie, la serie de entrada se convierte en un número. Si se omite trueChar, "1" es un bit de activación. |
| fmtbase | fmtbase(valor, númCar [, serieBase ]) | Si se omite baseString, se asume que es "0123456789ABCDEF", lo que devuelve los numChars que se encuentran más a la derecha tras convertir el valor en la base representada por baseString. baseString puede ser cualquier lista de caracteres, suponiendo que el carácter que se encuentra más a la izquierda representa cero y el que está más a la derecha representa el valor más alto del sistema básico en que se está convirtiendo. |
| exists | =[valor] | Se evalúa en true si el valor se evalúa en true. (Esta función es equivalente a la función defined). |
| definición | =[valor] | Se evalúa en true si el valor se evalúa en true. Si el valor es un nombre de propiedad de RICOH ProcessDirector, esta función devuelve true si la propiedad está definida en la base de datos. Si una propiedad está definida en la base de datos, puede referirse a ella en otras funciones CEL. |
| len | len(serie) | Devuelve el número de caracteres de la serie de entrada. |
| nil | nil | Devuelve un valor que puede usar en las funciones CEL para representar un valor nulo. |
| aggr | [aggr=sum] [aggr=max] [aggr=min] | Devuelve el valor de la suma, el valor máximo o el valor mínimo de una expresión (expr) evaluada con respecto a todos los documentos del trabajo. Si tiene la característica Mecanismo de inserción, puede utilizarla en el archivo de reglas para el registro de cabecera del archivo de control de inserción. |
Funciones de contexto de registro
| Nombre de la función | Sintaxis | Descripción |
|---|---|---|
| nombre_campo | nombre_campo o nombre_campo() | El valor del campo del registro actual en el contexto. |
| recnum | recnum o recnum() | El número de registro del registro actual que se utiliza en el contexto. |
Funciones de contexto de almacenamiento en memoria caché de registro
| Nombre de la función | Sintaxis | Descripción |
|---|---|---|
| nombre_campo | nombre_campo o nombre_campo(desplazamiento) | Si desplazamiento es 0 o falta, el valor del campo para el registro actual en el contexto. Si desplazamiento es un número positivo, el valor del campo de desplazamiento de registro delante. Si desplazamiento es un número negativo, el valor del campo para el registro desplazamiento detrás. El número máximo de registros almacenados en caché actualmente es 10. El número de registros almacenados en caché previamente puede ser cualquier valor y se determina de forma dinámica durante el procesamiento. |
| recnum | recnum o recnum() | El número de registro del registro actual que se utiliza en el contexto. |
Ejemplos
| Expresión | Explicación |
|---|---|
| if(or(a100,a==0),1,0) | Si el valor de a es mayor que 100 o igual a 0, esta expresión se evalúa en 1; de lo contrario, se
evalúa en 0. |
| if(and(a>3,a<10),1,0) | Si el valor de a es mayor que 3 y menor que 10, esta expresión se evalúa en 1; de lo contrario, se
evalúa en 0. |
| if(fld,fld,'') | Trata un valor que falta como una serie vacía; de lo contrario, trata el valor que falta como no definido, lo que es distinto que un valor en blanco. |
| fmtbase(if(output_bin=='2',1,0) + if(output_bin=='3',2,0) + if(meter == '1', 4,0) , 1) | Devuelve un número hexadecimal, donde el bit de orden inferior (desde la derecha)
indica si output_bin está establecido en 2, el segundo bit indica si output_bin está establecido en 3 y el tercer bit indica si meter está establecido en 1. |
| 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 ) | Devuelve un número hexadecimal, donde el bit de orden inferior (desde la derecha)
indica si meter está establecido en 2, el segundo bit indica si el primer carácter de mch_isrt_bins está establecido en 'Y' y el tercer bit indica si el segundo carácter de mch_isrt_bins está establecido en 'Y'. |
| fmtbase(63,2,"0123456789ABCDFGHJKLMNPQRSTVWXYZ") | Convierte 63 a "1Z". Se puede utilizar cualquier serie como la base. |
| tr('abc', 'b') | Elimina todos los caracteres 'b'. |
| tr('00101', '01', 'NY') | Convierte '0' a 'N' y '1' a 'Y'. Resultados en 'NNYNY'. |
| tr('00101', '0123456789Y', 'YYYYYYYYYYN') == 'YYYYY' | Se evalúa en true si todos los caracteres de '00101' son dígitos. '00101' se puede sustituir por un valor de función de 5 caracteres. |
| len(tr('00101','0')) | Se evalúa en 2. Elimina todos los '0' de la serie de entrada y devuelve la longitud de los caracteres restantes. Cuenta de forma efectiva el número de '1' en la serie de entrada. |
| [expr=Doc.TotalSheets] [aggr=sum] | Devuelve la suma de todos los valores de la propiedad Doc.TotalSheets de todos los documentos del trabajo. |
| [expr=Doc.TotalSheets] [aggr=max] | Devuelve el valor máximo de la propiedad Doc.TotalSheets de todos los documentos del trabajo. |
| [expr=Doc.TotalSheets] [aggr=min] | Devuelve el valor mínimo de la propiedad Doc.TotalSheets de todos los documentos del trabajo. |
| [expr=recnum>1] | Ignorar la primera línea del archivo. (leer solo registros de número mayor que 1). |