Konfiguracja

Tabele historii używane przez moduł muszą mieć postać:

Wymagane jest także utworzenie sekwencji o nazwie takiej jak nazwa tabeli z dołączonym suffiksem "_s", np. dla tabeli "extra_history" powinna zostać utworzona sekwencja "extra_history_s".

Przykładowy skrypt tworzący tabelę "extra_history" i odpowiadającą jej sekwencję dla Oracle:

create table extra_history (
  id number(38) not null constraints his_pk primary key,
  resource_name varchar2(40) not null,
  field_name varchar2(40) not null,
  row_id number(38) not null,
  old_value varchar2(4000),
  new_value varchar2(4000),
  token number(2),
  extra_id number(38),
  creation_timestamp date not null,
  creation_user_id number(6) not null
);
create sequence extra_history_s start with 1;

Znaczenie pól w tabeli historii:

• resource_name - nazwa tabeli, w której zaszła zmiana,
• field_name - nazwa kolumny, w której zaszła zmiana,
• row_id - wartość numerycznego klucza głównego wiersza, który został zmieniony,
• old_value - poprzednia wartość zmienionego pola,
• new_value - nowa wartość zmienionego pola,
• token - = pole ułatwiające szybkie wybieranie pierwszego i ostatniego wpisu dotyczącego zmiany treści kolumny w określonym wierszu danej tabeli na pewną wartość. Wartość -2 oznacza, że jest jeden taki wpis w tabeli historii. Gdy są dwa takie same wpisy, to token=-1 dla pierwszego wpisu (wg. daty utworzenia), token=2 dla ostatniego. Gdy jest więcej wpisów, to dla wpisów pomiędzy pierwszym a ostatnim token=0. Można łatwo wybrać pierwszy lub ostatni wpis: pierwszy wpis: token mniejszy od 0, ostatni: abs(token)=2, pierwszy i/lub ostatni token<>0. Przy porównywaniu wierszy brane są pod uwagę pola resource_name, field_name, row_id, newValue oraz extraId.
• extra_id - dodatkowe id służące do rejestracji zmian w tabelach będących złączeniem, szczegółowy opis w rozdziale Historia dla tabel złączeniowych,
• creation_timestamp - data utworzenia wpisu w historii,
• creation_user_id - id użytkownika dokonującego zmiany.