Promotic
WikipediaLinkedInYoutubeTwitterFacebook

Connect - metoda objektu tvTrend

Popis:
Připojení objektu tvTrend ke zdroji dat (k proměnné v objektu PmTrend).
Syntaxe:
Connect(nType As Long, vServer As Variant, vGroup As Variant, vItem As Variant, sParam As String, [vUser As Variant], [vPassword As Variant]) As Boolean
Volání:
b = oTrend.Connect(nType, vServer, vGroup, vItem, sParam) 'Server NEvyžaduje ověření oprávnění.
b = oTrend.Connect(nType, vServer, vGroup, vItem, sParam, vUser, vPassword) 'Server vyžaduje ověření oprávnění.
Parametry:
nType(Long) Typ připojení
0 - parametry vServer, vGroup, vItem se neberou v úvahu a místo nich se připojuje podle nastavených 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í pomocí HTTP protokolu, 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 PmWebFolder > WebFolder > Identifikátor WEB komponenty nebo konfigurátoru PmTrend > 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 PmTrend > Trend > ID identifikátor skupiny.
Pokud nType=2 a zároveň položka trend v parametru vServer je:
- hodnota konfigurátoru PmWebFolder > 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 PmTrend > Trend > ID identifikátor skupiny.
- hodnota konfigurátoru PmTrend > Web Server > Identifikátor WEB komponenty, pak hodnotu tohoto parametru je potřeba nastavit na prázdný řetězec "".
vItem(Variant) Název veličiny ve skupině serveru trendů. Viz názvy veličin v záložce PmTrend > 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ěleny čárkou, například "iniread=min,max,color". Význam těchto řetězců je po řadě minimum, maximum, jednotka, barva a název. Tyto hodnoty jsou voláním metody načteny z veličiny v záložce PmTrend > Data a nastaveny do prohlížeče.

Pokud se parametr nevyužívá, pak je nutno nastavit prázdný řetězec "".

vUser[nepovinné] (Variant) Název uživatele. Zadává se jen, pokud server trendů vyžaduje ověření přístupu uživatelem a heslem, viz zadání uživatele a hesla v záložce PmRoot > Trendy.

Parametr vUser neni nutno zadávat, pokud je parametr nType=1 nebo 0 a vlastnost ConnetionType=1, tj. metoda Connect se připojuje k lokálnímu serveru.

vPassword[nepovinné] (Variant) Heslo uživatele. Zadává se jen, pokud server trendů vyžaduje ověření přístupu uživatelem a heslem, viz zadání uživatele a hesla v serveru trendů - konfigurace záložky PmRoot > Trendy.

Parametr vPassword neni nutno zadávat, pokud je parametr nType=1 nebo 0 a vlastnost ConnetionType=1, tj. 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 tomto 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 záložka PmRoot > Trendy a parametry vUser, vPassword mohou být využívány.

Poté, co metoda úspěšně skončila, jakýkoliv posun v časové ose, nebo explicitní volání metody TrendsView.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.

Příklad1:
Připojení k serveru trendů, k objektu PmWebFolder v tomto serveru, trends (v adrese "http://computer/trends") je identifikátor Web komponenty v záložce WebFolder.
Dim bConnect, oTrend
Set oTrend = oTView.Trends("t1")
If Not oTrend Is Nothing Then
  bConnect = oTrend.Connect(2, "http://computer/trends", "group1", "a1", "")
  If bConnect Then
     'OK
  End If
End If
Příklad2:
Připojení k serveru trendů, k objektu PmTrend v tomto serveru, historical1 (v adrese "http://computer/historical1") je identifikátor Web komponenty v záložce Web Server.
Dim bConnect, oTrend
Set oTrend = oTView.Trends("t1")
If Not oTrend Is Nothing Then
  bConnect = oTrend.Connect(2, "http://computer/historical1", "", "a1", "")
  If bConnect Then
     'OK
  End If
End If
Příklad3:
Dim bConnect, oTrend
Set oTrend = oTView.Trends("t1")
If Not oTrend Is Nothing Then
  bConnect = oTrend.Connect(1, "local", "group1", "a1", "")
  If bConnect Then
     'OK
  End If
End If
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice