Connect - metoda objektu tvTrend

Popis:

Připojení objektu tvTrend ke zdroji dat (k datovému rozšíření ExtTrend do objektu PmaTrendGroup).

Syntaxe:

Boolean Connect(Long nType, Variant vServer, Variant vGroup, Variant vItem, String sParam, [Variant vUser], [Variant vPassword])

Parametry:

nType	(Long) Typ připojení 0 - Parametry vServer, vGroup, vItem se neberou v úvahu a místo nich se připojuje podle nastavení vlastností: ConnectionType, ConnectionServer, ConnectionGroup, ConnectionItem, ConnectionUser, ConnectionPassword. 1 - Lokální připojení, připojení k trend serveru ve stejné běžící PROMOTIC aplikaci. Platné jsou všechny parametry metody. 2 - Vzdálené připojení přes HTTP protokol, data zasílána v XML formátu. Platné jsou všechny parametry metody.
vServer	(Variant) Vzdálený zdroj dat - server. Pokud nType=0, pak parametr není brán v úvahu. Pokud nType=1, pak hodnotu tohoto parametru je potřeba nastavit na řetězec "local". Pokud nType=2, pak je to http adresa a hodnotu tohoto parametru je potřeba nastavit textem typu: "http://computer/trend", kde: - computer je obvykle název vzdáleného počítače - trend je hodnota konfigurátoru "PmaWebFolder > WebFolder > Identifikátor Web komponenty" nebo konfigurátoru "PmaTrendGroup > Web server > Identifikátor Web komponenty" v aplikaci na počítači computer.
vGroup	(Variant) Skupina ve vzdáleném zdroji dat - serveru trendů (ID této skupiny). Pokud nType=0, pak parametr není brán v úvahu. Pokud nType=1, pak hodnotu tohoto parametru je potřeba nastavit například na řetězec "group1", kde group1 je hodnota na serveru v konfigurátoru "PmaTrendGroup > Trend > ID identifikátor skupiny". Pokud nType=2 a zároveň položka trend v parametru vServer je: - hodnota konfigurátoru "PmaWebFolder > WebFolder > Identifikátor Web komponenty", pak hodnotu tohoto parametru je potřeba nastavit například na řetězec "group1", kde group1 je hodnota konfigurátoru "PmaTrendGroup > Trend > ID identifikátor skupiny". - hodnota konfigurátoru "PmaTrendGroup > Web server > Identifikátor Web komponenty", pak hodnotu tohoto parametru je potřeba nastavit na prázdný řetězec "".
vItem	(Variant) Název proměnné ve skupině serveru trendů. Viz názvy proměnných v kartě "PmaTrendGroup > Data".
sParam	(String) Parametry pro připojení. Zadává se řetězec "iniread=xxx", kde xxx je libovolný z řetězců min, max, unit, color, name, nebo jejich kombinace oddělené čárkou. Například "iniread=min,max,color". Tyto hodnoty jsou voláním metody načteny z datového rozšíření ExtTrend a nastaveny do prohlížeče. Pokud parametr se nevyužívá, pak je nutno nastavit prázdný řetězec "".
vUser	[nepovinné] (Variant) Jméno uživatele. Zadává se pouze pokud server trendů vyžaduje ověření přístupu uživatelem a heslem, viz zadání uživatele a hesla v kartě "PmaRoot > Trendy". Parametr vUser není nutno zadávat, pokud parametr nType=1 nebo 0 a vlastnost ConnetionType=1, tzn. metoda Connect se připojuje k lokálnímu serveru.
vPassword	[nepovinné] (Variant) Heslo uživatele. Zadává se pouze pokud server trendů vyžaduje ověření přístupu uživatelem a heslem, viz zadání uživatele a hesla v serveru trendů - konfigurace v kartě "PmaRoot > Trendy". Parametr vPassword není nutno zadávat, pokud je parametr nType=1 nebo 0 a vlastnost ConnetionType=1, tzn. metoda Connect se připojuje k lokálnímu serveru.

Vrácená hodnota:

true - Připojení proběhlo úspěšně

false - Chyba v připojení

Poznámka:

Připojit se lze lokalně k trend serveru běžícímu ve stejné aplikaci jako ve které běží prohlížeč - v tom případě je přístup k serveru zaručen vždy a parametry vUser, vPassword nejsou využívány.

Připojit se lze ke vzdálenému serveru trendů PROMOTIC. Přístup ke vzdálenému serveru může být ověřován, viz karta "PmaRoot > Trendy" a lze použít parametry vUser, vPassword.

Poté, co metoda úspěšně skončila, jakýkoli posun v časové ose, nebo explicitní volání metody PmgTrendViewer.ReadData má za důsledek vyslání žádosti o data připojenému serveru.

Připojení je platné až do příštího volání metody Connect, nebo do zrušení objektu tvTrend, nebo do ukončení činnosti prohlížeče.