Linha de comando cee

O cee é a linha de comando do ceelab. Ele imprime a partir de um terminal (PowerShell, bash, zsh, cmd), de um script ou de uma tarefa agendada, com os seus tipos de documento, os seus números e as suas verificações de sempre: o resultado é o mesmo que no aplicativo.

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 é a chave do tipo de documento, visível na aba Tipos de documento (Configurações avançadas › Chave do tipo). Os modelos são criados no aplicativo; o cee serve para usá-los.

Antes de começar

O cee é instalado com o ceelab. Abra o ceelab pelo menos uma vez no computador e configure a impressora de etiquetas e a pasta de saída.

Sistema	Chamada
Windows	cee em um novo terminal, depois da instalação.
Linux	cee diretamente.
macOS	/Applications/ceelab.app/Contents/MacOS/cee

Comandos

Os comandos são em inglês; as mensagens seguem o idioma do ceelab. cee COMANDO --help mostra a ajuda de um comando, e cee print TIPO --help lista as informações a preencher para esse tipo.

Comando	Efeito
cee types	Lista os seus tipos de documento e as informações a preencher.
cee describe TIPO	Detalha um tipo: documentos produzidos, informações a preencher, valores possíveis.
cee preview TIPO --out ARQUIVO.pdf	Salva uma pré-visualização (PDF ou PNG), sem imprimir nem consumir nada.
cee print TIPO [valores] [--copies N]	Imprime como o espaço Geração, de 1 a 10 000 cópias.
cee history	Últimos documentos produzidos.
cee reprint ID|--last	Reimprime um documento de forma idêntica, sem consumir número.
cee edit ID|--last [valores]	Corrige um documento e o reimprime, com os mesmos números.

--dry-run faz todas as verificações de uma impressão real e mostra o que seria produzido, sem imprimir nada.

Informar os valores

Cada informação a preencher é informada pelo seu nome, ou com --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: a vírgula é aceita (12,5); data: AAAA-MM-DD ou DD/MM/AAAA; lista de opções: o texto exato da opção; Sim/Não: true ou false.
• Uma informação não informada recebe o seu valor padrão. Os números e os cálculos ficam por conta do ceelab.
• Um valor com espaços vai entre aspas: --set "name=Jane Doe" funciona em qualquer terminal.

Verificações

Antes de imprimir, o cee verifica tudo, como o aplicativo: valores, impressora de etiquetas, pasta de saída e verificação da primeira etiqueta. Se faltar alguma coisa, nada é impresso e nenhum número é consumido. Uma saída que falhar depois disso é refeita com cee reprint ID.

Para os seus scripts

Com --json, a resposta é um único objeto JSON, legível pelos seus scripts, inclusive em caso de erro.

# 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	sucesso
2	comando escrito incorretamente
3	tipo ou documento não encontrado
4	valor recusado
6	ceelab ainda não está pronto neste computador: abra-o uma vez
7	nenhuma impressora de etiquetas configurada
8	uma saída falhou: ela fica registrada e pode ser reimpressa
9	ceelab ocupado: tente de novo
11	verificação da primeira etiqueta a fazer no aplicativo