Obecne założenia :

Plik json z ogólną konfiguracją powinien znajdować się w \resources\config.

Musi być połączenie z internetem, aby pobrać kursy walut.

Odcinki trasy muszą być wprowadzane w kolejności chronologicznej.

Szablony dokumentów Word (docx) muszą być zapisane w MS Word 2013 przynajmniej. Nie mogą być zapisane w tzw zgodności do wcześniejszych wersji Word.

Radzaje konfiguracji.

Poniżej opisane sposoby konfiguracji wpływają na sposób działania wtyczki oraz następujące w niej rozliczenie delegacji.

Rodzaj

Opis

Format

Ustawianie wartości

kliencka

zawiera parametry ustawiane indywidualnie dla każdego wdrożenia

parametry akcji

w PWE w parametrach akcji Business Trip

domyślna

zawiera 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.

zmieniona

zawiera parametry jak w konfiguracji domyślnej, ale tylko te które wymagały jednak zmiany w danym wdrożeniu

plik 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ą.

Ustawienie konfiguracji klienckiej.

Parametry ogólne dot. ustawień sposobu działania rozliczenia.

Parametr akcji	Opis ustawienia	Ustawienie obligatoryjne?
'Czy zapisać zmienne?	jeśli 'Tak' to przed otwarciem okna do rozliczenia delegacji, zostaną zapisane wszystkie zmienne na formularzu zadania. Jeśli 'Nie' to otworzy okno bez zapisywania zmiennych.	Tak
Czy tabela wydatków widoczna?		Tak
Czy ostrzegać, gdy daty niezgodne?		Tak
Czy okno rozliczenia widoczne?		Tak
Czy rodzaj wydatku widoczny?		Tak
Rodzaje wydatków
Odświeżanie kursu, etap
Odświeżanie kursu, dzisiaj/z pola
Odświeżanie kursu, Id pola		*może być konieczny do kursu waluty dla delegacji zagranicznej
Podsumowanie pdf drukować?		Tak
Podsumowanie pdf, klasa
Podsumowanie pdf, szablon
Karta pojazdu pdf, drukować?		Tak
Karta pojazdu pdf, klasa
Karta pojazdu pdf, szablon

Parametry wejściowe :

Aby ustawić parametry wejściowe należy ustawić dla poniższych parametrów zmienne procesu zawierające dane które zostaną przekazane z procesu wniosku delegacji do rozliczenia delegacji.

Parametr akcji	Opis ustawienia	Ustawienie obligatoryjne?
Numer delegacji	zmienna procesu z której zostanie pobrane id delegacji. Wcześniej musi być zapewniona unikalność tych id, ale nie ma narzuconego formatu.	Tak
Typ delegacji	zmienna procesu z której zostanie pobrana informacja o typie rozliczanej delegacji. Tj 'kraj' jeśli w Polsce, 'zagranica' jeśli poza granicami Polski. Domyślnie 'kraj'.	Nie
Imię i nazwisko		Nie
Cel delegacji		Nie
Data rozpoczęcia		Nie
Data zakończenia		Nie
Miasto		Nie
Kraj		Nie
Rodzaj transport		Nie
Data wydania zaliczki	zmienna procesu z której zostanie pobrana data wydania zaliczki pracownikowi. *Uwaga, dla delegacji zagranicznej ustawienie tej informacji może być niezbędne podczas rozliczania w zależności od ustawień w json w parametrze 'kurs_do_obliczen' . Wtedy wg tej daty są pobierane kursy walut używane w rozliczeniu. Dlatego przy określaniu tej daty należy zastosować obowiązujące w danej firmie zasady dot. ustalania kursów walut, które mogą być powiązane z typem delegacji, datą zaliczki oraz datami delegacji.	Nie*

Parametry wyjściowe :

Aby ustawić parametry wyjściowe należy zmapować poniższe parametry na zmienne procesu umieszczone w tabelach dynamicznych. Wg tego ustawienia do tych zmiennych zostaną zapisane informacje z rozliczenia delegacji.

Tabela podsumowań (obligatoryjna):

Parametr akcji	Opis ustawienia	Ustawienie obligatoryjne?
Numer delegacji		Tak

Tabela kosztów (obligatoryjna):

Parametr akcji	Opis ustawienia	Ustawienie obligatoryjne?
Numer delegacji		Tak

Tabela wydatków (opcjonalna):

Parametr akcji	Opis ustawienia	Ustawienie obligatoryjne?
Numer delegacji	*Ale jeśli chcemy zapisać w tabeli wydatków jakąkolwiek daną to musi być też zmapowany 'Numer delegacji'.	Nie*

Uruchomienie wtyczki na systemie gdzie nie działały 'plusDelegacje' :

Pod przyciskiem na formularzu ustawić akcję wraz z ustawieniem odpowiednich mapowań parametrów wejściowych i parametrów wyjściowych - Krytyczne.

Uruchomienie wtyczki zamiast działających obecnie 'plusDelegacje' :

NEW

pobrać z projektu businessTripConf.json, przekopiować zawartość do własnego pliku i na podstawie starego json'a zmienić tylko te ustawienia, które są inne i istnieją w nowym jsonie. Te ustawienia które są takie same, wykasować z własnego pliku.
załadować ustawienia z utworzonego pliku z własną konfiguracją w administracja->konfiguracja systemu->delegacje
ustawić w akcjach parametry ogólne.

OLD

Pod przyciskiem na formularzu ustawić akcję 'Delegacje' wraz z ustawieniem odpowiednich mapowań jak dla 'mapping_zmienne_procesu' znajdujące się w pliku json z konfiguracją.- Krytyczne.

Dla parametru 'Data wydania zaliczki' trzeba zaimplementować w akcji analogiczny mechanizm ustawiania jaki był zastosowany w skrypcie js odpalającym plusDelegacje 3.1. Mechanizm wynika z reguł stosowanych w danej firmie.

W pliku konfiguracji json usunąć wszystkie ustawienia dla 'mapping_zmienne_procesu' - Ważne.
W w/w akcji ustawić odpowiednie mapowania jak dla 'mapping_wydatkow', "mapping_podsumowan" i "mapping_kosztow" znajdujące się w pliku json z konfiguracją.

Parametr w plusDelegacje 3.1	Odpowiednik w akcji
Parametr w plusDelegacje 3.1	Rodzaj parametru	Nazwa parametru
saveVariables funkcji DelegacjeModule_runModule wywoływanej w skrypcie js uruchamiającym moduł plusDelegacje 3.1	Ustawienie	'Czy zapisać zmienne?'

W pliku konfiguracji BusinessTripConf.json usunąć wszystkie ustawienia dla :

- 'mapping_wydatkow'
- 'id_tabeli_wydatkow'
- "id_tabeli_podsumowan"
- "mapping_podsumowan"
- "id_tabeli_kosztow"
- "mapping_kosztow"

Szablon dot rozliczania trasy poprawić, tj w pierwszym wierszu tabeli dot. rozliczania trasy w każdej komórce wpisać wartość 'T'.
Używane oba szablony docx dokumentów zapisać w MS Word 2013, bez tzw zgodności do wcześniejszych wersji.
Szablon dot. podsumowania trasy podpiąć w archiwum do klasy o nazwie jak ustawione jest w json w "generowanie_pdf_podsumowanie_rozliczenia"."klasa_dokumentu". Oraz nadać nazwę szablonu którą skopiować do parametru json "generowanie_pdf_podsumowanie_rozliczenia"."nazwa_szablonu"
Szablon dot. ewidencji pojazdu podpiąć w archiwum do klasy o nazwie jak ustawione jest w json w "generowanie_pdf_karta_ewidencji_pojazdu"."klasa_dokumentu". Oraz nadać nazwę szablonu którą skopiować do parametru json "generowanie_pdf_karta_ewidencji_pojazdu"."nazwa_szablonu".
Usunąć całkowicie z json parametr "generowanie_pdf_podsumowanie_rozliczenia"."sciezka_do_szablonu"
Usunąć całkowicie z json parametr "generowanie_pdf_karta_ewidencji_pojazdu"."sciezka_do_szablonu"
Jeśli po dodaniu do archiwum dokumentu, mają sie zaktualizować wartości jego indeksów to ustawić w Administracja->Archiwim->Akcje przepisanie indeksów z procesu do archiwum na ustawionych w "generowanie_pdf_podsumowanie_rozliczenia"."klasa_dokumentu" i "generowanie_pdf_karta_ewidencji_pojazdu"."klasa_dokumentu" klasach dokumentów.

Rozliczenie dla procesów utworzonych jeszcze przed zaktualizowaniem plusDelegacji do BusinessTrip (kroki opisane powyżej), nie będzie działało poprawnie w BusinessTrip.
Poprawne rozliczenie po aktualizacji jest tylko możliwe jeśli proces delegacji został utworzony także w BusinessTrip.
Procesy utworzone wcześniej muszą zostać rozliczone w PlusDelegacjach.