Na końcu tego samouczka znajduje się gotowy plik z pełnym kodem funkcji dodatkowej, potrafiący wyświetlać błędy oraz przygotowujący dane do wysyłki pod względem znaków specjalnych. Jednak dla lepszego zrozumienia przedstawimy najpierw kluczowe fragmenty kodu w wersji podstawowej.

Tworzymy definicję funkcji

Aby utworzyć nową funkcję dodatkową, otwórz w systemie Comarch ERP Optima okno Cennik, następnie otwórz wspomniane wcześniej okno Konfiguracja funkcji dodatkowych i utwórz funkcję o nazwie Drukuj etykietę towaru

Dane etykiety JustLabel

W celu zbudowania przykładu, musimy najpierw zdefiniować pewne dane dotyczące konfiguracji etykiety, jaką chcemy wydrukować.

• kolejka drukowania – kolejka odpowiadająca za wydruki na docelowej drukarce, w naszym przypadku drukarkę nazwaliśmy Mock, a kolejka drukowania to pq_Mock. Musisz zamienić tę wartość nazwą kolejki drukowania, którą chcesz wykorzystać w swoim środowisku.
• nazwa szablonu etykiety – ponieważ nasza etykieta będzie odpowiadała za wydruk danych dot. towaru, nazwiemy ją towar
• placeholdery zastosowane w etykiecie to nazwy zmiennych, które będą zastępowane realnymi danymi. Wstępnie użyjemy jednego pola tekstowego używającego jednego placeholdera:
  
  • code – kod produktu

Przygotuj testową etykietę

Stwórz nowy, testowy szablon etykiety. Nazwij go towar. Na szablonie umieść pole tekstowe, którego wartością będzie placeholder {code}. Możesz także zbudować bardziej rozbudowane wyrażenie, łącząc statyczny tekst i placeholder, np.

„Kod wybranego produktu: [(${code})]„.

Sekcja SQL

Sekcja SQL naszej funkcji dodatkowej rozpoczyna się od deklaracji jej początku, czyli od [SQL]. W następnej linii widzimy deklarację parametru, którego wartością jest aktualnie aktywny obiekt z przeglądarki okna Comarch Optima. Funkcja z założenia będzie wykonywana z okna Towarów, stąd zapytanie kierowane jest do tabeli Towary. Ostatnim elementem sekcji jest definicja zapytania SQL, wykorzystującego zdefiniowany wcześniej parametr.

[SQL]
@PAR ?@HX|Zaznaczenia|Zaznaczenia:1@? PAR@
Select Twr_TwrId From cdn.Towary where {Zaznaczenia(Twr_TwrId, 1)}

Klikając przycisk wykonania funkcji dodatkowej, aplikacja wykona powyższe zapytanie, a jego wyniki będą dostępne w sekcji JavaScript w obiekcie Recordset. Jak da się zauważyć, celem powyższego zapytania jest uzyskanie wartości id zaznaczonego towaru.

Sekcja JS

Sekcja JavaScript może być napisana w bardzo różny sposób, zależny od programisty. Poniżej przedstawiamy tylko przykładowy, uproszczony sposób implementacji, który powinien dac Ci wyobrażenie jak zrealizować podstawowe zadanie. Poniższy przykład został rozbudowany i uzupełniony o dodatkowe funkcje w ostatniej sekcji tego samouczka.

Rozpoczynamy sekcję JavaScript poprzez znacznik [JS].

Musimy mieć na uwadze, że celem tej sekcji jest wykorzystanie danych z obiektu Recordset do budowy żądania REST przesyłanego do JustLabel. Utworzyliśmy sobie zmienną pomocniczą productPresent która poinformuje nast w dalszej części programu, czy odnaleziono id produktu, oraz zmienną jsondata w której zapiszemy ciało obiektu JSON, przesyłanego do JustLabel w żądaniu drukowania.

[JS]
var jsondata = '';
var productPresent = false;

while(!Recordset.EOF) \{
    productPresent = true;
    var towarId = Recordset.Fields(0).Value;
    var rTowar = Session.CreateObject("CDN.Towary").Item("Twr_TwrID=" + towarId );
    jsondata = '{"template":{"name":"towar","options":[{"numberOfCopies":1,"placeholderValues":{"code":"'
               + rTowar.Kod + '"}}]}}';
    Recordset.moveNext();
\}

Pętla while(!Recordset.EOF) nie wykona się ani razu, jeżeli żaden produkt nie został odnaleziony. W przeciwnym wypadku, oznaczamy productPresent jako true i pobieramy za pomocą wbudowanych funkcji Optimy obiekt Towar.

var rTowar = Session.CreateObject("CDN.Towary").Item("Twr_TwrID=" + towarId);

Do obiektu jsondata zapisywane są wartości z obiektu rTowar, przyporządkowane do nazw placeholderów zdefinowanych w szablonie etykiety towar. W bardziej czytelnej formie, JSON jaki próbujemy uzyskać odpowiada schematowi przedstawionemu poniżej. Zwróć uwagę na poszczególne wartości, które pokrywają się z założeniami tego samouczka, zdefiniowanymi w sekcji Dane etykiety JustLabel

• nazwa szablonu etykiety – towar
• nazwa wykorzystanego w etykiecie placeholdera – code

W aktualnym przykładzie wykorzystujemy jeden placeholder. W pełnym przykładzie jest ich więcej i są wymienione jako kolejne pola obiektu placeholderValues.

{
  "template": {
    "name": "towar",
    "options": [
      {
        "numberOfCopies": 1,
        "placeholderValues": {
          "code": "rTowar.Kod"
        }
      }
    ]
  }
}

Kolejnym etapem będzie wysłanie żądania na określony endpoint. W tym celu należy zbudować odpowiedni adres URL mikroserwisu. Zakładając, że aplikacja JustLabel uruchomiona jest na tej samej maszynie co aplikacja Comarch ERP Optima, adresem hosta będzie tutaj localhost, a standardowym portem, na którym aplikacja nasłuchuje jest 5987. W następnej kolejności należy podać adres entpointu print, a po nim nazwę kolejki drukowania, która w naszym przykładzie nosi nazwę pq_Mock. Ostateczny adres URL przedstawiono we fragmencie kodu:

if(productPresent) \{
    var url = 'http://localhost:5987/print/pq_Mock';
    var xmlhttp = new ActiveXObject("MSXML2.XMLHTTP.6.0");
    xmlhttp.open("POST", url, false);
    xmlhttp.setRequestHeader("Content-Type", "application/json; charset=UTF-8");
    xmlhttp.send(jsondata);
\}

Powyższy kod przesyła żądanie POST na zdefiniowany adres URL, przekazując jako wartość JSON zbudowany w poprzednim kroku.

Opis funkcji dodatkowej

Na początku warto określić czemu służy dana funkcja. Optima udostępnia składnię, która to umożliwia. Dodajmy opis funkcji na początku skryptu.

/*<COM_DOK>
<OPIS>
   Funkcja wysyłająca request drukowania etykiety z towarem
</OPIS>
</COM_DOK>
*/