Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

RodzajOpisFormatUstawianie wartości
klienckazawiera parametry ustawiane indywidualnie dla każdego wdrożeniaparametry akcjiw PWE w parametrach akcji Business Trip
domyślnazawiera pozostałe parametry potrzebne do działania wtyczki, które albo wynikają z przepisów lub założeń
lub najczęściej nie jest potrzebne indywidualne ustawienie podczas wdrożenia
plik json

ładowana automatycznie przy uruchomieniu z zawartego we wtyczce pliku, który zawiera przyjęte domyślne wartości.
Można go znaleźć w projekcie wtyczki w .../resources/config/businessTripDefaultConfig.json

zmienionazawiera parametry jak w konfiguracji domyślnej, ale tylko te które wymagają jednak zmiany w danym wdrożeniuplik json

Aby zmienić parametr z konfiguracji domyślnej trzeba utworzyć lokalny poprawny plik json, zawierający tylko te parametry, które chcemy zmienić.
Potem trzeba go wczytać w Administracja->Konfiguracja systemu->Delegacje. Nadpisze to tylko te wybrane parametry, ale wszystkie ich wartości oraz umieści plik z tą konfiguracją na serwerze w '...\plugins\data\com_suncode_plugin-business-trip\config'.

Wczytana konfiguracja jest ładowania automatycznie przy uruchomieniu i automatycznie nadpisuje konfigurację domyślną.

Aby dokonać zmian w tej konfiguracji trzeba ponownie wczytać przygotowany plik z kompletnymi zmianami.
Natomiast aby całkowicie usunąć całkowicie tą konfigurację trzeba wczytać plik z pustym json'em lub usunąć wcześniej załadowany plik z serwera w powyżej wskazanej lokalizacji.

...

ParametrOpis
wydatki_walutysymbole walut, w których ma być możliwość zarejestrowania poniesionych wydatków
kilometrowkazawiera kategorie oraz przypisane koszty.
kilometrowka_dlaokreśla dla jakiego typu pojazdu, ma zostać wyliczona kilometrówka.
wymog_ewidencji_pojazduokreśla dla jakiego typu pojazdu ma być wymagane uzupełnienie pól dot ewidencja pojazdu.
srodek_transportuwszystkie środki transportu, dostępne do wyboru dla osoby rozliczającej delegację.
nawa_polskiej_walutynazwa polskiej waluty, używanej w procesie.
before_save_on_mapzmienna określająca metodę, która ma zostać wywołana tuż przed zapisaniem danych w procesie - metoda przyjmuje dwa parametry: "Map<String, Object>" - mapowane zmienne oraz "DB_roz_del" - obiekt zawierający wszystkie informacje o delegacji i zwraca mapę wartości Map<String, Object> np.

public static Map<String, Object> beforeWriteToProcess(Map<String, Object> zmienna, DB_roz_del delegacje)
{
    return zmienna;
}

krajmapa wartości, zawiera koszty: diety, ryczałtów dla delegacji krajowej.
zagranica :część konfiguracji dotycząca delegacji zagranicznej.
  • rozdziel_ryczalty
wartość true, powoduje rozdzielenie ryczałtów na poszczególne kraje (w walucie tych krajów). Wartość false, powoduje zliczenie wszystkich ryczałtów i przeliczenie ich na PLN.
  • wysokosc_diety_gdy_pracodawca_zapewnil_posilek
procent diety, w przypadku gdy pracodawca zapewnił posiłek w delegacji zagranicznej.
  • kurs_do_obliczen :

ustawienia dotyczące sposobu wybierania daty dla kursów walutowych.
Uwaga, kolejne trzy parametry dot odświeżania kursu można ustawić w konfiguracji klienckiej.

    • odswiezanie_kursu_na_etapie_od_wer_pakietu
wersja mapy, od której odświeżanie będzie funkcjonować.
    • odswiezanie_ile_dni_odjac_od_dzisiaj
ile dni ma zostać odjętych od daty dzisiejszej. Domyślną wartością jest -1 (data z wczoraj).
    • czy_czytac_z_pola
wartość true, powoduję, że moduł będzie odczytywał datę dla kursów walutowych, ze wskazanego pola.
    • ile_dni_odjac_od_daty_pola
w polu, można wskazać, ile dni ma zostać odjętych od daty wskazanej w polu.
    • czy_obslugiwac_date_zaliczki
wartość true, powoduje, możliwość przekazania daty z poziomu javascriptu (identyfikator data_wydania_zaliczki, w array'u identyfikatorów, przekazywanych w funkcji javascript).
    • czy_data_zaliczki_wazniejsza_od_daty_z_rozliczenia
wartość true, powoduje, że data zaliczki, przekazana z poziomu javascript, jest ważniejsza od daty z wcześniejszego rozliczenia wskazanej delegacji.
  • waluty
lista dostępnych walut w których może nastąpić rozliczenie
  • dieta
lista stawek diet i walut dla krajów, wg których nastąpi rozliczenie dla poszczególnych krajów
  • kraje
lista dostępnych krajów w rozliczeniu
  • granica_odrazu
typy pojazdów, dla których, rozpoczęcie, zakończenie naliczania diety następuje "od razu", tzn. wylot powoduję naliczanie diety dla kraju przylotu (docelowego) od momentu startu samolotu. Do takich środków lokomocji, należą, samolot oraz statek. Ustawienie to, jest używane tylko i wyłącznie przy kalkulacji diety. Nie powinno się go zmieniać.

Domyślne wartości parametrów w poprawnym formacie można znaleźć w projekcie wtyczki w .../resources/config/businessTripDefaultConfig.json 

Konfiguracja zmieniona.

 Jest opcjonalna. Powinna zawierać tylko te parametry konfiguracji domyślnej, które jednak musiały zostać zmienione, bo domyślna wartość nie była odpowiednia.

Uruchomienie wtyczki 'BusinessTrip'.

...