Open - metoda objektu PmaTrendGroup

Popis:

Otevření nebo vytvoření nového archivu trendů a zpřístupnění jeho dat.

Syntaxe:

Boolean Open(String sSourceType, String sSource, [String 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 objekt PmaTrendGroup. Údaje jsou zde ve formátu KeyVal, například "database:c:\database.mdb;table:data;". "server:xxx;" (nepovinné) - (ignoruje se pokud je uveden parametr sConnection) Název SQL serveru, ze kterého budou čtena data. Nenastavuje se pokud parametr sSourceType je nastaven na "accesscyclic", "accessbackup", "dbasebackup" nebo "promoticcyclic". "user:xxx;" (nepovinné) - (ignoruje se pokud je uveden parametr sConnection) Uživatel pro přístup k SQL serveru. Nenastavuje se pokud parametr sSourceType je nastaven na "accesscyclic", "accessbackup", "dbasebackup" nebo "promoticcyclic". "password:xxx;" (nepovinné) - (ignoruje se pokud je uveden parametr sConnection) Heslo uživatele pro přístup k SQL serveru. Nenastavuje se pokud parametr sSourceType je nastaven na "accesscyclic", "accessbackup", "dbasebackup" nebo "promoticcyclic". "database:xxx;" (nepovinné) - (ignoruje se pokud je uveden parametr sConnection) Určuje se zde databáze, ve které jsou uložena data. Pokud parametr sSourceType je: "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 parametr sSourceType je: "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, pak to znamená, že se bude prohlížet jediný konkrétní soubor a nikoliv sada záloh. Poznámka!* Lze zadat také úplný název souboru .dbf včetně cesty (složky), pak se cesta už nezadává v parametru "database:". Úplnou cestu lze 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 (lze zadat s příponou). Poznámka! Lze zde také zadat úplný název souboru .ht včetně cesty (složky), pak se cesta už nezadává v parametru "database:". Úplnou cestu lze 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 nelze 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 pouze pokud se přistupuje k tabulce databáze, která vznikla archivací dat objektem PmaTrendGroup, v jiném případě se tento parametr zadává prázdný. Parametr nelze zadat při nastavení sSourceType na "mssqlbackup", "accessbackup", "dbasebackup" nebo "promoticcyclic". Upozornění! Pokud se otevírá databázová tabulka, která nebyla vytvořena objektem PmaTrendGroup a ve které není obsažený sloupec s atributem, pak se musí tento parametr uvést s prázdnou hodnotou (colattrname:;), v jiném případě by se použila výchozí hodnota "pm_attr". "backupcount:xxx;" (nepovinné) - Určuje počet záloh (tabulek) v archivu trendů. Nastavuje se pouze pokud parametr sSourceType je nastaven na "mssqlbackup", "accessbackup" nebo "dbasebackup". "backupsizerows:xxx;" (nepovinné) - Určuje velikost jedné zálohy (tabulky) v archivu trendů počtem řádků. Nastavuje se pouze pokud parametr sSourceType je nastaven na "mssqlbackup", "accessbackup" nebo "dbasebackup". "backupsizetime:xxx;" (nepovinné) - Určuje velikost jedné zálohy (tabulky) v archivu trendů časovým intervalem. Nastavuje se pouze pokud parametr sSourceType je nastaven na "mssqlbackup", "accessbackup" nebo "dbasebackup".
sConnection	[nepovinné] (String) ADO Connection řetězec napojení na databázi tredů. Pokud je tento parametr nastaven, pak 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, v jiném případě 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 (po spuštění aplikace, dřívějším voláním metody Open), pak 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 Objekt PmaTrendGroup v módu "Jen pro čtení (nová data nelze zapisovat)").