Promotic
WikipediaLinkedInYoutubeTwitterFacebook

SaveToHtm - metoda obiektu TrendsView

Opis:
Metoda wczyta plik HTML określony w parametrze sSrcHtm, zapisze do niego własne dane wyeksportowane do łańcucha i w rezultacie wytworzy stronę HTML, którą zapisze według ustawienia parametru sDstHtm.

W ten sposób wytworzona strona HTML może mieć wygląd wykresu lub tabelkowy i można ją wykorzystać na przykład do druku (patrz Przykład1).

Składnia:
SaveToHtm(sSrcHtm As String, sDstHtm As String, sParams As String, [sParText As String]) As Variant
Wołanie:
b = oTView.SaveToHtm(sSrcHtm, sDstHtm, sParams)
Parametry:
sSrcHtm(String) Nazwa pliku ze ścieżką określona prefiksem file: (np. "file:c:/source.htm"), z którego jest wczytywany źródłowy plik HTML. Jeżeli nie jest wprowadzona pełna ścieżka, wtedy zostanie uzupełniona względnie w stosunku do foldera aplikacji (jeżeli przeglądarka trendów działa w aplikacji PROMOTIC).

Jeżeli wprowadzona wartość jest:

ver:0 lub pusty łańcuch "" - Przestarzały sposób, kiedy zostanie zastosowany dla użytkownika niedostępny plik, dostarczony systemem PROMOTIC.
ver:1 - Oznacza zastosowanie wersji 1 wewnętrznego pliku źródłowego HTML (TrPrintGraph1.htm). Jest zalecane stosowanie tej nowej wersji.

U Web klienta, w panelu napisanym w języku JavaScript, zostanie bez względu na powyższe ustawienie zastosowany jako szablon plik TrPrintGraph2.htm.

 
W katalogu podległym Web katalogu instalacyjnego PROMOTIC można znaleźć taki sam szablon o nazwie TrPrintxxx.htm, w którym xxx rozróżnia, czy chodzi o szablon w formie wykresów czy tabelkowy - TrPrintGraph1.htm, TrPrintTable1.htm. Plik ten można skopiować (np. do katalogu aplikacji), kopię dostosować i w ten sposób zmienioną kopię zastosować zamiast oryginalnego pliku przez ustawienie parametru sSrcHtm na ścieżkę do w ten sposób zmienionej kopii.

Do wprowadzenia nie można bezpośrednio wykorzystać makro wyrażenia, lecz można wykorzystać metodę EvalMacro.

sDstHtm(String) Miejsce do zapisania strony HTML. Może być następujące: Może być:
- plik na dysku, który zostanie nowo wytworzony - Nazwa pliku ze ścieżką wprowadzona z prefiksem file: (np. "file:c:/dest.htm"). Jeżeli nie jest wprowadzona pełna ścieżka, wtedy zostanie uzupełniona względnie w stosunku do foldera aplikacji (jeżeli przeglądarka trendów jest uruchomiona w aplikacji PROMOTIC).
- łańcuch w zmiennej (String) - W tym przypadku parametr jest wejściowo/wyjściowy (wejściem jest "string:") i następnie po wywołaniu tej metody zawiera właściwą zawartość pliku HTML.
- łańcuch w zmiennej (String) - gdzie słowem kluczowym jest "return:" wtedy metoda zwraca samą zawartość strony HTML. (Metoda z takim parametrem działa również w panelach JavaScript.)

Do wprowadzenia nie można bezpośrednio wykorzystać makro wyrażenia, lecz można wykorzystać metodę EvalMacro.

sParams(String) Dodatkowe parametry określająca sposób wytworzenia pliku docelowego. Dane są tutaj w formacie KeyVal, na przykład "mode:graph;view:dlg;".
"mode:xxx;" (opcjonalne) - Określa, która strona zostanie wykorzystana do wyświetlania danych przeglądarki trendów
table (domyślnie) - strona w tabelkowej formie
graph - strona w formie graficznej z wykresem 2-wymiarowym
"graphcfg:xxx;" (opcjonalne) - Określa, jakie ustawienie zostanie zastosowane dla przeglądarki trendów w formie graficznej (TrendsView) w zapisanej stronie HTML. Strona HTML zawiera w sobie swój własny obiekt ActiveX (TrendsView).
default (domyślnie) - Wszystkie ustawienia przeglądarki w zapisanej stronie HTML będą domyślne (z wyjątkiem czasu od-do).
copy - Wszystkie ustawienia przeglądarki w zapisanej stronie HTML zostanie przejęte z przeglądarki, w której została wywołana metoda SaveToHtm.
"view:xxx;" (opcjonalne) - Określa, czy i jak ma zostać wyświetlona wytworzona strona
no (domyślnie) - nie jest wyświetlana
dlg - wytworzona strona zostanie wyświetlona w oknie o wstępnie ustawionej wielkości
"text_xxx:yyy;" (opcjonalne) - Szablon HTML (określony w parametrze sSrcHtm) zawiera kilka wstępnie ustawionych słów kluczowych, które umożliwiają wprowadzenie tekstu przez projektanta, który następnie zostanie wyświetlony w wytworzonym pliku (określonym w parametrze sDstHtm) zamiast tych słów kluczowych, patrz opis wartości.
text_title - Wartość słowa kluczowego title w szablonie HTML (sSrcHtm) zostanie zastąpiona przez łańcuch yyy.

Przykład: text_title:Kotlownia 5;

text_note1 - Wartość słowa kluczowego note1 w szablonie HTML (sSrcHtm) zostanie zastąpiona przez łańcuch yyy.
text_note2 - Wartość słowa kluczowego note2 w szablonie HTML (sSrcHtm) zostanie zastąpiona przez łańcuch yyy.
text_codeinit - Wartość słowa kluczowego codeinit w szablonie HTML (sSrcHtm) zostanie zastąpiona przez łańcuch yyy. Łańcuch yyy jest kodem inicjalizującym w języku javascript, który zostanie wykonany przy wczytaniu strony.

Jeżeli w łańcuchu yyy występuje znak ; (średnik), wtedy jest konieczne ustawić text_codeinit:$Par:0; a właściwy kod inicjalizacyjny wprowadzić w parametrze sParText, patrz Przykład5. W przykładzie zastosowane odniesienie oTView jest odniesieniem do przeglądarki trendów TrendsView i jej nazwa musi być dotrzymana.

text_userYY - Oprócz wstępnie przygotowanych słów kluczowych można zedytować kopię szablonu (skopiowaną z oryginalnego szablonu HTML z katalogu PROMOTIC Web, patrz opis parametru sSrcHtm) i uzupełnić do niego następne słowa kluczowe i w parametrze zdefiniować łańcuch do zastąpienia. Na przykład jeżeli w szablonie HTML występuje słowo kluczowe userkey, wtedy parametr jest:

text_userkey:tekst do wyświetlenia;

sParText[opcjonalne] (String) Tekst do zastąpienia słowa kluczowego codeinit w szablonie HTML. Patrz opis parametru sParams, wartości codeinit.
Wartość zwrotna:
true - zapis przebiegł pomyślnie (nieważne jeżeli parametr sDstHtm = "return:")
false - W innym przypadku (nieważne jeżeli parametr sDstHtm = "return:")
HTMLstring - Zwraca zawartość strony html jeżeli parametr sDstHtm jest ustawiony na "return:"
"" - pusty łańcuch ("") oznacza awarię metody (tylko jeżeli parametr sDstHtm jest ustawiony na "return:")
Patrz również:
Przykład1:
Wytworzy graficzną stronę HTML do wydruku w pamięci. W tym przypadku jest jako pusty szablon (źródłowy plik HTML) zastosowana strona HTML dostarczana z systemem PROMOTIC. Wytworzona strona HTML następnie zostanie wydrukowana na domyślnej drukarce SO Windows z określeniem wielkości strony.
 
JavaScriptVBScriptWybierz oraz skopiuj do schowka

var oTView = pMe.Acx;
var sHtml = oTView.SaveToHtm("ver:1", "return;", "mode:graph;");
if (sHtml != "")
  Pm.PrintHtmlPage(sHtml, "sourcetype:textstring;printer:default;width:700px;height:930px;");
Przykład2:
Wytworzy graficzną stronę HTML do wydruku. W tym przypadku jest jako pusty szablon (źródłowy plik HTML) zastosowana strona HTML dostarczana z systemem PROMOTIC. Wytworzona strona HTML następnie zostanie wyświetlona w przeglądarce i jest gotowa na przykład do wydruku.
VBScriptWybierz oraz skopiuj do schowka

oTView.SaveToHtm "ver:1", "file:trendprint.htm", "mode:graph;"
Pm.ShellExecute "open", "#app:trendprint.htm", "", "#app:", 1
Przykład3:
Wyświetlenie strony HTML w oknie:
VBScriptWybierz oraz skopiuj do schowka

oTView.SaveToHtm "ver:1", "file:trendprint.htm", "mode:graph;view:dlg;"
Przykład4:
Wytworzy graficzną stronę HTML do wydruku. W tym przypadku jest jako szablon HTML zastosowana kopie trendsrc.htm (umieszczona w katalogu aplikacji) strony HTML dostarczanje z systemem PROMOTIC. Wytworzona strona HTML następnie zostanie wyświetlona w przeglądarce i jest gotowa na przykład do wydruku.
VBScriptWybierz oraz skopiuj do schowka

oTView.SaveToHtm "file:trendsrc.htm", "file:trendprint.htm", "mode:graph;view:dlg;"
Przykład5:
Wytworzy graficzną stronę HTML do wyrduku. W tym przypadku jest jako szablon HTML zastosowana strona HTML dostarczana z systemem PROMOTIC. Słowa kluczowe title, note1 i note2 w szablonie HTML są kolejno zastąpione łańcuchami "Osiedle Wysockiego", "Stacja 12" i "Stronę wytworzył Jan Kowalski". Wytworzona strona HTML następnie zostanie wyświetlona w przeglądarce i jest gotowa na przykład do wydruku.
VBScriptWybierz oraz skopiuj do schowka

oTView.SaveToHtm "ver:1", "file:trendprint.htm", "mode:graph;view:dlg;text_title:Osiedle Wysockiego;text_note1:Stacja 12;text_note2:Stronę wytworzył Jan Kowalski;"
Przykład6:
Wytworzy graficzną stronę HTML do wydruku. W tym przypadku jest jako szablon HTML wykorzystana strona HTML dostarczana z systemem PROMOTIC. Słowo kluczowe codeinit z szablonu HTML jest zastąpione łańcuchem "oTView.TrendArea.Dx=540", który spowoduje zmianę wielkości obszaru elementu przy wczytaniu strony. Wytworzona strona HTML następnie zostanie wyświetlona w przeglądarce i jest gotowa na przykład do wydruku.
VBScriptWybierz oraz skopiuj do schowka

Dim sParCode
sParCode = "oTView.TrendArea.Dx = 540;"
oTView.SaveToHtm "ver:1", "file:trendprint.htm", "mode:graph;view:dlg;text_codeinit:$Par:0;", sParCode
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice