Integracje

⌘K
  2. Strona główna
  4. Integracje
  6. ERP – Integracja z Comarc...
  8. Opis integracji
  10. Jak wypełnić plik konfiguracyjny – Optima?

Jak wypełnić plik konfiguracyjny – Optima?

Ten wpis pomaga zebrać dane potrzebne do przygotowania integracji xSale z Comarch ERP Optima. Na podstawie tych informacji konfigurowany jest WebService oraz ustawienia po stronie xSale.

W tym artykule znajdziesz

Pliki do pobrania

Formularz wdrożeniowy xSale Optima (do wypełnienia)
Przykładowo wypełniony formularz wdrożeniowy xSale – Optima

Dostęp do serwera

Do poprawnego połączenia Comarch ERP Optima z xSale na serwerze klienta instalowany jest WebService. Więcej o tym elemencie integracji opisuje wpis Futuriti WebService – Comarch ERP Optima.

Najlepiej przekazać dostęp do serwera, na którym jest zainstalowana Optima i z którego można połączyć się z bazami SQL Optimy. Dostęp jest potrzebny do instalacji, konfiguracji i późniejszej obsługi WebService.

Zdalny Pulpit (RDP)

Preferowaną metodą jest połączenie przez Zdalny Pulpit. Ułatwia ono instalację, późniejsze aktualizacje i diagnostykę integracji. Połączenie RDP może przygotować administrator lub osoba obsługująca infrastrukturę IT.

Do połączenia potrzebne są:

  • adres IP lub nazwa serwera, opcjonalnie z portem, np. 193.239.184.20:3939,
  • nazwa użytkownika, często w formacie NAZWA_SERWERA\UŻYTKOWNIK,
  • hasło,
  • informacja, czy przed połączeniem wymagany jest VPN.

Przed przekazaniem danych warto sprawdzić, czy połączenie działa na komputerze poza siecią lokalną firmy. Pomoc Microsoft dotycząca RDP jest dostępna tutaj.

TeamViewer

Jeśli połączenie RDP nie jest możliwe, można skorzystać z firmowego TeamViewer. W takim przypadku potrzebne są ID oraz hasło z aplikacji. Ta metoda może wymagać ponownego udostępnienia dostępu przy każdej zmianie, aktualizacji lub diagnostyce WebService.

Dane Comarch ERP Optima

W formularzu należy podać dane, które pozwalają WebService zalogować się do Optimy. W konfiguracji odpowiadają im między innymi ustawienia OptimaLogin, OptimaPassword, OptimaDatabase i OptimaPath.

Do uzupełnienia są:

  • nazwa operatora w Optimie, np. dedykowany operator XSALE,
  • hasło operatora, jeśli jest wymagane,
  • nazwa firmy lub bazy firmowej Optimy,
  • ścieżka instalacji Optimy, jeśli jest wymagana w danej instalacji,
  • informacja, z jakich modułów/licencji ma korzystać integracja.

Do prawidłowego działania integracji muszą być spełnione wymagania licencji Comarch ERP Optima. W praktyce warto przygotować osobnego operatora i osobne licencje dla integracji, aby praca użytkowników nie blokowała WebService.

Dane bazy można sprawdzić podczas logowania do Comarch ERP Optima, po rozwinięciu szczegółów w zakładce Ogólne.

Alternatywnie można je sprawdzić w Optimie w ścieżce Pomoc – O programie – Informacje techniczne – Informacje.

Dane serwera SQL

WebService korzysta bezpośrednio z baz SQL Optimy, dlatego w formularzu trzeba podać dane serwera SQL. W konfiguracji odpowiadają im między innymi pola SQLServerName, SQLDatabase, SQLDatabaseConfiguration, SQLTrustedConnection, SQLUserID i SQLPassword.

Możliwe są dwa sposoby logowania:

  • logowanie domenowe / Windows – wtedy SQLTrustedConnection jest ustawione jako True i nie trzeba podawać loginu oraz hasła SQL,
  • logowanie SQL – wtedy trzeba podać login i hasło użytkownika SQL z dostępem do bazy firmowej oraz konfiguracyjnej Optimy.

Dane SQL można zwykle uzyskać od administratora, opiekuna ERP lub osoby, która instalowała Comarch ERP Optima. Jeśli firma korzysta z SQL Server Management Studio, są to dane używane do połączenia z serwerem SQL.

Magazyny

W formularzu należy wskazać magazyn lub magazyny, z których mają być pobierane stany magazynowe. W konfiguracji WebService odpowiada temu lista magazynów, np. WarehouseCodeList. Jeśli zamówienia mają trafiać na konkretny magazyn w Optimie, wykorzystywane jest także ustawienie magazynu dla RO, np. SalesOrderWarehouseCode.

Listę magazynów można sprawdzić w Optimie w ścieżce Handel – Zasoby. Po otwarciu karty towaru lista magazynów jest widoczna w zakładce Zasoby.

Ceny

W formularzu należy podać typy cen z Optimy, które mają być przekazywane do xSale. W konfiguracji WebService typy cen mogą być zapisywane jako mapowanie cenników, np. ArticlePriceListDic. Dla kontrahentów tworzonych przy zamówieniach mogą być wykorzystywane również ustawienia domyślnego typu ceny, np. DefaultDetalPriceTypeId i DefaultNotDetalPriceTypeId.

Typy cen można sprawdzić w Optimie w ścieżce Handel – Zasoby, po otwarciu karty towaru. Warto podać dokładnie te cenniki, które mają być wykorzystywane w sprzedaży online.

Foldery robocze WebService

W niektórych wdrożeniach potrzebne jest również wskazanie folderów roboczych WebService. Są one używane do plików wymiany, paczek towarów, dokumentów, wydruków PDF i zdjęć. W konfiguracji odpowiadają im między innymi ustawienia RecivedFolder, RecivedLoadedFolder, RecivedBadFolder, ArticlePackageTempFolder, PrintPDFTempFolder i photoFilePath.

Jeśli foldery są tworzone przez zespół wdrożeniowy xSale, klient nie musi ich samodzielnie uzupełniać. Ważne jest jednak, aby konto, na którym działa WebService, miało do nich uprawnienia odczytu i zapisu.

Najczęstsze problemy z połączeniem RDP

  • Użytkownik nie został podany w pełnym formacie, np. NAZWA_SERWERA\UŻYTKOWNIK.
  • Do połączenia wymagany jest VPN, ale dane VPN nie zostały przekazane.
  • Adres wymaga podania portu, np. 000.000.000.000:0000.
  • Zdalny Pulpit nie jest włączony na serwerze.
  • Konto Windows nie ma uprawnień administratora lub nie ma prawa logowania przez RDP.

Dobre praktyki

  • Utwórz dedykowane konto Windows dla WebService, np. xSale. Dzięki temu integracja nie korzysta z prywatnej sesji pracownika.
  • Utwórz dedykowanego operatora w Comarch ERP Optima, np. XSALE. Dokumenty tworzone przez integrację będą wtedy łatwiejsze do identyfikacji.
  • Wydziel licencje Optimy dla integracji, jeśli jest taka możliwość. Zmniejsza to ryzyko, że WebService nie zaloguje się z powodu braku wolnej licencji.
  • Po zmianie danych w pliku konfiguracyjnym zrestartuj WebService, aby nowe ustawienia zostały wczytane.

Czego brakuje w tym artykule?