INFORMATOR TECHNICZNY WONDERWARE
Informator Techniczny nr 74
26-10-2004
Zastosowanie w InTouch u kontrolki ActiveX wwGenericSQLGrid do odczy-
tywania informacji z baz danych
Kontrolka ActiveX wwGenericSQL firmy Wonderware przeznaczona jest do pobierania informacji z bazy
danych i wyświetlania ich w postaci tabelarycznej. Nie wymaga definiowania z
ródeł danych ODBC ani
list powiązań (Bind List).
Instalacja kontrolki wwGenericSQLGrid
W celu zainstalowania kontrolki wwGenericSQLGrid w aplikacji wizualizacyjnej InTouch, należy:
1. Zainstalować na tym samym komputerze, na którym znajduje się oprogramowanie InTouch,
kontrolkÄ™ wwGenericSQLGrid.
2. Zainstalować kontrolkę wwGenericSQLGrid w środowisku edycyjnym InTouch a, a więc w
programie WindowMaker. W tym celu należy:
" Po uruchomieniu programu WindowMaker, wybrać opcję:
Special\Configure\Wizard/ActiveX Installation...
" W wyświetlonym oknie wybrać zakładkę ActiveX Control Installation, a następnie w dol-
nym oknie, w którym znajdują się wszystkie zainstalowane obiekty ActiveX w systemie
operacyjnym Windows, należy wskazać kontrolkę o nazwie: wwGenericSQLGrid.Grid.
ASTOR Sp. z o.o. e-mail: [e-mail]
tel.: [phone]
Dział Oprogramowania Przemysłowego http://www.astor.com.pl
fax: [phone]
ul. Smoleńsk 29, 31-112 Kraków
" Wybrać przycisk Install, w celu zainstalowania obiektu ActiveX w programie WindowMa-
ker. Program wwGenericSQLGrid.Grid zniknie z dolnego okna, a pojawi się w oknie gór-
nym, gdzie znajdujÄ… siÄ™ wszystkie zainstalowane w programie WindowMaker, obiekty Ac-
tiveX. Zamknąć okno przyciskiem Close.
Osadzanie kontrolki w InTouch u
Z okna wyboru wizardów Wizard Selection należy wskazać grupę ActiveX Controls i wybrać kontrolkę
Grid (pełna nazwa wwGenericSQLGrid.Grid), a następnie umieścić ją w oknie InTouch.
2
Konfiguracja kontrolki
Po umieszczeniu kontrolki w oknie InTouch a, należy dwukrotnie na nią kliknąć, aby przejść do okna
konfiguracyjnego.
Na zakładce ControlName w polu ControlName należy podać unikalną nazwę, dzięki której będzie
można się do niej odwoływać w skryptach.
Pola Left, Top, Width, Height określają położenie i wielkość kontrolki w oknie.
Opcja Visible określa czy kontrolka ma być widoczna na oknie lub nie.
3
Na zakładce Czcionka należy wybrać czcionkę, która ma być używana do prezentacji danych w
kontrolce.
Na zakładce Connection można wstępnie określić parametry połączenia z bazą danych SQL przez
zdefiniowanie następujących ustawień:
" ServerName  nazwa komputera, gdzie uruchomiony jest serwer bazy danych SQL.
" DatabaseName  nazwa bazy danych, z której będą pobierane dane.
" UserName  nazwa użytkownika, który może się dostać do bazy danych.
" Password  hasło dla logującego się do bazy danych użytkownika.
" SQLString  należy wprowadzić polecenie w języku SQL (zapytanie SQL), jakie ma zo-
stać wykonane przez serwer bazy danych.
4
Kontrolka połączy się z bazą danych o nazwie public na komputerze lokalnym (localhost) używając
użytkownika o nazwie sa i hasła sa. W kontrolce wyświetlone zostaną wszystkie rekordy z tabeli
intouch.
Na zakładce Properties można przypisać zmienne do odpowiednich właściwości kontrolki oraz
kierunek wymiany danych:
" Wartość zmiennej może zostać przypisana do właściwości kontrolki.
" Wartość właściwości kontrolki może zostać przypisana do zmiennej.
" Wartość zmiennej może zostać przypisana do właściwości kontrolki lub wartość właściwości
kontrolki może zostać przypisana do zmiennej.
Po wybraniu opcji Advanced można filtrować pokazujące się w zakładce Properties właściwości
kontrolki.
5
Na zakładce Events można przypisać skrypty ActiveX do odpowiednich zdarzeń obsługiwanych przez
kontrolkÄ™.
Metody kontrolki dostępne z poziomu skryptów
Metoda Typ Opis
zwracanych
danych
About() brak Wyświetla okno informacji o kontrolce.
About();
Connect() brak Zastosowanie po zmianie parametrów połączenia. Metoda ta
uruchamia także metodę Execute by sprawdzić połączenie z
bazą. Przed uruchomieniem metody Connect należy ustawić
właściwość SQLString.
Connect();
ConnectWithString() brak Połączenie się ze z
ródłem danych używając ciągu znaków
ADO. Przykłady połączeń na końcu informatora techniczne-
go.
ConnectWithString( CONNECTION STRING );
Clear() brak Metoda ta czyści zawartość kontrolki.
Clear();
Execute() Zastosowanie po zmianie właściwości SQLString. Metoda ta
wykona zapytanie i zwróci wynik zapytania do kontrolki.
Execute();
6
GetColumnNumber() long Zwraca numer kolumny aktualnie zaznaczonej komórki. Gdy
nie jest zaznaczona żadna komórka zwracana jest wartość -1
IntegerTag = GetColumnNumber();
GetRowColumnValue() string Zwraca wartość komórki określonej przez numer wiersza i
kolumny.
StringTag = GetRowColumnValue(Row as Integer, Column
as Integer);
GetRowNumber() long Zwraca aktualny numer wiersza.
IntegerTag = GetRowNumber();
GetSelectedCellValue() string Zwraca wartość aktualnie zaznaczonej komórki.
StringTag = GetSelectedCellValue();
ColumnValue() string Zwraca wartość z określonej kolumny w zaznaczonym wier-
szu.
StringTag = ColumnValue(Column as Integer);
Disconnect() brak Odłącza kontrolkę od z
ródła danych.
Disconnect();
MoveFirst() brak Przechodzi do pierwszego wiersza w wyświetlanej bazie.
MoveFirst();
MoveLast() brak Przechodzi do ostatniego wiersza w wyświetlanej bazie.
MoveLast();
MoveNext() brak Przechodzi do następnego wiersza w wyświetlanej bazie.
MoveNext();
MovePrevious() brak Przechodzi do poprzedniego wiersza w wyświetlanej bazie.
MovePrevious();
SQLStringAppend() brak Dodaje ciąg znaków do właściwości SQLString. Metoda ta
dodaje spację na początku dodawanego ciągu znaków.
SQLStringAppend( where IntegerTag > 10 );
Właściwości kontrolki dostępne z poziomu skryptów
Właściwość Typ danych Opis
ServerName string Nazwa serwera, do którego ma się podłączyć kontrolka.
DatabaseName string Nazwa bazy danych, do której ma się podłączyć kontrolka.
UserName string Nazwa (ID) użytkownika, który będzie korzystał z bazy da-
nych.
Password string Hasło dla użytkownika, który będzie korzystał z bazy danych.
Caption string Nagłówek dla kontrolki. W przypadku, gdy właściwość Cap-
tion jest pusta nagłówek dla kontrolki nie będzie widoczny.
FillColor Ustawia lub zwraca kolor wypełnienia dla obiektu.
FillStyle Ustawia lub zwraca styl wypełnienia dla obiektu.
Font Ustawia lub zwraca czcionkę użytą dla kontrolki.
MaxRecords long Ustawia lub zwraca maksymalną liczbę rekordów, jakie zo-
stały wysłane do kontrolki. Zero oznacza, że wysłane zostały
wszystkie rekordy.
SQLString string Ustawia lub zwraca aktualny ciąg znaków dla zapytania w
języku SQL.
RowCount long Zwraca aktualnÄ… liczbÄ™ wierszy w kontrolce.
EOF boolean Zwraca status końca pliku (1  prawda, 0  fałsz).
7
Enabled boolean Ustawia lub zwraca stan kontrolki jako możliwy lub niemożli-
wy dostęp do kontrolki (1  dostęp możliwy, 0  dostęp nie-
możliwy).
BOF boolean Zwraca status początku pliku (1  prawda, 0  fałsz).
ConnectionString string Ustawia lub zwraca wartość ciągu znaków połączenia.
ConnectionTimeOut long Ustawia lub zwraca maksymalny czas próby łączenia z bazą
danych.
ColumnHeaders boolean Ustawia lub zwraca stan pokazywania nagłówków kolumn (1
 nagłówki widoczne, 0  nagłówki niewidoczne).
A
Ä…czenie siÄ™ z serwerem baz danych np. Microsoft SQL Server
Aby połączyć się z bazą danych obsługiwaną przez serwer SQL należy określić następujące właściwości
kontrolki ActiveX:
" ServerName  nazwa serwera SQL,
" DatabaseName  nazwa bazy danych na serwerze SQL,
" UserName  nazwa użytkownika,
" Password  hasło dla użytkownika,
" SQLString  polecenie w języku SQL, które ma wykonać serwer.
Następnie należy użyć metody Connect, aby połączyć się z bazą i uzyskać wynik zapytania.
Przykładowe ustawienia połączenia z bazą danych w Microsoft SQL Server:
#Grid1.ServerName = "localhost";
#Grid1.DatabaseName = "pubs";
#Grid1.UserName = "sa";
#Grid1.Password = "sa";
#Grid1.SQLString = "select * from authors where au_fname = 'johnson'";
#Grid1.Connect();
Wynikiem działania powyższego przykładu jest wyświetlenie w kontrolce rekordów z bazy danych pubs
z tabeli authors znajdującej się na lokalnym komputerze (localhost) spełniających kryteria: w kolumnie
au_fname = johnson. W kontrolce zostaną wyświetlone wszystkie kolumny znajdujące się w tabeli.
A
Ä…czenie siÄ™ z bazami danych poprzez metodÄ™ ConnectWithString()
Oprócz możliwości łączenia się z bazami danych poprzez metody ServerName, DatabaseName,
UserName i Password istnieje możliwość łączenia się poprzez metodę ConnectWithString. Daje to
możliwość łączenia się nie tylko z serwerami bazami danych, ale ze wszystkimi relacyjnymi bazami
danych np.: Microsoft Access oraz ze z
ródłami danych ODBC np.: Microsoft Excel, Paradox czy
Microsoft Visual FoxPro.
8
Przykłady użycia metody ConnectWithString() dla z
ródeł danych typu OLE DB.
y
ródło danych Ciąg znaków dla połączenia OLE DB
Microsoft Access Provider=Microsoft.Jet.OLEDB.4.0;Data Source=fizyczna ścieżka do pliku
.mdb
Microsoft SQL Server Provider=SQLOLEDB.1;Data Source=ścieżka do bazy danych na serwe-
rze
Oracle Provider=MSDAORA.1;Data Source= ścieżka do bazy danych na serwe-
rze
Microsoft Indexing Service Provider=MSIDXS.1;Data Source=ścieżka do pliku
Połączenie z bazą Microsoft Access korzystając z OLE DB:
#Grid1.ConnectWithString( Provider=Microsoft.Jet.OLEDB.4.0;Data
Source=C:\database\intouch.mdb );
Przykłady użycia metody ConnectWithString() dla z
ródeł danych ODBC.
Sterownik (driver) z
ródła Ciąg znaków dla połączenia ODBC
danych
Microsoft Access Driver={Microsoft Access Driver (*.mdb)};DBQ=fizyczna ścieżka do pliku
.mdb
SQL Server DRIVER={SQL Server};SERVER=ścieżka do serwera
Oracle DRIVER={Microsoft ODBC for Oracle};SERVER=ścieżka do serwera
Microsoft Excel Driver={Microsoft Excel Driver (*.xls)};DBQ=fizyczna ścieżka do pliku
.xls;DriverID=278
Microsoft Excel 97 Driver={Microsoft Excel Driver (*.xls)};DBQ=fizyczna ścieżka do pliku
.xls;DriverID=790
Paradox Driver={Microsoft Paradox Driver (*.db)};DBQ=fizyczna ścieżka do pliku
.db;DriverID=26
Text Driver={Microsoft Text Driver (*.txt;*.csv)};DefaultDir=fizyczna ścieżka do
pliku .txt
Microsoft Visual FoxPro® Driver={Microsoft Visual FoxPro
(with a database con- Driver};SourceType=DBC;SourceDb=fizyczna ścieżka do pliku .dbc
tainer)
Microsoft Visual FoxPro Driver={Microsoft Visual FoxPro
(without a database con- Driver};SourceType=DBF;SourceDb=fizyczna ścieżka do pliku .dbf
tainer)
Połączenie z bazą Microsoft Access korzystając z ODBC:
#Grid1.ConnectWithString( Driver={Microsoft Access Driver
(*.mdb)};DBQ=C:\database\intouch.mdb );
9