Syrve Arrivals. Wcześniejsza integracja
Ponieważ Syrve Arrivals jest teraz natywnie zintegrowany z aplikacją Syrve, ten artykuł staje się przestarzały. Proszę odnieść się do zaktualizowanego artykułu Syrve Arrivals, aby poznać szczegóły uproszczonej natywnej integracji, która nie wymaga dodatkowych aplikacji i jest zarządzana z jednego miejsca.
Przegląd
Aplikacja Syrve Arrivals to elektroniczna tablica wyświetlająca przeznaczona do automatyzacji elektronicznej kolejki. Na tablicy Syrve Arrivals Twoi goście mogą sprawdzić status swojego zamówienia oraz czas odbioru. Użycie Syrve Arrivals wygląda następująco:
- Gość składa zamówienie i otrzymuje paragon z numerem.
- System przesyła zamówienie do kuchni i wyświetla jego numer na tablicy.
- Gdy zamówienie jest przygotowane, kucharz oznacza je jako gotowe, co jest również widoczne na tablicy.
- Gość widzi, że jego zamówienie jest gotowe i je odbiera.
- Menedżer oznacza zamówienie jako wydane i znika ono z tablicy.
Tablica może wyświetlać następujące szczegóły zamówienia: numer, status, czas odbioru, czas oczekiwania, imię klienta oraz jego numer telefonu.
Aplikacja wygląda jak strona internetowa, gdzie możesz przejść do dowolnego szablonu tablicy. Szablon definiuje wygląd tablicy: układ i kolorystykę. Możesz skonfigurować aplikację za pomocą specjalnego pliku konfiguracyjnego.
Wymagania systemowe
Przed instalacją i użyciem Syrve Arrivals upewnij się, że:
- Twoja wersja Syrve to 4.3.2 lub nowsza.
- Używasz modułu Kitchen Screen (KDS) lub Syrve Delivery jako części systemu Syrve. Możesz używać Syrve Arrivals tylko jeśli posiadasz przynajmniej jeden z tych modułów.
- Zainstalowana jest wersja Net.Framework 4.5 lub nowsza (Windows XP i POS Ready 2009 nie są wspierane).
Urządzenia, które chcesz używać z Syrve Arrivals oraz terminale Syrve POS znajdują się w tej samej sieci.
Instalacja i uruchomienie
Aby zainstalować Syrve Arrivals, wykonaj następujące kroki:
- Sprawdź, czy Twoje Syrve Office posiada licencję Syrve Arrivals_v3 (Web FrontApi). Każde połączenie (uruchomiona przeglądarka) wymaga licencji.
- Pobierz aplikację z ftp://arrivals:wjpfei35@ftp.Syrve.ru i skopiuj do dowolnego katalogu.
- Zainstaluj wtyczkę Resto.Front.Api.WebServer dla Syrve POS. W tym celu skopiuj folder wtyczki do C:\Program Files\syrve\syrve\Front.Net\Plugins. Użyj pliku konfiguracyjnego config.json, aby połączyć Syrve Arrivals z WebApi. Znajdziesz ten plik w katalogu Syrve Arrivals. Szczegóły dotyczące parametrów konfiguracji znajdziesz w kolejnym rozdziale.
Aby otworzyć Syrve Arrivals, uruchom plik mongoose-windows.exe w katalogu aplikacji. Spowoduje to otwarcie strony powitalnej Syrve Arrivals w domyślnej przeglądarce, gdzie możesz przejść do wybranego szablonu.
Konfiguracja aplikacji
Główne ustawienia Syrve Arrivals znajdują się w pliku config.json, który jest umieszczony w katalogu aplikacji.
Poniższa tabela zawiera opis parametrów. Zobacz także plik documentation.json.
| Parametr | Opis | Wartość domyślna |
| webServiceUrl | Adres WebApi | http://localhost:9042 |
| deliveryScheme | Procedura realizacji dostawy. Ten parametr definiuje, które statusy należy sprawdzać. Możesz określić:
| Delivery |
| orderType | Typy zamówień wyświetlane w Syrve Arrivals. Możliwe wartości:
| Ordinary, Pickup, Courier |
| showStatus | Status zamówienia wyświetlany na tablicy. Określony jest ID statusu KDS. | 0 |
| completeStatus | Status zamówienia niewyświetlany na tablicy. Określony jest ID statusu KDS. | 5 |
| hideStatus | Status gotowego zamówienia. Określony jest ID statusu KDS. | 6 |
| inProgressStatusName | Format statusu dla zamówienia w trakcie realizacji. Zawiera dwa parametry: typ i format. | |
| type | Typ formatu wyjścia statusu. Możliwe wartości:
| ServeTime |
| format | Format wyjścia statusu. Zależy od typu formatu (parametr type). Na przykład, dla typów wyjścia czasu użyj [HH:mm], a dla zwykłego tekstu (SpecialText) – podaj ten tekst. | HH:mm |
| completeStatusName | Tekst wyświetlany, gdy zamówienie jest gotowe. | Gotowe |
| orderNumberLength | Długość numeru zamówienia. | 2 |
| leadOrderNumberSymbol | Znak używany na początku numeru zamówienia, jeśli ma mniej znaków niż orderNumberLength. | 0 |
| ordersRefreshTimeout | Okres odświeżania tablicy w sekundach. | 15 |
| imageChangeTimeout | Okres zmiany obrazu w sekundach. | 30 |
| notResponseTimeout | Limit czasu odpowiedzi POS w sekundach. | 30 |
| splashChangeTimeout | Interwał zmiany w sekundach dla wyskakujących okien gotowych zamówień. | 4 |
| splashShowTimeout | Czas wyświetlania wyskakujących okien gotowych zamówień. | 3 |
| completeStatusImage | Obraz gotowego zamówienia. Obraz jest wyświetlany, jeśli określono jego plik. Jeśli puste, używana jest wartość completeStatusName. | complete.png |
| notResponseImage | Obraz błędu POS. | error.png |
| licenseLimitImage | Obraz błędu numeru licencji. | license-error.png |
| logoImage | Obraz logo. | logo.png |
| backgroundImage | Obraz tła. | Wartość pusta |
| orderCompleteSound | Dźwięk gotowego zamówienia. Określ plik MP3. | sound.mp3 |
| showTables | Numery stolików wyświetlanych zamówień. Kilka stolików należy oddzielić przecinkiem. Pusta linia: wyświetl wszystkie stoliki. | |
| hideTables | Numery stolików niewyświetlanych zamówień. Kilka stolików należy oddzielić przecinkiem. Pusta linia: wyświetl wszystkie stoliki. | |
| showOrderSources | Lista źródeł zamówień wyświetlanych na ekranie. Kilka źródeł należy oddzielić przecinkiem. Pusta linia: wyświetl wszystkie źródła. | |
| hideOrderSources | Lista źródeł zamówień niewyświetlanych na ekranie. Kilka źródeł należy oddzielić przecinkiem. Pusta linia: wyświetl wszystkie źródła. |
Kody statusów zamówień (ID) używane w konfiguracji:
- 0 - W kolejce.
- 1 - Czas na gotowanie.
- 2 - Gotowanie.
- 3 - Gotowanie2.
- 4 - Gotowanie3.
- 5 - Gotowanie4.
- 6 - Gotowe.
- 7 - Podane.
- 8 - Usunięte.
Wszystkie obrazy używane w pliku konfiguracyjnym Syrve Arrivals są przechowywane w folderze content. Znajdziesz tam logotypy, obrazy tła, dźwięki oraz inne pliki, które mogą być używane we wszystkich szablonach. Prosimy nie korzystać z zewnętrznych źródeł plików, nie są one obsługiwane.
Katalog content\images zawiera obrazy reklamowe zmieniające się na tablicy wyświetlacza. Prosimy nie używać tego folderu do innych obrazów, takich jak logotypy, obrazy tła itp.
Katalog content\images-fullscreen zawiera obrazy zmieniające się w trybie pełnoekranowym, gdy brak jest zamówień.
Dla wygody możesz tworzyć dodatkowe foldery w katalogu content. W takim przypadku określ odpowiednią ścieżkę w pliku config.json. Załóżmy, że utworzyłeś folder logo w katalogu content i umieściłeś tam plik logo.png. Wtedy musisz podać ścieżkę: logo\logo.png.
Konfiguracja szablonu
W Syrve Arrivals mamy kilka gotowych szablonów. Znajdują się one w katalogu templates. Każdy z nich ma swój folder o tej samej nazwie. Każdy folder zawiera:
- Plik HTML. Definiuje układ strony wyświetlanej na tablicy.
- Plik CSS z opisem układu pliku HTML.
Możesz użyć dowolnego z gotowych szablonów lub stworzyć nowy.
Aby stworzyć nowy, możesz skopiować istniejący katalog szablonu i nadać mu nazwę według własnego uznania. Następnie edytuj pliki katalogu zgodnie z Twoimi standardami korporacyjnymi.