Pantek Productivity Pack. DBGraphXY. Uživatelský manuál

Pantek Productivity Pack

DBGraphXY Uživatelský manuál

Verze 1.1 10. října 2001

DBGraphXY Verze 1.1 Uživatelský manuál

Obsah ÚVOD ..................................................................................................................................................... 3 Charakteristika produktu ..................................................................................................................... 3 Systémové požadavky ........................................................................................................................ 3 Omezení.............................................................................................................................................. 3 Instalace.............................................................................................................................................. 4 Licencování......................................................................................................................................... 4 KONFIGURACE ..................................................................................................................................... 5 Stránky vlastností................................................................................................................................ 5 General............................................................................................................................................ 5 Axis.................................................................................................................................................. 6 Series .............................................................................................................................................. 7 Other ................................................................................................................................................... 8 Vlastnosti............................................................................................................................................. 9 Metody .............................................................................................................................................. 11 Události ............................................................................................................................................. 13 Seznam chybových kódů .................................................................................................................. 14 TIPY A TRIKY....................................................................................................................................... 15 Nastavení zdroje dat ......................................................................................................................... 15 Sestavení SQL dotazu ...................................................................................................................... 15 Nastavení vzhledu grafu ................................................................................................................... 16 Posun grafu a zoom.......................................................................................................................... 17 Odečítání hodnot .............................................................................................................................. 17 Reakce na chybové stavy................................................................................................................. 17 DOKUMENTOVANÉ CHYBY ............................................................................................................... 19 Zobrazení chyby “System Resource Exceeded” při použití ovladače Microsoft ODBC dBase Driver .......................................................................................................................................................... 19

Strana 2 / 20


Úvod Charakteristika produktu DBGraphXY je objekt ActiveX, který umožňuje zobrazit data uložená v libovolné relační databázi v grafu typu XY. Objekt je určen pro použití v aplikacích Wonderware InTouch. Hlavní vlastnosti a přínosy: •

Zobrazení dat z libovolného databázového systému nebo jiného datového zdroje, ke kterému je k dispozici OLE DB poskytovatel (OLE DB provider) nebo ODBC ovladač.

•

Požadavek na zobrazení dat se definuje pomocí SQL dotazu. Hodnoty z prvního sloupce výsledku SQL dotazu jsou vyneseny na ose X grafu, hodnoty ostatních sloupců na ose Y.

•

SQL dotaz je možné dynamicky měnit za běhu aplikace.

•

Možnost oddělit definované sady dat mezerami (např. jednotlivá měření) pro zlepšení přehlednosti výsledného zobrazení.

•

Odečítání hodnot z grafu.

•

Zmenšování a zvětšování oblasti grafu.

•

Horizontální pohyb v grafu.

•

Možnost reakce na případné chybové stavy.

Systémové požadavky •

Wonderware InTouch 7.1 nebo Wonderware InTouch 7.11

•

Microsoft Windows NT 4.0 SP5 nebo vyšší nebo Microsoft Windows 2000

•

MDAC version 2.5 (Microsoft Data Access Components)

Omezení •

Data, která budou vynesena na osu X grafu (tj. data z prvního sloupce výsledku SQL dotazu) musí být setříděna vzestupně.

Strana 3 / 20


Instalace Instalaci produktu DBGraphXY lze začít spuštěním souboru Setup.exe. Instalace probíhá automaticky bez zásahu uživatele. Instalační program nakopíruje a zaregistruje všechny potřebné soubory na cílový počítač. Po skončení instalace je DBGraphXY připraven k použití. Pro použití v programu Wonderware InTouch WindowMaker je třeba prvek nainstalovat do tohoto prostředí. Tato instalace se provede takto: •

Zobrazte dialog “Wizard/ActiveX Installation” (menu Special/Configure/Wizard-ActiveX Installation)

•

Zvolte kartu “ActiveX Control Installation”.

•

Ze seznamu “Available ActiveX controls” vyberte “Pantek DBGraphXY Control”.

•

Stiskněte tlačítko “Install”. Řádek “Pantek DBGraphXY Control” by se měl přesunout do seznamu “Installed ActiveX controls”.

•

Klikněte na tlačítko “OK”.

Tímto by měl být DBGraphXY nainstalován. Pro vložení do okna bude nyní dostupný ve “Wizards”, ve skupině “ActiveX Controls”.

Licencování Tento produkt může být používán pouze na počítačích obsahujících instalaci některého z produktů rodiny Wonderware FactorySuite 2000. Pro svou funkci dále vyžaduje platný licenční soubor PantekLic.lic. Licenční soubor je umístěn ve složce Program Files\FactorySuite\Common\License. Licence je svázána se sériovým číslem (Serial Number) produktu FactorySuite. Bez platného licenčního souboru bude DBGraphXY spuštěn v demo režimu. Tento režim je plně funkční, avšak při prvním zobrazení a během používání se zobrazuje dialog s informacemi o produktu a údajem, že jde o demoverzi. Licenční soubory můžete objednávat u společnosti Pantek (CS) s.r.o.: s.r.o. •

Tel.: +420 – 49 – 563 5072 nebo 563 5073

•

E-mail: [email protected]

•

http://www.pantek.cz

Strana 4 / 20


Konfigurace Stránky vlastností General Stránka vlastností General obsahuje konfiguraci základních parametrů DBGraphXY.

Connection String

Textový řetězec, který definuje místo, ze kterého bude DBGraphXY číst data a případně způsob přístupu k nim. Je možné vepsat přímo nebo použít průvodce pro sestavení tohoto řetězce, který se spustí kliknutím na tlačítko „Build…“. Průvodce nabídne seznam všech nainstalovaných OLE DB poskytovatelů a umožní nastavení parametrů zvoleného poskytovatele. SQL Query

Výraz v jazyce SQL (SQL dotaz) určující, jaká data budou zobrazena. Podporovaná syntaxe jazyka SQL je přímo závislá na zvoleném OLE DB poskytovateli. Hodnoty z prvního sloupce z výsledku dotazu budou vyneseny na osu x. Connect To Database

Určuje, zda se bude DBGraphXY v režimu run-time i development připojovat k databázi. V režimu development při konfiguraci stránek vlastností musí být DBGraph vždy připojen k databázi. Initially draw n records

Maximální počet záznamů, které bude DBGraphXY číst z databáze při prvním vykreslení. Umožňuje omezit maximální počet záznamů, které budou výsledkem zadaného SQL dotazu, a tím zabránit přenesení příliš velkého objemu dat z databáze do DBGraphXY. Po prvotním vykreslení je již dále toto nastavení ignorováno.

Strana 5 / 20


Axis Stránka vlastností Axis obsahuje konfiguraci os v DBGraphXY. Poznámka: položky na stránce budou nepřístupné, pokud není zaškrtnuté políčko „Connect to Database“ na stránce vlastností General.

Column

Jméno sloupce. Odpovídá výsledku zadaného SQL dotazu. První sloupec v dotazu musí obsahovat hodnoty pro osu x. Položku není možné modifikovat. Axis Scale

Skupina obsahuje nastavení rozsahů jednotlivých os. Minimum

Obsahuje minimální hodnotu pro příslušnou osu. Maximum

Obsahuje maximální hodnotu pro příslušnou osu. Divisions

Obsahuje počet jednotek, na něž je osa rozdělena. Title

Skupina obsahuje nastavení titulku jednotlivých os. Text

Obsahuje text titulku pro příslušnou osu. Aligment

Určuje zarovnání titulku pro příslušnou osu.

Strana 6 / 20


Series Stránka vlastností Series obsahuje nastavení vykreslování jednotlivých řad. Poznámka: položky na stránce budou nepřístupné, pokud není zaškrtnuté políčko „Connect to Database“ na stránce vlastností General.

Series

Jméno řady. Odpovídá výsledku zadaného SQL dotazu. Položku není možné modifikovat. Color

Nastavuje barvu vykreslované čáry. Width

Nastavuje tloušťku vykreslované čáry. Style

Nastavuje styl vykreslované čáry (plná, čárkovaná, tečkovaná a čerchovaná). Nastavení jiného stylu než Solid je akceptováno pouze pro čáru tloušťky 1.

Hide

Určuje, zda daná řada bude viditelná. Show Markers

Určuje, zda se na dané řadě budou vykreslovat značky.

Strana 7 / 20


Other Ostatní nastavení prvku DBGraphXY. Poznámka: vlastnosti budou nepřístupné, pokud není zaškrtnuté políčko „Connect to Database“ na stránce vlastností General.

Show Scooters

Určuje, zda budou zobrazeny jezdci či nikoliv. Show x-axis title

Určuje, zda budou zobrazeny popisky na ose x. Vlastnost bude nepřístupná, jestliže bude

zaškrtnuto Insert gap after each in. Show y-axis title

Určuje, zda budou zobrazeny popisky na ose y. Gaps

Skupina obsahuje nastavení pro konfiguraci vykreslování oddělených sad. Pokud tabulka obsahuje např. několik sad naměřených hodnot, prvek DBGraphXY umožňuje jednotlivé sady oddělit mezerami. Ze seznamu je nutné vybrat sloupec, který definuje sadu (např. číslo měření), a při změně hodnoty v tomto sloupci se vloží do grafu mezera. Insert gap after each change in

Určuje, zda budou mezi jednotlivé sady vkládány mezery. V seznamu je nutné vybrat

sloupec definující sadu. Vlastnost bude nepřístupná, jestliže bude zaškrtnuto Show x-axis

title.

Show label where the set begins

Určuje, zda bude na začátku každé sady zobrazena její hodnota (např. číslo měření).

Vlastnost bude nepřístupná, jestliže není zaškrtnuto Insert gap after each change in. Obsah

popisku je shodný s vybraným sloupcem v seznamu.

Strana 8 / 20


Vlastnosti Prvek DBGraphXY poskytuje následující vlastnosti: Active Series

Datový typ: Integer Popis: určuje číslo aktivní řady. Hodnoty aktivní slouží jako popisek pro osu y. Connection String

Datový typ: Message Popis: Text definující zdrojovou databázi. Pro aplikaci změn provedených v režimu run-time

se musí zavolat metoda Refresh(). ConnectToDB

Datový typ: Discrete Popis: Určuje, zda-li se DBGraphXY má připojovat k databázi. Při změně této vlastnosti se automaticky připojí nebo odpojí od databáze. Logické hodnotě TRUE (pravda) odpovídá číselná hodnota –1; FALSE (nepravda) odpovídá 0. DivisionsX

Datový typ: Integer Popis: Obsahuje počet jednotek, na něž je rozdělena osa x. Vlastnost je pouze pro čtení. V režimu run-time je možné vlastnost změnit pomocí metody SetAxisX. ErrorCode

Datový typ: Integer Popis: Obsahuje číselný kód chybového stavu. Hodnota je nastavena prvkem DBGraphXY, kdykoliv dojde k nějaké chybě (nejčastěji při volání metod). Vlastnost je pouze pro čtení. ErrorString

Datový typ: Message

Popis: Obsahuje text s popisem chybového stavu odpovídající hodnotě ErrorCode. Vlastnost

je pouze pro čtení. MaximumX

Datový typ: Real Popis: Obsahuje maximální hodnotu osy x. Vlastnost je pouze pro čtení. V režimu run-time je možné vlastnost změnit pomocí metody SetAxisX.

MinimumX

Datový typ: Real Popis: Obsahuje minimální hodnotu osy x. Vlastnost je pouze pro čtení. V režimu run-time je možné vlastnost změnit pomocí metody SetAxisX.

Strana 9 / 20


ShowScooters

Datový typ: Discrete Popis: Určuje, zda budou zobrazeny jezdci či nikoliv. Logické hodnotě TRUE (pravda) odpovídá číselná hodnota –1; FALSE (nepravda) odpovídá 0. SQLQuery

Datový typ: Message Popis: Obsahuje SQL dotaz. Pro aplikaci změn provedených v režimu run-time je nutné

zavolat metodu Refresh().V režimu run-time je možné tuto vlastnost modifikovat buď přímo

nebo pomocí metod AppendSQLQuery() a SetDefaultSQLQuery().

Strana 10 / 20


Metody Prvek DBGraphXY poskytuje následující metody: void AboutBox ()

Popis: Zobrazuje About Box. void AppendSQLQuery (Message Query)

Popis: Připojí obsah parametru Query k existující hodnotě vlastnosti SQLQuery. void DisplayMarkers (Integer Series, Discrete Visible)

Popis: Metoda nastavuje viditelnost značek na řadách. Parametr Series určuje číslo řady a

parametr Visible určuje, zda-li budou značky této řady zobrazeny. Řady jsou číslovány od 1. void DisplaySeries (Integer Series, Discrete Visible)

Popis: Metoda nastavuje viditelnost jednotlivých řad. Parametr Series určuje číslo řady a

parametr Visible určuje, zda-li bude řada viditelná. Řady jsou číslovány od 1. Message GetColName (Integer NumColumn)

Popis: Vrací jméno sloupce (řady). Parametr NumColumn udává číslo sloupce (řady). Sloupce

jsou číslovány od nuly.

Message GetNextTable ()

Popis: Vrací postupně jména všech tabulek, které obsahuje nastavená vlastnost

ConnectionString. Volání této metody musí následovat po zavolání metody GetTableList (). Integer GetTableList ()

Popis: Vrací počet tabulek, které obsahuje nastavená vlastnost ConnectionString. Jména tabulek lze postupně získat pomocí metody GetNextTable ().

Message GetValue (Integer Position, Integer Series)

Popis: Metoda vrací hodnotu bodu v grafu určeného parametry funkce. Parametr Position

určuje pořadí bodu zleva. Body jsou číslovány od nuly. Pořadí bodu je možné získat pomocí jezdců, jejichž pozice je shodná s pořadím bodu, na němž se jezdec nachází a je

parametrem vypalované události MoveRightScooter nebo MoveLeftScooter. Parametr Series

určuje číslo řady. Řady jsou číslovány od 1, nulu je možné použít pro získání hodnot na ose

x. void MoveLeft (Integer Records)

void MoveRight (Integer Records)

Popis: Metody posunou graf o zadaný počet záznamů vlevo nebo vpravo, maximálně však na začátek nebo na konec grafu.

Strana 11 / 20


void PageLeft ()

void PageRight ()

Popis: Metody posunou graf o stránku vlevo nebo vpravo, maximálně však na začátek nebo na konec grafu. void Redraw ()

Popis: Metoda překreslí obsah grafu. void Refresh ()

Popis: Metoda občerstvuje obsah grafu, aplikuje SQL dotaz. V případě nezměněného dotazu ponechává nastavení grafu. void SetAxisX (Real Min, Real Max, Integer Divisions)

Popis: Metoda nastavuje vlastnosti osy x. Pro aplikaci změn je nutné zavolat metodu

Refresh().

void SetAxisY (Integer Series, Real Min, Real Max, Integer Divisions)

Popis: Metoda nastavuje vlastosti osy y. Parametr Series určuje číslo řady. Pro aplikaci změn je nutné zavolat metodu Refresh ().

void SetDefaultSQLQuery ()

Popis: Změní obsah vlastnosti SQLQuery a všechna nastavení na hodnoty nastavené v režimu

development. Pro aplikaci změn je nutné zavolat metodu Refresh (). void ShowSQLQuery ()

Popis: Zobrazí dialogový box s aktuálním SQL dotazem. void ZoomIn ()

Popis: Metoda zvětší část grafu vymezenou jezdci. Metoda je funkční pouze tehdy, je-li zapnuto zobrazování jezdců (vlastnost ShowScooters). void ZoomOut ()

Popis: Metoda zmenší oblast grafu o právě zobrazený počet záznamů. Střed grafu zůstane zachován. Metoda je funkční pouze tehdy, je-li zapnuto zobrazování jezdců (vlastnost

ShowScooters).

Strana 12 / 20


Události Prvek DBGraphXY vypaluje následující události: MoveLeftScooter (Integer Position)

Popis: Událost je vypálena, jakmile je přesunut levý jezdec na jiný bod. Parametr Position udává pořadí bodu zleva, na němž se jezdec nachází. Body jsou číslovány od nuly. MoveRightScooter (Integer Position)

Popis: Událost je vypálena, jakmile je přesunut pravý jezdec na jiný bod. Parametr Position udává pořadí bodu zleva, na němž se jezdec nachází. Body jsou číslovány od nuly.

Strana 13 / 20


Seznam chybových kódů Následující text obsahuje seznam všech chybových kódů prvku DBGraphXY. Číslo chyby a anglický popis odpovídá hodnotám vlastností ErrorCode a ErrorString. 0 - ""

Operace byla úspěšná. 1 - "Graph "Graph is not configured"

Graf není správně nebo vůbec nakonfigurován (SQL dotaz, definice zdrojové databáze). 2 - "Wrong "Wrong index"

V metodě bylo zadáno špatné číslo parametru (například metoda GetColName). 3 - "Cannot "Cannot create Connection string dialog"

Chyba při vytváření dialogu pro sestavení ConnectionString (textový řetězec definující

zdrojovou databázi). 5 - "Ado "Ado Error"

Chyba technologie ADO. 6 - "Wrong "Wrong database"

Chyba v databázi (např. v záznamech chybí hodnoty, nebo sloupec pro osu x obsahuje nečíselný datový typ). 7 - "Not supported data type"

Chyba může nastat při volání metody GetValue s parametrem sloupce obsahující nečíselný datový typ.

8 - "Scooters "Scooters is hide"

Vlastnost ShowScooters je nastavena na FALSE. Chyba vznikne při volání metod ZoomIn,

ZoomOut.

9 - "Wrong "Wrong parameters"

Metodě byly zadány špatné parametry. Např. v metodě SetAxisX bylo maximum zadáno menší než minimum.

Strana 14 / 20


Tipy a triky Nastavení zdroje dat Pro získání přístupu k datům je nutné nadefinovat vlastnosti ConnectionString a SQLQuery. V režimu development jsou tyto vlastnosti přístupné na stránce vlastností General. Aplikace

těchto vlastností se provede stisknutím tlačítka Apply, při přechodu na jinou stránku nebo

zavřením stránky vlastností tlačítkem OK. Připojování k databázi je možné ovlivnit

zaškrtávacím políčkem Connect to Database. Zaškrtnutím políčka Inittialy draw n records

máte možnost ovlivnit počet prvně vykreslených záznamů.

V režimu run-time jsou tyto vlastnosti přístupné pomocí textových proměnných. Po

nastavení těchto vlastností je nutné zavolat metodu Refresh.

Sestavení SQL dotazu SQL dotaz se ukládá do textové vlastnosti SQLQuery. DBGraphXY obsahuje několik metod,

jak zadat SQL dotaz.

SQL dotaz je možné rovnou předat vlastnosti SQLQuery: Př.:

MySQLQuery = “select * from table1“; #PantekDBGraphXYControl1.SQLQuery = MySQLQuery; #PantekDBGraphXYControl1.Refresh();

V případě SQL dotazu, který je rozdělen na několik textových proměnných, je možné použít

metodu AppendSQLQuery. Každá textová proměnná obsahuje část výsledného SQL dotazu: Př.:

MySQLQuery_1 = “select * from table1!; MySQLQuery_2 = “ where ID>10“; MySQLQuery_3 = “ order by DateTime“; #PantekGraphXY1.SQLQuery = MySQLQuery_1; #PantekDBGraphXY1.AppendSQLQuery ( MySQLQuery_2 ); #PantekDBGraphXY1.AppendSQLQuery ( MySQLQuery_3 ); #PantekDBGraphXYControl1.Refresh(); Výsledný dotaz vznikne spojením proměnných MySQLQuery_1, MySQLQuery_2 a

MySQLQuery_3.

Pomocí metody SetDefaultSQLQuery je možné nastavit dotaz zadaný na stránce vlastností

General a přidávat tak podle potřeby metodou AppendSQLQuery pouze např. podmínku where. Př.:

Strana 15 / 20


ConditionSQLQuery = “ where ID>10“; #PantekDBGraphXY1.SetDefaultSQLQuery(); #PantekDBGraphXY1.AppendSQLQuery ( ConditionSQLQuery ); #PantekDBGraphXYControl1.Refresh(); Výsledný dotaz vznikne připojením proměnné ConditionSQLQuery. Pro aplikování nového dotazu je nutné zavolat metodu Refresh.

Nastavení vzhledu grafu DBGraphXY umožňuje nastavit: •

vlastnosti vykreslovaných čar - barva, styl, tloušťka, skrytí, zobrazování značek

•

vlastnosti os - měřítko, titulek, skrytí popisku a titulku

•

zobrazování jezdců

•

oddělení sady mezerami při vykreslování (např. jednotlivá měření)

•

měřítko osy y

Vlastnosti vykreslovaných čar

Nastavení všech vlastností čar se provádí na stránce vlastností Series. V seznamu Series se

vybere podle názvu požadovaná řada a nakonfigurují se požadované vlastnosti čáry. Styl

čáry lze nastavovat pouze pro tloušťku čáry rovnu jedné. Při jiné tloušťce je čára vždy plná (styl Solid). V režimu run-time je možné nastavovat viditelnost řady a zobrazování značek pomocí metod DisplaySeries a DisplayMarkers. Vlastnosti os

Osám je nutné vždy nastavit jejich měřítko. Nastavení se provádí na stránce vlastností Axis.

V seznamu Column se podle názvu vybere požadovaná řada a nastaví se minimum,

maximum a počet jednotek, na něž je osa rozdělena (Divisions). Volitelně může být ose

přiřazen titulek (Title) a je možné nastavit jeho zarovnání (Alignment). V režimu run-time se nastavení měřítka os provádí pomocí metod SetAxisX a SetAxisY.

Popisky a titulky os je možné skrýt. Nastavení se provádí na stránce vlastností Other.

Vlastnost Show x-axis title bude nepřístupná, jestliže je zaškrtnuta vlastnost Insert gap

after each change in:.

Zobrazování jezdců

Nastavení se provádí na stránce vlastností Other, vlastnost ShowScooters. V režimu runtime se nastavuje viditelnost jezdců pomocí vystavené vlastnosti ShowScooters. Oddělování jednotlivých sad

Pokud tabulka obsahuje např. několik sad naměřených hodnot, prvek DBGraphXY umožňuje jednotlivé sady oddělit mezerami. Tato konfigurace se provádí na stránce vlastností Other

zaškrtnutím políčka Insert gap after each change in. Tato vlastnost je nepřístupná, jestliže je zaškrtnuta vlastnost Show x-axis title. Ze seznamu je nutné vybrat sloupec, který

definuje sadu (např. číslo měření), a při změně hodnoty v tomto sloupci se vloží do grafu

Strana 16 / 20


mezera. Při zobrazování "s mezerami" nebude osa x souvislá a v závislosti na počtu mezer

se zmenší i nastavená maximální hodnota osy x. Zaškrtnutím políčka Show label where the

set begins umožníte zobrazování popisků na začátku každé sady (např. číslo měření). Obsah popisku je shodný s vybraným sloupcem v seznamu. Měřítko osy y

Měřítko pro osu y se nastavuje z konfigurace aktivní řady. Aktivní řada se nastavuje pouze v

režimu run-time pomocí vlastnosti ActiveSeries. Změnou této vlastnosti se změní měřítko a

popis osy y.

Posun grafu a zoom Prvek DBGraphXY vystavuje dvě sady metod pro horizontální posun grafu: • •

po stránkách pomocí metod PageLeft a PageRight

po záznamech pomocí metod MoveLeft a MoveRight, jejímž parametrem je počet záznamů, o který se má graf posunout.

Graf je možné posunout maximálně na začátek nebo na konec grafu. Pro zoom grafu slouží metody ZoomIn a ZoomOut. • •

Metoda ZoomIn zvětší oblast grafu, která je vymezena jezdci.

Metoda ZoomOut zmenší oblast grafu o právě zobrazený počet záznamů. Střed grafu

zůstane zachován.. Pozice jezdců nemají na tuto metodu vliv.

Metody ZoomIn a ZoomOut lze volat pouze při zapnutém zobrazování jezdců (vlastnost

ShowScooters).

Odečítání hodnot Prvek Pantek DBGraphXY umožňuje odečítat hodnoty bodů v grafu. K odečítání hodnot slouží metoda GetValue, jejímiž parametry jsou číslo řady a pozice bodu zleva. Pořadí bodu je možné získat pomocí jezdců, jejichž pozice je shodná s pořadím bodu. Jezdec při pohybu vypaluje událost, jejíž parametr je pozice bodu, na němž se jezdec nachází. Následující příklad demonstruje použití metody GetValue ve skriptu zachytávajícím vypalovanou událost

MoveLeftScooter. Př.: Position = #ThisEvent.MoveLeftScooterposition; { pozice je uložena do číselné proměnné } LeftValue3 = #Pantek DBGraphXY1.GetValue(Position, 3); { získání hodnoty třetí řady na dané pozici a uložení hodnoty do textové proměnné }

Reakce na chybové stavy Všechny vystavené metody nastavují vlastnosti ErrorString a ErrorCode. V programu InTouch je možné k těmto vlastnostem přiřadit proměnné (na stránce vlastností Properties). V

případě, že se tyto vlastnosti změní, změní se i příslušné proměnné programu InTouch. Chybový kód a text je možné kontrolovat ve skriptu po volání příslušné metody (viz příklad). Př.: Strana 17 / 20


#PantekDBGraphXY1.ZoomIn () { metoda nastavuje chybový kód } IF #Pantek DBGraphXY1.ErrorCode <>0 THEN errorString = #PantekDBGraphXY1.ErrorString; { textová proměnná } errorCode = #PantekDBGraphXY1.ErrorCode; { číselná proměnná } Show („ErrorWindow“); { okno obsahující proměnné errorString a errorCode } ENDIF;

Strana 18 / 20


Dokumentované chyby Zobrazení chyby “System Resource Exceeded” při použití ovladače Microsoft ODBC dBase Driver Příznaky: DBGraphXY je nakonfigurován pro čtení dat ze souborů DBF použitím ODBC ovladače Microsoft ODBC dBase driver. DBGraphXY korektně zobrazuje záznamy v programu WindowViewer, ale pokud je okno obsahující DBGraphXY několikrát zavřeno a znovu otevřeno, pak se objeví následující chybová zpráva: “[Microsoft][ODBC dBase Driver] System resource exceeded.” Od této chvíle nebude DBGraphXY zobrazovat správně data, dokud nerestartujete program WindowViewer. Obdobný problém se může vyskytnout také při použití programu WindowMaker. Podmínky výskytu chyby: Problém byl detekován pouze při použití ovladače Microsoft ODBC dBase driver na počítači, kde je nainstalováno BDE (Borland Database Engine). Řešení: Jestliže potřebujete použít soubory formátu DBF jako zdroje dat pro DBGraphXY, pak neinstalujte BDE na počítače s instalací InTouch/ DBGraphXY. Komentář: DBF je datový formát používaný databázovými systémy Microsoft dBase, založený na souborech s příponou DBF. Každý DBF soubor reprezentuje tabulku v databázi dBase. BDE je instalováno jako součást instalací některých produktů. Například, pokud instalujete Wonderware IndustrialSQL Server, pak instalace rovněž nainstaluje BDE. ODBC ovladač pro Microsoft dBase, který je instalován například s Microsoft Office, podporuje pouze DBF soubory s maximální délku jména osm znaků. Dalším omezením je, že tento ovladač vždy otevírá soubor DBF v režimu výhradního přístupu. To znemožňuje ostatním aplikacím zapisovat do téhož souboru, ze kterého DBGraphXY čte. Jakmile nainstalujete BDE, tak obě uvedená omezení budou odstraněna, ale může se objevit chyba popsaná v této kapitole. Tato chyba byla detekována pouze s ovladačem Microsoft ODBC dBase driver.

Strana 19 / 20


Dodavatel Pantek (CS) s.r.o.

Pantek (CS) s.r.o., pobočka Ostrava

Škroupova 957

28. října 150

Hradec Králové

Ostrava

500 02

702 00

Tel.: +420-(0)49-5635 072 až 3

Tel.: +420-(0)69-6602 378





Strana 20 / 20

Pantek Productivity Pack. DBGraphXY. Uživatelský manuál

Recommend Documents