Miniaturka artykułu
18-06-2024, Kamil

Instrukcja eCommerce

VI. Aplikacja do harmonogramu zadań Windows

Niezalecane, ustawienia pod specjalne zamówienia Klienta.
Do paczki z dodatkiem dołączono katalog o nazwie Harmonogram zawierający aplikację, którą można uruchomić w harmonogramie zadań i wywoływać workery opisane powyżej automatycznie, w tle.
Wymagane jest, aby na komputerze na którym uruchamiane będzie zadanie była zainstalowana wersja enovy, zgodna z wersją wymaganą przez pobraną wersję dodatku. 
Jeżeli podczas dodawania dokumentów lub towarów wykonywane są jakieś akcje automatyczne w enova365 korzystające z zewnętrznych DLL (np. Soneta.OplataCukrowa), należy te zewnętrzne pliki DLL skopiować i wkleić do katalogu Harmonogram/ExternalDlls.
1. Konfiguracja aplikacji.
W katalogu Harmonogram znajduje się plik XML z rozszerzeniem *.config.
W pliku tym należy ustawić niezbędne dane konfiguracyjne dla aplikacji, która będzie łączyć się bazą danych enova365.
Dane te znajdują się w węźle XML: configuration -> applicationSettings -> enova365.EcommerceSync.TaskSchedule.Properties.Settings

Węzeł ten zawiera węzły o nazwie settings, które posiadają atrybut name, który jest nazwą danej konfiguracyjnej oraz węzeł value, który zawiera wartość danej konfiguracyjnej.
Dane konfiguracyjne:
  • SonetaPath: ścieżka do instalatorów wszystkich wersji enovy; domyślnie: C:\Program Files (x86)\Soneta
  • LogsPath: ścieżka do plików z logami, które będą generowane podczas uruchamiania zadania służące do weryfikacji działania aplikacji. Katalog musi wcześniej zostać utworzony; domyślnie: D:\Logs
  • EnovaDb: nazwa firmy z listy baz danych
  • EnovaLogin: operator programu enova365
  • EnovaPassword: hasło operatora do programu enova365
  • AccountName: nazwa konta ecommerce dodanego w enova365, dla którego ma być wykonywana synchronizacja; jeżeli dla wszystkich dodanych kont, należy wprowadzić wartość Wszystkie
2. Dodawanie zadania.
Aby dodać nowe zadanie, należy uruchomić aplikację Harmonogram zadań i kliknąć na Utwórz zadanie...


Następnie w nowym okienku w zakładce Ogólne należy przypisać dowolną nazwę i ewentualnie opis zadania.
Aby uniknąć problemów z nie uruchamianiem się harmonogramu oraz uprawnieniami, warto zaznaczyć opcję Uruchom niezależnie od tego, czy użytkownik jest zalogowany oraz Uruchom z najwyższymi uprawnieniami:


Następnie w zakładce Wyzwalacze należy dodać nowy wyzwalacz za pomocą przycisku Nowy... i w nowym oknie ustawić częstotliwość oraz godziny w jakich zadanie ma być wyzwalane automatycznie. Przykładowa poniższa konfiguracja będzie wyzwalać zadanie od dnia 17.02.2022, od godziny 10:00:00 i będzie je uruchamiać co godzinę:


Należy wyzwalacz zatwierdzić przyciskiem OK i przejść do zakładki Akcje, aby dodać nową akcję za pomocą przycisku Nowa... W nowym oknie należy wybrać typ akcji na Uruchom program, następnie podać ścieżkę do pliku exe z katalogu Harmonogram znajdującego się w paczce dodatku oraz dodać parametr synchronizacji.


W celu eksportu towarów należy podać parametr ExportMode. Parametr ExportMode może przyjmować następujące wartości (bez polskich znaków):
  • Towary - całe kartoteki towarów (bez zdjęć)
  • Ceny - tylko ceny
  • Ilosci - tylko ilości
  • IlosciCeny - tylko ilości i ceny
  • Zdjecia - tylko zdjęcia
Zaleca się wykorzystywanie wartości Ilosci, Ceny lub IlosciCeny, resztę zaleca się robić ręcznie z poziomu aplikacji enova365 poprzez workery na towarach służące do eksportu.
Pozostałe parametry synchronizacji:
  • CreatePackage=1: Tylko Baselinker. Tworzenie paczek dla zamówień, które mają uzupełnioną cechę z ID zamówienia, uzupełnioną cechę z nr listu przewozowego, ale pustą cechę z ID paczki. Zostanie podstawiony zawsze domyślny kurier, wybranego w konfiguracji (Zamówienia > Domyślny kurier)
  • CreatePackageAuto=1: Tylko Baselinker. Tworzenie paczek dla zamówień, które mają uzupełnioną cechę z ID zamówienia, uzupełnioną cechę z nr listu przewozowego, ale pustą cechę z ID paczki. Zostanie podstawiony kurier na podstawie algorytmicznej cechy na dokumencie zwracającej identyfikator kuriera. Cecha jest wybierana w konfiguracji (Zamówienia > Cecha ID kuriera)
  • ExportInvoices=1: Tylko Baselinker i ErpitB2B. Eksport faktur i paragonów, które mają uzupełnioną cechę z ID zamówienia, ale pustą cechę z ID dokumentu sprzedaży
  • EksportKontrahenci=1: Tylko ErpitB2B. Eksport kontrahentów do B2B, którzy zostali zmodyfikowani później niż data wprowadzona w konfiguracji (Kontrahenci > Eksportuj od daty)
  • ImportInvoices=1: Tylko Baselinker. Import faktur i paragonów wg ustawień w konfiguracji (data od i ewentualne statusy zamówień)
  • ImportOrders=1: import zamówień wg ustawień w konfiguracji (data od i statusy)
  • ImportWz=1: Tylko ErpitB2B. Import WZ wg ustawień w konfiguracji (data od)
Dzięki tym parametrom można dodać wiele zadań przy wykorzystaniu jednej aplikacji. Przykładowo można dodać zadanie z parametrem ExportMode=Ilosci, które będzie uruchamiane co godzinę, oraz zadanie z parametrem ImportOrders=1, które będzie uruchamiane raz dziennie.
Opcjonalnie można dodać parametr /dbconfig="ścieżka_do_pliku_lista_baz_danych.xml" w celu podania ścieżki do pliku Lista baz danych.xml znajdującego się w innym miejscu niż katalog zalogowanego użytkownika.
Przykład: /dbconfig=”D:\prod\ecom\lista baz danych.xml”
Po dodaniu akcji, należy ją zatwierdzić przyciskiem OK, a następnie zatwierdzić zadanie również przyciskiem OK. Od tego momentu zadanie będzie wyzwalane zgodnie z ustawieniami.