Wstęp
Proces konwersji danych wymaga uzyskania przez każdą agencję unikalnego na całej platformie asariMLS identyfikatora ID oraz Tokenu do konta na asariWEB.
Rozpoczęcie czynności związanych z uzyskaniem ID oraz Tokenu wymaga zarejestrowania konta na platformie asariMLS.
Rejestracji konta dokonujemy korzystając z formularza rejestracyjnego: http://asariweb.pl/userBase/register
Po dokonaniu rejestracji należy zalogować się do aplikacji na stronie: http://asariweb.pl a następnie przejść do opcji Twoje ustawienia.
W przypadku problemów z dostępem do asariWEB skorzystaj z pomocy.
Na zakładce Ustawienia aplikacji należy przejść do opcji API gdzie widoczne jest ID i Token
Uwaga!
Posiadanie identyfikatora (ID) oraz Tokenu równoznaczne jest możliwością dostania się do danych na zarejestrowanym koncie przy wykorzystaniu udokumentowanych funkcji API.
Przekazywanie tych informacji osobom postronnym jest operacją niepożądaną !
W przypadku wykonywania konwersji danych przez osoby postronne, należy po zakończeniu konwersji zmodyfikować Token poprzez kontakt z Działem Obsługi Klienta.
Od wersji e-Biuro Nieruchomości 8.54.1276 konwerter jest automatycznie pobierany do głównego katalogu instalacji programu EBIURO.
Konwerter możemy również pobrać samodzielnie uruchamiając w przeglądarce link: http://pliki.asari.pl/swo/KonwerterEBAW.exe
W przypadku samodzielnego pobrania pliku konwertera wgrywamy go do głównego katalogu EBIURO i tylko z tego miejsca uruchamiamy.
Konwerter może być uruchamiany wielokrotnie. Może być uruchamiany z różnych stanowisk. Opcje dostępne w każdej z zakładek mogą być wywoływane wielokrotnie.
Proces konwersji to proces wieloetapowy. Nieodłączne w tym procesie jest obserwowanie wysyłanych na adres administratora konta (osoby która zakładała konto na asariWEBie) komunikatów o błędach.
Dostrzeżone błędy należy poprawić w programie e-Biuro Nieruchomości a następnie powtórzyć etap konwersji w którym pojawiły się błędy.
Po wprowadzeniu danych aktywuje się klawisz Zaloguj do konta. Naciśnięcie klawisza powoduje zweryfikowanie danych i w przypadku ich prawidłowej postaci podłączenie do konta asariWEB.
Podłączenie do konta powoduje wyświetlenie nazwy firmy, NIPu oraz adresu e-mail związanego z kontem asariWEB oraz pojawienie się zakładek z kolejnymi krokami konwersji.
Każda zakładka w górnej części okna zawiera, krótką informację, z którą należy się zapoznać.
ETAP 00 - Ogólne
Konwerter z definicji konwertuje oferty o statusie:
- AKTUALNA
- ZAWIESZONA
- ZREALIZOWANA
Jeżeli chcemy konwertować również oferty o statusie NIEAKTUALNA należy w zakładce o nazwie 00 – Ogólne zaznaczyć opcję RÓWNIEŻ OFERTY NIEAKTUALNE
Konwerter umożliwia pracę w trybie konwersji przyrostowej (zaznaczona opcja KONWERSJA PRZYROSTOWA) lub w trybie konwersji pełnej (odznaczona opcja KONWERSJA PRZYROSTOWA)
Tryb konwersji pełnej
W tym trybie, konwerter w każdym z etapów bierze pod uwagę wszystkie dane, bez względu na to ile razy już był uruchamiany.
Jeśli jakaś informacja była już skonwertowana to ją pomija, chyba, że została zaznaczona opcja Nadpisz jeśli istnieje (Opcja ta jest dostępna tylko w niektórych krokach)
W przypadku zaznaczonej opcji Nadpisz jeśli istnieje, konwerter nadpisuje na istniejące już w asariWEBie dane, dokonując przez to ich aktualizacje.
Konwersja pełna jest procesem dłuższym czasowo od konwersji przyrostowej.
Tryb konwersji przyrostowej
W tym trybie, konwerter w każdym z etapów bierze pod uwagę tylko te dane, które zostały zmienione lub pojawiły się jako nowe od ostatniego uruchomienia konwertera.
Opcja Nadpisz jeśli istnieje jest domyślnie zaznaczona. W trybie konwersji przyrostowej nie można tej opcji odznaczyć.
W tym przypadku konwerter nadpisuje na istniejące już w asariWEBie dane, dokonując przez to ich aktualizacje lub wprowadza nowe pozycje, które pojawiły się od ostatniej konwersji.
Konwersja przyrostowa jest procesem krótszym czasowo od konwersji pełnej.
ETAP 01 - Oddziały
Pierwszy krok konwersji umożliwia zdefiniowanie oddziałów agencji. Jeśli agencja nie posiada oddziałów, przechodzimy do następnego etapu konwersji.
ETAP 02 - Agenci
Kolejnym krokiem jest importowanie agentów.
Import agentów rozpoczynamy od naciśnięcia klawisza Raport. Spowoduje on wyświetlenie na ekranie listy ewentualnych błędów w definicji użytkowników w programie e-Biuro Nieruchomości.
Raportowane błędy:
- posiadanie przez kilku użytkowników tego samego adresu e-mail (asariWEB wymaga aby każdy użytkownik posiadał unikalny adres email)
- brak u użytkownika adresu email
- brak u użytkownika numeru telefonu komórkowego (asariWEB wymaga aby każdy użytkownik posiadał unikalny adres email)
Raportowane błędy należy poprawić w programie e-Biuro Nieruchomości i powtórzyć wywołanie raportu
W sytuacji gdy raport nie zwraca nam błędów lub akceptujemy jego wynik (nie wprowadzamy poprawek) rozpoczynamy import naciskając klawisz Importuj.
Po dokonanym imporcie agentów wracamy do aplikacji asariWEB, i przechodzimy do opcji Administracja, wybieramy zakładkę Grupy i w celu nadania prawidłowych uprawnień dla grupy Administrator systemu naciskamy ikonę żółtego ołówka.
W oknie edycji uprawnień grupy o nazwie Administrator systemu zaznaczamy wszystkie opcje widoczne z lewej strony ekranu.
Przy niektórych opcjach jest dodatkowa ikonka, którą należy kliknąć aby wejść w definicje zakresu uprawnień.
W każdym z okien definicji zakresu uprawnień dla grupy Administrator systemu ustawiamy opcję Cała firma (wszystki ebiura) analogicznie jak pokazuje poniższy rysunek.
Po tych czynnościach wracamy do konwertera. Możemy rozpocząć proces dopasowywania pracowników.
ETAP 03 - Agenci - MAPA
Dopasowywanie pracowników dotyczy definicji pracowników dostępnych już w asariWEB do tych obecnych w e-Biuro Nieruchomości przy każdej z ofert i kliencie.
Przed rozpoczęciem dopasowania definicji agentów należy nacisnąć klawisz Importuj.
Konwerter w tym momencie przeanalizuje zawartość bazy danych e-Biuro Nieruchomości i wyświetli w oknie konwertera wszelkie napotkane w e-Biuro Nieruchomości wystąpienia nazw agentów, które pojawiają się przy ofercie oraz przy kliencie.
Po zakończeniu importu należy na każdej pozycji listy dokonać dopasowanie - Ctrl+D - Dopasuj
ETAP 04 - Lokalizacje ofert
Jednym z najbardziej pracochłonnych etapów jest dopasowywanie lokalizacji wprowadzonych w e-Biuro Nieruchomości przy ofertach oraz przy kryteriach poszukiwań (ETAP 04a) do lokalizacji w asariWEB.
Po zaimportowaniu lokalizacji - klawisz Importuj, należy każdą pozycję dopasować korzystając z opcji Ctrl+D - Dopasuj. Dla ułatwienia pracy, możemy skorzystać z opcji Pokaż tylko lokalizacje nie dopasowane.
Po zaznaczeniu tej opcji na liście będą widoczne tylko te pozycje, które wymagają jeszcze naszej ingerencji.
Wywołanie opcji Dopasuj powoduje pojawienie się okienka Ustalenie lokalizacji GUS -> Adres oferty. W okienku tym mamy możliwość poprawienia nazwy województwa i modyfikowania w polu Szukaj wpisu w taki sposób aby naciśnięcie klawisza Enter - Szukaj skutkowało pojawieniem się na liście Lokalizacje GUS dopuszczalnych wartości lokalizacji. Dla ułatwienia poniżej listy Lokalizacji GUS ekran prezentuje numery ofert, w której występuje dopasowywana przez nas aktualnie lokalizacja.
Poniższe ekrany obrazują sposób ?mapowania? lokalizacji.
ETAP 04a - Lokalizacje sesji
Podobną pracę jak przy Etapie 04 należy wykonać przy Etapie 04a. Dotyczy on lokalizacji, które występują w e-Biuro Nieruchomości przy sesjach skojarzonych z poszukującymi.
ETAP 05 - ETAP 14
Od etapu 05 do 14 na każdej z zakładek wciskamy jedynie klawisz Importuj i czekamy na zakończenie procesu importu.
W etapach 06 do 14 po każdym z wykonanych importów wysyłany jest na adres e-mail widoczny na ekranie Start konwertera mail z raportem informującym o skuteczności wykonanego w danym kroku importu.
W przypadku zarejestrowanych błędów należy poprawić dane w programie e-Biuro Nieruchomości i ponownie uruchomić konwersję danych.
Uwaga!
Wszelkie uwagi prosimy zgłaszać na adres mailowy Działu Obsługi Klienta: dok@asari.pl
Najczęściej zadawane pytania (FAQ)
Mapowanie lokalizacji zagranicznych.
W przypadku gdy w Etapie 04 konwerter pyta się nas o dopasowanie lokalizacji zagranicznych należy dokonać dowolnego dopasowania wybierając np. /Zachodniopomorskie/Szczecin.
Konwerter podczas konwersji ofert z lokalizacjami zagranicznymi nie bierze pod uwagę dopasowywania wykonanego w etapie czwartym.
Konwertuje lokalizacje dokładnie tak jak zostały wprowadzone do programu e-Biuro Nieruchomości.
Komunikat: "Błąd uploadu dokumentu"
Należy sprawdzić, czy w podanej przez konwerter lokalizacji znajduje się plik dokumentu.
Najczęstszą przyczyną pojawiania się tego komunikatu, jest dołączanie w e-Biuro Nieruchomości dokumentów znajdujących się poza serwerem, na którym zainstalowane jest e-Biuro Nieruchomości.
Konwerter w takiej sytuacji "nie widzi" plików, które należałoby skonwertować.
Rozwiązaniem jest przeniesienie plików z dysków lokalnych na serwer i poprawienie ścieżek w e-Biuro Nieruchomości.
Komunikat: "Błąd uploadu zdjęcia"
Należy sprawdzić, czy w podanej przez konwerter lokalizacji znajduje się plik zdjęcia.
Najczęstszą przyczyną pojawiania się tego komunikatu, jest usunięcie w e-Biuro Nieruchomości z katalogu ARCHIWUM zdjęć oferty.
Konwerter w takiej sytuacji "nie widzi" plików zdjęć, które należałoby skonwertować.
Komunikat: "Nie znaleziono location.id"
Pojawienie się tego komunikatu oznacza rozbieżność danych w programie e-Biuro Nieruchomości wpisanych na zakładkę Dane adresowe względem danych adresowych wpisanych jako adres policyjny (Ctrl+P)
W tym przypadku należy poprawić dane wprowadzone na zakładce Dane adresowe w ten sposób, żeby były zgodne z zawartością adresu policyjnego.
Po takiej zmianie należy ponownie zaimportować dane lokalizacji (Etap 04) i dopasować niedopasowane lokalizacje.