AMODIT Cloud Agent

Ostatnia modyfikacja Grudzień 07, 2017

Użytkownicy Platformy AMODIT w chmurze (app.amodit.com, cloud2.amodit.com) nie mają możliwości skonfigurowania tzw. słowników zewnętrznych, gdyż źródła danych dla tych słowników znajdują się w ich lokalnych zasobach, czyli z punktu widzenia Platformy AMODIT, za firewallem.

AMODIT Cloud Agent jest rozwiązaniem eliminującym to ograniczenia. Umożliwia on skonfigurowanie na Platformie AMODIT słowników zewnętrznych i wskazanie jako źródło danych, źródła znajdującego się lokalnie w siedzibie użytkownika.

Podstawowym zadaniem AMODIT Cloud Agent’a jest:

  1. Konfiguracja zewnętrznego źródła danych i podłączenie jako słownika zewnętrznego na Platformie AMODIT
  2. Okresowe aktualizowanie danych w słownikach Platformy AMODIT na podstawie danych dostępnych w lokalnych zasobach użytkownika.

AMODIT Cloud Agent składa się z:

  1. usługi Windows, która okresowo komunikuje się z Web Service Platformy AMODIT
  2. oraz programu GUI (interfejsu użytkownika) do konfiguracji tej usługi.

Agent, o ustalonych osobno dla każdego słownika, interwałach czasowych dokonuje aktualizacji pozycji słownikowych z lokalnego źródła danych do Platformy AMODIT.

Instalacja

AMODIT Cloud Agent musi być zainstalowany na serwerze lub komputerze, który będzie pozostawał włączony i będzie miał dostęp (poprzez ODBC) do lokalnego źródła, z którego mają być synchronizowane dane.

AMODIT Cloud Agent dostępny jest w dwóch wersjach 32-bit i 64-bit.

Wersja 32-bit umożliwia podłączanie źródeł danych opartych o 32-bit’owe sterowniki ODBC czyli np. można użyć jako źródło danych plików MS Excel czy bazy MS Access.

Należy pobrać odpowiednią wersję instalacyjną. Rozpakować pliki i uruchomić setup.exe i postępować zgodnie z poleceniami na ekranie.

Instalator zainstaluje i uruchomi usługę Windows oraz zainstaluje program konfiguracyjny o nazwie AMODIT Cloud Agent.

Konfiguracja słownika

Na konfigurację połączenia słownika w AMODIT z zewnętrznym źródłem danych składają się trzy elementy, które należy skonfigurować w podanej poniżej kolejności:

  1. Utworzenie i konfiguracja połączenia ODBC dla źródła danych
  2. Konfiguracja słownika na Platformie AMODIT
  3. Konfiguracja AMODIT Cloud Agent

Utworzenie połączenia ODBC dla źródła danych

W celu wskazania źródła danych należy skonfigurować połączenie ODBC dla tego źródła danych. Czynności te wykonuje się za pomocą dostępnej w MS Windows funkcji „Administrator źródeł danych ODBC”. Po uruchomieniu tej funkcji należy przejść do zakładki „Systemowe DSN” i dodać źródło danych podając jego nazwę (np. Amod_Dict) oraz w zależności od typu źródła danych (MS SQL, SQL Lite, Excel itp.) odpowiednio skonfigurować połączenie z wybranym źródłem danych. Nazwa źródła danych ODBC jest ważna i będzie wykorzystana do konfiguracji słownika na Platformie AMODIT ( w tym przykładzie będzie to DSN=Amod_Dict ). Nazwa źródła danych nie może zawierać spacji.

 

Konfiguracja słownika zewnętrznego na Platformie AMODIT.

Mając skonfigurowane ODBC dla Twojego źródła danych możesz skonfigurować na Platformie AMODOT słownik, który będzie korzystał z tego źródła danych.

  1. Zaloguj się kontem z uprawnieniami administracyjnymi do Swojej Platformy AMODIT.
  2. Przejdź do zakładki Słowniki
  3. Kliknij „Dodaj słownik zewnętrzny”

  • W polu Tytuł wpisz nazwę słownika, który chcesz mieć dostępny w AMODIT np. Lista klientów, Projekty, Konat MPK itd. w zależności od tego co słownik będzie zawierał.
  • Zaznacz opcję „Połączenie przez agenta”
  • W polu Connection string wpisz DSN=Nazwa_Połaczenia_ODBC. W naszym przykładzie byłoby to np. DSN=Amod_Dict Nie stosujemy cudzysłowów, nazwa źródła nie może zawierać spacji ( Zobacz rozdział o konfigurowaniu połączenia ODBC do lokalnego źródła danych).
  • W polu zapytanie SQL:
    • Jeżeli naszym źródłem danych jest tabela (w rozumieniu SQL) to wybieramy „Nazwa tabeli”. Ta opcja pobiera wszystkie dane z źródła danych. Przykładowo, jeżeli w naszym zewnętrznym źródle danych mamy tabelę o nazwie Kontrahenci, to taką nazwę wpisujemy w tym polu.
    • Jeżeli naszym źródłem jest wynik zapytania SQL, to wybieramy „Zapytanie SQL”. Ta opcja pozwala na określenie, które dane chcemy pobrać ze źródła danych. Przykładowo, jeżeli chcemy wykonać działania na danych pobieranych ze źródła danych, to wpisujemy zapytanie w postaci np. takiej SELECT NAZWA, OPIS FROM KONTRAHENCI. To spowoduje, że pobrane zostaną tylko dane NAZWA i OPIS.
  • W polu „Nazwa agenta” wpisz dowolną nazwę identyfikującą instancję AMODIT Cloud Agent’a. Przykładowo „ERP”. Nazwę tę wpiszesz później w konfiguracji agenta.
  • W polu ‘Częstotliwość wykonywania działań przez agenta” wpisz liczbę minut, które określą co jaki czas agent ma synchronizować dane dla tego słownika.
  • Mapowanie pól
    • W polu ID wpisz nazwę pola (kolumny) ze swojego źródła danych, które jednoznacznie (unikalnie) identyfikuje rekordy
    • W polu Nazwa wpisz nazwę pola (kolumny) ze swojego źródła danych, które będzie umieszczone w polu „Tytuł” słownika.
    • W polu Opis wpisz nazwę pola (kolumny) ze swojego źródła danych, które będzie umieszczone w polu „Opis” słownika.
    • W polu „Sortuj po”wpisz nazwę pola (kolumny) ze swojego źródła danych, po którym dane w słowniku będą sortowane. Zaleca się podanie tego samego pola co w polu Nazwa.
    • Pole data modyfikacji możesz pozostawić puste.
  • Kliknij Dodaj.

Konfiguracja AMODIT Cloud Agent’a

Mając skonfigurowane źródło danych oraz słownik po stronie Platformy AMODIT możesz teraz skonfigurować agenta i uruchomić synchronizację.

Uruchom AMODIT Cloud Agent’a.

Konfigurację należy przeprowadzić w następującej kolejności:

  1. W polu AMODIT URL wpisz nazwę Twojej instancji Platformy AMODIT.
  2. W polu user wpisz login użytkownika AMODIT z uprawnieniami administracyjnymi
  3. W polu Password podaj hasło tego użytkownika.
  4. W polu „Agent Name’ wpisz nazwę agenta, utworzoną w czasie konfigurowania słownika w AMODIT.
  5. Kliknij Test AMODIT Connection.
  6. Jeżeli wszystko jest OK, to kliknij „Download dictionaries configuration”. Spowoduje to odczytanie z Twojej instancji Platformy AMODIT słowników., które mają ustawioną opcję „Połączenie przez agenta”. Nazwy tych słowników pojawią się lewym dolnym oknie.
  7. Klikając na nazwę słownika, w prawej części widoczne będą ustawienia wybranego słownika.
  8. Kliknij Test SQL. Jeżeli wszystko jest OK, oznacza to że Agent jest gotowy do działania.
  9. Jeżeli natychmiastowo chcesz synchronizować słowniki kliknij „Synchronise dictionaries”

Dla sprawdzenia przejdź do Platformy AMODIT i zobacz, czy pojawiły się dane w słowniku.