Zmiany pomiędzy wersją 15 and wersją 16 dla DeployerGuide/Customization/Forte/ForteOnTimer

Data i czas:

11/15/12 12:25:29 (12 years temu)

Autor:

jachtelik (IP: 213.227.67.33)

Komentarz:

--

DeployerGuide/Customization/Forte/ForteOnTimer

@@ -8 +8 @@
   * [#tworzenie_skryptu Tworzenie skryptu VBA realizującego zadania importu][[BR]]
   * [#sbc Umieszczanie skryptu VBA w dokumentach typu SBC][[BR]]
-  * [#przygotowanie_procedury Przygotowanie procedury "Generowanie zamówienia obcego z eDokumentów"]
+  * [#przygotowanie_procedury Przygotowanie procedury "Generowanie zamówienia obcego z eDokumentów"][[BR]]
+  * [#ontimer_on Konfiguracja procedury OnTimer()]
 
 Niniejszy artykuł jest częścią opisu dostępnego pod adresem [DeployerGuide/Customization/Forte Integracja z Forte]
@@ -14 +15 @@
 == Wprowadzenie == #wprowadzenie
 
-Dla celów integracji z systemem można wykorzystać mechanizm procedur dostępny w systemie Forte (HM). Procedura jest to pewnego rodzaju raport, który napisany jest w języku stworzony przez Sage Symfonię: ''!AmBasic''. 
-Jedną z takich procedur jest raport '''!OnTimer()''', który może być uruchamiany w określonych interwałach czasu.
+System Forte HM oferuje wiele możliwości wykonania procedur, które można wykorzystać w procesie integracji. Są to:
+ * język raportów '''!AmBasic''' - język skryptowy własny dostępny w Handlu Forte, który umieszczamy bezpośrednio w raporcie, jest kombinacją języka VB oraz C, nie posiada dobrej dokumentacji (ta co jest, to załączam do niniejszej instrukcji).
+ * język '''VBA''', czyli Visual Basic For Applications - produkt wykorzystywany przez Microsoft m.in. w produktach pakietu Office. Jest dość okrojona wersja Visual Basic-a, ale do tych potrzeb jest po prostu wystarczająca.
 
 ''Przejdź do [#ontimer Menu ]
@@ -241 +243 @@
 
 
-Dispatch App, Doc
-
-App = GetApplication()
+Dispatch App, Doc // deklarowanie obiektów
+
+App = GetApplication() //ustawienie stanu obiektu
+// wywołanie uruchomienia dokumentu SBC
 Doc = App.Documents.OpenDocument("C:\\Users\\ztestowy\\documents\\Sage\\EdokGenZO.sbc")
 
 }}}
 
-=== Włączanie działania !OnTimer() === #ontimer_on
+Po zapisaniu takiego raportu (możemy dla testów wykonać) należy skonfigurować procedurę OnTimer.
+
+''Przejdź do [#ontimer Menu ]''
+
+
+=== Konfiguracja procedury !OnTimer() === #ontimer_on
+
+Procedura !OnTimer() jest specyficznego rodzaju raportem, który systemowo posiada możliwość jego wywołania w zadanym interwale czasu. Domyślną wartością jest 5 sek, lecz może ona być dostosowana w plikach konfiguracyjnych.
+
+Konfiguracja !OnTimer()
 
  * Mając odpowiednie uprawnienia administratora w systemie Forte HM Z lewego panelu wybieramy menu Ustawienia. 
@@ -255 +267 @@
  * Po zaznaczeniu !OnTimer wybieramy edytuj i wybieramy TAK, a następnie zapisujemy.
 
-=== Informacje o możliwościach wykorzystania procedury !OnTimer() === #wykorzystanie_ontimer
 Mając już włączony mechanizm wykonywania raportu !OnTimer musimy wykonać raport.
 Raport jest opcjonalny, gdyż wszystkie niezbędne instrukcje można oczywiście ująć w !OnTimerze.
-
-HMF ofertuje wiele możliwości wykonania procedur. Są to:
- * język raportów '''!AmBasic''' - język skryptowy własny dostępny w Handlu Forte, który umieszczamy bezpośrednio w raporcie, jest kombinacją języka VB oraz C, nie posiada dobrej dokumentacji (ta co jest, to załączam do niniejszej instrukcji).
- * język '''VBA''', czyli Visual Basic For Applications - produkt wykorzystywany przez Microsoft m.in. w produktach pakietu Office. Jest dość okrojona wersja Visual Basic-a, ale do tych potrzeb jest po prostu rewelacyjna.
-
-Na potrzeby integracji sugeruje się wykorzystać język VBA. Import danych do Forte HM (na przykładzie generowania dokumentu '''Zamówienia Obcego''' przedstawiam poniżej.
- 
- 4. Aby wywołać powyższy skrypt dodajemy w tym samym module metodę:
+Aby skonfigurowana procedura !OnTimer() wykonała dla nas konkretną czynnność należy zmienić jej kod. W tym celu odszukujemy w drzewku ''Raporty > Procecdury '' raport ''Procedura !OnTimer''. Edytując ją wprowadzamy kod:
+{{{
+#text/x-vba
+int sub OnOpen()
+
+        OnOpen = 0
+endsub
+
+int sub OnTimer()
+
+        If xFactory.user == "b2b" then // użytkownik, który stale ma uruchomioną instancję Forte HM.
+
+        //Wywołanie raportu generującego dokumenty zamówień obcych z eDokumentów
+        Run ("Generowanie zamówienia obcego z eDokumentów") 
+        //      Message "OnTimer()"
+        EndIf
+
+        OnTimer = 0
+
+endsub
+
+int sub OnClose()
+
+        OnClose = 0
+endsub
+
+}}}
+
+'''Uwaga!'''
+Jak już wspomniano powyżej aby OnTimer zadziałał, musi być uruchomiona instancja Forte HM na wybranym użytkowniku.
+Użytkownik b2b jest systemowym użytkownikiem b2b, który jest przeznaczony do tych zadań.