Za pomocą opisywanej wtyczki oraz komponentów operujących na źródłach danych można odczytywać jak i przekazywać dane z systemu PlusWorkflow do dowolnej bazy danych skonfigurowanej poprzez opisywane poniżej połączenie.

 

Instrukcja tworzenia źródeł danych w systemie - http://192.168.1.52:8081/confluence/pages/viewpage.action?pageId=13272439

 

Opisywane źródła danych mogą działać zarówno na systemach baz danych oficjalnie wspieranych przez PlusWorkflow (PostgreSQL, MSSQL, Oracle) jak i tych niewspieranych (np. MySQL). W przypadku niewspieranych przez PlusWorkflow baz danych konieczne jest umieszczenie na serwerze odpowiedniego sterownika JDBC w postaci pliku .jar.

Opis konfiguracji połączenia z bazą danych

Aby utworzyć nowe połączenie z bazą należy wybrać przycisk "Utwórz połączenie" na formularzu dodawania nowego źródła danych.

Po kliknięciu powyższego przycisku ukaże się okno konfiguracji połączenia:

Nazwa parametruOpis parametru
IdUnikalne id połączenia
NazwaNazwa połączenia, wyświetlana w systemie
OpisOpis połączenia, wyświetlany w systemie
Nazwa klasy sterownikaNazwa klasy sterownika JDBC wg. konwencji Java - {package.name}.{ClassName}
Przykład: PostgreSQL: org.postgresql.Driver  | MS SQL: com.microsoft.sqlserver.jdbc.SQLServerDriver  | Oracle: oracle.jdbc.driver.OracleDriver
W przypadku podania nazwy klasy sterownika nieistniejącego w systemie PlusWorkflow na formularzu zostanie wyświetlony przycisk "Wgraj sterownik", za pomocą którego możliwe jest dodanie do systemu nowego sterownika (np. obsługującego bazę MySQL).
Adres połączenia

Connection string, zawierający adres oraz nazwę bazy danych

Przykład: PostgreSQL: jdbc:postgresql://127.0.0.1:5432/test | MS SQL:  jdbc:sqlserver://{adresSerwera};databaseName={NazwaBazy}

Nazwa użytkownikaNazwa użytkownika bazy danych
HasłoHasło użytkownika bazy danych
Sposób generowania kluczy

Możliwe wartości:

  • Brak
  • Z automatycznym generowaniem kluczy
  • Bez automatycznego generowania kluczy

"Bez automatycznego generowania kluczy" należy wybrać, gdy baza nie obsługuje automatycznego generowania kluczy np. Progress (nie mylić z Postgress).

Po uzupełnieniu parametrów połączenia można przetestować poprawność konfiguracji poprzez kliknięcie "Testuj". Jeśli system potwierdzi nawiązanie połączenia można zapisać daną konfigurację poprzez kliknięcie przycisku "Utwórz połączenie". Raz utworzone połączenie dodane zostanie do listy szablonów

 

Od wersji 1.0.8 wtyczka automatycznie dodaje do listy połączeń konfiguracje udostępnione systemowi poprzez inne wtyczki, np. DB Explorer. Połączenie takie zawiera odpowiednią adnotację (nazwa lub id wtyczki, z której pochodzi dane połączenie).

Od wersji 1.0.12 logowane są wyniki zapytania do bazy danych. Logowanie odbywa się na poziomie INFO. Aby logi były widoczne w pliku logów należy w konfiguracji systemu ustawić odpowiedni poziom dla klasy komponentu:

com.suncode.plugin.datasource.jdbc.component.JdbcDataSource

Aby dany logger pojawił się na liście należy przynajmniej raz wywołać źródło danych.

 

Przykład konfiguracji

1.0.13

  • Ukrycie parametru: "Wywołaj bez automatycznego generowania kluczy"
  • Dodanie nowego parametru: "Sposób generowania kluczy"