Wyrażenia wartości

W tym samouczku dowiesz się, jak korzystać z edytora wyrażeń wartości. Każdy element tekstowy, kod kreskowy lub kod dwuwymiarowy został zaprojektowany, aby reprezentować pewną wartość. Możesz ustawić, zaprogramować lub obliczyć tę wartość za pomocą omawianego w tym samouczku edytora.

Otwórz edytor szablonów etykiet

Możesz użyć istniejącego szablonu lub stworzyć nowy na potrzeby tego samouczka. Jeśli nie wiesz, jak to zrobić, albo chciałbyś dowiedzieć się podstawowych informacji na temat rozmiarów i pozycjonowania elementów na etykiecie, sprawdź ten samouczek najpierw.

Co to są wyrażenia

Jak już wspomniano, każdy element tekstowy, kod kreskowy lub kod dwuwymiarowy został zaprojektowany, aby reprezentować pewną wartość. Możesz chcieć stworzyć element tekstowy, który będzie działał jako etykieta statyczna, dynamicznie zmieniająca się reprezentacja zmiennej, lub możesz potrzebować zmodyfikować swoje dane przed wydrukiem, dodać pewien prefiks, obciąć tekst lub zmienić go na wielkie litery. Możliwe jest także łączenie statycznego tekstu, dynamicznych zmiennych (parametrów) i korzystanie jednocześnie z funkcji. Wszystkie te zadania można wykonać przy użyciu edytora wyrażeń wartości.

Otwórz edytor wyrażeń

Dodaj prosty element tekstowy do szablonu etykiety. Po aktywowaniu zauważ pole Value expression w panelu opcji elementu. Kliknij ikonę długopisu, aby otworzyć edytor. Jak widać, domyślna statyczna wartość tekstu jest ustawiona dla każdego nowego elementu tekstowego.

Kontrolki edytora wyrażeń

Przy użyciu edytora wyrażeń możesz dodawać i usuwać części wyrażenia jako bloki przy użyciu ikon plus i kosza. Po zakończeniu budowania wyrażenia powinieneś je zapisać za pomocą przycisku Potwierdź. Zwróć uwagę na znaczenie kolorów prezentowanych w edytorze. Pomagają one rozpoznać cel i typ każdego bloku. Możesz używać bloków tekstu statycznego, parametrów i funkcji. Podczas składania wyrażenia możesz również zobaczyć wyniki w podglądzie w czasie rzeczywistym na górze edytora wyrażeń.

Dodaj nowy blok do wyrażenia

Otwórz edytor wyrażeń i spróbuj dodać nowe wyrażenie tekstu statycznego, używając ikony plus obok ostatniego bloku w edytorze. Wprowadź losowy ciąg znaków w polu Static value i zatwierdź zaokrągloną ikoną plus. Zauważ, jak blok jest dodawany do wyrażenia i widoczny w podglądzie.

Usuń blok z wyrażenia

Otwórz edytor wyrażeń i spróbuj usunąć jeden z bloków. Aby to zrobić, najedź kursorem na blok, który chcesz usunąć. Zobaczysz czerwoną ikonę kosza obok bloku. Użyj tego przycisku kosza. Zauważ, jak blok jest usuwany z wyrażenia i z podglądu.

Tekst statyczny

Tekst statyczny jest głównie używany do drukowania stałych, niezmiennych elementów etykiety. Dobrym przykładem byłaby np. opis dynamicznego pola tekstowego lub kodu kreskowego. Jeśli chcesz nadać tytuł jednemu z pól etykiety, utwórz element tekstowy i stwórz dla niego wyrażenie tekstu statycznego, na przykład „Kod produktu„.

Utwórz pole tekstowe używane jako tytuł „Kod produktu”

  1. Dodaj nowy element tekstowy do sing _trash icon.
  2. Kliknij ikonę plus, aby dodać nowy blok wyrażenia, wybierając typ Tekst statyczny.
  3. Wprowadź Kod produktu w polu Static value.
  4. Kliknij zaokrągloną ikonę plus (zauważ nowy blok w edytorze i nową wartość w sekcji podglądu).
  5. Kliknij przycisk Potwierdź w edytorze.

Twoje pole tytułowe Kod produktu powinno być gotowe.

Parametry

Parametry reprezentują dynamiczne wartości w szablonie etykiety, które zmienią się dla każdego wydruku. Te zmienne będą dostarczane w zależności od metody zarządzania wydrukami, poprzez wprowadzenie danych w odpowiedni formularz Excela lub przesyłanie ich w formie JSON na punkt końcowy REST.

Podczas projektowania etykiety dodaj do szablonu parametry i nadaj im znaczące nazwy, które pozwolą łatwo je zidentyfikować w wyrażeniach wartości. Obowiązkowe jest także ustawienie wartości podglądowej dla każdego parametru. Ta wartość będzie wyświetlana jako wartość wyrażenia podczas projektowania szablonów i zostanie zastąpiona dostarczonymi danymi podczas użytku produkcyjnego. Należy pamiętać, że parametr nie może być pokazany jako oddzielny element na etykiecie. Zawsze jest częścią wyrażenia wartości jednego z elementów, takich jak elementy tekstowe lub kody kreskowe.

Utwórz kod kreskowy reprezentujący kod produktu

  1. Dodaj nowy element kodu kreskowego Code-39 do swojego szablonu i ustaw jakąś nazwę, abyś mógł go zidentyfikować.
  2. Dodaj nowy parametr tekstu w dolnym lewym panelu edytora (podwójna ikona T).
  3. Wybierz nowy parametr na liście i ustaw parametry w prawym panelu opcji elementu:
  • ustaw nazwę jako productCode
  • jako wartość podglądową wpisz dowolny kod
  1. Kliknij na wcześniej utworzony element kodu kreskowego i otwórz jego edytor wyrażeń wartości.
  2. Usuń domyślny blok tekstu za pomocą ikony kosza.
  3. Kliknij ikonę plus, aby dodać nowy blok wyrażenia, wybierając typ parametr....
  4. Otwórz listę Wybierz parametr. Powinieneś być w stanie zlokalizować swój parametr productCode.
  5. Kliknij zaokrągloną ikonę plus (zauważ nowy blok w edytorze i nową wartość w sekcji podglądu).
  6. Kliknij przycisk Potwierdź w edytorze.

Twoje pole kodu kreskowego Kod produktu powinno być gotowe i powinno prezentować wartość podglądową twojego parametru productCode.

Funkcje

Czasami konieczne będzie zmodyfikowanie danych przed ich wydrukowaniem na etykietach. Na przykład możesz musieć dodać przedrostek do każdego kodu kreskowego, aby system zarządzania magazynem (WMS) rozpoznał rodzaj pola. Możesz także chcieć ograniczyć długość tekstu do określonej liczby znaków. W przeciwnym razie, możesz chcieć sformatować datę, wydobyć z niej pewną część lub zmienić tekst na wielkie litery, małe litery lub zastosować kapitalizację do każdego słowa. Wszystkie te zadania można osiągnąć za pomocą wbudowanych funkcji edytora wyrażeń.

W przykładach powyżej stworzyliśmy element tekstu statycznego z tytułem „Kod produktu” oraz element kodu kreskowego zawierający rzeczywisty kod produktu. Zauważ, że element kodu kreskowego zamienia swoją wartość na wielkie litery. Ale co jeśli chcesz także wydrukować kod produktu czytelny dla ludzi i chcesz przedstawić kod wielkimi literami, ale nie jesteś pewien, czy otrzymasz dane, które są poprawnie przygotowane? Poniższy przykład rozwiązuje ten problem.

Utwórz element tekstu reprezentujący kod produktu wielkimi literami

Skorzystamy z parametru productCode z przykładu w poprzednim rozdziale. Jeśli nie podążałeś wcześniej za tym samouczkiem, dodaj nowy parametr tekstu o wspomnianej nazwie lub odwołaj się do poprzedniego rozdziału.

  1. Zasymuluj podgląd wartości parametru productCode jako nieprawidłowej. Ustaw jego wartość podglądową na jakiś małymi literami (na przykład: p100rm23).
  2. Dodaj nowy element tekstu do swojego szablonu i otwórz odpowiadający mu edytor wartości wyrażeń.
  3. Usuń domyślny blok tekstu za pomocą ikony kosza.
  4. Kliknij ikonę plus, aby dodać nowy blok wyrażenia, wybierając typ Funkcja....
  5. Z listy funkcji wybierz funkcję toUpperCase.
  6. Kliknij zaokrągloną ikonę plus (zauważ nowy blok w edytorze i nowe ostrzeżenie w sekcji podglądu).
  7. Blok funkcji pozwala dodać argumenty funkcji poniżej bloku. toUpperCase oczekuje tylko jednego argumentu, czyli tekstu, który powinien zostać zamieniony na wielkie litery.
  8. Kliknij przycisk plus poniżej argumentu value funkcji i wybierz typ parametru, a następnie wybierz swój parametr productCode.
  9. Kliknij zaokrągloną ikonę plus (zauważ nowy blok wartości poniżej bloku funkcji w edytorze i nową wartość w sekcji podglądu).
  10. Kliknij przycisk Confirm w edytorze.

Twoje pole tekstu Kod produktu powinno być gotowe i powinno prezentować wartość podglądową twojego parametru productCode zamienioną na wielkie litery.

Połączenie wszytkich elementów razem

Jak zauważyłeś, patrząc na zrzut ekranu na początku tego samouczka, wyrażenia wartości mogą być dość złożone i mogą łączyć wszystkie funkcje omówione w tym samouczku. Chociaż w większości przypadków prawdopodobnie nie będzie konieczne budowanie tak złożonych wyrażeń, dobrze jest wiedzieć, jak to zrobić. Z wiedzą, którą zdobyłeś w poprzednich sekcjach, spróbuj przygotować nowe pole tekstowe, które będzie korzystać z czterech parametrów. Ustaw nowe nazwy i wartości dla parametrów poniżej. Zwróć uwagę na kod produktu zapisany małymi literami oraz imię i nazwisko spedycjonera.

  1. productCode: p100rm23
  2. productDescription: Długi i bardzo szczegółowy opis, który nie może być wydrukowany w pełnej długości
  3. speditorFirstName: john
  4. speditorLastName: doe

Teraz przypomnijmy ci docelowe wyrażenie:

Chcemy stworzyć wyrażenie, które połączy i sformatuje dane, aby uzyskać wartość zawierającą

  1. pewne fragmenty tekstu statycznego,
  2. kod produktu ustawionego wielkimi literami,
  3. skrócony opis produktu do 15 znaków,
  4. kapitalizację pierwszej litery imienia spedycjonera,
  5. całe nazwisko spedycjonera ustawione wielkimi literami.

Utwórz element tekstu reprezentujący kod produktu wielkimi literami

Aby zbudować wyrażenie, postępuj zgodnie z krokami:

  1. Dodaj nowy element tekstu do swojego szablonu i otwórz odpowiadający mu edytor wartości wyrażeń.
  2. Usuń domyślny blok tekstu za pomocą ikony kosza.
  3. Dodaj statyczny tekst „Info: ” – zauważ spację na końcu.
  4. Dodaj funkcję toUpperCase i ustaw jej wartość na parametr productCode.
  5. Dodaj statyczny tekst „-” – zauważ spację na początku i na końcu.
  6. Dodaj funkcję abbreviate i ustaw jej wartość na parametr productDescription oraz maksymalną wartość rozmiaru na statyczną wartość 15.
  7. Dodaj statyczny tekst „From:” – zauważ spację na początku i na końcu.
  8. Dodaj funkcję capitalizeWords i ustaw jej wartość na parametr speditorFirstName.
  9. Dodaj statyczny tekst „ ” – jeden znak: spacja.
  10. Dodaj funkcję toUpperCase i ustaw jej wartość na parametr speditorLastName.
  11. Kliknij przycisk Potwierdź w edytorze.

Ostateczny efekt powinien wyglądać tak:

Info: P100RM23 - A long v... From: John DOE

Table of contents