Integrator Magento-SAP (magsapa)

1. Funkcjonalno programu.
1.1. Wstp
Program suy do synchronizacji danych pomidzy sklepem internetowym opartym o
platform Magento (wersja 1.! a systemem "#P
Program dziaa w tle jako usuga
Po restarcie komputera na kt$rym zainstalowany jest program% proces synchronizacji
zostanie ponownie rozpoczty% a dane zostan& zaktualizowane
'omunikacja pomidzy programem a sklepem oparta jest o #P( Magento oraz o
)ezpo*rednie zapytania do )azy My"+,
'omunikacja pomidzy programem a )az& "#P oparta jest o funkcje oferowane przez
-izness .onnector (-.!
/efinicja danych dostpowych niez)dnych do komunikacji pomidzy programem a
o)oma systemami jest zapisana jako instalacja. 0ytkownik ma moliwo*1 edycji%
sprawdzenia i usunicia tych ustawie2.
"ynchronizacja danych prze)iega w peni automatycznie% ale istnieje opcja pozwalaj&ca
na wymuszenie synchronizacji rcznie
1.3. Prenosen!e no"#c$ pro%ukt&" SAP %o sklepu !nterneto"ego
/odawanie do sklepu Magneto% nowych produkt$w stworzonych w "#P od)ywa si raz
dziennie o 1455
6odzina ta moe )y1 zmieniona przez uytkownika programu.
/ane po)ierane s& z -. funkcj& 7getMatMas7 z zakadu 75557 i w jzyku polskim 7,7
Przenoszone s& tylko produkty kt$rych kod spenia kryteria4
YT-00000 YT-99999, YT-0000 YT-9999,TG-00000 TG-99999, GV-0000 GV-9999,
00000 99999, zaczynajce si od I
Produkty przenoszone s& do sklepu internetowego do kategorii 7(tymczasowa! (mport
"#P7 ze statusem 78y&czone7 i uzupeniane s& o dane z "#P4
kod, nazwa, ilo, cena, jednostka, ib, c
1.9. S#nc$ron!acja stan&" maga#no"#c$ pro%ukt&"
"tany magazynowe sklepu internetowego synchronizowane s& na podstawie ilo*ci
produkt$w "#P z magazynu 75557.
/o ich po)ierania suy funkcja -. 7get"tanyMag7
"ynchronizacja stan$w magazynowych od)ywa si cyklicznie co 9 minuty.
:kres ten moe )y1 zmieniony przez uytkownika programu.
Proces sprawdzania r$nic pomidzy stanami nie o)ci&a serwera sklepu Magneto%
poniewa stany Magento cache;owane s& w programie.
<a)lica cache stan$w Magento aktualizowana jest (dla )ezpiecze2stwa! 3 razy dziennie.
1.=. S#nc$ron!acja cen pro%ukt&"
.eny produkt$w sklepu internetowego aktualizowane s& na podstawie cennik$w "#P.
"klep internetowy dla klient$w indywidualnych korzysta z cennika "'
"klep internetowy dla klient$w hurtowych korzysta z cennika >0
"ynchronizacja cen od)ywa si raz dziennie o 1455 .
6odzina ta moe )y1 zmieniona przez uytkownika programu.
1.. S#nc$ron!acja am&"!e' kl!ent&" !n%#"!%ualn#c$
Po utworzeniu w sklepie internetowym zam$wienia przez klienta indywidualnego jego
dane przenoszone s& do "#P. Po utworzeniu zam$wienia w "#P i nadaniu mu numeru%
zam$wienie w sklepie internetowym aktualizowane jest o ten numer.
:dszukiwanie nowych zam$wie2 i ich przenoszenie do "#P od)ywa si co 9 minuty.
:kres ten moe )y1 zmieniony przez uytkownika programu.
/o dodawania zam$wienia w "#P wykorzystywana jest funkcja -. 7"end?M,<o"#P7
/ane domy*lne zam$wie2 to4
typ dokument4 7@"'87
dzia sprzeday4 78A:.7
kana dystry)ucji4 7"'7
dzia4 7517
zakad4 75557
'lienci odszukiwani s& w "#P na podstawie B(P.
Ce*li klient nie zostanie znaleziony zostanie dodany.
Ce*li klient zosta znaleziony jego dane zostan& zaktualizowane.
Przenoszone dane klient$w to4
imi% nazwisko% nazwa firmy (je*li podano!% miasto% ulica% kod pocztowy% telefon
Pozycje zam$wienia przenoszone do "#P zawieraj&4
kod produktu% ilo*1% jednostk% warto*1 ra)atu
'oszt dostawy przenoszony jest jako pozycja z kodem 70"D06#397
(. Instalacja programu
(.1 W#magan!a
system 8indows (93EF= )it!
stay dostp do internetu
program moe )y1 zainstalowany tylko na 1 komputerze
(.( Pre% !nstalacj)
zainstalowa1 .Bet 9. Gramework
zainstalowa1 M""+, "erHer .ompact 9. "p1
w folderze w kt$rym zainstalowana ma )y1 aplikacja naley umie*ci1 pliki
config.ini w kt$rym zapisywana jest informacja dotycz&ca nazwy klienta i
wersji programu(np4 toya% produkcja!
(.* Po !nstalacj!
skopiowa1 pliki magsapa.php i magsapaIkod.php do g$wnego katalogu sklepu
Magneto
w narzdziach administracyjnych systemu 8indows zmieni1 try) uruchamiania
usugi 70suga magsapa7 z 7rczna7 na 7automatyczna7
Podczas pierwszego uruchomienia programu w widocznym oknie naley wpisa1
klucz licencyjny kt$ry jest generowany na podstawie czterech liter J kodu
programu na okre*lony czas.
8 przypadku przenoszenia programu na inny komputer% a)y zapewni1 ci&go*1
synchronizacji danych (e)y zam$wienia ju raz przeniesione do "#P nie
zostay przeniesione ponownie! naley w katalogu g$wnym programu nowo
powstay plik z )az& danych programu o nazwie magsapa/ata-ase.sdf zamieni1
na istniej&cy.
*. Praca programem
*.1 +kno programu
8ygl&d okna aplikacji przedstawia rys. 1.
8 cz*ci tytuowej znajduje si informacja o tym w jakim try)ie pracuje aplikacja% oraz z jaki jest
adres strony sklepu. Po ikonie znajduj&cej si pod g$wnym menu w tool)ardze mona okre*li1
czy usuga aplikacji jest w&czona% czy wy&czona. Ba rysunku program z wy&czona usug&.
Ays. 1 :kno aplikacji
*.( W,)can!e-"#,)can!e us,ug!
Ce*li usuga dziaa w try)ie automatycznego uruchamiania% w&czanie usugi nie jest konieczne.
#)y w&czy1Ewy&czy1 usug naley w menu g$wnym programu wy)ra1 opcj !"#$c%o
$s&$'! lu) 7(at#zyaj $s&$'!% lu) skorzysta1 z guzika na tool)arze.
Ays. 3 0ruchamianie i zatrzymywanie usugi za pomoc& opcji menu Program
*.* .ar)%an!e !nstalacjam!
:kno pojawia si po wy)raniu4 z menu )#o'#a opcji (a#zdzanie instalacjai. 8 aplikacji
skonfigurowana jest jedna instalacja. (nstalacja to ustalone powi&zanie sklepu magento z )az&
"#P. #)y edytowa1 instalacj klika si na przycisk *dyt$j% a)y usun&1 instalacj klika si
przycisk "s$+. #)y doda1 now& instalacj wy)iera si przycisk ,odaj
Ays. 9. :kno @arz&dzanie instalacjami
Po klikniciu przycisku *dyt$j pojawia si okno przedstawione na rysunku =.
8 cz*ci -aza danyc% ./) podawane s& parametry do nawi&zania po&czenia z "#P%
8 cz*ci .kle0 a'ento podawany jest adres url sklepu magento -3..
8 cz*ci 10cje ./) podaje si warto*ci K'-0A dla sklepu -3. oraz :utlet.
8 cz*ci 10cje a'ento ustala si r$nic strefy czasowej.
8 cz*ci 10cje ws02lne w okienku Powiadamiaj (e;mail! wpisuje si adres (adresy!
mailowe na kt$re maja przychodzi1 maile z powiadomieniami o )dnych zam$wieniach.
rys. = :kno Ldycja instalacji
#)y zapisa1 wszelkie zmiany naley klikn&1 na przycisk (a0isz.
0waga4 zmiany w instalacji mona wprowadza1 tylko przy wy&czonej usudze programu.
*./ S#nc$ron!acja pro%ukt&"
:kno "ynchronizacja produkt$w suy do rcznego uruchamiania synchronizacji produkt$w.
:kno otwiera si po wy)raniu opcji .ync%#onizacja )#od$kt2w z menu )#o'#a. :kno zostao
przedstawione na rysunku . 6$wnym elementem na oknie jest szereg zakadek. 8 celu
rozpoczcia procedury rcznej synchronizacji produkt$w naley klikn&1 na klawisz )obie#z
dane3 /o momentu po)rania wszystkich informacji nie ma moliwo*ci przej*cia do
pozostaych zakadek okna.
Ays. "ynchronizacja produkt$w ; informacje
Po po)raniu wszelkich danych zwi&zanych w zakadce informacje pojawi si podsumowanie%
przykadowe na rysunku F.
Ays. F "ynchronizacja produkt$w po po)raniu wszystkich danych.
#)y wywoa1 synchronizacj przechodzi si do zakadki 10e#acje (rys. M!% w cz*ci
/kt$alizacja danyc% zaznaczamy wszystkie opcje i klikamy /kt$aliz$j.
Ays. M "ynchronizacja produkt$w J :peracje
Przed wywoaniem aktualizacji w pozostaych zakadkach mona zweryfikowa1 po)rane dane.
@rzuty nastpnych zakadek poniej.
Ays. N J "ynchronizacja produkt$w J <owarowanie
Ays. O J "ynchronizacja produkt$w J Produkty )rakuj&ce
Ays. 15 J "ynchronizacja produkt$w J A$nice w ilo*ciach
Ays. 11 J "ynchronizacja produkt$w J A$nice w cenach
Ays. 13 ; "ynchronizacja produkt$w J r$nice w nazwach
Ays. 19 J "ynchronizacja produkt$w J Produkty Magento
Ays. 1= J "ynchronizacja produkt$w J Produkty "#P
Ays. 1. ; "ynchronizacja produkt$w J Produkty wsp$lne
Ays. 1F J "ynchronizacja produkt$w J Produkty identyczne
Ays. 1M J "ynchronizacja produkt$w ; Aaporty
: wykonaniu synchronizacji rcznej poinformuje odpowiedni komunikat.
*.0 +pcje programu
8 tym oknie istnieje moliwo*1 konfiguracji parametr$w wpywaj&cych na dziaanie usugi
m.in. czstotliwo*ci synchronizacji stan$w magazynowych oraz godzin aktualizacji cen i
importu nowych produkt$w.
:pcje te s& dostpne w menu programu /dinist#acja P 10cje 0#o'#a$
8ygl&d okna do konfiguracji aplikacji przedstawia rysunek 1M. @miany w opcjach programu
prosimy wprowadza1 przy wy&czonej usudze.
Ays. 1N J :kno :pcje Programu
/. S#stem raporto"an!a-%!agnost#k!
8szystkie do)owe zmiany wykonane przez usug zapisywane s& codziennie w oso)nym pliku
o nazwie 7"erHice,og.rrrr.mm.dd.tQt7 (rrrr.mm.dd to konkretna data! w podkatalogu programu o
nazwie 7katalogIro)oczy7.
Ponadto zmiany s& logowane w plikach4 "erHice,og.tQt i Program,og.tQt zapisywane
w katalogu% w kt$rym zainstalowana jest aplikacja.
Ce*li zmiany wprowadzaa usuga% informacje s& zapisywane w pliku "erHice,og.tQt%
w przypadku zmian wprowadzanych przez aplikacj% zmiany zapisywane s& w pliku
Program,og.tQt.
'ady wpis w logu jest poprzedzony dat& i godzin& wpisu.
8 podkatalogu 7katalogIro)oczy7 zapisywane s& pliki Qml o nazwie
produktyImagentoIallI3I1IQQQQIyyyy.Qml 6dzie QQQQ J pocz&tkowe id produktu magento%
yyyy J ko2cowe id produktu magento. /ane o produktach po)ierane s& paczkami po 1555
produkt$w.
8 pliku zapisane s& po)rane informacje po)rane o produktach z magento w momencie
wywoania po)ierania danych podczas synchronizacji. #utomatycznie dzieje si to raz dziennie
o 1455% zgodnie z wcze*niejszym opisem istnieje moliwo*1 wywoania synchronizacji rcznie.
8 celu sprawdzenia poprawno*ci po)ierania danych z magento i "#P mona skorzysta1
z rcznej synchronizacji produkt$w% )ez wykonywania aktualizacji.
0. +peracje "#kon#"ane c#kl!cn!e
.a%an!a "#kon#"ane 1 ra %!enn!e o go%. 11224
dodawanie nowych produkt$w do magento
aktualizacja cen w magento
aktualizacja nazw
aktualizacja stan$w
aktualizacja przypisania produkt$w do we)sit$w
.a%an!a "#kon#"ane co * m!nut#1
synchronizacja stan$w
przenoszenie zam$wie2 do "#P