palio.modules
Class History

java.lang.Object
  extended by palio.modules.core.Module
      extended by palio.modules.History
All Implemented Interfaces:
palio.modules.core.CurrentModuleDataKeys

public class History
extends palio.modules.core.Module

Moduł służący do rejestracji zmian w dowolnych tabelach portalu. Można rejestrować tylko zmiany w tabelach posiadających numeryczny klucz główny w polu o nazwie ID. Ooperacje domyślnie wykonywane są na connectorze data.

Wymaga obecności tabeli dla wywołań domyślnych P_HISTORY:
create table p_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
);

oraz sekwencji p_history_s (lub xxx_s, gdzie xxx to nazwa innej niż domyślna tabeli historii).

Moduł buforuje odczyty wartości parametrów (ale tylko wartości, wartości domyślnych i opisów już nie).

Znaczenie pól tabeli:

  • resource_name - nazwa tabeli, w której zaszła zmiana,
  • field_name - nazwa kolumny, w której zaszła zmiana,
  • row_id number(38) - wartość numerycznego klucza głównego wiersza, który został zmieniony,
  • old_value - poprzednia wartość zmienionego pola,
  • new_value - nowa wartość zmienionego pola,
  • token - =-2 gdy jest jeden wpis w historii, gdy są dwa takie same: token=-1 dla pierwszego (wg. daty utworzenia), 2 dla ostatniego, gdy więcej: dla wierszy pomiędzy pierwszym a ostatnim token=0. Można łatwo wybrać pierwszy lub ostatni wiersz: pierwszy wpis: token mniejszy od 0, ostatni: abs(token)=2, pierwszy i/lub ostatni token<>0. Przy porównywaniu wierszy brane są pod uwagę wszystkie pola prócz old_value i user_id.
  • extra_id - dodatkowe id służące do rejestracji zmian w tabelach będących złączeniem - wtedy rejestruje się zmianę w jednej z tabel wchodzącej w skład złącznia (A), z nazwą kolumny nie istniejącą w tej tabeli, a oznaczającą historię dla tabeli złączenia, row id = klucz główny tabeli A i extra_id = klucz główny z drugiej tabeli wchodzącej w skład złączenia,
  • creation_timestamp - data utworzenia wpisu w historii,
  • creation_user_id - id użytkownika dokonującego zmiany.
  • Moduł jest dostępny w każdej instancji jPalio.

    Version:
    1.3.0
    Author:
    Krzysztof Madyniak, Arkadiusz Chrustowski

    Field Summary
     
    Fields inherited from interface palio.modules.core.CurrentModuleDataKeys
    DESIGNER_ACTIONS_BUFFER, HTML_FORM_BUILDER, HTML_MAP_BUILDER, HTML_MENU_BUILDER, HTML_TOOLTIPS_BUFFER, ITEXT_DOCUMENT, MAIL_MESSAGE, XLS_DOCUMENT, XML_DOCUMENT
     
    Constructor Summary
    History(palio.Instance instance, java.util.Properties parameters)
              Konstruktor.
     
    Method Summary
     java.lang.Boolean equals(java.lang.Object oldValue, java.lang.Object newValue)
              Deprecated.  
     java.lang.String getVersion()
              Zwraca numer wersji modułu.
     void modify(java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue)
              Modyfikuje pole fieldName w tabeli resourceName w wierszu rowId (zał. że tabela ma kolumnę id będącą kluczem głównym) na wartość newValue.
     void modifyAndTrim(java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue)
              Analogiczne do modify, z tym, że z nowej wartości są usuwane zewnętrzne białe znaki, a wielokrotne białe znaki są zamieniane na pojedynczą spację.
     void modifyAndTrimH(java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue)
              Analogiczne do modifyH, z tym, że z nowej wartości są usuwane zewnętrzne białe znaki, a wielokrotne białe znaki są zamieniane na pojedynczą spację.
     void modifyAndTrimH(java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue, java.lang.Long userId)
              Analogiczne do modifyH, z tym, że z nowej wartości są usuwane zewnętrzne białe znaki, a wielokrotne białe znaki są zamieniane na pojedynczą spację.
     void modifyAndTrimH(java.lang.String historyTableName, java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue)
              Analogiczne do modifyH, z tym, że z nowej wartości są usuwane zewnętrzne białe znaki, a wielokrotne białe znaki są zamieniane na pojedynczą spację.
     void modifyAndTrimH(java.lang.String historyTableName, java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue, java.lang.Long userId)
              Analogiczne do modifyH, z tym, że z nowej wartości są usuwane zewnętrzne białe znaki, a wielokrotne białe znaki są zamieniane na pojedynczą spację.
     void modifyDate(java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue, java.lang.String dateFormat)
              Modyfikuje pole fieldName typu date w tabeli resourceName w wierszu rowId (zał. że tabela ma kolumnę id będącą kluczem głównym) na wartość newValue.
     void modifyDateH(java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue, java.lang.String dateFormat)
              Modyfikuje pole fieldName w tabeli resourceName w wierszu rowId (zał. że tabela ma kolumnę id będącą kluczem głównym) na wartość newValue.
     void modifyDateH(java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue, java.lang.String dateFormat, java.lang.Long userId)
              Modyfikuje pole fieldName typu date w tabeli resourceName w wierszu rowId (zał. że tabela ma kolumnę id będącą kluczem głównym) na wartość newValue.
     void modifyDateH(java.lang.String historyTableName, java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue, java.lang.String dateFormat)
              Modyfikuje pole fieldName w tabeli resourceName w wierszu rowId (zał. że tabela ma kolumnę id będącą kluczem głównym) na wartość newValue.
     void modifyDateH(java.lang.String historyTableName, java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue, java.lang.String dateFormat, java.lang.Long userId)
              Modyfikuje pole fieldName typu date w tabeli resourceName w wierszu rowId (zał. że tabela ma kolumnę id będącą kluczem głównym) na wartość newValue.
     void modifyH(java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue)
              Modyfikuje pole fieldName w tabeli resourceName w wierszu rowId (zał. że tabela ma kolumnę id będącą kluczem głównym) na wartość newValue.
     void modifyH(java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue, java.lang.Long userId)
              Modyfikuje pole fieldName w tabeli resourceName w wierszu rowId (zał. że tabela ma kolumnę id będącą kluczem głównym) na wartość newValue.
     void modifyH(java.lang.String historyTableName, java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue)
              Modyfikuje pole fieldName w tabeli resourceName w wierszu rowId (zał. że tabela ma kolumnę id będącą kluczem głównym) na wartość newValue.
     void modifyH(java.lang.String historyTableName, java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue, java.lang.Long userId)
              Modyfikuje pole fieldName w tabeli resourceName w wierszu rowId (zał. że tabela ma kolumnę id będącą kluczem głównym) na wartość newValue.
     java.lang.Long recordChange(java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue)
              Działa analogicznie jak recordChange, tylko z extraId=null i saveAlways=null, zapisuje id bieżącego użytkownika.
     java.lang.Long recordChange(java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue, java.lang.Long userId)
              Działa analogicznie jak recordChange, tylko z extraId=null i saveAlways=null, zapisuje id użytkownika userId.
     java.lang.Long recordChange(java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String oldValue, java.lang.String newValue)
              Działa analogicznie jak recordChange, tylko z extraId=null i saveAlways=null, zapisuje id bieżącego użytkownika.
     java.lang.Long recordChange(java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String oldValue, java.lang.String newValue, java.lang.Long userId)
              Działa analogicznie jak recordChange, tylko z extraId=null i saveAlways=null.
     java.lang.Long recordChange(java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String oldValue, java.lang.String newValue, java.lang.Long userId, java.lang.Long extraId)
              Działa analogicznie jak recordChange,tylko z saveAlways=null.
     java.lang.Long recordChange(java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String oldValue, java.lang.String newValue, java.lang.Long userId, java.lang.Long extraId, java.lang.String saveAlways)
              Działa analogicznie jak recordChange.
     java.lang.Long recordChange(java.lang.String historyTableName, java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue)
              Działa analogicznie jak recordChange, tylko z extraId=null i saveAlways=null, zapisuje id bieżącgo użytkownika.
     java.lang.Long recordChange(java.lang.String historyTableName, java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue, java.lang.Long userId)
              Działa analogicznie jak recordChange, tylko z extraId=null i saveAlways=null, zapisuje id użytkownika userId.
     java.lang.Long recordChange(java.lang.String historyTableName, java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String oldValue, java.lang.String newValue)
              Działa analogicznie jak recordChange, tylko z extraId=null i saveAlways=null, zapisuje id bieżącego użytkownika.
     java.lang.Long recordChange(java.lang.String historyTableName, java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String oldValue, java.lang.String newValue, java.lang.Long userId)
              Działa analogicznie jak recordChange, tylko z extraId=null i saveAlways=null.
     java.lang.Long recordChange(java.lang.String historyTableName, java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String oldValue, java.lang.String newValue, java.lang.Long userId, java.lang.Long extraId)
              Działa analogicznie jak recordChange,tylko z saveAlways=null.
     java.lang.Long recordChange(java.lang.String historyTableName, java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String oldValue, java.lang.String newValue, java.lang.Long userId, java.lang.Long extraId, java.lang.String saveAlways)
              Działa analogicznie jak recordChange,tylko że z connectorName = null
     java.lang.Long recordChange(java.lang.String connectorName, java.lang.String historyTableName, java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String oldValue, java.lang.String newValue, java.lang.Long userId, java.lang.Long extraId, java.lang.String saveAlways)
              Porównuje podane wartości i rejestruje ew. zmiany w tabeli historii historyTableName jako zmiany wartości w tabeli resourceName, w polu fieldName i wierszu rowId z wartości oldValue na newValue dokonanej przez usera userId, extraId może zostać podane dla zapamiętania zmian w tabeli realizującej złączenie wiele do wielu dla dwóch tabel, jeśli saveAlways not null, to rejestruje zmiany nawet jeśli wartość poprzednia i bieżąca jest taka sama.
     void recordChanged(java.lang.String historyTableName, java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowID, java.lang.Object oldValue, java.lang.Object newValue, java.lang.Long userID, java.lang.Long extraID)
              Deprecated.  
     java.lang.Long recordDateChange(java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue, java.lang.String dateFormat)
              Działa analogicznie jak recordDateChange tylko zapisuje id użytkownika bieżącego.
     java.lang.Long recordDateChange(java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue, java.lang.String dateFormat, java.lang.Long userId)
              Działa analogicznie jak recordDateChange.
     java.lang.Long recordDateChange(java.lang.String historyTableName, java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue, java.lang.String dateFormat)
              Działa analogicznie jak recordDateChange tylko zapisuje id użytkownika bieżącego.
     java.lang.Long recordDateChange(java.lang.String historyTableName, java.lang.String resourceName, java.lang.String fieldName, java.lang.Long rowId, java.lang.String newValue, java.lang.String dateFormat, java.lang.Long userId)
              Działa analogicznie jak recordChange tylko dla pól typu date.
     
    Methods inherited from class palio.modules.core.Module
    getConfigParam, getDescription, getModuleTranslation
     
    Methods inherited from class java.lang.Object
    equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
     

    Constructor Detail

    History

    public History(palio.Instance instance,
                   java.util.Properties parameters)
    Konstruktor.

    Parameters:
    instance - instancja jPalio, w ramach której ma zostać utworzony obiekt modułu.
    Method Detail

    getVersion

    public java.lang.String getVersion()
    Zwraca numer wersji modułu.

    Specified by:
    getVersion in class palio.modules.core.Module
    Returns:
    numer wersji modułu

    recordChanged

    @Deprecated
    public void recordChanged(java.lang.String historyTableName,
                                         java.lang.String resourceName,
                                         java.lang.String fieldName,
                                         java.lang.Long rowID,
                                         java.lang.Object oldValue,
                                         java.lang.Object newValue,
                                         java.lang.Long userID,
                                         java.lang.Long extraID)
                       throws palio.PalioException
    Deprecated. 

    zasady tokenów: gdy jedna wartość: -2, gdy dwie: -1 pierwsza, 2 ostatnia, gdy więcej: środkowe 0 zasady wyboru: pierwszy wpis: token mniejszy od 0, ostatni: abs(token)=2

    Parameters:
    historyTableName - nazwa tabeli z historią
    resourceName - nazwa tabeli, w której nastąpiły zmiany
    fieldName - nazwa kolumny, w której nastąpiły zmiany
    rowID - id wiersza, w którym nastąpiły zmiany
    oldValue - poprzednia wartość
    newValue - nowa wartość
    userID - id usera dokonującego zmiany
    extraID - dodatkowe id
    Throws:
    palio.PalioException

    equals

    @Deprecated
    public java.lang.Boolean equals(java.lang.Object oldValue,
                                               java.lang.Object newValue)
    Deprecated. 

    Porównuje dwie wartości, zwraca true gdy równe.

    Parameters:
    oldValue - stara wartość
    newValue - nowa wartość
    Returns:
    true gdy równe

    recordChange

    public java.lang.Long recordChange(java.lang.String connectorName,
                                       java.lang.String historyTableName,
                                       java.lang.String resourceName,
                                       java.lang.String fieldName,
                                       java.lang.Long rowId,
                                       java.lang.String oldValue,
                                       java.lang.String newValue,
                                       java.lang.Long userId,
                                       java.lang.Long extraId,
                                       java.lang.String saveAlways)
                                throws palio.PalioException
    Porównuje podane wartości i rejestruje ew. zmiany w tabeli historii historyTableName jako zmiany wartości w tabeli resourceName, w polu fieldName i wierszu rowId z wartości oldValue na newValue dokonanej przez usera userId, extraId może zostać podane dla zapamiętania zmian w tabeli realizującej złączenie wiele do wielu dla dwóch tabel, jeśli saveAlways not null, to rejestruje zmiany nawet jeśli wartość poprzednia i bieżąca jest taka sama. Musi istnieć sekwencja historyTableName_s Zwraca id zarejestrowanej zmiany.

    Parameters:
    connectorName - nazwa connectora do bazy danych
    historyTableName - nazwa tabeli historii, w której będzie rejestrowana zmiana
    resourceName - nazwa tabeli, w której nastąpi(ła) zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi(ła) zmiana
    rowId - id wiersza w tabeli, w której nastąpi(ła) zmiana
    oldValue - poprzednia wartość zmienianego pola
    newValue - nowa wartość zmienianego pola
    userId - id użytkownika dokonującego zmiany
    extraId - dodatkowe id związane zmienianym polem (przy rejestracji zmian w tabeli złączeń)
    saveAlways - gdy not null to zmiana zapisywana zawsze, nawet gdy wartość stara i nowa nie różnią się
    Returns:
    id dokonanego wpisu w tabeli historii
    Throws:
    palio.PalioException

    recordChange

    public java.lang.Long recordChange(java.lang.String historyTableName,
                                       java.lang.String resourceName,
                                       java.lang.String fieldName,
                                       java.lang.Long rowId,
                                       java.lang.String oldValue,
                                       java.lang.String newValue,
                                       java.lang.Long userId,
                                       java.lang.Long extraId,
                                       java.lang.String saveAlways)
                                throws palio.PalioException
    Działa analogicznie jak recordChange,tylko że z connectorName = null

    Parameters:
    historyTableName - nazwa tabeli historii, w której będzie rejestrowana zmiana
    resourceName - nazwa tabeli, w której nastąpi(ła) zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi(ła) zmiana
    rowId - id wiersza w tabeli, w której nastąpi(ła) zmiana
    oldValue - poprzednia wartość zmienianego pola
    newValue - nowa wartość zmienianego pola
    userId - id użytkownika dokonującego zmiany
    extraId - dodatkowe id związane zmienianym polem (przy rejestracji zmian w tabeli złączeń)
    saveAlways - gdy not null to zmiana zapisywana zawsze, nawet gdy wartość stara i nowa nie różnią się
    Returns:
    id dokonanego wpisu w tabeli historii
    Throws:
    palio.PalioException

    recordChange

    public java.lang.Long recordChange(java.lang.String historyTableName,
                                       java.lang.String resourceName,
                                       java.lang.String fieldName,
                                       java.lang.Long rowId,
                                       java.lang.String oldValue,
                                       java.lang.String newValue,
                                       java.lang.Long userId,
                                       java.lang.Long extraId)
                                throws palio.PalioException
    Działa analogicznie jak recordChange,tylko z saveAlways=null.

    Parameters:
    historyTableName - nazwa tabeli historii, w której będzie rejestrowana zmiana
    resourceName - nazwa tabeli, w której nastąpi(ła) zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi(ła) zmiana
    rowId - id wiersza w tabeli, w której nastąpi(ła) zmiana
    oldValue - poprzednia wartość zmienianego pola
    newValue - nowa wartość zmienianego pola
    userId - id użytkownika dokonującego zmiany
    extraId - dodatkowe id związane zmienianym polem (przy rejestracji zmian w tabeli złączeń)
    Returns:
    id dokonanego wpisu w tabeli historii
    Throws:
    palio.PalioException

    recordChange

    public java.lang.Long recordChange(java.lang.String historyTableName,
                                       java.lang.String resourceName,
                                       java.lang.String fieldName,
                                       java.lang.Long rowId,
                                       java.lang.String oldValue,
                                       java.lang.String newValue,
                                       java.lang.Long userId)
                                throws palio.PalioException
    Działa analogicznie jak recordChange, tylko z extraId=null i saveAlways=null.

    Parameters:
    historyTableName - nazwa tabeli historii, w której będzie rejestrowana zmiana
    resourceName - nazwa tabeli, w której nastąpi(ła) zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi(ła) zmiana
    rowId - id wiersza w tabeli, w której nastąpi(ła) zmiana
    oldValue - poprzednia wartość zmienianego pola
    newValue - nowa wartość zmienianego pola
    userId - id użytkownika dokonującego zmiany
    Returns:
    id dokonanego wpisu w tabeli historii
    Throws:
    palio.PalioException

    recordChange

    public java.lang.Long recordChange(java.lang.String historyTableName,
                                       java.lang.String resourceName,
                                       java.lang.String fieldName,
                                       java.lang.Long rowId,
                                       java.lang.String oldValue,
                                       java.lang.String newValue)
                                throws palio.PalioException
    Działa analogicznie jak recordChange, tylko z extraId=null i saveAlways=null, zapisuje id bieżącego użytkownika.

    Parameters:
    historyTableName - nazwa tabeli historii, w której będzie rejestrowana zmiana
    resourceName - nazwa tabeli, w której nastąpi(ła) zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi(ła) zmiana
    rowId - id wiersza w tabeli, w której nastąpi(ła) zmiana
    oldValue - poprzednia wartość zmienianego pola
    newValue - nowa wartość zmienianego pola
    Returns:
    id dokonanego wpisu w tabeli historii
    Throws:
    palio.PalioException

    recordChange

    public java.lang.Long recordChange(java.lang.String historyTableName,
                                       java.lang.String resourceName,
                                       java.lang.String fieldName,
                                       java.lang.Long rowId,
                                       java.lang.String newValue,
                                       java.lang.Long userId)
                                throws palio.PalioException
    Działa analogicznie jak recordChange, tylko z extraId=null i saveAlways=null, zapisuje id użytkownika userId. Old value jest odczytywane na podstawie resourceName, fieldName i rowId.

    Parameters:
    historyTableName - nazwa tabeli historii, w której będzie rejestrowana zmiana
    resourceName - nazwa tabeli, w której nastąpi(ła) zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi(ła) zmiana
    rowId - id wiersza w tabeli, w której nastąpi(ła) zmiana
    newValue - nowa wartość zmienianego pola
    userId - id użytkownika dokonującego zmiany
    Returns:
    id dokonanego wpisu w tabeli historii
    Throws:
    palio.PalioException

    recordChange

    public java.lang.Long recordChange(java.lang.String historyTableName,
                                       java.lang.String resourceName,
                                       java.lang.String fieldName,
                                       java.lang.Long rowId,
                                       java.lang.String newValue)
                                throws palio.PalioException
    Działa analogicznie jak recordChange, tylko z extraId=null i saveAlways=null, zapisuje id bieżącgo użytkownika. Old value jest odczytywane na podstawie resourceName, fieldName i rowId.

    Parameters:
    historyTableName - nazwa tabeli historii, w której będzie rejestrowana zmiana
    resourceName - nazwa tabeli, w której nastąpi(ła) zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi(ła) zmiana
    rowId - id wiersza w tabeli, w której nastąpi(ła) zmiana
    newValue - nowa wartość zmienianego pola
    Returns:
    id dokonanego wpisu w tabeli historii
    Throws:
    palio.PalioException

    recordChange

    public java.lang.Long recordChange(java.lang.String resourceName,
                                       java.lang.String fieldName,
                                       java.lang.Long rowId,
                                       java.lang.String oldValue,
                                       java.lang.String newValue,
                                       java.lang.Long userId,
                                       java.lang.Long extraId,
                                       java.lang.String saveAlways)
                                throws palio.PalioException
    Działa analogicznie jak recordChange. Zapisuje zmiany do domysnej tabeli historii tabeli.

    Parameters:
    resourceName - nazwa tabeli, w której nastąpi(ła) zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi(ła) zmiana
    rowId - id wiersza w tabeli, w której nastąpi(ła) zmiana
    oldValue - poprzednia wartość zmienianego pola
    newValue - nowa wartość zmienianego pola
    userId - id użytkownika dokonującego zmiany
    extraId - dodatkowe id związane zmienianym polem (przy rejestracji zmian w tabeli złączeń)
    saveAlways - gdy not null to zmiana zapisywana zawsze, nawet gdy wartość stara i nowa nie różnią się
    Returns:
    id dokonanego wpisu w tabeli historii
    Throws:
    palio.PalioException

    recordChange

    public java.lang.Long recordChange(java.lang.String resourceName,
                                       java.lang.String fieldName,
                                       java.lang.Long rowId,
                                       java.lang.String oldValue,
                                       java.lang.String newValue,
                                       java.lang.Long userId,
                                       java.lang.Long extraId)
                                throws palio.PalioException
    Działa analogicznie jak recordChange,tylko z saveAlways=null. Zapisuje zmiany do domysnej tabeli historii tabeli.

    Parameters:
    resourceName - nazwa tabeli, w której nastąpi(ła) zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi(ła) zmiana
    rowId - id wiersza w tabeli, w której nastąpi(ła) zmiana
    oldValue - poprzednia wartość zmienianego pola
    newValue - nowa wartość zmienianego pola
    userId - id użytkownika dokonującego zmiany
    extraId - dodatkowe id związane zmienianym polem (przy rejestracji zmian w tabeli złączeń)
    Returns:
    id dokonanego wpisu w tabeli historii
    Throws:
    palio.PalioException

    recordChange

    public java.lang.Long recordChange(java.lang.String resourceName,
                                       java.lang.String fieldName,
                                       java.lang.Long rowId,
                                       java.lang.String oldValue,
                                       java.lang.String newValue,
                                       java.lang.Long userId)
                                throws palio.PalioException
    Działa analogicznie jak recordChange, tylko z extraId=null i saveAlways=null. Zapisuje zmiany do domysnej tabeli historii tabeli.

    Parameters:
    resourceName - nazwa tabeli, w której nastąpi(ła) zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi(ła) zmiana
    rowId - id wiersza w tabeli, w której nastąpi(ła) zmiana
    oldValue - poprzednia wartość zmienianego pola
    newValue - nowa wartość zmienianego pola
    userId - id użytkownika dokonującego zmiany
    Returns:
    id dokonanego wpisu w tabeli historii
    Throws:
    palio.PalioException

    recordChange

    public java.lang.Long recordChange(java.lang.String resourceName,
                                       java.lang.String fieldName,
                                       java.lang.Long rowId,
                                       java.lang.String oldValue,
                                       java.lang.String newValue)
                                throws palio.PalioException
    Działa analogicznie jak recordChange, tylko z extraId=null i saveAlways=null, zapisuje id bieżącego użytkownika. Zapisuje zmiany do domysnej tabeli historii tabeli.

    Parameters:
    resourceName - nazwa tabeli, w której nastąpi(ła) zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi(ła) zmiana
    rowId - id wiersza w tabeli, w której nastąpi(ła) zmiana
    oldValue - poprzednia wartość zmienianego pola
    newValue - nowa wartość zmienianego pola
    Returns:
    id dokonanego wpisu w tabeli historii
    Throws:
    palio.PalioException

    recordChange

    public java.lang.Long recordChange(java.lang.String resourceName,
                                       java.lang.String fieldName,
                                       java.lang.Long rowId,
                                       java.lang.String newValue,
                                       java.lang.Long userId)
                                throws palio.PalioException
    Działa analogicznie jak recordChange, tylko z extraId=null i saveAlways=null, zapisuje id użytkownika userId. Old value jest odczytywane na podstawie resourceName, fieldName i rowId. Zapisuje zmiany do domysnej tabeli historii tabeli.

    Parameters:
    resourceName - nazwa tabeli, w której nastąpi zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi zmiana
    rowId - id wiersza w tabeli, w której nastąpi zmiana
    newValue - nowa wartość zmienianego pola
    userId - id użytkownika dokonującego zmiany
    Returns:
    id dokonanego wpisu w tabeli historii
    Throws:
    palio.PalioException

    recordChange

    public java.lang.Long recordChange(java.lang.String resourceName,
                                       java.lang.String fieldName,
                                       java.lang.Long rowId,
                                       java.lang.String newValue)
                                throws palio.PalioException
    Działa analogicznie jak recordChange, tylko z extraId=null i saveAlways=null, zapisuje id bieżącego użytkownika. Old value jest odczytywane na podstawie resourceName, fieldName i rowId. Zapisuje zmiany do domysnej tabeli historii tabeli.

    Parameters:
    resourceName - nazwa tabeli, w której nastąpi zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi zmiana
    rowId - id wiersza w tabeli, w której nastąpi zmiana
    newValue - nowa wartość zmienianego pola
    Returns:
    id dokonanego wpisu w tabeli historii
    Throws:
    palio.PalioException

    recordDateChange

    public java.lang.Long recordDateChange(java.lang.String historyTableName,
                                           java.lang.String resourceName,
                                           java.lang.String fieldName,
                                           java.lang.Long rowId,
                                           java.lang.String newValue,
                                           java.lang.String dateFormat,
                                           java.lang.Long userId)
                                    throws palio.PalioException
    Działa analogicznie jak recordChange tylko dla pól typu date. Zapisuje id użytkownika userId. Poprzednia wartość (oldValue) jest odczytywane na podstawie resourceName, fieldName i rowId. Odczytywana wartość jest formatowana wg. dateFormat, natomiast zapisywana (newValue) powinna już być odpowiednio sformatowana (tak, jak ma się zarejestrować w historii).

    Parameters:
    historyTableName - nazwa tabeli historii, w której będzie rejestrowana zmiana
    resourceName - nazwa tabeli, w której nastąpi(ła) zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi(ła) zmiana
    rowId - id wiersza w tabeli, w której nastąpi(ła) zmiana
    newValue - nowa wartość zmienianego pola
    dateFormat - format bazodanowy daty, używany przy odczycie poprzedniej wartości (oldValue)
    userId - id użytkownika dokonującego zmiany
    Returns:
    id dokonanego wpisu w tabeli historii
    Throws:
    palio.PalioException

    recordDateChange

    public java.lang.Long recordDateChange(java.lang.String historyTableName,
                                           java.lang.String resourceName,
                                           java.lang.String fieldName,
                                           java.lang.Long rowId,
                                           java.lang.String newValue,
                                           java.lang.String dateFormat)
                                    throws palio.PalioException
    Działa analogicznie jak recordDateChange tylko zapisuje id użytkownika bieżącego.

    Parameters:
    historyTableName - nazwa tabeli historii, w której będzie rejestrowana zmiana
    resourceName - nazwa tabeli, w której nastąpi(ła) zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi(ła) zmiana
    rowId - id wiersza w tabeli, w której nastąpi(ła) zmiana
    newValue - nowa wartość zmienianego pola
    dateFormat - format bazodanowy daty, używany przy odczycie poprzedniej wartości (oldValue)
    Returns:
    id dokonanego wpisu w tabeli historii
    Throws:
    palio.PalioException

    recordDateChange

    public java.lang.Long recordDateChange(java.lang.String resourceName,
                                           java.lang.String fieldName,
                                           java.lang.Long rowId,
                                           java.lang.String newValue,
                                           java.lang.String dateFormat,
                                           java.lang.Long userId)
                                    throws palio.PalioException
    Działa analogicznie jak recordDateChange. Zapisuje zmiany do domysnej tabeli historii tabeli.

    Parameters:
    resourceName - nazwa tabeli, w której nastąpi zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi zmiana
    rowId - id wiersza w tabeli, w której nastąpi zmiana
    newValue - nowa wartość zmienianego pola
    dateFormat - format bazodanowy daty, używany przy odczycie poprzedniej wartości (oldValue)
    userId - id użytkownika dokonującego zmiany
    Returns:
    id dokonanego wpisu w tabeli historii
    Throws:
    palio.PalioException

    recordDateChange

    public java.lang.Long recordDateChange(java.lang.String resourceName,
                                           java.lang.String fieldName,
                                           java.lang.Long rowId,
                                           java.lang.String newValue,
                                           java.lang.String dateFormat)
                                    throws palio.PalioException
    Działa analogicznie jak recordDateChange tylko zapisuje id użytkownika bieżącego.

    Parameters:
    resourceName - nazwa tabeli, w której nastąpi zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi zmiana
    rowId - id wiersza w tabeli, w której nastąpi zmiana
    newValue - nowa wartość zmienianego pola
    dateFormat - format bazodanowy daty, używany przy odczycie poprzedniej wartości (oldValue)
    Returns:
    id dokonanego wpisu w tabeli historii
    Throws:
    palio.PalioException

    modify

    public void modify(java.lang.String resourceName,
                       java.lang.String fieldName,
                       java.lang.Long rowId,
                       java.lang.String newValue)
                throws palio.PalioException
    Modyfikuje pole fieldName w tabeli resourceName w wierszu rowId (zał. że tabela ma kolumnę id będącą kluczem głównym) na wartość newValue. Zmiana nie jest rejestrowana w historii.

    Parameters:
    resourceName - nazwa tabeli, w której nastąpi zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi zmiana
    rowId - id wiersza w tabeli, w której nastąpi zmiana
    newValue - nowa wartość zmienianego pola
    Throws:
    palio.PalioException

    modifyAndTrim

    public void modifyAndTrim(java.lang.String resourceName,
                              java.lang.String fieldName,
                              java.lang.Long rowId,
                              java.lang.String newValue)
                       throws palio.PalioException
    Analogiczne do modify, z tym, że z nowej wartości są usuwane zewnętrzne białe znaki, a wielokrotne białe znaki są zamieniane na pojedynczą spację. Zmiana nie jest rejestrowana w historii.

    Parameters:
    resourceName - nazwa tabeli, w której nastąpi zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi zmiana
    rowId - id wiersza w tabeli, w której nastąpi zmiana
    newValue - nowa wartość zmienianego pola
    Throws:
    palio.PalioException

    modifyDate

    public void modifyDate(java.lang.String resourceName,
                           java.lang.String fieldName,
                           java.lang.Long rowId,
                           java.lang.String newValue,
                           java.lang.String dateFormat)
                    throws palio.PalioException
    Modyfikuje pole fieldName typu date w tabeli resourceName w wierszu rowId (zał. że tabela ma kolumnę id będącą kluczem głównym) na wartość newValue. Zmiana nie jest rejestrowana w historii. Zapisywana (newValue) wartość jest formatowana wg. dateFormat.

    Parameters:
    resourceName - nazwa tabeli, w której nastąpi zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi zmiana
    rowId - id wiersza w tabeli, w której nastąpi zmiana
    newValue - nowa wartość zmienianego pola
    dateFormat - format bazodanowy daty, używany przy odczycie zapisie nowej wartości (newValue)
    Throws:
    palio.PalioException

    modifyH

    public void modifyH(java.lang.String historyTableName,
                        java.lang.String resourceName,
                        java.lang.String fieldName,
                        java.lang.Long rowId,
                        java.lang.String newValue,
                        java.lang.Long userId)
                 throws palio.PalioException
    Modyfikuje pole fieldName w tabeli resourceName w wierszu rowId (zał. że tabela ma kolumnę id będącą kluczem głównym) na wartość newValue. Rejestrowana jest zmiana w tabeli historyTableName historii z użytkownikiem userId.

    Parameters:
    historyTableName - nazwa tabeli historii, w której będzie rejestrowana zmiana
    resourceName - nazwa tabeli, w której nastąpi zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi zmiana
    rowId - id wiersza w tabeli, w której nastąpi zmiana
    newValue - nowa wartość zmienianego pola
    userId - id użytkownika dokonującego zmiany
    Throws:
    palio.PalioException

    modifyH

    public void modifyH(java.lang.String historyTableName,
                        java.lang.String resourceName,
                        java.lang.String fieldName,
                        java.lang.Long rowId,
                        java.lang.String newValue)
                 throws palio.PalioException
    Modyfikuje pole fieldName w tabeli resourceName w wierszu rowId (zał. że tabela ma kolumnę id będącą kluczem głównym) na wartość newValue. Rejestrowana jest zmiana w tabeli historyTableName historii z bieżącym użytkownikiem.

    Parameters:
    historyTableName - nazwa tabeli historii, w której będzie rejestrowana zmiana
    resourceName - nazwa tabeli, w której nastąpi zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi zmiana
    rowId - id wiersza w tabeli, w której nastąpi zmiana
    newValue - nowa wartość zmienianego pola
    Throws:
    palio.PalioException

    modifyH

    public void modifyH(java.lang.String resourceName,
                        java.lang.String fieldName,
                        java.lang.Long rowId,
                        java.lang.String newValue,
                        java.lang.Long userId)
                 throws palio.PalioException
    Modyfikuje pole fieldName w tabeli resourceName w wierszu rowId (zał. że tabela ma kolumnę id będącą kluczem głównym) na wartość newValue. Rejestrowana jest zmiana w domyślnej tabeli historii z użytkownikiem userId.

    Parameters:
    resourceName - nazwa tabeli, w której nastąpi zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi zmiana
    rowId - id wiersza w tabeli, w której nastąpi zmiana
    newValue - nowa wartość zmienianego pola
    userId - id użytkownika dokonującego zmiany
    Throws:
    palio.PalioException

    modifyH

    public void modifyH(java.lang.String resourceName,
                        java.lang.String fieldName,
                        java.lang.Long rowId,
                        java.lang.String newValue)
                 throws palio.PalioException
    Modyfikuje pole fieldName w tabeli resourceName w wierszu rowId (zał. że tabela ma kolumnę id będącą kluczem głównym) na wartość newValue. Rejestrowana jest zmiana w domyślnej tabeli historii z bieżącym użytkownikiem.

    Parameters:
    resourceName - nazwa tabeli, w której nastąpi zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi zmiana
    rowId - id wiersza w tabeli, w której nastąpi zmiana
    newValue - nowa wartość zmienianego pola
    Throws:
    palio.PalioException

    modifyAndTrimH

    public void modifyAndTrimH(java.lang.String historyTableName,
                               java.lang.String resourceName,
                               java.lang.String fieldName,
                               java.lang.Long rowId,
                               java.lang.String newValue,
                               java.lang.Long userId)
                        throws palio.PalioException
    Analogiczne do modifyH, z tym, że z nowej wartości są usuwane zewnętrzne białe znaki, a wielokrotne białe znaki są zamieniane na pojedynczą spację. Rejestrowana jest zmiana w tabeli historii historyTableName z użytkownikiem userId.

    Parameters:
    historyTableName - nazwa tabeli historii, w której będzie rejestrowana zmiana
    resourceName - nazwa tabeli, w której nastąpi zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi zmiana
    rowId - id wiersza w tabeli, w której nastąpi zmiana
    newValue - nowa wartość zmienianego pola
    userId - id użytkownika dokonującego zmiany
    Throws:
    palio.PalioException

    modifyAndTrimH

    public void modifyAndTrimH(java.lang.String historyTableName,
                               java.lang.String resourceName,
                               java.lang.String fieldName,
                               java.lang.Long rowId,
                               java.lang.String newValue)
                        throws palio.PalioException
    Analogiczne do modifyH, z tym, że z nowej wartości są usuwane zewnętrzne białe znaki, a wielokrotne białe znaki są zamieniane na pojedynczą spację. Rejestrowana jest zmiana w tabeli historii historyTableName z bieżącym użytkownikiem.

    Parameters:
    historyTableName - nazwa tabeli historii, w której będzie rejestrowana zmiana
    resourceName - nazwa tabeli, w której nastąpi zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi zmiana
    rowId - id wiersza w tabeli, w której nastąpi zmiana
    newValue - nowa wartość zmienianego pola
    Throws:
    palio.PalioException

    modifyAndTrimH

    public void modifyAndTrimH(java.lang.String resourceName,
                               java.lang.String fieldName,
                               java.lang.Long rowId,
                               java.lang.String newValue,
                               java.lang.Long userId)
                        throws palio.PalioException
    Analogiczne do modifyH, z tym, że z nowej wartości są usuwane zewnętrzne białe znaki, a wielokrotne białe znaki są zamieniane na pojedynczą spację. Rejestrowana jest zmiana w domyślnej tabeli historii z użytkownikiem userId.

    Parameters:
    resourceName - nazwa tabeli, w której nastąpi zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi zmiana
    rowId - id wiersza w tabeli, w której nastąpi zmiana
    newValue - nowa wartość zmienianego pola
    userId - id użytkownika dokonującego zmiany
    Throws:
    palio.PalioException

    modifyAndTrimH

    public void modifyAndTrimH(java.lang.String resourceName,
                               java.lang.String fieldName,
                               java.lang.Long rowId,
                               java.lang.String newValue)
                        throws palio.PalioException
    Analogiczne do modifyH, z tym, że z nowej wartości są usuwane zewnętrzne białe znaki, a wielokrotne białe znaki są zamieniane na pojedynczą spację. Rejestrowana jest zmiana w domyślnej tabeli historii z bieżącym użytkownikiem.

    Parameters:
    resourceName - nazwa tabeli, w której nastąpi zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi zmiana
    rowId - id wiersza w tabeli, w której nastąpi zmiana
    newValue - nowa wartość zmienianego pola
    Throws:
    palio.PalioException

    modifyDateH

    public void modifyDateH(java.lang.String historyTableName,
                            java.lang.String resourceName,
                            java.lang.String fieldName,
                            java.lang.Long rowId,
                            java.lang.String newValue,
                            java.lang.String dateFormat,
                            java.lang.Long userId)
                     throws palio.PalioException
    Modyfikuje pole fieldName typu date w tabeli resourceName w wierszu rowId (zał. że tabela ma kolumnę id będącą kluczem głównym) na wartość newValue. Rejestrowana jest zmiana w tabeli historii historyTableName z użytkownikiem userId. Odczytywana i zapisywana (newValue) wartość jest formatowana wg. dateFormat.

    Parameters:
    historyTableName - nazwa tabeli historii, w której będzie rejestrowana zmiana
    resourceName - nazwa tabeli, w której nastąpi zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi zmiana
    rowId - id wiersza w tabeli, w której nastąpi zmiana
    newValue - nowa wartość zmienianego pola
    dateFormat - format bazodanowy daty, używany przy odczycie poprzedniej wartości (oldValue) i zapisie nowej (newValue)
    userId - id użytkownika dokonującego zmiany
    Throws:
    palio.PalioException

    modifyDateH

    public void modifyDateH(java.lang.String historyTableName,
                            java.lang.String resourceName,
                            java.lang.String fieldName,
                            java.lang.Long rowId,
                            java.lang.String newValue,
                            java.lang.String dateFormat)
                     throws palio.PalioException
    Modyfikuje pole fieldName w tabeli resourceName w wierszu rowId (zał. że tabela ma kolumnę id będącą kluczem głównym) na wartość newValue. Rejestrowana jest zmiana w tabeli historii historyTableName z bieżącym użytkownikiem.

    Parameters:
    historyTableName - nazwa tabeli historii, w której będzie rejestrowana zmiana
    resourceName - nazwa tabeli, w której nastąpi zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi zmiana
    rowId - id wiersza w tabeli, w której nastąpi zmiana
    newValue - nowa wartość zmienianego pola
    dateFormat - format bazodanowy daty, używany przy odczycie poprzedniej wartości (oldValue) i zapisie nowej (newValue)
    Throws:
    palio.PalioException

    modifyDateH

    public void modifyDateH(java.lang.String resourceName,
                            java.lang.String fieldName,
                            java.lang.Long rowId,
                            java.lang.String newValue,
                            java.lang.String dateFormat,
                            java.lang.Long userId)
                     throws palio.PalioException
    Modyfikuje pole fieldName typu date w tabeli resourceName w wierszu rowId (zał. że tabela ma kolumnę id będącą kluczem głównym) na wartość newValue. Rejestrowana jest zmiana w domyślnej tabeli historii z użytkownikiem userId. Odczytywana i zapisywana (newValue) wartość jest formatowana wg. dateFormat.

    Parameters:
    resourceName - nazwa tabeli, w której nastąpi zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi zmiana
    rowId - id wiersza w tabeli, w której nastąpi zmiana
    newValue - nowa wartość zmienianego pola
    dateFormat - format bazodanowy daty, używany przy odczycie poprzedniej wartości (oldValue) i zapisie nowej (newValue)
    userId - id użytkownika dokonującego zmiany
    Throws:
    palio.PalioException

    modifyDateH

    public void modifyDateH(java.lang.String resourceName,
                            java.lang.String fieldName,
                            java.lang.Long rowId,
                            java.lang.String newValue,
                            java.lang.String dateFormat)
                     throws palio.PalioException
    Modyfikuje pole fieldName w tabeli resourceName w wierszu rowId (zał. że tabela ma kolumnę id będącą kluczem głównym) na wartość newValue. Rejestrowana jest zmiana w domyślnej tabeli historii z bieżącym użytkownikiem.

    Parameters:
    resourceName - nazwa tabeli, w której nastąpi zmiana
    fieldName - nazwa kolumny w tabeli, w której nastąpi zmiana
    rowId - id wiersza w tabeli, w której nastąpi zmiana
    newValue - nowa wartość zmienianego pola
    dateFormat - format bazodanowy daty, używany przy odczycie poprzedniej wartości (oldValue) i zapisie nowej (newValue)
    Throws:
    palio.PalioException