Założenia :
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ć. 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. |
Ustawianie konfiguracji klienckiej.
Parametry ogólne dot. ustawień sposobu działania rozliczenia.
| Parametr akcji | Opis ustawienia | Ustawienie obligatoryjne? |
|---|---|---|
| 'Czy zapisać zmienne? | NIE UŻYWAĆ ! Prawdopodobnie będzie wycięty i zastąpiony standardową funkcjonalnością PWFL. 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 |
|---|---|---|
| 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.
Uwaga
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 | |
|---|---|---|
| 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.
Procesy z poprzedniej wersji nie będą działały
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.