Modèl etikèt ak resi

Yon modèl se yon etikèt ZPL, yon etikèt EPL oswa yon resi ak {{variables}}. Fè l yon sèl fwa nan tablo de bò a epi enprime l depi nenpòt aplikasyon ak yon ID modèl ak done yo:

await jp.print({
  templateId: "tpl_01J9SHIPLABEL",
  data: { order: "10492", customer: { name: "Anne Joseph" } },
});

• Mòd cloud (POST /v1/jobs): cloud la ranpli modèl la, epi ajan an resevwa ZPL, EPL oswa JSON resi nòmal.
• Mòd lokal (SDK navigatè): chak ajan òganizasyon an resevwa modèl yo nan konfigirasyon li epi li ranpli yo poukont li. Sa mache san entènèt tou.

Fè yon modèl

Tablo de bò → Modèl → Nouvo modèl:

1. Chwazi kalite a: etikèt ZPL, etikèt EPL oswa resi. Editè a kòmanse ak yon egzanp ki mache.
2. Chwazi papye a (pa obligatwa). Yon travay ki pa di ki papye sèvi ak papye modèl la.
3. Ekri modèl la ak kèk done egzanp (JSON).
   • Apèsi a montre sa enprimant lan resevwa.
   • Pou resi, li montre tou yon imaj motè ajan an menm desinen.
4. Anrejistre. Ajan yo resevwa modèl la nan kèk segonn. Apre sa, editè a montre kòd pou enprime l.

Yon òganizasyon ka gen 200 modèl, 2 MB an total.

Sentaks

Ekri	Rezilta
{{name}}	Valè a, pwoteje dapre kalite modèl la
{{customer.name}}	Yon valè ki anndan yon lòt
{{{name}}} oswa {{& name}}	Valè a jan li ye a, san pwoteksyon
{{#items}}…{{/items}}	Repete pou chak eleman nan yon lis. Yon objè vin kontèks la yon sèl fwa; lòt valè montre blòk la lè yo vre, pa vid oswa pa zewo.
{{^items}}…{{/items}}	Parèt lè valè a pa la, fo, vid oswa zewo
{{.}}	Eleman aktyèl nan yon lis
{{@index}}, {{#@first}}…{{/@first}}, {{^@last}}…{{/@last}}	Pozisyon nan yon lis (depi 0), premye ak dènye eleman
{{! note }}	Yon kòmantè

Yon valè ki pa la pa enprime anyen. Nimewo, true ak false enprime tankou nan JSON; objè ak lis enprime an JSON.

Pwoteksyon karaktè

Valè ki soti nan done ou yo pa janm ka tounen kòmand enprimant:

• ZPL:
  • Nan yon chan ki kòmanse ak ^FH (pa egzanp ^FO40,40^A0N,40,40^FH^FD{{name}}^FS), karaktè ^, ~, endikatè ^FH la ak karaktè kontwòl yo enprime egzakteman, kòm kòd ekzadesimal (_5E).
  • Nan lòt kote, karaktè sa yo retire.
  • Mete ^FH anvan ^FD nan chak chan ki gen yon valè. Ekspòtasyon ZebraDesigner yo deja sèvi ak ^FH\, epi endikatè \ la jere tou.
• EPL: yo mete yon backslash devan gwiyèm ak backslash, epi yo retire retou alaliy yo.
• Resi: valè yo ekri kòm kontni tèks JSON, kidonk gwiyèm ak retou alaliy pa danjere. Sèvi ak {{{rows}}} pou mete yon lis ki soti nan done ou an JSON:

{ "type": "table", "columns": [{ "width": 0.7 }, { "width": 0.3, "align": "right" }], "rows": {{{rows}}} }

oswa konstwi liy yo nan modèl la:

"rows": [{{#items}}["{{name}}", "{{price}}"]{{^@last}},{{/@last}}{{/items}}]

Enprime depi sèvè w

curl https://api.jodaprint.dev/v1/jobs \
  -H "Authorization: Bearer $JODAPRINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"deviceId":"dev_…","alias":"label","templateId":"tpl_01J9SHIPLABEL","data":{"order":"10492"}}'

GET /v1/templates bay lis modèl yo (otorizasyon jobs:read). Ak SDK Node la:

const { data: templates } = await jp.templates.list();
await jp.jobs.create({ deviceId: "dev_…", templateId: templates[0].id, data: { order: "10492" } });

Yon travay ak yon modèl ki pa egziste, oswa ak done modèl la pa ka itilize, echwe ak INVALID_JOB.

Apèsi etikèt

Tablo de bò a montre apèsi etikèt ZPL ak EPL kòm kòmand enprimant lan resevwa, pa kòm yon imaj. Rezon an esplike nan ADR 0040. Pou wè yon etikèt desinen, kole ZPL ki jenere a nan yon vizyonè ou fè konfyans. Rezilta a gen done ou yo ladan l.

Dokiman: rapò ak devi

Yon modèl Dokiman (HTML) se yon paj konplè an HTML ak CSS, pou enprimant lazè ak enprimant lank: rapò, devi, relve.

• Ajan an enprime l atravè navigatè òdinatè a (Chrome oswa Edge), kidonk fòk youn ladan yo enstale. Ajan Android yo pa enprime HTML.
• Chwazi gwosè paj la ak maj yo an CSS: @page { size: letter; margin: 16mm; }, oswa size: A4.
• Valè yo chape an HTML (<, >, &, giyme): done yo pa janm tounen balizaj. Sèvi ak {{{html}}} sèlman pou HTML ou fè konfyans.
• Ajan depi vèsyon 1.0.1 resevwa modèl HTML pou mòd lokal. Travay nan cloud mache ak tout vèsyon.

Galri

Tablo de bò → Modèl → Galri gen modèl ki pare: 5 resi, 5 etikèt, 5 rapò ak 5 devi. Sèvi ak modèl sa a louvri yon kopi nan editè a, ak mo ki enprime yo (Total, Devi…) nan lang ou, ak done egzanp ki montre varyab li bezwen. Anrejistre l, epi chanje l jan ou vle: se modèl pa w.