Expresiones

Aplica a: BarcoderX Basic y Ultimate

Estado: Planificado. Todavía no hay nada publicado y no hay nada que descargar. Esta página describe el lenguaje de expresiones a nivel de conceptos. Los nombres de las funciones se fijan antes de la primera versión, y la lista completa aparecerá en la referencia de funciones.

Una expresión es una fórmula breve dentro de una plantilla. Calcula un valor para cada etiqueta: el texto que se imprimirá, los datos de un código de barras, si un elemento se muestra, o el valor de casi cualquier propiedad de un elemento.

Dónde se usan las expresiones

• Contenido. El texto de un elemento de texto o los datos de un código de barras pueden ser una expresión en lugar de un texto fijo o de un campo simple.
• Imprimir cuando. Un elemento lleva una expresión que decide si aparece. Un resultado falso omite el elemento.
• Propiedades. Casi cualquier propiedad de un elemento se puede definir mediante una expresión: posición, tamaño, rotación, colores, fuente, simbología y opciones. BarcoderX verifica que el resultado sea adecuado para la propiedad.
• Macros. Una macro es una expresión a la que usted le pone nombre y que reutiliza. Vea más abajo.

Cómo se ve una expresión

El texto va entre comillas dobles. Para poner una comilla doble dentro de un texto, escríbala dos veces. Los números, true, false y null se escriben tal cual. Los paréntesis agrupan partes de una fórmula. Los nombres de funciones y de operadores no distinguen entre mayúsculas y minúsculas.

Algunas variables vienen incorporadas y no se pueden cambiar: $pageWidth y $pageHeight (en la unidad de la página), $jobLabelIndex (el número de la etiqueta dentro del trabajo, empezando en 1) y $jobLabelTotal. Dentro de la leyenda de un código de barras, $humanReadable entrega el texto que BarcoderX generó para ese código de barras.

Un valor es uno de estos: nada (null), verdadero o falso, un número (decimal exacto), texto, una fecha y hora, o una lista.

Funciones

BarcoderX planea al menos 100 funciones integradas para la primera versión. La meta es 120. Se agrupan así:

• Los nombres de las funciones están en inglés y son iguales en todos los idiomas. Sus descripciones y sus mensajes de error están en inglés y en español.
• La cultura siempre es explícita. Una función de formato recibe una cultura, o usa la cultura del trabajo. Nunca se lee la cultura del equipo.
• El reloj es el del trabajo. Now, Today y UtcNow dan la misma hora en todo el trabajo.
• Las funciones son puras. No pueden leer ni escribir archivos, llamar a la red ni acceder a la aplicación anfitriona.
• Texto de la etiqueta en varios idiomas. La función Localize recibe una clave y devuelve el texto en el idioma del trabajo.

Seguras por diseño

Las expresiones se ejecutan en infraestructura compartida, por lo que BarcoderX las limita. La API web publica los límites.

La búsqueda de patrones usa un motor que no se puede forzar a funcionar durante mucho tiempo, y se detiene al cabo de un límite de tiempo corto.

Un error en una expresión nunca detiene un trabajo y nunca lanza una excepción hacia su aplicación. Se convierte en un diagnóstico que indica en qué parte de la expresión está el problema. Usted elige qué muestra la etiqueta en su lugar: nada, un texto de error o una etiqueta fallida.

BarcoderX también detecta un círculo de dependencias, por ejemplo cuando #a.Value y #b.Value se refieren entre sí, y lo informa.

Sus propias funciones y macros

• En el SDK, puede registrar sus propias funciones .NET.
• En la API web, nadie puede cargar código. En su lugar, usted puede guardar macros con nombre en su servidor. Una macro no puede llamarse a sí misma, y se ejecuta dentro del mismo presupuesto de pasos que cualquier otra expresión.

BarcoderX es un producto de P4 Software.