Rejestracja sprzedaży Powoli zbliżamy się do zakończenia prac nad projektem Hurtownia. Zajęcia 5 zjazdu szkoleniowego zostaną poświęcone na zabezpieczenie procesu rejestracji sprzedaży. Problem będzie dość skomplikowany, ale da także możliwość pokazania wielu nowych rozwiązań jak i uporządkowania dotychczasowej wiedzy i umiejętności. Sformułowanie problemu Celem jest przygotowanie formularza ekranowego pozwalającego na obsługę sprzedaży produktów oferowanych przez hurtownię w zakresie: 1. Wyboru nabywcy z pola kombi z ewentualną możliwością zarejestrowania nowego nabywcy bezpośrednio z formularza sprzedaży; 2. Wyboru produktu z pola kombi znając w miarę możliwości jego dokładny opis (nazwa produktu, wielkość i rodzaj opakowania, nazwa dostawcy, cena jednostkowa); 3. Ustalenie liczby opakowań wybranego produktu w taki sposób, aby nie było możliwości przekroczenia liczby dostępnych opakowań; 4. Przed zaakceptowaniem wyboru nabywca powinien znać wartość netto i brutto wybranej ilości opakowań; 5. Możliwość dodania wybranego produktu do koszyka zakupów wraz z wyświetleniem kwoty brutto wartości koszyka; 6. Możliwość rezygnacji z wybranego pojedynczego produktu (wycofanie go z koszyka zakupów); 7. Zarejestrowanie sprzedaży w dwóch tabelach bazy danych: sam fakt sprzedaży w tabeli Sprzedaz, a jej detali w tabeli DetaleSprzedazy. Jednocześnie w tabeli tempmagazyn muszą być zarejestrowane informacje dla obsługi magazynu pozwalające na wydanie w pierwszej kolejności tych opakowań danego produktu, którym najwcześniej kończy się data przydatności; 8. Przygotowanie faktury VAT dokumentującej fakt dokonania zakupu. Baza danych, potrzebne tabele i procedury przechowywane Projekty tabel Sprzedaz i DetaleSprzedazy pokazane są niżej, obie tabele połączone są relacją typu jeden-do-wielu poprzez pole ids. Dla potrzeb obsługi magazynu została utworzona pomocnicza tabela tempmagazyn, umieszczane w niej będą informacje ułatwiające wydawanie zakupionych produktów z przestrzeganiem zasady, aby te same produkty były wydawane wg najkrótszych terminów ich przydatności. 1
Dane będą wstawiane do tych tabel poprzez pokazane niżej procedury przechowywane. Pierwsza z nich odpowiada za zarejestrowanie faktu sprzedaży, jej zadaniem jest także zwrócenie identyfikatora wstawionego rekordu, który będzie wykorzystany jako jeden z argumentów w drugiej procedurze. Pokazana niżej procedura będzie odpowiadać za zarejestrowanie detalu sprzedaży, będzie ona wywołana tyle razy, ile różnych produktów będzie zakupionych w jednej transakcji. Obie pokazane wyżej procedury będą uruchamiane przy obsłudze transakcji, czyli z możliwością wycofania wszystkich zmian w obu tabelach w sytuacji, gdyby były problemy z ich wykonaniem. Do tabeli tempmagazyn informacje będą wprowadzane z pomocą pokazanej niżej procedury. Po wydaniu zakupionych produktów informacja o nich będzie usuwana z tej tabeli z pomocą kolejnej procedury przechowywanej. Poza pokazanymi procedurami do obsługi procesu sprzedaży będą jeszcze potrzebne procedury zabezpieczające funkcjonowanie formularza, który za moment będziemy projektować, Kolejno zostaną przedstawione te procedury. Pierwsza z tych procedur będzie odpowiedzialna za dostarczenie danych do pola kombi, które będzie pozwalało na wybór nabywcy (odbiorcy) oferowanych produktów. Pokazana niżej procedura będzie dostarczać informacji o dostępnych produktach, poza identyfikatorem produktu i jego rozbudowaną nazwą zwraca ona kilka dodatkowych informacji, które będą potrzebne przy obsłudze sprzedaży (dostępna liczba opakowań, cena jednostkowa opakowania, stawka podatku VAT). Informacje zwrócone przez tą procedurę będą wykorzystane do zbudowania instancji klasy CProdukty, której zadaniem będzie zawarcie w jednym obiekcie szeregu właściwości danego produktu. Klasa CProdukty na ten moment jeszcze nie istnieje, utworzymy ją za chwilę. W klasie tej nadpiszemy metodę ToString tak, aby instancje tej klasy można było wykorzystać jako elementy pola kombi pozwalającego na wybór produktów. Rekordset zwracany przez tę procedurę będziemy także przechowywać w jawnej postaci w jakimś pomocniczym obiekcie (np., w DataGridView lub DataTable) na potrzeby modyfikacji źródła danych dla pola 2
kombi pozwalającego na wybór produktów (np., w momencie wyczerpania wszystkich opakowań) czy na obsługę wycofania z koszyka jakiegoś produktu. Pokazana niżej procedura będzie uruchamiana dla każdego produktu w koszyku zakupów, a jej zadaniem jest przygotowanie informacji dla obsługi magazynu w sensie wskazania opakowań, które mają być wydane, Dane te ostatecznie trafią do tabeli tempmagazyn. Projekt formularza frmsprzedaz Dodajemy do rozwiązania nowy formularz o nazwie jak wyżej i umieszczamy na nim formanty tak, jak to pokazano niżej. 3
Formanty tego formularza i ich nazwy systemowe pokazane są w widoku Document Outline (menu View/Other Windows). Przed napisaniem kodu procedur obsługujących funkcjonowanie tego formularza musimy przygotować dwie nowe klasy o nazwach CSprzedaz oraz CProdukty, będą one zawierać metody i właściwości, które wykorzystamy w kodzie formularza frmsprzedaz. Obiekt klasy CSprzedaz Zaczynamy od dodania do rozwiązania nowego obiektu typu Class o nazwie CSprzedaz.vb. Obiekt ten będzie zawierał oprócz klasy CSprzedaz także klasę CProdukty (trochę nietypowo, ale jest to dopuszczalne). Poniżej widok tego obiektu z zaimportowanym szeregiem przestrzeni nazw, takie przestrzenie jak System.Data i System.Data.SqlClient są niezbędne do współpracy z bazą danych MS SQL, a System.Math pozwoli na korzystanie z funkcji Round. Pozostałe trzy przestrzenie wykorzystamy do przygotowania raportu faktury jako dokumentu Worda. W obiekcie CSprzedaz.vb utworzono dwa interfejsy, pierwszy z nich o nazwie ISprzedaz zawiera zapowiedzi tych właściwości (Function) i metod (Sub), które wykorzystamy do obsługi sprzedaży. Interfejs IMagazyn zapowiada właściwości i funkcje, które wykorzystamy do obsługi magazynu na etapie wydawania zakupionych produktów. 4
W kodzie klasy CSprzedaz wpisujemy instrukcje dziedziczenia po klasie CForStorageSub, zapowiedzi implementacji obu interfejsów oraz deklarujemy zmienne prywatne klasy. W kolejnym kroku tworzymy kod poszczególnych funkcji. Pokazana niżej metoda będzie odpowiedzialna za przygotowanie formularza frmsprzedaz do pracy, jej zadaniem jest pobranie z bazy danych informacji będących źródłem danych dla formantu cbonabywca oraz pobranie danych, które opisują dostępne produkty. Dane te są zapisywane w publicznej zmiennej zadeklarowanej w formularzu frmsprzedaz. Kolejna metoda odpowiada za przygotowanie informacji o tym, ile opakowań i z których dostaw będą wydane dla zrealizowania faktu sprzedaży danego produktu (chodzi o to, aby w momencie dysponowania tym samym produktem z dwóch rożnych dostaw wydawać te opakowania, które były przyjęte wcześniej, czyli te, którym kończy się termin przydatności do spożycia). 5
Metoda zarejestrowania sprzedaży wykorzystuje mechanizm transakcji udostępniony przez klasę bazową. 6
Ostatnia metoda interfejsu ISprzedaz jest najbardziej rozbudowana, a jej zadaniem jest przygotowanie faktury sprzedaży. Faktura będzie przygotowana jako dokument Worda w oparciu o szablon Faktura.dotx zlokalizowany w folderze wskazanym zmienną strfolderfaktury, który może być bezpośrednio wydrukowany na drukarce lub zachowany w postaci pliku PDF. Zostaną wykorzystane możliwości MS Word w wyeksportowaniu pliku do formatu PDF. 7
8
Metoda powyższa korzysta z prywatnej procedury klasy, której zadaniem jest zwolnienie aplikacji MS Word. Procedura została w całości skopiowana z Internetu, o czym informuje stosowny komentarz 9
Klasa CProdukty Jak o tym wspominałem wcześniej klasa ta będzie wykorzystana do zbudowania obiektów dodawanych do pola kombo cboprodukty. 10
Kod formularza frmsprzedaz Kod formularza zaczyna się zaimportowaniem przestrzeni nazw: System.Math będzie nam potrzebna z uwagi na wykorzystanie funkcji Round. W sekcji deklaracji deklarujemy te zmienne klasy, które mają być dostępne dla wszystkich jej procedur i funkcji. Poza znanymi z wcześniejszych rozwiązań typami danych deklarujemy tu i tworzymy obiekt będący kolekcją. Na uwagę zasługuje także obiekt dt typu DataTable, który będzie źródłem danych dla gridu dgvkoszyk. Na tym etapie jest to tylko deklaracja, później utworzymy ten obiekt i dodamy do niego kolumny określonego typu danych. Procedura poniższa wykonywana jest w momencie uruchomienia formularza, kończy jego przygotowanie do pracy. 11
Procedura pokazana niżej dba o to, aby formant cboprodukty był dostępny dla użytkownika w momencie, gdy zostanie wybrany nabywca w polu cbonabywca. Kolejna procedura wykonywana jest w momencie wyboru produktu w polu cboprodukty, musi ona wykonać szereg prac związanych z określeniem ceny jednostkowej produktu, stawki Vat jak i liczby dostępnych opakowań. Informacje te muszą być odzyskane z wybranej pozycji w polu kombi poprzez jej przekonwertowanie na typ CProdukty, co pozwoli na skorzystanie z właściwości tej klasy. Prywatna funkcja klasy formularza UstalIndex wykorzystywana jest do odszukania wybranego produktu w kolekcji jgkol w celu pobrania z kolekcji aktualnej dostępnej liczby opakowań. 12
Zmiana liczby opakowań w formancie nudile uruchamia pokazaną niżej procedurę, jej zadaniem jest zaktualizowanie informacji o wartości netto i brutto wybranego produktu. Klik przycisku btndodaj uruchamia kolejną procedurę, jej zadaniem jest dodanie informacji o wybranym produkcie do gridu dgvkoszyk. 13
Nabywca może się rozmyśleć co do zakupu produktu, który już jest w koszyku, a my musimy stworzyć możliwość usunięcia takiego produktu z gridu dgvkoszyk. Zadanie to realizuje pokazana niżej procedura. 14
15
Kilka zrzutów ekranowych obsługi sprzedaży 16