Promotic
WikipediaLinkedInYoutubeTwitterFacebook

SaveCfg - metoda objektu TrendsView

Popis:
Uložení aktuálních konfiguračních dat prohlížeče
Syntaxe:
SaveCfg(sCfg As String, nStyle As Long, sFilter As String) As Boolean
Volání:
oTView.SaveCfg sCfg, nStyle, sFilter
Parametry:
sCfg(String) Místo pro uložení konfiguračních dat. Může být:
"input:" - Výběr ze seznamu. Před uložením se otevře seznam již existujících konfigurací. Lze tak vybrat existující soubor nebo zvolit nový soubor.
- Pokud běží prohlížeč trendů v lokálním obraze na serveru:

Seznam konfigurací se načte ze souborové složky zadané za textem "input:". Tam bude také uložen vybraný soubor..

- Pokud běží prohlížeč trendů ve WEB prohlížeči:

Seznam konfigurací se načte z dočasného úložiště WEB prohlížeče. Na toto úložiště se také uloží vybraný soubor. V tomto případě se nehledí na to, co je zadáno za textem "input:".

Příklad: "input:#cfg:", viz Příklad1.

"file:" - Soubor na disku. Konfigurační data budou uloženy do zadaného souboru, který je uveden za textem "file:".
- Pokud běží prohlížeč trendů v lokálním obraze na serveru:

Název souboru je uveden včetně celé cesty k souboru..

- Pokud běží prohlížeč trendů ve WEB prohlížeči:

Ve WEB prohlížeči není zatím tato volba funkční.

Příklad: "file:#cfg:config.tg", viz Příklad2.

"string:" - Textový řetězec. Parametr je v tomto připadě vstupně/výstupní a výstupní následně obsahuje samotná konfigurační data - XML formátovaný text.

Hodnota "string:" je zastaralá a je lepší použít metodu GetCfg.

nStyle(Long) Určuje, jakým způsobem mají být data uložena.
0 - Uložit vždy.
1 - Pokud soubor již existuje, pak se zobrazi dotaz, zda existujici soubor přepsat (pokud je zadána odpověď NE, konfigurace není uložena).
2 - Pokud soubor již existuje, konfigurace není uložena.
sFilter(String) Určuje, které z vlastností prohlížeče budou uloženy do konfiguračních dat.

Jednotlivé hodnoty lze řetězit. Příklad: "View;Trends;TimeMinMax;".

"View;" - Uložit vzhled prohlížeče mimo objektů tvTrend a mimo časů levého a pravého okraje prohlížeče.
"Trends;" - Uložit pouze konfiguraci objektů tvTrend bez datových bodů
"TrendsNoConnect;" - Uložit pouze konfiguraci objektů tvTrend bez datových bodů a bez parametrů připojení. Parametry připojení udávají vlastnosti ConnectionType, ConnectionServer, ConnectionGroup a ConnectionItem objektu tvTrend. Tato volba je vhodná pro použítí při generování konfiguračního souboru pro tisky. Poznámka! Pokud některá vlastnost trendu, (například tvTrend.Name, tvTrend.Unit, tvTrend.ValueMin, tvTrend.ValueMax nebo tvGraph.Color), obsahuje příznak $default (indikující vyčtení hodnoty ze serveru), potom bude tento příznak nahrazen skutečnou vyčtenou hodnotou (bez připojení není odkud vyčíst).
"TrendsData;" - Uložit jen aktuálně prohlížečem načtené datové body objektu tvTrend bez konfigurace tohoto objektu. Tato volba je vhodná pro použití při generování konfiguračního souboru pro tisky.
"TimeMinMax;" - Uložit levý a pravý čas okraje prohlížeče.
"TimeZoom;" - Uložit jen délku časové osy prohlížeče.
Vrácená hodnota:
Metoda vrací úspěšnost uložení. Hodnota false je neúspěšné uložení.
Poznámka:
Konfigurační data jsou uložena ve formátu XML a následně je lze upravovat libovolnými textovými editory a zpětně načitat do prohlížeče metodou LoadCfg.
 
Tato metoda ukládá konfiguraci vždy na počítači, na kterém se trendy prohlíží. Tzn. pokud je prohlížeč trendů na klientovi (WEB prohlížeč typy InternetExplorer, Firefox, Chrome ..), pak se konfigurace uloží v dočasném uložišti tohoto WEB prohlížeče a jiný klient k ní nebude mít přístup. Metoda nemůže konfigurace ukládat na server, protože zde nejsou žádné omezovací mechanismy pro testování uživatele (ať každý nemůže ukládat na server).

Pro ukládání konfigurace na server je určena metoda GetCfg.

Příklad1:
Před uložením se otevře seznam již existujících konfigurací. Lze tak vybrat existující soubor nebo zvolit nový soubor. Do souboru se uloží pouze konfigurace objektů tvTrend zobrazených v prohlížeči.
oTView.SaveCfg "input:#cfg:", 1, "Trends;"
Příklad2:
Uložení do zadaného souboru na disku. Do souboru se uloží pouze konfigurace objektů tvTrend zobrazených v prohlížeči.
oTView.SaveCfg "file:#cfg:mycfg.tg", 0, "Trends;"
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice