Línea de comandos cee

cee es la línea de comandos de ceelab. Imprime desde un terminal (PowerShell, bash, zsh, cmd), un script o una tarea programada, con sus tipos de documento, sus números y sus controles de siempre: el resultado es el mismo que desde la aplicación.

cee print shipping-label
cee print shipping-label --copies 10
cee print shipping-label --set name="Jane Doe"
cee edit --last --set name="Jane Doe"

shipping-label es la clave del tipo de documento, visible en la pestaña Tipos de documento (Ajustes avanzados › Clave del tipo). Las plantillas se diseñan en la aplicación; cee sirve para usarlas.

Antes de empezar

cee se instala con ceelab. Abra ceelab al menos una vez en el equipo y configure la impresora de etiquetas y la carpeta de salida.

Sistema	Llamada
Windows	cee en un terminal nuevo, después de la instalación.
Linux	cee directamente.
macOS	/Applications/ceelab.app/Contents/MacOS/cee

Comandos

Los comandos están en inglés; los mensajes siguen el idioma de ceelab. cee COMANDO --help muestra la ayuda de un comando, y cee print TIPO --help enumera la información que hay que introducir para ese tipo.

Comando	Efecto
cee types	Enumera sus tipos de documento y la información que hay que introducir.
cee describe TIPO	Detalla un tipo: documentos producidos, información que hay que introducir, valores posibles.
cee preview TIPO --out ARCHIVO.pdf	Guarda una vista previa (PDF o PNG), sin imprimir ni consumir nada.
cee print TIPO [valores] [--copies N]	Imprime como el espacio Generación, de 1 a 10 000 ejemplares.
cee history	Últimos documentos producidos.
cee reprint ID|--last	Reimprime un documento de forma idéntica, sin consumir ningún número.
cee edit ID|--last [valores]	Corrige un documento y lo reimprime, con los mismos números.

--dry-run realiza todos los controles de una impresión real y muestra lo que saldría, sin imprimir nada.

Indicar los valores

Cada dato que hay que introducir se indica por su nombre, o con --set:

cee print product_label --product "Vis inox" --reference VX-0620
cee print product_label --set product="Vis inox" --set reference=VX-0620

• Número: se acepta la coma (12,5); fecha: AAAA-MM-DD o DD/MM/AAAA; lista de opciones: el texto exacto de la opción; Sí/No: true o false.
• Un dato que no se indica toma su valor predeterminado. Los números y los cálculos los hace ceelab.
• Un valor con espacios se pone entre comillas: --set "name=Jane Doe" funciona en todas partes.

Controles

Antes de imprimir, cee lo comprueba todo, como la aplicación: valores, impresora de etiquetas, carpeta de salida y control de la primera etiqueta. Si falta algo, no se imprime nada y no se consume ningún número. Una salida que falla después se rehace con cee reprint ID.

Para sus scripts

Con --json, la respuesta es un único objeto JSON, legible por sus scripts, también en caso de error.

# PowerShell
$r = cee print shipping-label --set "name=Jane Doe" --json | Out-String | ConvertFrom-Json
if ($LASTEXITCODE -ne 0) { throw $r.error.message }

Código	Significado
0	éxito
2	comando mal escrito
3	tipo o documento no encontrado
4	valor rechazado
6	ceelab aún no está listo en este equipo: ábralo una vez
7	ninguna impresora de etiquetas configurada
8	una salida ha fallado: queda registrada y se puede reimprimir
9	ceelab ocupado: vuelva a intentarlo
11	control de la primera etiqueta pendiente en la aplicación