ZPL ビューアー：ZPL ラベルをプレビュー

ZPL ラベルがプリンターに行く前に、画面で確認できます。UCC テンプレートから小売業者テンプレートを選んでフォームに入力するか、自分の ZPL を貼り付けて、プレビュー、コピー、ZPL・PNG・PDF でのダウンロードができます。

ZPL は、ラベルプリンターに「何を、どこに印刷するか」を指示する言語です。コードを目で判断するのは難しく、フィールドが 2 ミリずれて、印刷して初めて気づくこともあります。ZPL ビューアー（Utilities → ZPL Viewer、/utilities/zpl-viewer）は、設定したラベルサイズとプリンター解像度で、まずラベルを画面に描きます。何かを印刷する前にレイアウトを確認できます。使い方は 2 通り：UCC テンプレートに保存された小売業者ラベルテンプレートから始めて値を入力するだけ、あるいは自分の ZPL コードを貼り付けてプレビューします。プレビューはブラウザ内でローカルに描画されます。

手順 1：小売業者テンプレートを選ぶ#

1. Utilities → ZPL Viewer（/utilities/zpl-viewer）を開きます。ページは「小売業者テンプレート」モードで始まります — 「カスタム ZPL」になっている場合は、上部の切替で戻します。
2. テンプレートのドロップダウンを開いて 1 つ選びます。入力して検索もでき、各項目は「小売業者 · テンプレート名」と表示されます。
3. 選択すると、ドロップダウンの横にそのテンプレートのサイズ、バージョン、ラベル種別が表示され、下のラベル幅・高さもテンプレートから自動で設定されます。

• リストに入るのは UCC ラベルテンプレートのみです。テンプレート自体は WMS → UCC テンプレート（/wms/templates）で作成・編集します。ビューアーはそれを使うだけです。
• ドロップダウンに「UCC テンプレートが見つかりません」と出る場合は、選べるテンプレートがまだありません — 先に WMS → UCC テンプレート（/wms/templates）で追加するか、下記のカスタム ZPL モードを使ってください。

手順 2：ラベルの内容を入力#

1. 「ラベル内容を入力」カードには、テンプレートに書かれたプレースホルダ（テンプレートの ZPL では [[...]] の形）の数だけ入力欄が現れます。欄の名前が、何を入れるかを示します。
2. 各欄に値を入力します。テンプレートの ZPL は入力に合わせて更新され、右側のプレビューも少し遅れて自動で描き直されます。
3. フォームが乱れたら、カード上部の「リセット」で全欄が空に戻り、値の入力をやり直せます。

• 空のままの欄は、そのプレースホルダが ZPL にそのまま残り、ページには「未入力のプレースホルダ」の警告が名前付きで一覧表示されます — ラベルを完成品とする前に、すべて入力してください。
• 入力値からは ^ と ~ の 2 文字が自動で取り除かれます。これらは ZPL の制御文字で、値に含まれるとラベルが壊れます — 名前や住所には使わないでください。

または：自分の ZPL を貼り付ける（カスタム ZPL モード）#

1. Utilities → ZPL Viewer（/utilities/zpl-viewer）上部の切替を「カスタム ZPL」にします。
2. 「ZPL コード」ボックスに自分の ZPL を貼り付けるか、入っている内容を編集します — 短い例（シンプルな「Hello ZPL」ラベル）があらかじめ入っているので、コードの形がすぐ分かります。
3. 右側のプレビューは、テンプレートモードと同様に編集に追随します。

手順 3：ラベルサイズと解像度を設定し、プレビューを確認#

1. ラベルの幅と高さをインチで設定します。テンプレートは自身に保存されたサイズから自動設定され（サイズ未設定のテンプレートは 4 × 6 インチ）、カスタムモードでは 4 × 6 から始まります — 実際に印刷するラベルに合わせて変更してください。
2. プリンターに合う解像度を選びます：203 dpi（8 dots/mm、一般的な熱転写設定）または 300 dpi（12 dots/mm、高精細）。プレビューの文字とバーコードはその精細さで描かれます。
3. 変更のたびに、プレビューは少し遅れて自動で描き直されます。古い表示に見える場合は「レンダリング」をクリックするとその場で描き直されます。

• ラベルコードにこのビューアーが対応していないコマンドがある場合、そのコマンドはスキップされ、プレビューの下に「未対応コマンド（スキップ）」として一覧表示されます。ラベルの残りは描画されますが、プレビューを信頼する前に一覧を確認してください。
• プレビューが完全に失敗した場合は、ZPL コードの確認を求めるエラーが出ます — よくある原因は、コードの開始または終了マーカーの不足です。

手順 4：ラベルをコピーまたはダウンロード#

1. 「ZPL をコピー」をクリックすると、最終的な ZPL コード（入力値が反映済み）がクリップボードにコピーされ、必要な場所に貼り付けられます。
2. 必要な形式でダウンロードもできます：ZPL ボタンはコードを .zpl ファイルで、PNG はプレビューを画像で、PDF は設定したラベルサイズちょうどのページの文書でダウンロードします。

この記事で使った Docklify 機能#

• ZPL ビューアー — Utilities → ZPL Viewer（/utilities/zpl-viewer）
• プレースホルダ入力フォーム付き小売業者ラベルテンプレート — Utilities → ZPL Viewer → 小売業者テンプレートモード（/utilities/zpl-viewer）
• UCC テンプレート（ラベルテンプレートの作成・編集場所）— WMS → UCC テンプレート（/wms/templates）
• 実寸と解像度（203／300 dpi）でのラベルプレビュー、コピーと ZPL／PNG／PDF ダウンロード — Utilities → ZPL Viewer → 印刷プレビュー（/utilities/zpl-viewer）