Promotic
WikipediaLinkedInYoutubeTwitterFacebook

Open - metoda objektu PmTrend

Popis:
Otevření nebo vytvoření nového archivu trendů a zpřístupnění jeho dat.
Syntaxe:
Open(sSourceType As String, sSource As String, [sConnection As String]) As Boolean
Volání:
oTrend.Open sSourceType, sSource, sConnection
Parametry:
sSourceType(String) Určuje typ archivu, jehož data budou voláním metody zpřístupněna.
"accesscyclic" (nepovinné) - Otevření archivu technologií Database Access cyclic.
"mssqlcyclic" (nepovinné) - Otevření archivu technologií Database MS SQL server cyclic.
"oraclecyclic" (nepovinné) - Otevření archivu technologií Database Oracle cyclic.
"mysqlcyclic" (nepovinné) - Otevření archivu technologií Database MySQL cyclic.
"firebirdcyclic" (nepovinné) - Otevření archivu technologií Database FireBird cyclic.
"promoticcyclic" (nepovinné) - Otevření archivu technologií Promotic binary file cyclic.
"accessbackup" (nepovinné) - Otevření archivu technologií Database Access backups (zastaralé).
"dbasebackup" (nepovinné) - Otevření archivu technologií Database dBase backups.
"mssqlbackup" (nepovinné) - Otevření archivu technologií Database MS SQL server backups (zastaralé).
sSource(String) Určuje zdroj dat, ke kterému se připojuje PmTrend objekt. Údaje s přiřazenou hodnotou jsou zde odděleny středníkem, například "database:c:\database.mdb;table:data;".
"server:xxx;" (nepovinné) - (ignoruje se pokud je parametr sConnection)Název SQL serveru, ze kterého budou čtena data. Nenastavuje se pokud je parametr sSourceType nastaven na "accesscyclic", "accessbackup", "dbasebackup" nebo "promoticcyclic".
"user:xxx;" (nepovinné) - (ignoruje se pokud je parametr sConnection)Uživatel pro přístup k SQL serveru. Nenastavuje se pokud je parametr sSourceType nastaven na "accesscyclic", "accessbackup", "dbasebackup" nebo "promoticcyclic".
"password:xxx;" (nepovinné) - (ignoruje se pokud je parametr sConnection)Heslo uživatele pro přístup k SQL serveru. Nenastavuje se pokud je parametr sSourceType nastaven na "accesscyclic", "accessbackup", "dbasebackup" nebo "promoticcyclic".
"database:xxx;" (nepovinné) - (ignoruje se pokud je parametr sConnection)Určuje se zde databáze, ve které jsou uložena data. Pokud je parametr sSourceType:
"mssqlcyclic", "oraclecyclic", "mysqlcyclic", "firebirdcyclic", "mssqlbackup": určuje se zde SQL databáze.
"dbasebackup": určuje se zde složka se soubory *.dbf.
"accesscyclic", "accessbackup": určuje se zde soubor *.mdb.
"promoticcyclic": určuje se zde složka se souborem *.ht.
"table:xxx;" (nepovinné) - Určuje tabulku nebo prefix tabulky, ve které jsou uložena data. Pokud je parametr sSourceType:
"mssqlcyclic", "oraclecyclic", "mysqlcyclic", "firebirdcyclic", "accesscyclic": určuje se zde název tabulky s cyklickými daty.
"dbasebackup": určuje se zde prefix (počátek) názvů záloh (tabulek v databázi), úplný název je pak tvořen tímto prefixem a datem s časem. Pokud se zde zadá celý název souboru *.dbf včetně přípony, potom to znamená, že se bude prohlížet jediný konkrétní soubor a nikoliv sada záloh. Poznámka!Lze zde také zadat úplný název souboru *.dbf včetně cesty (složky), potom se cesta už nezadává v parametru "database:". Úplnou cestu je možné zadat i v podobě #data:.
"mssqlbackup", "accessbackup": určuje se zde prefix (počátek) názvů záloh (tabulek v databázi), úplný název je pak tvořen tímto prefixem a datem s časem nebo pořadovým číslem.
"promoticcyclic": určuje se zde název cyklického souboru *.ht (může být zadán i s příponou). Poznámka! Lze zde také zadat úplný název souboru *.ht včetně cesty (složky), potom se cesta už nezadává v parametru "database:". Úplnou cestu je možné zadat i v podobě #data:.
"coltimename:xxx;" (nepovinné) - Zadává se název sloupce tabulky (určené parametrem table), ve kterém je uložen čas. Parametr není možno zadat při nastavení sSourceType na "mssqlbackup", "accessbackup", "dbasebackup" nebo "promoticcyclic".
"colattrname:xxx;" (nepovinné) - Zadává se název sloupce tabulky (určené parametrem table), ve kterém jsou uloženy atributy. Vyplňuje se jen tehdy, když se přistupuje k tabulce databáze, jenž vznikla archivací dat PmTrend objektem, jinak se tento parametr zadává prázdný. Parametr není možno zadat při nastavení sSourceType na "mssqlbackup", "accessbackup", "dbasebackup" nebo "promoticcyclic".

Upozornění! Pokud se otevírá databázová tabulka, která nebyla vytvořena PmTrend objektem a ve které není obsažený sloupec s atributem, potom se musí tento parametr uvést s prázdnou hodnotou (colattrname:;), jinak by se použila výchozí hodnota "pm_attr".

"backupcount:xxx;" (nepovinné) - Určuje počet záloh (tabulek) v archivu trendů. Nastavuje se jen pokud je parametr sSourceType nastaven na "mssqlbackup", "accessbackup" nebo "dbasebackup".
"backupsizerows:xxx;" (nepovinné) - Určuje velikost jedné zálohy (tabulky) v archivu trendů počtem řádků. Nastavuje se jen pokud je parametr sSourceType nastaven na "mssqlbackup", "accessbackup" nebo "dbasebackup".
"backupsizetime:xxx;" (nepovinné) - Určuje velikost jedné zálohy (tabulky) v archivu trendů časovým intervalem. Nastavuje se jen pokud je parametr sSourceType nastaven na "mssqlbackup", "accessbackup" nebo "dbasebackup".
sConnection[nepovinné] (String) ADO Connection řetězec napojení na databázi tredů. Pokud je tento parametr nastaven, potom se nepoužívají následující parametry parametru sSource: "server:xxx;", "database:xxx;", "user:xxx;" a "password:xxx;". Tyto parametry jsou už obsaženy ve vlastním ADO Connection řetězci v parametru sConnection.
Vrácená hodnota:
Vrací true, pokud byl archiv úspěšně otevřen, jinak false.
Poznámka:
Metoda nastavuje a otevírá archiv trendů (pokud doposud nebyl vytvořen, pak i vytváří). Pokud byl archiv otevřen již dříve (při startu aplikace, dřívějším voláním Open), metoda nejdříve uzavře stávající archiv.

Konfigurátor Jen pro čtení (nová data nelze zapisovat) ovlivňuje chování metody Open (viz PmTrend objekt v módu "Jen pro čtení (nová data nelze zapisovat)").

Viz také:
Příklad1:
Otevření tabulky v Access databázi vytvořené PmTrend objektem.
oTrend.Open "accesscyclic", "database:c:\trend1.mdb;table:history1;coltimename:pm_time;colattrname:pm_attr;"
  nebo
oTrend.Open "accesscyclic", "table:history1;coltimename:pm_time;colattrname:pm_attr;", "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=c:/trend1.mdb;"
Příklad2:
Otevření tabulky v Access databázi data.mdb (vytvořené externě jiným systémem). Sloupec času v tabulce se jmenuje savetime. Je zapnut mód "Jen pro čtení (nová data nelze zapisovat)", tj. konfigurátor Jen pro čtení (nová data nelze zapisovat) je nastaven na true.
oTrend.Open "accesscyclic", "database:c:\data.mdb;table:pmctv;coltimename:savetime;colattrname:;"
  nebo
oTrend.Open "accesscyclic", "table:pmctv;coltimename:savetime;colattrname:;", "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=c:\data.mdb;"
Příklad3:
Otevření tabulky v MS SQL serveru (tabulka opět nebyla vytvořena systémem PROMOTIC). Sloupec času v tabulce se jmenuje savetime. Je zapnut mód "Jen pro čtení (nová data nelze zapisovat)", tj. konfigurátor Jen pro čtení (nová data nelze zapisovat) je nastaven na true.
oTrend.Open "mssqlcyclic", "server:.\MSSQLSERVER;user:pm_writer;password:pmwriter;database:pm_data;table:pmctv;coltimename:savetime;colattrname:;"
  nebo
oTrend.Open "mssqlcyclic", "table:pmctv;coltimename:savetime;colattrname:;", "Provider=SQLOLEDB;Server=.\MSSQLSERVER;Database=pm_data;Uid=pm_writer;Pwd=pmwriter;"
Příklad4:
Otevření binárního datového souboru, který byl vytvořen Promotic PmTrend objektem.
oTrend.Open "promoticcyclic", "table:c:\data.ht;"
Příklad5:
Otevření archivu trendů ve formátu dBase ve složce dat aplikace, v jeho podsložce trend\archive. Archiv trendů byl vytvořen Promotic PmTrend objektem a názvy souborů *.dbf (tabulek) začínají prefixem Trend.
oTrend.Open "dbasebackup", "database:#data:/trend/archive;table:trend;backupcount:15;backupsizerows:500;backupsizetime:not limited;"
  nebo
oTrend.Open "dbasebackup", "table:trend;backupcount:15;backupsizerows:500;backupsizetime:not limited;", "Data Source=c:/trend/archive;"
Příklad6:
Otevření jednoho konkrétního souboru dBase ve složce dat aplikace, v jeho podsložce trend\archive. Soubor byl vytvořen PROMOTIC PmTrend objektem.
Dim sSource
oTrend.Close
sSource = "table:#data:/trend/archive/trend2014-02-12_14-18-26.dbf;"
  nebo
sSource = "database:#data:/trend/archive;table:trend2014-02-12_14-18-26.dbf;"
oTrend.Open "dbasebackup",sSource
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice