1.	Zastosowanie interfejsów

Interfejsy do baz MS Access umo¿liwiaj¹ po³¹czenie danych graficznych EWMAPY z danymi opisowymi zgromadzonymi w bazie danych MS Access. Powi¹zanie to dokonywane jest w dwojakiej formie:
- interfejsu pytaj¹cego,
- interfejsu szrafuruj¹cego/szukaj¹cego.
Interfejs pytaj¹cy umo¿liwia pozyskanie danych dotycz¹cych jednego obiektu - dzia³ki, punktu, jednoznacznego tekstu lub obiektu z bazy obiektowej.
Interfejs szrafuruj¹cy/szukaj¹cy umo¿liwia wskazanie (zaszrafurowanie) szeregu obiektów spe³niaj¹cych zadany warunek przy u¿yciu jêzyka SQL bazy danych Access.
Dziêki sterownikom ODBC istnieje mo¿liwoœæ powi¹zania baz MS Access z innymi bazami danych, np. Oracle. Tym samym MS Access stanowi swoisty “pomost” pomiêdzy EWMAP¥ a dowoln¹ baz¹ danych.
Dla poprawnego wykorzystania niniejszych interfejsów konieczne jest posiadanie programu MS Access.

2.	
Konfiguracja

2.1	
Konfiguracja interfejsów do MS Accessa

Program Access s³u¿y do konfiguracji interfejsów EWMAPY wspó³pracuj¹cych z programem MS Access. Interfejsy te mog¹ pobieraæ informacjê z baz danych MS Accessa. Bazy danych MS Accessa mog¹ mieæ dowoln¹ strukturê zaprojektowan¹ przez u¿ytkownika (pewne minimalne wymagania zostan¹ opisane ni¿ej) i zawieraæ dowolne dane. W sk³ad pakietu interfejsów wchodz¹:
- AcsInfo - interfejs pytaj¹cy (informacyjny) dla dzia³ek, punktów i tekstów na warstwach,
- AcsOInfo - interfejs pytaj¹cy (informacyjny) dla obiektów,
- AcsDPok - interfejs dla okna wyboru, zwrotny (szrafuruj¹cy) i szukaj¹cy dla dzia³ek,
- AcsPWysz - interfejs dla okna wyboru i szukaj¹cy punktów,
- AcsOPok - interfejs zwrotny (szrafuruj¹cy) i zaznaczaj¹cy dla obiektów.
W celu przeprowadzenia poprawnej konfiguracji interfejsów w EWMAPIE (przy pomocy programu Access), wszystkie interfejsy, w³¹cznie z programem konfiguracyjnym - Access, powinny znajdowaæ siê w jednym katalogu na dysku, a przed dokonaniem konfiguracji nale¿y zakoñczyæ dzia³anie programu EWMAPA, jeœli by³ on uruchomiony.

Okno g³ówne programu konfiguracyjnego Access sk³ada siê z dwóch czêœci:
- konfiguracji interfejsów,
- dodania interfejsów do konfiguracji EWMAPY.
Konfiguracja interfejsów polega na podaniu œcie¿ki dojœcia do MS Accessa oraz na dodaniu baz (w sensie bazy EWMAPY) do listy konfiguracja dla poszczególnych baz  i ich skonfigurowaniu. W celu poprawnej komunikacji pomiêdzy interfejsami, a okreœlonymi bazami EWMAPY, dodawane bazy musz¹ mieæ takie same nazwy, jak pola identyfikator bazy dla interfejsów w konfiguracji baz EWMAPY. Po dodaniu baz do listy nale¿y skonfigurowaæ bazê poprzez wybranie okreœlonej nazwy bazy z listy i naciœniêcie przycisku Konfiguruj bazê. Szczegó³y dotycz¹ce konfiguracji baz znajduj¹ siê w rozdziale konfiguracja bazy.

Druga czêœæ okna g³ównego - dodanie interfejsów do konfiguracji EWMAPY ma na celu skonfigurowanie programu EWMAPA do wspó³pracy z interfejsami. W celu konfiguracji interfejsów do dzia³ek, punktów i tekstów nale¿y zaznaczyæ odpowiednie pola wyboru. Natomiast w przypadku interfejsów do obiektów nale¿y przycisn¹æ przycisk Konfiguruj interfejsy dla obiektów. Szczegó³y zwi¹zane z konfiguracj¹ znajduj¹ siê w rozdziale konfiguracja obiektów.

Po zakoñczeniu konfiguracji mo¿na zamkn¹æ program przyciskiem Wyjœcie z zapisem, dziêki czemu wszystkie poczynione zmiany przed zamkniêciem zostan¹ zapisane (z wyj¹tkiem konfiguracji interfejsów dla obieków, która zapisuje siê od razu po zamkniêciu odpowiedniego okna) lub przyciskiem Wyjœcie bez zapisu, które spowoduje anulowanie wszystkich wprowadzonych zmian.

2.2	
Konfiguracja bazy

W konfiguracji bazy (w sensie EWMAPY) nale¿y podaæ w odpowiednich okienkach edycyjnych:
- œcie¿ki dojœcia do odpowiednich baz MS Accessa (mo¿e to byæ ta sama baza),
- nazwy pól kluczowych, które musz¹ wystêpowaæ we wszystkich kwerendach MS Accessa, które bêd¹ s³u¿y³y interfejsom EWMAPY do pobierania danych. Pola te musz¹ byæ typu tekstowego. Wi¹¿¹ one informacje zawarte w bazach MS Accessa z EWMAP¥. W przypadku dzia³ek w polu kluczowym powinien byæ przechowywany numer dzia³ki, dla punktów - numer punktu, dla warstw - tekst na warstwie, dla obiektów - kod obiektu oraz jego numer (identyfikator). W przypadku obiektów mo¿na nie podaæ pola kluczowego dla kodu obiektu i bêdzie to oznacza³o, ¿e kwerendy zwi¹zane z obiektami bêd¹ zwraca³y informacje o obiektach o tym samym okreœlonym kodzie,
- nazwy kwerend dla interfejsów pytaj¹cych,
- nazwy kwerend dla pozosta³ych interfejsów,
- nazwy formatek edycyjnych, które maj¹ byæ przywo³ywane po naciœniêciu odpowiedniego przycisku w interfejsie pytaj¹cym,
- nazwy makr wykonywanych po przywo³aniu okienka edycyjnego. Makro to mo¿e np. pobieraæ ze schowka wartoœæ odpowiedniego pola kluczowego i kopiowaæ j¹ do odpowiedniego okienka edycyjnego formatki MS Accessa. Wartoœæ pola kluczowego do schowka kopiuje interfejs pytaj¹cy po naciœniêciu przycisku do przywo³ywania okienka edycyjnego.

2.3	
Konfiguracja obiektów

Konfiguracja interfejsów do obiektów ma na celu zmodyfikowanie konfiguracji EWMAPY, tak ¿eby mo¿na by³o w EWMAPIE w danej kartotece z warstwami i baz¹ obiektów, korzystaæ z interfejsów do obiektów. Konfiguracja polega na dopisaniu w pliku ‘pliki.txt’ œcie¿ek dojœcia do interfejsów z domyœlnymi opcjami dla wyselekcjonowanych przez u¿ytkownika kodów obiektów.

Po uruchomieniu tej opcji pojawia siê okienko, w którym nale¿y wybraæ bazê spoœród tych, które s¹ widoczne dla programu EWMAPA, a nastêpnie kartotekê z warstwami i baz¹ obiektów, dla której chcemy przeprowadziæ konfiguracjê interfejsów. Nastêpnie nale¿y postêpowaæ zgodnie z opisem w rozdziale wybór kodów obiektów.

2.3.1	
Wybór kodów obiektów

Po wyborze okreœlonej kartoteki z warstwami i obiektami u¿ytkownik ma za zadanie wype³nienie listy z kodami obiektów, do których ma byæ przypisany interfejs pytaj¹cy. Po poprawnym uzupe³nieniu listy oraz pola wyboru okreœlaj¹cego, czy do konfiguracji danej bazy obiektów ma byæ tak¿e dodany interfejs szrafuruj¹cy i zaznaczaj¹cy, nale¿y klikn¹æ na przycisku Zapisz konfiguracje. W tym momencie do pliku ‘pliki.txt’ zostan¹ dopisane kody obiektów wymienione na liœcie wraz ze œcie¿kami dojœcia do programów interfejsowych. Je¿eli wczeœniej z jakimœ kodem obiektu by³ skojarzony ju¿ program interfejsu do MS Accessa, to zostanie on usuniêty lub zast¹piony nowymi ustawieniami.

3.	
Interfejs pytaj¹cy

Interfejs pytaj¹cy ma na celu szybkie wyœwietlenie informacji w programie EWMAPA o dzia³ce, punkcie, tekœcie na warstwie lub obiekcie pobieranych z baz MS Accessa. Pobieranie informacji nastêpuje przy pomocy kwerendy okreœlonej w konfiguracji. Kwerendê tê mo¿na zmieniaæ dynamicznie w trakcie dzia³ania programu. Je¿eli jakiegoœ elementu nie bêdzie w bazach MS Accessa, to mo¿na wywo³aæ z okienka interfejsu formatkê MS Accessa dodaj¹c¹ element do bazy. Czcionkê, któr¹ wyœwietlane s¹ informacje mo¿na zmieniaæ, klikaj¹c prawym przyciskiem myszy w okienku z wyœwietlan¹ informacj¹.

4.	
Szrafurowanie, szukanie i wybór dzia³ek, punktów lub obiektów

Interfejs ma na celu udostêpnienie u¿ytkownikowi mo¿liwoœci wyboru dzia³ek, punktów lub obiektów spe³niaj¹cych okreœlone warunki podawane przez u¿ytkownika. Po dokonaniu wyboru dzia³ek, punktów lub obiektów spe³niaj¹cych zadane warunki mo¿na je zobaczyæ w programie EWMAPA.

G³ówne okno programu interfejsu podzielone jest na trzy czêœci, gdzie znajduj¹ siê:
- warunki podawane przez u¿ytkownika,
- panel z przyciskami steruj¹cymi prac¹ programu,
- lista pól wybranej kwerendy, za pomoc¹ których mo¿na uk³adaæ warunki.
W celu sformu³owania okreœlonego warunku i wybrania do wizualizacji pewnej grupy dzia³ek, punktów lub obiektów nale¿y postêpowaæ wed³ug ni¿ej opisanego schematu:
Wybór koloru (w interfejsie zaznaczaj¹cym) i stylu szrafury (w interfejsie szrafuruj¹cym).
Sformu³owanie warunków, wg których bêd¹ wybierane dzia³ki, punkty lub obiekty.
Wykonanie wyboru.
Klikaj¹c na przycisku Podgl¹d odpowiedzi, mo¿emy zobaczyæ, jakie dzia³ki, punkty lub obiekty zosta³y wybrane. Nastêpnie w celu dokonania kolejnego wyboru musimy postêpowaæ zgodnie z opisanym powy¿ej schematem. 
Po wykonaniu przynajmniej jednego wyboru nale¿y zakoñczyæ dzia³anie programu interfejsu, poprzez klikniêcie na przycisku Zakoñcz, je¿eli akceptujemy dokonany wybór i chcemy, ¿eby dzia³ki, punkty lub obiekty zosta³y wybrane w EWMAPIE lub klikn¹æ na przycisku Anuluj w przeciwnym wypadku.

4.1	
Wybór koloru i stylu szrafury

Wybierane przez u¿ytkownika dzia³ki lub obiekty bêd¹ szrafurowane lub zaznaczane w EWMAPIE kolorem i stylem pokazanym w panelu z przyciskami. W celu zmiany koloru nale¿y klikn¹æ na przycisku Zmieñ kolor i w wyœwietlanym oknie wybraæ inny kolor. W celu zmiany stylu szrafury nale¿y klikn¹æ na przycisku Zmieñ styl i w wyœwietlanym oknie wybraæ inny styl wype³niania (style pokazane na liœcie w kolorze czerwonym s¹ przezroczyste). Zmiana koloru i stylu odnosi skutek tylko dla dzia³ek lub obiektów, które bêd¹ wybierane po tej operacji. Wszystkie poprzednio dokonane wybory bêd¹ zaznaczane takimi kolorami, jakie by³y wybrane w chwili wykonania wyboru.
4.2	
Sformu³owanie warunków

Warunki podawane przez u¿ytkownika mog¹ zawieraæ wszelkiego rodzaju funkcje i operatory akceptowane w jêzyku zapytañ do baz danych - SQL w programie MS Access.

Lista z nazwami pól, z których mo¿na formu³owaæ wyra¿enie warunkowe, znajduje siê po prawej stronie okna programu interfejsu. W celu przeniesienia nazwy pola do okienka edycyjnego wyra¿enia warunkowego nale¿y klikn¹æ dwukrotnie okreœlon¹ nazwê.
Poni¿ej zosta³y przedstawione przyk³ady sformu³owanych warunków:
- dzia³ki, na których iloœæ budynków jest wiêksza od 3

	[iloœæ] > 3

- dzia³ki le¿¹ce na ulicy Rolniczej, na których iloœæ budynków równa jest 3

	[iloœæ] = 3 and
	[ulica] = ’Rolnicza’ 

- obiekty le¿¹ce na ulicy Rolniczej lub Jasnej (wielkoœæ liter nie ma znaczenia)

	[ulica] = ’rolnicza’ or
	[ulica] = ’jasna’

- dzia³ki, których w³aœciciele znajduj¹ siê w miejscowoœci zaczynaj¹cej siê na literê “k”

	[Miejscowoœæ] like ’K*’

- dzia³ki, których w³aœciciele znajduj¹ siê w miejscowoœci 5-literowej i zaczynaj¹cej siê na literê “k”

	[Miejscowoœæ] like ’K????’

4.3	
Wykonanie wyboru

Wykonanie wyboru nastêpuje po sformu³owaniu warunków wyboru i polega na klikniêciu na przycisku Wykonaj. Je¿eli warunki zosta³y sformu³owane prawid³owo, to wybrane dzia³ki, punkty lub obiekty zostan¹ dopisane do pliku odpowiedzi interfejsu oraz zostan¹ uaktualnione liczniki w panelu steruj¹cym. W przypadku b³êdnego sformu³owania warunków pojawi siê okienko z informacj¹ o b³êdzie.

5.	
Dodatek

5.1	
Przyk³adowa baza danych

Wraz z pakietem interfejsów dostarczona jest przyk³adowa baza MS Accessa, która znajduje siê w pliku “adresy.mdb”. Zadaniem tej bazy jest powi¹zanie dwóch informacji: numeru dzia³ki z jej adresem. Budowa bazy jest bardzo prosta. Sk³ada siê ona z dwóch tabel:
- adresy,
- ulice.
Tabela “adresy” jest podstawow¹ tablic¹. Wiersze tej tablicy zawieraj¹ referencje do tablicy “ulice”, która pe³ni rolê s³ownika nazw ulic. Obydwie tabele s¹ ze sob¹ zwi¹zane w kwerendzie “adres”, która pokazuje ulicê i numer domu dla danej dzia³ki. Do dodawania kolejnych elementów do bazy s³u¿y formularz “adresy” (zbie¿noœæ nazw jest przypadkowa). Oprócz wy¿ej wymienionych sk³adników w sk³ad bazy wchodzi jeszcze makrodefinicja “macro1”, wykorzystywana podczas dodawania nowych elementów z poziomu interfejsu pytaj¹cego.
W celu sprawdzenia dzia³ania przyk³adowej bazy nale¿y skonfigurowaæ interfejsy za pomoc¹ programu Access, który potrafi tak¿e dodaæ interfejsy do konfiguracji EWMAPY. Po uruchomieniu programu Access i dodaniu nowej bazy (w sensie baz EWMAPY; patrz rozdzia³ 2), nale¿y j¹ skonfigurowaæ podaj¹c:
- œcie¿kê dojœcia do bazy MS Accessa (adresy.mdb) dla dzia³ek,
- nazwê pola kluczowego w kwerendzie dla dzia³ek (Nr dzia³ki),
- nazwê kwerendy dla interfejsu pytaj¹cego dla dzia³ek (Adres),
- nazwê kwerendy dla interfejsu szrafuruj¹cego dla dzia³ek (Adres),
- nazwê kwerendy dla okna wyboru dzia³ek (Adres),
- nazwê formatki dla interfejsu pytaj¹cego dla dzia³ek (Adresy),
- nazwê makra wykonywanego po dodaniu nowej dzia³ki (Macro1).

5.2	
Ograniczenia wersji demonstracyjnej

Wersje demonstracyjne interfejsów Accessa posiadaj¹ kilka ograniczeñ. Dla interfejsów pytaj¹cych te ograniczenia to:
 - brak mo¿liwoœci zmiany kwerendy pobieraj¹cej informacje z MS Accessa,
 - wyœwietlanie tylko trzech pierwszych pól zwracanych przez kwerendy.
Dla interfejsów szrafuruj¹cych i zaznaczaj¹cych ograniczenie to:
 - szrafurowanie lub zaznaczanie tylko dziesiêciu pierwszych elementów spe³niaj¹cych zadany przez u¿ytkownika warunek.