Befehlszeile cee

cee ist die Befehlszeile von ceelab. Sie druckt aus einem Terminal (PowerShell, bash, zsh, cmd), einem Skript oder einer geplanten Aufgabe heraus, mit Ihren Dokumenttypen, Ihren Nummern und Ihren gewohnten Prüfungen: Das Ergebnis ist dasselbe wie in der Anwendung.

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 ist der Schlüssel des Dokumenttyps, sichtbar auf der Registerkarte Dokumenttypen (Erweiterte Einstellungen › Typschlüssel). Vorlagen werden in der Anwendung gestaltet; cee dient dazu, sie zu verwenden.

Bevor Sie beginnen

cee wird mit ceelab installiert. Öffnen Sie ceelab mindestens einmal auf dem Arbeitsplatz und stellen Sie Etikettendrucker und Ausgabeordner ein.

System	Aufruf
Windows	cee in einem neuen Terminal, nach der Installation.
Linux	cee direkt.
macOS	/Applications/ceelab.app/Contents/MacOS/cee

Befehle

Die Befehle sind englisch; die Meldungen folgen der Sprache von ceelab. cee BEFEHL --help zeigt die Hilfe zu einem Befehl, und cee print TYP --help listet die für diesen Typ einzugebenden Angaben auf.

Befehl	Wirkung
cee types	Listet Ihre Dokumenttypen und die einzugebenden Angaben auf.
cee describe TYP	Zeigt einen Typ im Detail: erzeugte Dokumente, einzugebende Angaben, mögliche Werte.
cee preview TYP --out DATEI.pdf	Speichert eine Vorschau (PDF oder PNG), ohne etwas zu drucken oder zu verbrauchen.
cee print TYP [werte] [--copies N]	Druckt wie der Bereich Generierung, 1 bis 10 000 Exemplare.
cee history	Zuletzt erzeugte Dokumente.
cee reprint ID|--last	Druckt ein Dokument originalgetreu erneut, ohne eine Nummer zu verbrauchen.
cee edit ID|--last [werte]	Korrigiert ein Dokument und druckt es erneut, mit denselben Nummern.

--dry-run führt alle Prüfungen eines echten Drucks durch und zeigt, was ausgegeben würde, ohne etwas zu drucken.

Werte angeben

Jede einzugebende Angabe wird über ihren Namen oder mit --set angegeben:

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

• Zahl: Das Komma wird akzeptiert (12,5); Datum: JJJJ-MM-TT oder TT/MM/JJJJ; Auswahlliste: der exakte Text der Option; Ja/Nein: true oder false.
• Eine nicht angegebene Angabe erhält ihren Standardwert. Nummern und Berechnungen übernimmt ceelab.
• Ein Wert mit Leerzeichen kommt in Anführungszeichen: --set "name=Jane Doe" funktioniert überall.

Prüfungen

Vor dem Druck prüft cee alles, genau wie die Anwendung: Werte, Etikettendrucker, Ausgabeordner und die Kontrolle des ersten Etiketts. Fehlt etwas, wird nichts gedruckt und keine Nummer verbraucht. Eine Ausgabe, die erst danach fehlschlägt, wird mit cee reprint ID wiederholt.

Für Ihre Skripte

Mit --json ist die Antwort ein einziges JSON-Objekt, das Ihre Skripte auswerten können, auch im Fehlerfall.

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

Code	Bedeutung
0	Erfolg
2	fehlerhaft geschriebener Befehl
3	Typ oder Dokument nicht gefunden
4	Wert abgelehnt
6	ceelab auf diesem Arbeitsplatz noch nicht bereit: einmal öffnen
7	kein Etikettendrucker eingestellt
8	eine Ausgabe ist fehlgeschlagen: Sie ist festgehalten und lässt sich erneut drucken
9	ceelab ist beschäftigt: erneut versuchen
11	Kontrolle des ersten Etiketts steht in der Anwendung noch aus