Ligne de commande cee

cee est la ligne de commande de ceelab. Elle imprime depuis un terminal (PowerShell, bash, zsh, cmd), un script ou une tâche planifiée, avec vos types de document, vos numéros et vos contrôles habituels : le résultat est le même que depuis l’application.

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 est la clé du type de document, visible dans l’onglet Types de document (Réglages avancés › Clé du type). Les modèles se conçoivent dans l’application ; cee sert à les utiliser.

Avant de commencer

cee est installée avec ceelab. Ouvrez ceelab au moins une fois sur le poste, et réglez l’imprimante d’étiquettes et le dossier de sortie.

Système	Appel
Windows	cee dans un nouveau terminal, après l’installation.
Linux	cee directement.
macOS	/Applications/ceelab.app/Contents/MacOS/cee

Commandes

Les commandes sont en anglais ; les messages suivent la langue de ceelab. cee COMMANDE --help donne l’aide d’une commande, et cee print TYPE --help liste les informations à saisir pour ce type.

Commande	Effet
cee types	Liste vos types de document et les informations à saisir.
cee describe TYPE	Détaille un type : documents produits, informations à saisir, valeurs possibles.
cee preview TYPE --out FICHIER.pdf	Enregistre un aperçu (PDF ou PNG), sans rien imprimer ni consommer.
cee print TYPE [valeurs] [--copies N]	Imprime comme l’espace Génération, de 1 à 10 000 exemplaires.
cee history	Derniers documents produits.
cee reprint ID|--last	Réimprime un document à l’identique, sans consommer de numéro.
cee edit ID|--last [valeurs]	Corrige un document et le réimprime, avec les mêmes numéros.

--dry-run fait tous les contrôles d’une vraie impression et montre ce qui sortirait, sans rien imprimer.

Donner les valeurs

Chaque information à saisir se donne par son nom, ou avec --set :

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

• Nombre : la virgule est acceptée (12,5) ; date : AAAA-MM-JJ ou JJ/MM/AAAA ; liste de choix : le texte exact de l’option ; Oui/Non : true ou false.
• Une information non donnée prend sa valeur par défaut. Les numéros et les calculs sont faits par ceelab.
• Une valeur avec des espaces se met entre guillemets : --set "name=Jane Doe" fonctionne partout.

Contrôles

Avant d’imprimer, cee vérifie tout, comme l’application : valeurs, imprimante d’étiquettes, dossier de sortie, et contrôle de la première étiquette. Si quelque chose manque, rien n’est imprimé et aucun numéro n’est consommé. Une sortie qui échoue après coup se refait avec cee reprint ID.

Pour vos scripts

Avec --json, la réponse est un objet JSON unique, lisible par vos scripts, y compris en cas d’erreur.

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

Code	Sens
0	succès
2	commande mal écrite
3	type ou document introuvable
4	valeur refusée
6	ceelab pas encore prêt sur ce poste : ouvrez-le une fois
7	aucune imprimante d’étiquettes réglée
8	une sortie a échoué : elle est tracée et se réimprime
9	ceelab occupé : réessayez
11	contrôle de la première étiquette à faire dans l’application