Opis:
Ładowanie danych konfiguracyjnych do przeglądarki.
Dane konfiguracyjne są danymi w formacie
XML wytworzonymi
albo przez wywołanie metody
SaveCfg
lub przez wywołanie metody
GetCfg
lub 'ręcznie', na przykład w edytorze tekstu.
Składnia:
Boolean LoadCfg(String sCfg, Long nStyle, [Function onComplete])
Parametry:
sCfg | (String) Źródło wczytanych danych konfiguracyjnych.
"serverfile.tg:" - plik na serwerze w folderze z ustawieniami trendów (patrz konfigurator " Ścieżka do plików konfiguracyjnych"), np. "serverfile.tg:config.tg".
Uwaga! Ważnym jest, że niniejsze odniesienie do pliku konfiguracyjnego jet ważne zarówno na serwerze w uruchomionej aplikacji jak również u klienta w Web aplikacji. Umożliwia zatem zapisanie wczytania pliku konfiguracyjnego jednolitym sposobem bez względu na to, czy chodzi o aplikację lokalną czy też o Web aplikację. W uruchomionej aplikacji plik jest wczytany bezpośrednio jako file: natomiast w Web aplikacji jako http:.
"file:" - Plik na dysku, np. "file:c:/config.tg". Patrz Przykład3.
"string:" - Parametr zawiera właściwe dane konfiguracyjne - łańcuch w formacie XML.
Konfiguracja wprwdzie zostanie wczytane również jeżeli w parametrze brakuje na początku string:, lecz zalecamy tam wprowadzanie parametru string:.
"http:" - Adres URL. Do parametru jest konieczne określić na przykład "http://computer/address/cfg.tg". Patrz Przykład4.
"input:" - Wybór z listy.
W liście są wyświetlone nazwy plików konfiguracji zapisanych w folderze #cfg: (np. input:#cfg: ).
Jeżeli był zdefiniowany serwer konfiguracyjny (przy pomocy metody AddServer z parametrem sPurpose="cfg"), wtedy do wyboru są dodany także grupy konfiguracyjne z tego serwera.
U Web klienta są dodane do wyboru również:
- Pliki konfiguracyjne, które klient zapisał przy pomocy metody SaveCfg w tymczasowej przechowywalni przeglądarki Webowej.
- Grupy konfiguracyjne z serwera, z którego został dany Web panel wczytany. |
nStyle | (Long) Określa, w jaki sposób mają być wczytywane dane do przeglądarki. Właściwości przeglądarki są zawsze przepisywane. Parametr określa, w jaki sposób mają zostać wczytane obiekty tvTrend jeżeli przeglądarka przed wywołaniem niniejszej metody już ma wytworzone jakieś obiekty tvTrend (tzn. które wyświetlają już jakieś wykresy).
6 - Istniejące obiekty tvTrend w przeglądarce zostaną przepisane danymi konfiguracyjnymi. Jeżeli obiekty nie istnieją, wtedy są wytwarzane i napełnione.
10 - Istniejące obiekty tvTrend zostaną pozostawione bez zmian. Zostaną wytworzone i dodane nowe obiekty tvTrend.
11 - Istniejące obiekty tvTrend zostaną usunięte. Następnie zostaną wytworzone i dodane nowe obiekty tvTrend.
27 - Jeżeli w przeglądarce już istnieją obiekty tvTrend, wtedy najpierw zostanie wyświetlone okno z zapytaniem czy Najpierw usunąć zawartość przeglądarki (tzn. wszystkie trendy). Dopiero potem zostaną wytworzone i dodane nowe obiekty tvTrend. |
onComplete | [opcjonalne] (Function) Funkcja zdarzenia w formie function onComplete(ev) {};. Funkcja zostanie wywołana po wczytaniu pliku konfiguracyjnego (operacja asynchroniczna).
Parametry:
ev | (Object) Odniesienie do obiektu zawierającego ściślejsze informacje o danym zdarzeniu.
Result - Wynik wykonanej operacji.
true - wczytanie pomyślne
false - wczytanie nieudane |
---|
|
---|
Wartość zwrotna:
true - wczytanie pomyślne
false - wczytanie nieudane
Notatka:
Metoda ta działa także w
Web panelach.
Dane konfiguracyjne są
danymi tekstowymi przeglądarki w składni języka XML. Jeżeli są zapisane na dysk, wtedy jest konieczne ich zapisanie do pliku z rozszerzeniem
.tg (końcówkę
*.tg system PROMOTIC zna i potrafi z danymi zapisanymi w takich plikach pracować).
Jeżeli dane konfiguracyjne zawierają obiekty
tvTrend z danymi określającymi podłączenie do źródeł danych (do serwerów trendów), wtedy podczas biegu przeglądarki w runtime są obiekty trend po wczytaniu podłączone do źródła danych (do serwerów).
Każde wołanie metody ustawi właściwości
LastCfgSrc,
LastCfgTitle. We właściwości
LastCfgTitle jest ustawiona użytkownikiem określona nazwa grupy konfiguracyjnej. Wiersz z nazwą użytkownika nie powstaje automatycznie przy powstaniu pliku konfiguracyjnego przez wywołanie metody
SaveCfg, jest konieczne ręcznie uzupełnienie do zawartości pliku konfiguracyjnego wiersza z taką nazwą ustawioną przez użytkownika, patrz opis właściwości
LastCfgTitle.
Przykład1:
Odczyt konfiguracji z pliku na serwerze. Otworzy okno z listą zapisanych plików konfiguracyjnych. Po potwierdzeniu wyboru zostanie wyświetlone okno z opcją dodania lub zastąpienia istniejącej konfiguracji.
JavaScriptVBScriptWybierz oraz skopiuj do schowka
var oTView = pMe;
oTView.LoadCfg("input:#cfg:", 27, onLoadCfg);
function onLoadCfg(ev)
{
if (ev.Result)
{
oTView.ReadData();
oTView.Draw();
oTView.CursorTime = Pm.Time;
}
}
If oTView.LoadCfg("input:#cfg:", 27) Then
oTView.ReadData
oTView.Draw
oTView.CursorTime = Pm.Time
End If
Przykład2:
Odczyt ustawienia
z pliku na serwerze. Przed wywołaniem metody istniejące obiekty
tvTrend zostają usunięte, następnie jest wczytana konfiguracja z pliku na serwerze.
JavaScriptVBScriptWybierz oraz skopiuj do schowka
var oTView = pMe;
oTView.LoadCfg("serverfile.tg:mycfg.tg", 11, onLoadCfg);
function onLoadCfg(ev)
{
if (ev.Result)
{
oTView.ReadData();
oTView.Draw();
}
}
Dim oTView
Set oTView = pMe
If oTView.LoadCfg("serverfile.tg:mycfg.tg", 11) Then
oTView.ReadData
oTView.Draw
End If
Przykład3:
Odczyt konfiguracji
z pliku na dysku. Przed wywołaniem metody zostaną istniejące obiekty
tvTrend usunięte, następnie zostanie wczytana konfiguracja z pliku.
JavaScriptVBScriptWybierz oraz skopiuj do schowka
var oTView = pMe;
oTView.LoadCfg("file:c:/mycfg.tg", 11, onLoadCfg);
function onLoadCfg(ev)
{
if (ev.Result)
{
oTView.ReadData();
oTView.Draw();
}
}
Dim oTView
Set oTView = pMe
If oTView.LoadCfg("file:c:/mycfg.tg", 11) Then
oTView.ReadData
oTView.Draw
End If
Przykład4:
Odczyt konfiguracji
z adresu HTTP. Przeglądarka trendów wyświetla trendy z aplikacji PROMOTIC
AP1. Przeglądarka znajduje się albo w panelu innej aplikacji PROMOTIC lub jest w
Web panelu przeglądanym w przeglądarce internetowej. Jest konieczne wczytanie konfiguracji zapisanej na przykład w pliku
cfg1.tg. Niech ów plik jest udostępniany przez aplikację
AP1 (aplikacja ta znajduje się na komputerze o nazwie "
computerAP1") do Webu przy pomocy obiektu
PmaWebDir (
Identyfikator Web komponentu tego obiektu jest
"dir3") pod adresem HTTP na przykład
"http://computerAP1/dir3/cfg1.tg". W takim przypadku można wczytać konfigurację do przeglądarki następująco:
JavaScriptVBScriptWybierz oraz skopiuj do schowka
var oTView = pMe;
oTView.LoadCfg("http://computerAP1/dir3/cfg1.tg", 11, onLoadCfg);
function onLoadCfg(ev)
{
if (ev.Result)
{
oTView.ReadData();
oTView.Draw();
}
}
Dim oTView
Set oTView = pMe
If oTView.LoadCfg("http://computerAP1/dir3/cfg1.tg", 11) Then
oTView.ReadData
oTView.Draw
End If
Historia:
Pm8.00.12: zwraca wartość
true również dla opcji
"http:"