Instrukcje wstępnej konfiguracji kiosku

Przewodnik instalacji i konfiguracji oprogramowania 3S

Spis treści

• Przygotowanie do instalacji
• Wymagania systemowe i ustawienia systemu operacyjnego
  • Krok 1: Sprawdź wersję systemu operacyjnego
  • Krok 2: Sprawdź status aktywacji Windows
  • Krok 3: Sprawdź instalację sterowników
  • Krok 4: Wyłącz Kontrolę Konta Użytkownika (UAC)
  • Krok 5: Ustawienia zapory systemu Windows
  • Krok 6: Ochrona antywirusowa
  • Krok 7: Skonfiguruj ustawienia oszczędzania energii
  • Krok 8: Wyłącz tryb uśpienia
  • Krok 9: Włącz wyświetlanie ukrytych plików i rozszerzeń plików
  • Krok 10: Skonfiguruj datę i godzinę
  • Krok 11: Skonfiguruj ustawienia regionalne
• Instalacja i konfiguracja nowego kiosku samoobsługowego (SSK)
  • Przygotowanie do instalacji
  • Instalacja pakietu oprogramowania 3S
  • Konfiguracja pakietu oprogramowania 3S
  • Konfiguracja pliku konfiguracyjnego oprogramowania 3S
  • Ostateczne ustawienia pakietu oprogramowania 3S
• Aneks 1: Lista kontrolna
• Aneks 2: Parametry konfiguracji oprogramowania 3S
• Aneks 3: Parametry konfiguracji wtyczek
• Aneks 4: Wymagania dotyczące elementów projektu kiosku

Przygotowanie do instalacji

Ważne

Przed rozpoczęciem instalacji kiosku samoobsługowego (SSK) upewnij się, że spełnione są następujące wymagania:

1. Sprzęt SSK jest sprawny i podłączony do zasilania.
2. Kiosk ma dostęp do internetu. W celu połączenia kiosku zapoznaj się z instrukcją obsługi dołączoną do zestawu dostawczego lub stroną internetową producenta.
3. Wszystkie komponenty sprzętu kasowego (rejestratory fiskalne, urządzenia do przechowywania fiskalnego, drukarki paragonów) są podłączone, skonfigurowane i aktywowane zgodnie z instrukcjami producenta sprzętu.
4. Akceptacja płatności jest podłączona, skonfigurowana i zweryfikowana przez specjalistów bankowych.
5. Dostarczono i zatwierdzono w pełni wypełnioną listę kontrolną z klientem.
6. SyrvePOS Front jest zainstalowany i skonfigurowany.

Wymagania systemowe i ustawienia systemu operacyjnego

1 Sprawdź wersję systemu operacyjnego

Upewnij się, że na komputerze kontrolującym zainstalowany jest kompatybilny system operacyjny (Windows 10 x64 lub nowszy).

Jeśli wcześniej zainstalowany system nie spełnia powyższych wymagań, zainstaluj ponownie system operacyjny na komputerze.

Uwaga

Przewodnik instalacji Windows 10 jest dostępny na oficjalnej stronie Microsoft.

2 Sprawdź status aktywacji Windows

Sprawdź status i aktywuj system operacyjny, jeśli to konieczne. Aby sprawdzić status aktywacji w Windows 10:

1. Kliknij przycisk Start
2. Wybierz Ustawienia z menu
3. W sekcji Aktualizacja i zabezpieczenia wybierz Aktywacja

Status aktywacji pojawi się obok pozycji Aktywacja. Jeśli to konieczne, aktywuj system operacyjny.

3 Sprawdź instalację sterowników

Upewnij się, że wszystkie sterowniki są poprawnie zainstalowane w systemie operacyjnym:

1. Kliknij prawym przyciskiem myszy na ikonę Start, aby otworzyć menu kontekstowe
2. Wybierz Menedżer urządzeń z menu kontekstowego
3. Zweryfikuj, czy lista zainstalowanych urządzeń nie zawiera żadnych żółtych ikon ostrzegawczych
4. Jeśli to konieczne, użyj oficjalnych stron producentów sprzętu lub Centrum aktualizacji Windows, aby uzyskać i zainstalować najnowsze wersje sterowników

Uwaga

Przewodnik instalacji sterowników dla systemów operacyjnych Windows 10 i Windows 11 jest dostępny na stronie Microsoft.

4 Wyłącz Kontrolę Konta Użytkownika (UAC)

Oprogramowanie kiosku może działać poprawnie tylko z wyłączoną Kontrolą Konta Użytkownika w systemie operacyjnym Windows.

Aby wyłączyć Kontrolę Konta Użytkownika:

1. Otwórz aplikację Panel sterowania, uruchamiając ją z menu Start, w sekcji System Windows lub używając narzędzia wyszukiwania z hasłem "Control"
2. W sekcji Konta użytkowników wybierz Zmień ustawienia Kontroli konta użytkownika
3. W otwartym oknie ustaw suwak na najniższą pozycję "Nigdy nie powiadamiaj" i potwierdź zmianę, klikając OK

5 Ustawienia zapory systemu Windows

Ważne

W niektórych przypadkach włączona zapora może uniemożliwiać przesyłanie zamówień do Syrve, gdy używana jest elektroniczna kolejka. Wyłączenie zapory może być wymagane dla prawidłowego działania. Przed jej wyłączeniem oceń ryzyko związane z obniżoną ochroną systemu operacyjnego.

Instrukcje dotyczące wyłączania zapory systemu Windows są dostępne na stronie wsparcia Microsoft.

6 Ochrona antywirusowa

Gwarantujemy brak wirusów w pakiecie instalacyjnym. W przypadku pytań dotyczących oprogramowania antywirusowego innych firm prosimy o kontakt z pomocą techniczną producenta.

7 Skonfiguruj ustawienia oszczędzania energii

Aby kiosk działał poprawnie, skonfiguruj ustawienia oszczędzania energii i trybu uśpienia.

Aby skonfigurować ustawienia oszczędzania energii:

1. Kliknij prawym przyciskiem myszy na ikonę Start, aby otworzyć menu kontekstowe
2. Wybierz Menedżer urządzeń z menu kontekstowego
3. Rozwiń sekcję Kontrolery uniwersalnej magistrali szeregowej

Dla każdego urządzenia w tej sekcji:

1. Z menu kontekstowego, klikając prawym przyciskiem myszy na wybrane urządzenie, wybierz Właściwości
2. W zakładce Zarządzanie energią odznacz opcję "Zezwalaj komputerowi na wyłączanie tego urządzenia w celu oszczędzania energii"

Rozwiń sekcję Urządzenia interfejsu użytkownika i wykonaj te same ustawienia dla każdego urządzenia.

8 Wyłącz tryb uśpienia

Aby wyłączyć tryb uśpienia:

1. Kliknij prawym przyciskiem myszy na ikonę Start, aby otworzyć menu kontekstowe
2. Wybierz System z menu kontekstowego
3. Wybierz sekcję Zasilanie i uśpienie
4. Dla parametru Ekran wybierz Nigdy z listy rozwijanej
5. Ustaw tę samą wartość dla parametru Uśpienie
6. W tej samej sekcji otwórz Dodatkowe ustawienia zasilania i wybierz plan zasilania Wysoka wydajność

Uwaga

W niektórych edycjach systemu operacyjnego poniższe parametry mogą nie być dostępne w ustawieniach oszczędzania energii.

Dostosuj ustawienia dla wybranego planu zasilania:

1. Wybierz Zmień ustawienia planu, a następnie Zmień zaawansowane ustawienia zasilania
2. W zakładce Zaawansowane ustawienia znajdź sekcję Dysk twardy, zlokalizuj parametr Wyłącz dysk twardy po i ustaw go na 0
3. W tej samej zakładce, w sekcji Ustawienia USB, ustaw Ustawienie selektywnego zawieszania USB na Wyłączone dla wszystkich pozycji

9 Włącz wyświetlanie ukrytych plików i rozszerzeń plików

Aby włączyć wyświetlanie ukrytych plików i rozszerzeń plików:

1. Kliknij prawym przyciskiem myszy na ikonę Start, aby otworzyć menu kontekstowe
2. Wybierz Eksplorator plików z menu kontekstowego
3. W otwartym oknie wybierz zakładkę Widok
4. Zaznacz pola Rozszerzenia nazw plików i Ukryte elementy

Jeśli te parametry nie są dostępne w menu:

1. Kliknij prawym przyciskiem myszy na ikonę Start, aby otworzyć menu kontekstowe
2. Wybierz Eksplorator plików z menu kontekstowego
3. W zakładce Widok kliknij Opcje i wybierz Zmień opcje folderów i wyszukiwania
4. Przejdź do zakładki Widok i wykonaj następujące czynności:
   • Zaznacz opcję Pokaż ukryte pliki, foldery i dyski
   • Odznacz opcję Ukryj rozszerzenia znanych typów plików

10 Skonfiguruj datę i godzinę

Upewnij się, że data, godzina i strefa czasowa w ustawieniach systemu operacyjnego są ustawione poprawnie zgodnie z Twoją lokalizacją.

1. Kliknij przycisk Start
2. Wybierz Ustawienia z menu
3. W sekcji Czas i język otwórz Data i godzina i upewnij się, że aktualny czas i strefa czasowa są ustawione poprawnie; w razie potrzeby zmień ustawienia

11 Skonfiguruj ustawienia regionalne

W ustawieniach regionalnych Windows należy zwrócić uwagę na następujące parametry:

• Ustawienia formatu daty i godziny
• Ustawienia formatu liczb
• Ustawienia walutowe

Aby sprawdzić i skonfigurować ustawienia regionalne:

1. Kliknij przycisk Start
2. Wybierz Ustawienia z menu
3. W sekcji Czas i język otwórz Region
4. Przejdź do Dodatkowe ustawienia daty, godziny i regionu
5. Wybierz Region; w otwartym oknie dialogowym Region sprawdź poprawność ustawionych formatów daty
6. Kliknij Dodatkowe ustawienia
7. W zakładce Liczby otwartego okna dialogowego upewnij się, że wartości symboli dziesiętnych są ustawione zgodnie z Twoim regionem
8. Następnie w zakładce Waluta sprawdź poprawność ustawień walutowych dla Twojego regionu

Instalacja i konfiguracja nowego kiosku samoobsługowego (SSK)

1. Przygotowanie do instalacji

Ważne

Przed zainstalowaniem oprogramowania 3S musisz zainstalować i skonfigurować Syrve Front. Utwórz nowy folder na dysku C:\ i skopiuj wszystkie pliki z nośnika instalacyjnego lub zewnętrznego zasobu określonego przez dewelopera oprogramowania 3S.

Zawartość pakietu instalacyjnego:

• Oprogramowanie 3S
• Wtyczka do pracy z Syrve
• Edytor tekstu Notepad++
• AnyDesk

2. Instalacja pakietu oprogramowania 3S

Aby zainstalować pakiet oprogramowania 3S:

1. Otwórz folder z plikami instalacyjnymi i uruchom plik install_3s.exe jako administrator. (Kliknij prawym przyciskiem myszy na wybrany plik i wybierz "Uruchom jako administrator" z menu kontekstowego)
2. Postępuj zgodnie z instrukcjami kreatora instalacji
3. W otwartym oknie aktywacji wprowadź nazwę kiosku określoną w checkliście klienta w polu "Lokalizacja SSK" i kliknij Wyślij

Ważne

Nazwa musi być podana w formacie: Klient_Restauracja_Kiosk#

4. Po pojawieniu się komunikatu o pomyślnej aktywacji, zakończ instalację

3. Konfiguracja pakietu oprogramowania 3S

Wypełnij plik konfiguracyjny wtyczki Resto.Front.Api.AnSoftPlugin.dll.config

Aby skonfigurować wtyczkę:

1. Otwórz folder na dysku lokalnym komputera, gdzie zainstalowano pakiet oprogramowania 3S (domyślnie: C:\3S) i znajdź podfolder "Resto.Front.Api.AnSoftPlugin"
2. Kliknij prawym przyciskiem myszy na plik Resto.Front.Api.AnSoftPlugin.dll.config i wybierz Edytuj za pomocą Notepad++ z menu kontekstowego

Ważne

Nie używaj standardowych edytorów tekstu Windows (Notatnik, Wordpad) do edycji plików konfiguracyjnych.

Dla następujących parametrów pliku konfiguracyjnego, określ wartości uzyskane od klienta w checkliście (zobacz Załącznik 1):

Kod PIN użytkownika:

<setting name="Pin" serializeAs="String"><value>0000</value></setting>

Nazwa sekcji kiosku:

<setting name="Section" serializeAs="String"><value>Section</value></setting>

Typ płatności dla kiosku:

<setting name="PaymentType" serializeAs="String"><value>Kiosk Payment</value></setting>

Lista dodatkowych parametrów do bardziej szczegółowej konfiguracji wtyczki zgodnie z wymaganiami klienta i procesami biznesowymi znajduje się w Załączniku 3.

Zapisz wprowadzone zmiany.

Skopiuj folder "Resto.Front.Api.AnSoftPlugin" do folderu wtyczek Syrve Front znajdującego się pod adresem:

C:\Program Files\Syrve\SyrveRMS\Front.Net\Plugins

Ponowne uruchomienie usługi SyrvePOS Front

Aby podłączyć skonfigurowaną wtyczkę, musisz ponownie uruchomić usługę aplikacji SyrvePOS Front:

1. W prawym dolnym rogu paska zadań kliknij strzałkę; otworzy się okno z aplikacjami działającymi w tle
2. Na pasku zadań znajdź ikonę Agent, kliknij na nią prawym przyciskiem myszy
3. Wybierz "Zatrzymaj"
4. Poczekaj, aż usługa całkowicie się zatrzyma i uruchom ją ponownie

Weryfikacja działania wtyczki

Istnieją dwie opcje weryfikacji działania wtyczki:

Opcja 1: Za pomocą logów wtyczki

Logi wtyczki znajdują się w standardowym folderze Syrve Front dla agenta:

C:\Windows\ServiceProfiles\Resto.CashServer.Svc\AppData\Roaming\Syrve\CashServer\Logs\plugin-Resto.Front.Api.AnSoftPlugin.log

Jeśli plik został utworzony i zawiera poniższe linie, wtyczka uruchomiła się pomyślnie:

Rejestrowanie kanału ipc...
Zainicjalizowano jako wtyczka V8.
Kontekst wtyczki zainicjalizowany, tworzenie instancji wtyczki...
IPAddress: 127.0.0.1
port: 9696
3S: Serwer uruchomiony
Utworzono instancję "Resto.Front.Api.AnSoftPlugin.AnSoftPlugin"

Opcja 2: Za pomocą sprawdzenia portu

1. Kliknij prawym przyciskiem myszy na przycisk Start
2. Wybierz Menedżer zadań z menu kontekstowego
3. Otwórz kartę Wydajność i kliknij link Otwórz monitor zasobów
4. W oknie Monitora zasobów otwórz kartę Sieć
5. Rozwiń listę Nasłuchujące porty i sprawdź, czy port 9696 jest obecny w kolumnie Port

Jeśli jest nieobecny lub pojawi się komunikat o błędzie, skontaktuj się z pomocą techniczną AnSoft: support@ansoftgroup.ru

4. Konfiguracja pliku konfiguracyjnego oprogramowania 3S

Aby skonfigurować plik konfiguracyjny:

1. Otwórz folder na dysku lokalnym komputera, gdzie zainstalowano pakiet oprogramowania 3S (domyślnie: C:\3S) i otwórz plik Settings.config w edytorze Notepad++ (kliknij prawym przyciskiem myszy na wybrany plik i wybierz Edytuj za pomocą Notepad++ z menu kontekstowego)
2. Edytuj wartości następujących parametrów:

Parametr	Opis	Przykład
template	Nazwa szablonu dostarczona przez AnSoft	<template>Template</template>
timeOpen	Czas otwarcia zmiany kasowej na kiosku	<timeOpen>00:05:00</timeOpen>
timeClose	Czas zamknięcia zmiany kasowej na kiosku	<timeClose>23:59:00</timeClose>
menuUpdateTime	Czas rozpoczęcia aktualizacji menu na kiosku	<menuUpdateTime>23:59:00</menuUpdateTime>
ApiLogin	Login API klucza transportowego	<ApiLogin>00-0000000</ApiLogin>
Organizations	GUID organizacji powiązanej z kluczem transportowym	<Organizations>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</Organizations>

Lista dodatkowych parametrów do bardziej szczegółowej konfiguracji aplikacji zgodnie z wymaganiami klienta i procesami biznesowymi znajduje się w Załączniku 2.

5. Końcowe ustawienia pakietu oprogramowania 3S (SyrveKiosk)

Ustawienie wymaganej lokalizacji

1. Kliknij prawym przyciskiem myszy na przycisk Start
2. Wybierz Eksplorator plików z menu kontekstowego
3. Otwórz folder C:\3S
4. Znajdź foldery ustawień lokalizacji (EN, FR, AZ) i podobne, i usuń wszystkie lokalizacje, których nie używasz

Umieszczanie banerów i elementów menu

Banery i inne materiały promocyjne muszą spełniać wymagania określone w Załączniku 4 tego przewodnika.

Aby zainstalować materiały promocyjne na kiosku:

1. Skopiuj zdjęcia dostarczone przez klienta do folderu: C:\iiko\banner\slider
2. Skopiuj materiały wideo dostarczone przez klienta do folderu: C:\iiko\banner\video

Uwaga

Zdjęcia i filmy, które nie spełniają tych wymagań, mogą być zniekształcone, mogą się nie wyświetlać lub mogą spowalniać ładowanie interfejsu.

Początkowa lub wymuszona aktualizacja menu

Aby ręcznie rozpocząć aktualizację lub początkowe wypełnienie menu, użyj skryptu:

C:\3S\biz_update.bat

Automatycznie zamyka 3S, jeśli to konieczne, rozpoczyna aktualizację, a po jej zakończeniu ponownie uruchamia program 3S.

Konfiguracja zakończona

Konfiguracja pakietu oprogramowania 3S została zakończona!

Załącznik 1: Lista kontrolna

Lista kontrolna powinna być uzyskana od klienta przed instalacją i powinna zawierać następujące informacje:

Element	Wartość
Nazwa klienta
Nazwa restauracji/lokalizacji
Numer kiosku
Kod PIN użytkownika
Nazwa sekcji
Nazwa typu płatności
Login API
GUID organizacji
Czasy otwarcia i zamknięcia zmiany kasowej
Nazwa szablonu

Załącznik 2: Parametry konfiguracji oprogramowania 3S

Parametr	Cel
lang	Wartości True/False. Parametr pozwala wyłączyć wyświetlanie przycisku wyboru języka dla interfejsu i menu. True = przycisk jest wyświetlany, False = nie.
locale	Format wartości ru-RU, en-GB, itp. Definiuje domyślną lokalizację i język dla interfejsu i menu.
keyPath	Ścieżka do pliku klucza do aktywacji panelu administracyjnego. Przykład: D:\\key.txt
template	Nazwa szablonu dostosowania dla klienta. Określona w żądaniu połączenia.
frontIp	Domyślnie 127.0.0.1, zmieniane, jeśli 3S i Syrve Front są na różnych komputerach w tej samej sieci lokalnej. W takim przypadku należy podać adres IP komputera, na którym zainstalowano Syrve Front.
frontPort	Domyślnie 9696, musi odpowiadać portowi określonemu w ustawieniach wtyczki.
table	Wartość numeryczna. Aby wyświetlić numer zamówienia na paragonie jak w Syrve, ustaw na 0. Podając inną liczbę, zostanie ona dodana do numeru zamówienia. Np. jeśli w sekcji Syrve podano stolik #4, zamówienie 5 będzie wyświetlane jako 405, zamówienie 100 jako 400, zamówienie 123 jako 423.
timeClose	Czas zamknięcia zmiany kasowej. Przykład formatu: 23:55:00
timeOpen	Czas otwarcia zmiany kasowej. Przykład formatu: 09:45:00
menuUpdateTime	Czas aktualizacji i eksportu danych z zewnętrznego menu. Przykład formatu: 09:30:00
Title	Tytuł dla menu ekranu startowego. Jeśli nie określono, wyświetlane będzie "Popularne dania".
numberPrint	Wartości True/False. Parametr pozwala wyłączyć wyświetlanie numeru zamówienia na ekranie i paragonie. True = numer wyświetlany, False = nie.
selectScreen	Wartości True/False. Parametr wyświetlania ekranu wyboru typu zamówienia (Na miejscu/Na wynos). True = ekran włączony, False = wyłączony.
takeAway	Wartości True/False. Jeśli ekran wyboru typu zamówienia jest ukryty, to ustawia domyślny typ zamówienia. True = zamówienie jest składane jako "Na wynos", False = "Na miejscu".
btnStart	Wartości True/False. Parametr pozwala wyłączyć komunikat "Dotknij ekranu, aby zamówić" na ekranie startowym, jeśli przeszkadza w wyświetlaniu banera promocyjnego klienta.
allPopup	Wartości True/False. Parametr pozwala wymusić otwarcie okna popup przy wyborze pozycji, niezależnie od obecności modyfikatora.

Aneks 3: Parametry Konfiguracji Wtyczki

Parametr	Cel
Pin	Określ kod PIN ustawiony w ustawieniach BackOffice; flaga "dla wtyczek" musi być włączona.
Section	Określ nazwę sekcji, według której sprawdzane są listy stop.
FrontIp	Domyślnie 127.0.0.1, zmieniane, jeśli 3S i Syrve Front są na różnych komputerach w tej samej sieci lokalnej. W takim przypadku należy podać adres IP komputera, na którym zainstalowano Syrve Front.
FrontPort	Domyślnie 9696, musi odpowiadać portowi określonemu w ustawieniach 3S.
DirectKKT	True/False. True = jeśli planowana jest fiskalizacja przez sprzęt podłączony za pomocą wtyczek Syrve.
PaymentType	Określ nazwę typu płatności używanego dla zamówień SyrveKiosk.
PaymentType2	Określ alternatywną nazwę typu płatności używanego dla zamówień SyrveKiosk.
Bonus	True/False. True = aby podłączyć zewnętrzny typ płatności dla alternatywnych systemów lojalnościowych.
iikoCard	True/False. True = jeśli używany jest system SyrveLoyalty.
PaymentDiscountType	Określ nazwę typu płatności używanego dla płatności bonusowych w zamówieniach.
Here	Określ GUID typu zamówienia "Na miejscu".
TakeAway	Określ GUID typu zamówienia "Na wynos".
MinCountDish	Określ minimalną ilość, przy której danie "znika" z kiosku, gdy zostanie dodane do listy stop z określoną ilością.
Price	Określ nazwę kategorii cenowej. Ta sama kategoria cenowa musi być określona w ustawieniach sekcji Syrve Front.
PrintDish	True/False. True = jeśli wymagana jest dodatkowa wymuszona akcja "drukuj dania" podczas procesu płatności.
NumberTable	Określ numer stolika, na którym powinny być umieszczane zamówienia z SSK.
OrderOriginName	Określ nazwę źródła zamówienia, używaną do analizy i identyfikacji źródła zamówienia.

Aneks 4: Wymagania dotyczące Elementów Projektowych Kiosku (Banery, Ikony Menu)

Ważne

Maksymalna wydajność oprogramowania jest osiągana, gdy rozmiary obrazów/ikon nie przekraczają 320x200 pikseli, zalecany rozmiar: do 150 KB. Jeśli rozmiary obrazów są większe, program automatycznie je skalibruje, ale przy dużej liczbie pozycji wydajność zostanie znacznie zmniejszona.

Typ Mediów	Opis / Format
Ikony kategorii	Rozmiar 40x40px, format png lub svg. Rozmiar pliku nie większy niż 0.5 MB
Ikony przycisków systemowych	Rozmiar 320x240px, format png lub svg. Rozmiar pliku nie większy niż 0.5 MB
Suwak ekranu startowego	Pliki .jpg lub .png o wymiarach 1080x1920 i rozmiarze nie większym niż 400 KB
Pojedynczy baner dla strony startowej	Rozmiar obrazu 1080x1920, format png
Obraz nagłówka strony menu	Rozmiar obrazu 1080x250, format png
Obraz nagłówka dla wszystkich stron poza menu	Rozmiar obrazu 1080x250, format png
Obraz wyświetlany na dole ekranu płatności	Rozmiar obrazu 1080x250, format png
Obraz wyświetlany na dole po pomyślnej płatności	Rozmiar obrazu 1080x250, format png
Obraz zastępczy dla brakujących ikon menu	Rozmiar obrazu 320x200px, do 150KB