Instrukcja obsługi aplikacji WebMobile7 and Sello Integrator wersja 1.1.2 Piotr Taraszkiewicz Strona 1
Spis treści 1 WSTĘP O APLIKACJI 3 2 KONFIGURACJA APLIKACJI 4 2.1 KONFIGURACJA POŁĄCZENIA 4 2.2 POZOSTAŁE PARAMETRY 6 2.3 USTAWIENIE WAGI: 7 3 IMPORT DANYCH Z SELLO 8 3.1 WYBÓR DOSTAWCY I SPOSOBU WYSYŁKI 8 3.2 OGRANICZENIE IMPORTOWANYCH DANYCH DATY 9 4 ZAPIS WYEKSPORTOWANEGO PLIKU 10 5 IMPORT NUMERÓW NADAWCZYCH 11 Piotr Taraszkiewicz Strona 2
1 Wstęp o aplikacji Aplikacja została utworzona w celach zwiększania kompetencji dlatego też udostępniona jest za darmo na stronie www.pejoter.cba.pl. Kopiowanie i rozpowszechnianie jest dozwolone. Celem aplikacji jest uproszczenie procesu wysyłki firmom/osobom korzystających z oprogramowania Sello firmy INSert (www.sello.pl) oraz aplikacji kurierskiej WebMobile7 (zwanym dalej WM7) firmy Siódemka S.A. (www.siodemka.com). Uproszczenie to polega na wyciągnięciu danych o paczkach z programu Sello i eksport ich w postaci pliku XLS (Excel) importowanego następnie w WebMobile7. Teraz zamiast ręcznego przepisywania wszystkich przesyłek do aplikacji WebMobile7 lub ręcznego wypisywania listów przewozowych mamy możliwość wydruku wszystkich etykiet adresowych w znacznie krótszym czasie. Poniżej przestawione są diagramy pokazujące przebieg procesów z zastosowaniem aplikacji WM7 and Sello Integrator (lewa strona) oraz bez niej (prawa strona). Można zauważyć że bez aplikacji trzeba było powtarzać tą samą czynność (wprowadzanie listu) tyle razy ile mieliśmy paczek do wysłania. Piotr Taraszkiewicz Strona 3
2 Konfiguracja aplikacji WM7 and Sello Integrator v1.1.2 Aby umożliwić pracę z aplikacją należy skonfigurować połączenie z bazą danych Sello oraz opcje eksportu do pliku XLS w formacie Siódemki. Aplikację konfigurujemy w drugiej zakładce (screen poniżej) 1 2 3 Gdzie: 1 nazwy poszczególnych opcji programu 2 wartości poszczególnych opcji programu 3 pole opisu zawierające dodatkowe informacje o aktualnie wybranej opcji Pole nazw podzielone jest na parę rozwijalnych części ułatwiających odszukanie pożądanej pozycji. Konfiguracja Połączenia pozwala na ustawienie połączenia z bazą danych Sello (MS SQL Server) Konfiguracja importu sekcja zawiera opcje brane pod uwagę przy imporcie danych o paczkach z Sello Konfiguracja eksportu ustawienia eksportu do pliku XLS Inne inne opcje 2.1 Konfiguracja połączenia Aby aplikacja mogła odczytać dane o przygotowywanych przez nas paczkach musimy podać parametry dostępu do bazy danych Sello, inaczej nie będzie możliwy ich import. Na szczęście dla nas sam producent podaje niektóre z nich tak więc mamy ułatwione zadanie. Piotr Taraszkiewicz Strona 4
1 2 Serwer wpisujemy nazwę serwera aplikacji pokazanego przy uruchamianiu Sello (oznaczonej cyfrą 2 na rysunku powyżej). Domyślnie jest to ciąg znaków złożony z nazwy komputera i słowa INSERTGT (w moim przypadku PJR\INSERTGT, gdzie PJR to nazwa komputera) Nazwa bazy wpisujemy nazwę bazy danych wybieraną z listy przy uruchamianiu aplikacji (oznaczonej cyfrą 1 ) Nazwa użytkownika wpisujemy tutaj nazwę użytkownika BAZY DANYCH a nie samej aplikacji. NIE wpisujemy tutaj nazwy użytkownika wybieranego z listy przy uruchamianiu aplikacji (tj Szef, Duda Ania, Duda Marcin). Domyślną wartością ustaloną przez producenta jest sa i jeżeli nie modyfikowaliśmy ustawień bazy danych to NIE POWINNIŚMY wpisywać innej wartości w te pole. Hasło użytkownika wpisujemy tutaj hasło danego użytkownika bazy danych. Podobnie jak w przypadku nazwy NIE podajemy w tym miejscu hasła do aplikacji TYLKO do BAZY DANYCH. Domyślną wartością ustawioną przez producenta jest wartość pusta i jeżeli nie modyfikowaliśmy tego należy te pole pozostawić nieuzupełnione. Po konfiguracji połączenia będziemy już w stanie zaimportować pierwsze przesyłki. W przypadku jeżeli podaliśmy nieprawidłowe dane i program nie będzie w stanie podłączyć się do bazy danych powiadomi nas o tym stosownym komunikatem (rysunek poniżej) Piotr Taraszkiewicz Strona 5
2.2 Pozostałe parametry WM7 and Sello Integrator v1.1.2 Kolejnym krokiem jest ustawienie pozostałych opcji, które ułatwią pracę z aplikacją. Waga z Sello parametr pozwalający określić czy ma być importowana waga ustawiana w Sello (rysunek poniżej). Możliwości wyboru: True waga ta będzie importowana i na jej podstawie będzie określona waga przesyłki False waga ta będzie importowana ale na jej podstawie NIE będzie określana waga przesyłki Określanie wagi polega na sprawdzeniu w którym przedziale wagowym (Siódemki) mieści się liczba i ustawiana jest właściwa waga. Zawsze ustawiana jest waga wyższa, np. mamy paczkę o wadze 7 kg to ustawiona będzie waga do 10 kg. Czy nick to nr_ext? - opcja pozwala na zapis nicku odbiorcy do pola Nr ext w pliku XLS. Pole te pozwala na sprawniejsze wyszukiwanie przesyłek kierowanych do tego odbiorcy w aplikacji WebMobile7. Według specyfikacji Siódemki: nr ext jest to numer identyfikacji klienta w systemie nadawcy. Możliwości wyboru: True nick będzie wstawiany do pola nr_ext i importowany do WebMobile7 False nick NIE będzie wstawiany do pola nr_ext i importowany do WebMobile7 Czy nick w nr zewnętrznym opcja pozwala na zapis nicku odbiorcy (kupującego) do pola oznaczonego jako Numer_zewnętrzny. Po wstawieniu tam nick u będzie on widoczny na wydrukowanym liście przewozowym z systemu Siódemki. Możliwości wyboru: True nick będzie wstawiany do pola nr_zewnetrzny i importowany do WebMobile7 False nick NIE będzie wstawiany do pola nr_zewnetrzny i importowany do WebMobile7 Ilość paczek domyślna ilość paczek wysyłanych do jednego odbiorcy. Domyślnie wartość ta ustawiona jest na 1. Możemy podać tu dowolną wartość liczbową. W przypadku wprowadzenia większej liczby (na 2 ) z aplikacji WebMobile7 wydrukują się 2 etykiety i istnieje zagrożenie obciążenia za dwie przesyłki, dlatego też zaleca się pozostawienie domyślnej wartości ( 1 ). Piotr Taraszkiewicz Strona 6
Nazwisko nadawcy nazwisko nadawcy przesyłek. Pole to jest wymagane przez WM7 i bez wpisania żadnej wartości nie będzie możliwy import danych z poziomu WM7. Wartość z tego pola doklejana jest do każdego wiersza w pliku XLS (czyt. Do każdej przesyłki). Numer Zewnętrzny parametr pozwalający na określenie czy do pola nr_zewnętrzny ma być wstawiany symbol paczki (nr_paczki/rok), który służy do identyfikacji paczki w Sello. Możliwości wyboru: True numer paczki będzie wstawiany do pola nr_zewnetrzny i importowany do WebMobile7 False numer paczki NIE będzie wstawiany do pola nr_zewnetrzny i importowany do WebMobile7 UWAGA! Jeżeli nie wstawimy tego numeru nie będzie można zaimportować numerów nadawczych do Sello!!! Opis zawartości pole pozwalające na ustawienie stałego opisu doklejanego do każdego wiersza pliku xls (czyt.: do każdej przesyłki). Pole to jest wymagane w systemie Siódemki przy przesyłkach ubezpieczonych. Jeżeli nie wstawimy tu wartości i będziemy eksportować przesyłki pobraniowe WM7 może wyświetlić komunikat błędu. Waga przesyłek pole pozwalające na ustalenie stałej wagi przesyłek. Pole te powiązane jest z opcją Waga z Sello i działa razem z nią. Jeżeli chcemy ustawić stałą wagę dla każdej przesyłki (np. tą z umowy) musimy ustawić opcje: Waga z Sello: False Waga użytkownika: True W przeciwnym wypadku może być wstawiona waga pobrana z Sello (traktowana jest jako priorytet) Waga użytkownika opcja włączająca/wyłączająca możliwość wprowadzania stałej wagi; Możliwości wyboru: True waga użytkownika z pola Waga przesyłek będzie brana pod uwagę przy eksporcie danych False waga użytkownika z pola Waga przesyłek NIE będzie brana pod uwagę przy eksporcie danych 2.3 Ustawienie wagi Konfiguracja Waga z Sello: True Waga użytkownika: True Waga z Sello: False Waga użytkownika: True Waga z Sello: True Waga użytkownika: False Rezultat Wstawiana będzie waga pobrana z aplikacji Sello, jeżeli zaimportowana wartość będzie zerowa wstawiona będzie waga użytkownika W każdym wierszu wstawiana będzie waga użytkownika W każdym wierszu wstawiana będzie waga pobrana z Sello Piotr Taraszkiewicz Strona 7
3 Import danych z Sello WM7 and Sello Integrator v1.1.2 Po prawidłowym skonfigurowaniu aplikacji można przejść do importu pierwszych przesyłek z Sello. Wszystkich opisanych w tym rozdziale dokonujemy w pierwszej zakładce Pobieranie Danych (rysunek poniżej). 1 2 3 1 Wybór dostawcy i sposobu wysyłki 2 Ograniczenie importowanych danych - daty 3 Wyświetlenie wyników importu 3.1 Wybór dostawcy i sposobu wysyłki Wyboru dostawcy dokonujemy przez kliknięcie na listę rozwijaną Dostawcy. Zostanie wyświetlona lista dostawców z aplikacji Sello. W przypadku wyboru określonego dostawcy importowane będą tylko przesyłki oznaczone znacznikiem wybranego dostawcy. Aby wyświetlić sposoby wysyłki należy kliknąć w listę rozwijaną Sposoby wysyłki zostanie wyświetlona lista wprowadzonych w Sello sposobów wysyłki dla uprzednio wybranego dostawcy. W przypadku próby wyświetlenia listy bez wyboru dostawcy zostanie wyświetlony odpowiedni komunikat. Wybór sposobu wysyłki zawęzi zakres importowanych przesyłek do tych oznaczonych danym sposobem wysyłki inne przesyłki nie będą importowane. Piotr Taraszkiewicz Strona 8
3.2 Ograniczenie importowanych danych daty W związku z tym iż każda firma pracuje inaczej to każda firma wymaga innego rozwiązania. Dlatego też mamy możliwość wyboru między: Datą utworzenia datą utworzenia paczki w Sello Datą modyfikacji datą modyfikacji paczki w Sello Datą wysłania datą wysłania paczki (oznaczenia jako wysłana w Sello) W sytuacji kiedy nie będzie wybrana żadna data (wszystkie checkboxy będą odznaczone) zaimportowane zostaną przesyłki które nie były oznaczone jako wysłane. Nie będzie brana pod uwagę żadna data (mogą wyświetlić się paczki nawet z poprzednich lat). Aby wybrana przez nas data była brana pod uwagę należy zaznaczyć checkbox a przy jej nazwie i wybrać pożądaną wartość z pól wyboru daty jak na rysunku poniżej. Jeżeli tylko zaznaczymy checkbox a i nie wybierzemy żadnego zakresu dat zostaną zaimportowane przesyłki z dnia dzisiejszego (z dat widocznych w polach wyboru). UWAGA! Jeżeli wybierzemy więcej niż jedną datę warunki zostaną połączone i zaimportowane zostaną tylko przesyłki spełniające oba kryteria. Piotr Taraszkiewicz Strona 9
4 Zapis wyeksportowanego pliku WM7 and Sello Integrator v1.1.2 Jeżeli pobraliśmy już dane o przesyłkach które chcemy wysłać zostanie zapisanie ich do pliku w celu dalszego procesowania. Aby to wykonać klikamy w przycisk Eksport do XLS zostanie otworzone okno w którym wybieramy lokalizację zapisu oraz nazwę pliku (rysunek poniżej). Po wpisaniu nazwy pliku klikamy przycisk Zapisz plik z danymi zostanie zapisany w podanej lokalizacji. Teraz należy zaimportować dane w aplikacji WebMobile7 (proces ten w niniejszej instrukcji został pominięty) Piotr Taraszkiewicz Strona 10
5 Import numerów nadawczych WM7 and Sello Integrator v1.1.2 Po wykonaniu eksportu do pliku excela i zaimportowaniu przesyłek do WebMobile7 zostały nadane tym przesyłkom numery nadawcze (numery listów przewozowych) które teraz możemy pobrać do Sello. W pierwszej kolejności należy pobrać raport z aplikacji Siódemki. Najlepszy do tego będzie raport Listy nadane (zawiera wszystkie wydrukowane listy zawarte na dokumencie wydania). Eksportujemy raport z systemu Siódemki do wybranej lokalizacji i przechodzimy do trzeciej zakładki naszej aplikacji Import z WM7 (rysunek poniżej) Klikamy przycisk Import z XLS otworzy się okno w którym wskazujemy plik raportu wyeksportowanego z WebMobile7 (rysunek poniżej) Klikamy przycisk Otwórz plik zostanie wczytany przez aplikację (rysunek poniżej) Piotr Taraszkiewicz Strona 11
Aby wprowadzić numery nadawcze do przesyłek klikamy przycisk Zapis do Sello w kolumnie Status zostanie wyświetlony status operacji. W przypadku jak do paczki w polu nadawczym będzie wpisana jakaś wartość aplikacja nie nadpisze zmiany, zostanie wpisany status jak poniżej: Jeżeli chcemy aby wszystkie numery były nadpisane zaznaczamy checkbox Nadpisywanie i klikamy Zapis do Sello Aplikacja przed zapisem do Sello sprawdza format numeru zewnętrznego w pliku, jeżeli nie będzie on zgodny (inny niż numer/rok/dane) zostanie wyświetlony odpowiedni status. Piotr Taraszkiewicz Strona 12