Informator Techniczny nr 74 26-10-2004 INFORMATOR TECHNICZNY WONDERWARE Zastosowanie w InTouch u kontrolki ActiveX wwgenericsqlgrid do odczytywania 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 ź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 dolnym 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. Dział Oprogramowania Przemysłowego ul. Smoleńsk 29, 31-112 Kraków tel.: 012 428-63-30 fax: 012 428-63-09 e-mail: wonderware1@astor.com.pl http://www.astor.com.pl
Wybrać przycisk Install, w celu zainstalowania obiektu ActiveX w programie WindowMaker. Program wwgenericsqlgrid.grid zniknie z dolnego okna, a pojawi się w oknie górnym, gdzie znajdują się wszystkie zainstalowane w programie WindowMaker, obiekty ActiveX. 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 zostać 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 źródłem danych uŝywając ciągu znaków ADO. Przykłady połączeń na końcu informatora technicznego. 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 wierszu. StringTag = ColumnValue(Column as Integer); Disconnect() brak Odłącza kontrolkę od ź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 danych. 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ść Caption 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 został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ŝliwy dostęp do kontrolki (1 dostęp moŝliwy, 0 dostęp niemoŝ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). Łą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. Łą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 źródłami danych ODBC np.: Microsoft Excel, Paradox czy Microsoft Visual FoxPro. 8
Przykłady uŝycia metody ConnectWithString() dla źródeł danych typu OLE DB. Źródło danych Microsoft Access Microsoft SQL Server Oracle Microsoft Indexing Service Ciąg znaków dla połączenia OLE DB Provider=Microsoft.Jet.OLEDB.4.0;Data Source=fizyczna ścieŝka do pliku.mdb Provider=SQLOLEDB.1;Data Source=ścieŜka do bazy danych na serwerze Provider=MSDAORA.1;Data Source= ścieŝka do bazy danych na serwerze 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 źródeł danych ODBC. Sterownik (driver) źródła danych Microsoft Access SQL Server Oracle Microsoft Excel Microsoft Excel 97 Paradox Text Microsoft Visual FoxPro (with a database container) Microsoft Visual FoxPro (without a database container) Ciąg znaków dla połączenia ODBC Driver={Microsoft Access Driver (*.mdb)};dbq=fizyczna ścieŝka do pliku.mdb DRIVER={SQL Server};SERVER=ścieŜka do serwera DRIVER={Microsoft ODBC for Oracle};SERVER=ścieŜka do serwera Driver={Microsoft Excel Driver (*.xls)};dbq=fizyczna ścieŝka do pliku.xls;driverid=278 Driver={Microsoft Excel Driver (*.xls)};dbq=fizyczna ścieŝka do pliku.xls;driverid=790 Driver={Microsoft Paradox Driver (*.db)};dbq=fizyczna ścieŝka do pliku.db;driverid=26 Driver={Microsoft Text Driver (*.txt;*.csv)};defaultdir=fizyczna ścieŝka do pliku.txt Driver={Microsoft Visual FoxPro Driver};SourceType=DBC;SourceDb=fizyczna ścieŝka do pliku.dbc Driver={Microsoft Visual FoxPro Driver};SourceType=DBF;SourceDb=fizyczna ścieŝka do pliku.dbf Połączenie z bazą Microsoft Access korzystając z ODBC: #Grid1.ConnectWithString( Driver={Microsoft Access Driver (*.mdb)};dbq=c:\database\intouch.mdb ); 9