Integracja z barmanami

Bartender rozszerza funkcjonalność drukowania możliwą w aplikacjach Tulip.

:::(Info) ()Pobierztest jednostkowy Bartender z biblioteki Tulip.:::

Bartender firmy Seagull Scientific to wiodący w branży klient drukowania, który jest szeroko stosowany w całym świecie produkcji, aby działać jako warstwa interfejsu między rozwiązaniami ERP / MES a stale rozszerzającą się listą drukarek, konfiguracją sieci i nie tylko.

Krótko mówiąc, Bartender obsługuje stronę drukarki tego równania i udostępnia punkty końcowe API, na które mogą trafić funkcje konektora Tulip w celu wydrukowania dokumentów.

Uwagi dotyczące sieci

Klient Bartender będzie zazwyczaj hostowany na serwerze (lub komputerze) w sieci internetowej obiektu. Zazwyczaj nie jest on dostępny z systemów zewnętrznych. Ponieważ Tulip działa w chmurze, musimy udostępnić twoją instancję barmana w chmurze.

Można to zrobić na kilka sposobów:

1. Host On-Prem Connector może działać jako tunel do sieci. Proces konfiguracji tych konektorów może być nieco skomplikowany i prawdopodobnie będzie wymagał wsparcia ze strony zespołu IT.
2. Urządzenie brzegowe Tulip podłączone do sieci może działać jako host konektora w sieci. Jest to zdecydowanie najłatwiejszy sposób na ustanowienie tego tunelu i nie powinien wymagać żadnej pomocy IT w konfiguracji. Urządzenie Edge MC można nabyć za 150 USD.
3. Tunel SSH można ustanowić w celu ujawnienia instancji barmana. Jest to najbardziej techniczna opcja i prawie na pewno będzie wymagać pomocy działu IT. Ten rodzaj tunelu nie ma żadnych wbudowanych zabezpieczeń rozwiązania zbudowanego przez Tulip.

Dodatkowo będziemy korzystać z oferty Print Portal od Bartender. Jest on dostępny tylko w planach "Automation" i "Enterprise".

Konfiguracja

:::(Info) (UWAGA) Ta procedura została stworzona jako część oryginalnego badania integracji z barmanem, funkcje dostarczone w aplikacji do testów jednostkowych mogą się nieznacznie różnić :::

Konfiguracja etykiety Bartender

W Bartenderze stworzyłem przykładową etykietę o nazwie Label Example.btw dokument ten jest dostępny do pobrania (załączony na dole tego artykułu). Ważną konfiguracją jest upewnienie się, że każde pole dynamiczne na etykiecie jest powiązane z danymi wejściowymi w formularzu szablonu. W tym przypadku zmieniłem również nazwy tych pól wejściowych, aby nasze klucze podczas korzystania z etykiety w Tulip były bardziej intuicyjne.

Na koniec zanotowałem adres IP mojego serwera Bartender.

Gdy Bartender jest skonfigurowany, powinieneś być w stanie uzyskać dostęp do Print Portal z dowolnego komputera w tej samej sieci pod adresem:

http://[ip serwera]/bartender

Gorąco polecam przetestowanie formularza z poziomu Print Portal, aby upewnić się, że instancja Bartender jest poprawnie skonfigurowana.

Konfiguracja Tulip

Uwaga: W tym przykładzie będę używał Edge MC jako hosta konektora.

1. Podłącz urządzenie Edge MC do sieci
2. Kliknij konfigurację łącznika

1. Ustaw pole "Running on" na host konektora swojego Edge MC.

1. Ustaw hosta na adres IP serwera Bartender.

1. Ustaw port na "5160" zgodnie ze wskazaniami serwera Bartender.

Funkcje łącznika

Drukowanie do Bartender wymaga pięciu funkcji konektora:

1. Pobierz listę folderów w instancji Bartender. Wybierz folder, z którego chcesz drukować.
2. Pobierz listę drukarek i wybierz drukarkę, na której chcesz drukować.
3. Pobierz listę plików w wybranym folderze. Wybierz plik, który chcesz wydrukować.
4. Wyślij żądanie do punktu końcowego drukowania, co zwróci identyfikator żądania.
5. Przekaż drukarkę, ścieżkę do etykiety, identyfikator żądania i

:::(Info) (UWAGA) Drukarki, foldery i dokumenty (1, 2 i 3 powyżej) nie zmienią się, jeśli konfiguracja Bartender nie ulegnie zmianie. Można je ustawić statycznie w aplikacjach produkcyjnych :::

Get Folders

Dane wejściowe: Uwaga

Dane wyjściowe: Lista folderów w wystąpieniu Bartender. Każdy folder ma 3 atrybuty:

• Unikalny identyfikator
• Nazwa
• Ścieżka - jeśli ten folder znajduje się w innych folderach, będzie to ścieżka do tego folderu.

Get Printers

Dane wejściowe: Uwaga

Dane wyjściowe: Lista drukarek skonfigurowanych w instancji programu Bartender.

Get Folder Items

Dane wejściowe: Unikalny identyfikator folderu z funkcji Get Folders.

Dane wyjściowe: Lista nazw plików w tym folderze i bezwzględna ścieżka do tego folderu.

Get RequestID

Dane wejściowe: Nazwa drukarki, bezwzględna ścieżka do pliku (ścieżka do folderu + nazwa pliku) i unikatowy identyfikator folderu (z funkcji Get Folders)

Dane wyjściowe: Wartość tekstowa, ten identyfikator odpowiedzi będzie używany podczas drukowania.

:::(Info) (UWAGA) Funkcja ta musi być wywoływana za każdym razem, gdy wykonywane jest drukowanie. Unikalny identyfikator wydruku jest wymagany dla każdego zadania drukowania. :::

Print

Dane wejściowe: Nazwa drukarki, bezwzględna ścieżka do pliku (ścieżka folderu + nazwa pliku) i unikalny identyfikator folderu (z funkcji Get Folders), identyfikator odpowiedzi (z Get RequestID) i dowolne z dynamicznych pól w etykiecie

Dane wyjściowe: Wartość tekstowa wskazująca, czy wydruk się powiódł.

:::(Info) (UWAGA) Pola dynamiczne w tej etykiecie muszą być zgodne z polami w konfiguracji etykiety w programie Bartender. Przykładowa funkcja Print jest skonfigurowana do pracy z plikiem Label Example.btw, który jest dostarczany wraz z Library Unit Test. :::