Ten samouczek wyjaśnia sekcję podglądu REST i ZPL. Gdy masz otwarty szablon w edytorze szablonów, łatwo możesz sprawdzić i edytować kod szablonu oraz skopiować kod ZPL, który zostanie wysłany do drukarki. Możesz również generować ciało JSON dla REST API, co może pomóc w testowaniu lub korzystaniu z punktów końcowych aplikacji.
Otwórz edytor szablonów etykiet
Możesz użyć istniejącego szablonu lub utworzyć nowy na potrzeby tego samouczka. Jeśli nie wiesz, jak to zrobić, lub chcesz dowiedzieć się podstawowych informacji na temat rozmiarów i pozycji elementów na etykiecie, sprawdź ten samouczek najpierw.
Aby otworzyć panel podglądu, otwórz istniejącą etykietę w edytorze i naciśnij przycisk Procesowanie oraz parametry dla REST API u dołu edytora.
Dla tego samouczka bardzo ważne jest, aby twoja etykieta zawierała co najmniej jeden element i co najmniej jeden zmiennik (mile widziane są dwa lub więcej). Dzięki temu dowiesz się zarówno o kodzie ZPL, jak i o konstrukcji obiektu JSON.
Przygotuj strukturę i treść przykładowej etykiety
someName i someDescription i ustaw ich wartości na The Name i The Description.Pierwsza sekcja po lewej stronie dolnego panelu podglądu to podgląd bieżącego kodu szablonu. Klikając przycisk Generate code, wygenerujesz bieżący kod etykiety z możliwością edycji.
Przejrzyj podgląd kodu etykiety
Otwórz dolny panel Procesowanie oraz parametry dla REST API i kliknij przycisk Wygeneruj kod w pierwszej kolumnie.
Druga sekcja dolnego panelu podglądu to Podgląd zawartości zapytania JSON dla REST API. Ta sekcja umożliwia przeglądanie i kopiowanie przykładowego ciała JSON, które może być używane z punktem końcowym REST API do drukowania.
Zakładając, że utworzyłeś zmienne someName i someDescription zgodnie z poprzednią sekcją dotyczącą przygotowywania testowej etykiety i ustaw je na domyślne wartości, podgląd JSON będzie wyglądać tak:
{
"someName": "The Name",
"someDescription": "The Description"
}
Jak widać, ciało JSON, które powinno być wysłane do punktu końcowego drukowania REST, to prosta lista nazw zmiennych z wartościami, które powinny zostać podstawione w miejsce odpowiednich zmiennych.
Aby uzyskać więcej informacji na temat drukowania za pomocą REST API, odwiedź odpowiedni samouczek dostępny na naszej stronie internetowej.
Przejrzyj zawartości zapytania JSON dla REST API
Otwórz dolny panel Procesowanie oraz parametry dla REST API i przejrzyj wygenerowane ciało JSON dla swojego szablonu. Spróbuj zmienić niektóre wartości i/lub nazwy zmiennych. Następnie zapisz szablon i ponownie przejrzyj JSON.
Ostatnia sekcja dolnego panelu podglądu to Generated ZPL preview. ZPL to język, w którym drukarki otrzymują treść do druku. Przykład bardzo krótkiego kodu ZPL prezentującego etykietę z jednym polem tekstowym z zawartością TEST wygląda tak:
^XA
^CI28
^PON
^BY2,3,0,10
^LH0,0
^FO99,53^A0N,60,60^FH^FD_54_45_53_54^FS
^XZ
Możesz skopiować ten kod ZPL (i dowolny inny kod ZPL z podglądu aplikacji) i wkleić go do przeglądarki ZPL labelary.io, aby zobaczyć rezultat. Wynik kodu w tym przykładzie powinien przedstawiać prosty ciąg TEST.
Aplikacja przekształca szablon etykiety na kod ZPL i wysyła wygenerowany kod do drukarki. Kod ZPL można również wysłać do drukarki jako surowe dane. Jedno z końcówek aplikacji umożliwia tę operację, przekierowując surowe dane do żądanej kolejki drukarki.
Przejrzyj podgląd wygenerowanego kodu ZPL
Otwórz dolny panel Procesowanie oraz parametry dla REST API i przejrzyj wygenerowany kod ZPL. Spróbuj wprowadzić zmiany w szablonie, zapisz go i ponownie przejrzyj kod ZPL.