Aktualizacja bazy danych

Aktualizacja bazy danych
Aktualizacja posiadanej bazy danych może odbywać się dowolnie często. Wymaga to napisania
odpowiedniego skryptu modyfikującego dane w posiadanej bazie na podstawie danych otrzymanych z interfejsu
udostępnionego poniżej.
Dostęp do poniższych funkcji możliwy jest po podaniu unikalnego identyfikatora użytkownika oraz
hasła. Dla państwa dane te to:
Nazwa użytkownika:
Hasło:
********
********
• Towary powiązane
http://ateneum.net.pl/dbupdate/powiazane.php
Format pliku:
Separator pół:
CSV
, (przecinek)
Wygenerowany plik zawiera dane dotyczące towarów powiązanych, tj. takich, do których przy
sprzedaży zostanie dołączony inny towar. Uwaga, to połączenie jest jednostronne, czyli towar podstawowy jest
zawsze sprzedawany z towarem powiązanym, co nie oznacza, że towar będący powiązanym nie może zostać
zamówiony osobno. Ostateczna cena towaru podstawowego jest sumą cen obu towarów.
Przykładowa linia danych:
Ident_ate_towar_podstawowy, Ident_ate_towar_powiązany
Opis pól:
Ident_ate_towar_podstawowy
Ident_ate_towar_powiązany
-
identyfikator towaru podstawowego
identyfikator towaru powiązanego
• Sprawdzanie stanów
http://ateneum.net.pl/dbupdate/stany.php
Format pliku:
Separator pół:
CSV
, (przecinek)
Wygenerowany plik zawiera dane dotyczące aktualnych stanów magazynowych w Hurtowni Ateneum.
Przykładowa linia danych:
Ident_ate, Stan_magazynowy
Opis pól:
ident_ate
Stan_magazynowy
-
identyfikator towaru w bazie Ateneum
aktualny stan magazynowy
• Sprawdzanie synchronizacji danych
http://ateneum.net.pl/dbupdate/hashlist.php
Format pliku:
Separator pół:
CSV
, (przecinek)
Wygenerowany plik zawiera znaczniki modyfikacji poszczególnych rekordów w bazie książek
Ateneum. Na jego podstawie możliwe jest odnalezienie rekordów, które należy zmodyfikować, dodać lub
usunąć.
Jeżeli pobrany z tego pliku znacznik (hash) jest różny od zapisanego w bazie, oznacza to, że dany
rekord uległ zmianie i konieczna jest jego aktualizacja (metoda pobierania danych opisana w dalszej części
niniejszego dokumentu). Jeśli w pobranych danych znajduje się pozycja, której nie ma w bazie danych, oznacza
to, że jest to nowy rekord i należy go dopisać do bazy danych. Jeżeli natomiast w pobranym pliku nie ma
rekordu, a znajduje się on w bazie danych, oznacza to, że dana pozycja nie będzie już dostępna w hurtowni.
Przykładowa linia danych:
Ident_ate, hash
Opis pól:
ident_ate
hash
-
identyfikator towaru w bazie Ateneum
znacznik modyfikacji – ciąg 32 znaków
• Pobieranie danych
http://ateneum.net.pl/dbupdate/pozycja.php?id=ident_ate
Format pliku:
Kodowanie znaków:
Separator pół:
Separator dziesiętny
Parametry:
CSV
Latin 2 (ISO-8859-2)
, (przecinek)
. (kropka)
id
Identyfikator towaru w bazie Ateneum
Wygenerowany plik zawiera dane dotyczące rekordu wybranego za pomocą parametru id. W przypadku
podania nieprawidłowego identyfikatora towaru zwrócony zostanie komunikat o błędzie. Format generowanych
danych jest taki sam jak linii danych w przekazanej bazie, za wyjątkiem pola plik_zdjecia, które zawiera adres
URL z którego można pobrać plik ze zdjęciem.
Przykładowa linia danych:
Ident_ate, EAN, ISBN, tytuł, autor, wydawnictwo, opis_wydania,rok_wydania ,krótka_charakterystyka,
cena_detal_netto, stawka_vat, cena_detal_brutto, kategoria_poziom_1, kategoria_poziom_2,
kategoria_poziom_3, adres_zdjecia, hash
Opis pól:
ident_ate
parametr id
EAN
ISBN
Tytuł
autor
wydawnictwo
opis_wydania
rok_wydania
krótka_charakterystyka
cena_detal_netto
stawka_vat
cena_detal_brutto
kategoria_poziom_1
kategoria_poziom_2
kategoria_poziom_3
adres_zdjecia
pozycji
hash
-
identyfikator towaru w bazie Ateneum – identyczny z podanym jako
-
kod EAN książki
kod ISBN książki
tytuł książki
autor książki
wydawnictwo
ilość stron, format
rok wydania, oprawa
opis książki
cena detaliczna netto
stawka vat słownie
cena detaliczna brutto
nazwa dla poziomu 1 pierwszego katalogu
nazwa dla poziomu 2 pierwszego katalogu
nazwa dla poziomu 3 pierwszego katalogu
adres URL wskazujący na lokalizacje z której można pobrać zdjęcie danej
-
uaktualniony znacznik modyfikacji
http://ateneum.net.pl/dbupdate/image.php?id=ident_ate
Format pliku:
Rozmiar obrazu:
Parametry:
JPG
180px X 240px
id
Identyfikator towaru w bazie Ateneum
Funkcja ta zwraca obrazek w formacie jpg dla rekordu wybranego za pomocą parametru id. W
przypadku podania nieprawidłowego identyfikatora towaru lub nie posiadamy zdjęcia do danej pozycji
zwrócony zostanie obrazek jpg z piktogramem „brak zdjęcia”.
http://ateneum.net.pl/dbupdate/imagelarge.php?id=ident_ate
Format pliku:
Rozmiar obrazu:
Parametry:
JPG
różny (nieokreślony)
id
Identyfikator towaru w bazie Ateneum
Funkcja ta zwraca jest zamiennikiem funkcji image.php. Jej działanie jest identyczne, z tym że obrazek
jest zwracany w największym dostępnym w naszej bazie rozmiarze.
• Towary z polami dodatkowymi
http://ateneum.net.pl/dbupdate/pozdodlista.php
Format pliku:
lista
Plik zawiera listę (po jednym na każdą linijkę) identyfikatorów towarów ident_ate, do których
dysponujemy dodatkowymi danymi, możliwymi do pobrania procedurą pozycja_dodatkowe.php.
• Pobieranie dodatkowych pól
http://ateneum.net.pl/dbupdate/pozycja_dodatkowe.php?id=ident_ate
Format pliku:
Kodowanie znaków:
Separator pół:
Separator dziesiętny
Parametry:
CSV
Latin 2 (ISO-8859-2)
, (przecinek)
. (kropka)
id
Identyfikator towaru w bazie Ateneum
Wygenerowany plik zawiera dane dodatkowe dotyczące rekordu wybranego za pomocą parametru id.
W przypadku podania nieprawidłowego identyfikatora towaru zwrócony zostanie komunikat o błędzie. Jeżeli dla
wybranego identyfikatora towaru baza danych Ateneum nie posiada żadnych danych dodatkowych, zwrócony
zostanie wiersz zawierający same puste pola.
Przykładowa linia danych:
ideat_ate,wydawnictwo,autor,rok_wydania,data_premiery,seria,przedmiot,klasa,nr_dopusczenia,oprawa,format,
ilosc_stron,producent,material,wymiary,il_elementow,grupa_wiekowa,opakowanie
Opis pól:
ident_ate
parametr id
wydawnictwo
autor
rok_wydania
data_premiery
seria
przedmiot
klasa
nr_dopusczenia
oprawa
format
ilosc_stron
producent
material
wymiary
-
identyfikator towaru w bazie Ateneum – identyczny z podanym jako
-
nazwa wydawnictwa
autor
rok wydania
data premiery
seria do jakiej należy ten towar
przedmiot (tylko dla podręczników)
klasa (tylko dla podręczników)
numer dopuszczenia (tylko dla podręczników)
oprawa (twarda, broszurowa itd…)
wymiary pozycji w cm (tylko dla książek)
ilość stron
producent
przeważający materiał wykonania
wymiary
il_elementow
grupa_wiekowa
opakowanie
-
liczba elementów
grupa wiekowa
opakowanie (folia, pudełko)