Zmiany pomiędzy wersją początkową i wersją 1 dla DeployerGuide/Customization/ForteFK

Pokaż
Ignoruj:
Data i czas:
11/29/12 17:15:05 (12 years temu)
Autor:
JP (IP: 95.48.84.114)
Komentarz:

--

Legend:

Bez zmian
Dodane
Usunięte
Zmienione
  • DeployerGuide/Customization/ForteFK

    v1 v1  
     1= Integracja z Forte FK = 
     2 
     3=== Menu === #menu 
     4 1. [#data_source Konfiguracja źródła danych] 
     5 2. [#views_install Instalacja widoków w FORTE] 
     6 3. [#bs_connect_data_sources Tworzenie połączenia z systemami zewnętrznymi] 
     7 4. [#syncassist SyncAssist - eksport danych z eDokumentów do systemu Forte FK] 
     8 
     9== Konfiguracja źródła danych == #data_source 
     10 
     11Pierwszym krokiem integracji jest zdefiniowanie odpowiedniego źródła danych do bazy danych systemu FORTE FK. Do tego celu przechodzimy do ''Ustawień > Panel Sterowania > Pozostałe ustawienia > Źródła danych''. 
     12W otwartym oknie wybieramy Nowe, a następnie definiujemy parametry połączenia. 
     13 * Identyfikator źródła danych - wprowadzamy nazwę połączenia, przykładowo FORTE_FK. 
     14 * Sterownik - wybieramy sterownik połączenia, np. MsSQL lub ODBC. 
     15 * Ciąg połączenia - ciąg połączenia do bazy danych. Dla MsSQL może to być np. 
     16{{{ 
     17Server=<adres serwera bazy danych np. 192.168.0.1>;Database=<nazwa bazy danych>;Uid=<uużytkownik>;Pwd=<hasło>; 
     18}}} 
     19 
     20[[BR]][[Image(img001.png)]][[BR]]''(Rys.1 Ciąg połączenia z systemem Forte)''[[BR]] 
     21 
     22Na tym kończy się pierwszy etap integracji. 
     23 
     24== Instalacja widoków w FORTE == #views_install 
     25 
     26Idąc dalej musimy przygotować na bazie danych systemu FORTE HANDEL. W tym celu mając uprawnienia w systemie Ms SQL Server do tworzenia obiektów na bazie danych wykonujemy skrypt z lokalizacji:{{{public_html/apps/edokumenty/modules/Tools/BSConnect/install/sql/externals/symfonia_forte_fk/01_install_relations_crt.sql}}}: 
     27 
     28== Tworzenie połączenia z systemami zewnętrznymi == #bs_connect_data_sources 
     29 
     30Kolejnym krokiem w tym procesie jest modyfikacja pliku ''config.inc''. Należy dodać lub zmodyfikować wpis w tym pliku: 
     31{{{ 
     32define('SYNC_ACTIVE','NEW'); 
     33}}} 
     34 
     35Po ponownym zalogowaniu w systemie pojawia się przycisk w menu ''Narzędzia > Połączenia z systemami zewnętrznymi''. Widok przycisku przedstawia poniższy rysunek: 
     36 
     37[[BR]][[Image(img002.png)]][[BR]]''(Rys.2 Połączenia z systemami zewnętrznymi)''[[BR]] 
     38 
     39Domyślnie żadne połączenie nie jest zdefiniowane. Połączenie tworzymy klikając polecenie ''Nowy''.  
     40 
     41[[BR]][[Image(forte001.jpg)]][[BR]]''(Rys.3 Okno definiowania połączenia z systemem Forte)''[[BR]] 
     42 
     43W nowo otwartym oknie należy wypełnić pola: 
     44 * Nazwę połączenia z systemem zewnętrznym - nazwa musi być unikalna, 
     45 * Wybrać identyfikator systemu SYMFONIA_FORTE 
     46 * Wskazać źródło wymiany. Jeżeli nie istnieje to można utworzyć. 
     47 
     48[[BR]][[Image(forte002.jpg)]][[BR]]''(Rys.4 Okno definiowania źródła wymiany danych)''[[BR]] 
     49 
     50W źródle wymiany wprowadzamy: 
     51 * unikalną nazwę,  
     52 * wybieramy typ z listy rozwijanej (opis poniżej),  
     53 * źródło danych (dla typu DB),  
     54 * nazwa schematu w bazie Forte (najczęściej będzie to edokumenty - również dla połączeń typu DB) 
     55 * ścieżkę składu (dla typów XML i CUSTOM_XML) 
     56 * klasę (dla typu CUSTOM_XML) 
     57 
     58Źródło wymiany danych może być następujących typów: 
     59 * DB - Wymiana poprzez bazę danych. Wymaga istnienia dedykowanych widoków lub odpowiednich zapytań SQL 
     60 * XML - wymiana danych poprzez pliki XML. Podaje się ścieżkę do katalogu będącego składem plików 
     61 * CUSTOM_XML - jw. z tą różnicą, że wymagana jest dedykowana klasa PHP do obsługi takiego transferu. 
     62 
     63Gdy posiadamy już połączenie z systemem zewnętrznym należy skopiować pliki map np. 
     64{{{ 
     65cp APP_DATA/var/tpl/sync/SYMFONIA_FORTE_HANDEL_columns_map.ini APP_DATA/etc/sync/ 
     66}}} 
     67a następnie zmienić nazwę skopiowanego pliku w katalogu sync na {{{<IDENTYFIKATOR_Z_BS_CONNECT_SYSTEMS>_columns_map.in}}}i np. {{{1_columns_map.ini}}}, gdzie jest identyfikator połączenia z okna połączeń z systemami zewnętrznymi. 
     68 
     69Przykładowa zawartość takiego pliku to: 
     70{{{ 
     71[CONTACT] 
     72nazwa = name_1 
     73skrot = name_2 
     74kodpocz = code__ 
     75rejon = woj___ 
     76ulica = street 
     77dom = bldnum 
     78lokal = fltnum 
     79miejscowosc = city__ 
     80nip = nip___ 
     81pesel = pesel_ 
     82regon = regon_ 
     83kraj = countr 
     84fax = faxnum 
     85email = email_ 
     86www = www___ 
     87telefon1 = ph_num 
     88telefon2 = ph_num 
     89nazwisko = cntprs 
     90imie = cntprs 
     91Uwagi = notes_ 
     92 
     93[DOCUMENT] 
     94data = data__ 
     95terminplat = paytrm 
     96kod = symbol 
     97netto = netto_ 
     98vat = vat___ 
     99brutto = brutto 
     100dctype = dctype 
     101acorid = acorid 
     102 
     103[PRODUCT] 
     104kod = symbol 
     105nazwa = name__ 
     106jm = unitid 
     107vat = vat_id 
     108katalog=pgr_id 
     109stanmin = quamin 
     110cena_zakupu = purcst 
     111cena_sprzedazy = netto_ 
     112 
     113[FKELEMENT] 
     114lp = prior_ 
     115kodtw = symbol 
     116opis = dscrpt 
     117jm = unitnm 
     118ilosc = quantm 
     119cenanetto = netto_ 
     120vat_id = vat_id 
     121kodtw = depsym 
     122opis = depnam 
     123opis = mname_ 
     124}}} 
     125 
     126To jeszcze nie wszystko. 
     127Należy również ustawić zasady importu dla danego modułu. Otóż wchodzimy w Połączenia z systemami zewnętrznymi, wybieramy połączenie, edytujemy je - przechodzimy do zakładki Synchronizacja. W tej zakładce wybieramy np. Produkty i dajemy edytuj. W nowym oknie wybieramy akcję i edytujemy ją. Wprowadzamy tam zasady, wg których przebiegnie dalsza akcja.  
     128 
     129[[BR]][[Image(forte004.jpg)]][[BR]]''(Rys.5 Edycja zasad importu danych)''[[BR]] 
     130 
     131[[BR]][[Image(forte005.jpg)]][[BR]]''(Rys.6 Edycja zasad importu danych)''[[BR]] 
     132 
     133Po tak zdefiniowanych elementach należy przejść do odpowiedniego modułu, wybieramy przycisk Połączenie >> <Nazwa połączenia> >> <akcja do wykonania> 
     134 
     135[[BR]][[Image(forte003.jpg)]][[BR]]''(Rys.7 Przyykładowe pobranie dokumentów)''[[BR]] 
     136 
     137== !SyncAssist - eksport danych z eDokumentów do systemu Forte FK == #syncassist 
     138<TODO> 
     139== !OnTimer() - import i eksport danych do/z Forte HM == #ontimer 
     140[DeployerGuide/Customization/Forte/ForteOnTimer Integracja z Forte HM przy pomocy OnTimer()]