Przed przystąpieniem do wykorzystania importera, należy upewnić się, iż jesteśmy zalogowani w programie R2P. Importer użyje do importowania aktualnie zalogowanego użytkownika. Jeśli takowego nie znajdzie, zwróci błąd.
Na początku należy uruchomić linię komend (CMD), a następnie przejść do katalogu z programem importera za pomocą komendy "cd"
W celu uzyskania listy dostępnych parametrów wywołania programu, należy wprowadzić komendę:
Opis parametrów programu ImportInelo.exe
--help - Wyświetla listę dostępnych parametrów
--idFirmy - Pozwala określić ID firmy w R2Płatniku dla której import ma zostać wykonany
NP. ImportInelo.exe --idFirmy 1
--bezGUI - Pozwala wywołać program bez wyświetlania GUI (pasek postępu, komunikat o zakończeniu przetwarzania). Przyjmuje wartość „TAK” lub „NIE”
Np. ImportInelo.exe --bezGUI TAK
--r2pbin - Pozwala podać ścieżkę do katalogu BIN programu R2P
Np. ImportInelo.exe --r2pbin C:\RESET2\Platnik.10x\BIN
--konfiguracja lub --konf - Pozwala podać inną pełną ścieżkę do pliku konfiguracyjnego. (domyślna ścieżka znajduje się w katalogu bieżącym: „ImportIneloConfig.xml”)
Np. ImportInelo.exe --konf ”C:\Konfiguracji Inelo\Config.xml”
--zakonczNa lub --zakNa - Użycie parametru poinformuje program, aby zakończyć działanie na wybranym etapie i nie kontynuować importu. Dostępne etapy:
1. Weryfikacja uprawnień (WER_UPR)
2. Weryfikacja konfiguracji (WER_KONF)
3. Weryfikacji pliku z danymi wejściowym (WER_DANE)
4. Walidacja importu (WAL_IMP)
5. Import danych
Jako wartość parametru można podać również „-”, wtedy program wykona się do końca. Domyślna wartość parametru skonfigurowana w pliku ImportIneloConfig.xml to „-”.
Np. ImportInelo.exe --zakNa WER_KONF
--sumDlaIdentycznych - Użycie parametru poinformuje program, aby dla wybranego składnika (numer Inelo, id R2P lub nazwa) sumować kwoty, jeśli dany składnik z takimi samymi datami okresu obowiązywania wystąpi dla danego pracownika wielokrotnie (Pokrycie dat musi być dokładne, nie jest w tym przypadku uwzględniane procentowe pokrycie).
Format aby podać numer Inelo: "NRI:{Numer Inelo}"
Format aby podać id R2P: "IDR2P:{ID R2P}"
Format aby podać nazwę składnika: "NZW:{Nazwa składnika zgodna z ImportIneloConfig.xml}"
Przykłady:
ImportInelo.exe --sumDlaIdentycznych NRI:13 - Aktywuje sumowanie dla składnika z numerem Inelo 13
ImportInelo.exe --sumDlaIdentycznych IDR2P:1 - Aktywuje sumowanie dla składnika z ID w R2P równym 1
ImportInelo.exe --sumDlaIdentycznych "NZW:Stawka Miesięczna" - Aktywuje sumowanie dla składnika z nazwą "Stawka Miesięczna"
ImportInelo.exe --sumDlaIdentycznych NRI:13 IDR2P:1 "NZW:Stawka Miesięczna" - Aktywuje sumowanie dla trzech podanych składników
nieSumDlaIdentycznych ma priorytet nad tą opcją
--nieSumDlaIdentycznych - Użycie parametru poinformuje program, aby dla wybranego składnika (numer Inelo, id R2P lub nazwa) NIE sumować kwoty, jeśli dany składnik z takimi samymi datami okresu obowiązywania wystąpi dla danego pracownika wielokrotnie, zamiast tego dodać ten składnik tyle razy ile razy wystąpił w pliku do importu
Format aby podać numer Inelo: "NRI:{Numer Inelo}"
Format aby podać id R2P: "IDR2P:{ID R2P}"
Format aby podać nazwę składnika: "NZW:{Nazwa składnika zgodna z ImportIneloConfig.xml}"
Przykłady:
ImportInelo.exe --nieSumDlaIdentycznych NRI:13 - Wyłącza sumowanie dla składnika z numerem Inelo 13
ImportInelo.exe --nieSumDlaIdentycznych IDR2P:1 – Wyłącza sumowanie dla składnika z ID w R2P równym 1
ImportInelo.exe --nieSumDlaIdentycznych "NZW:Stawka Miesięczna" - Wyłącza sumowanie dla składnika z nazwą "Stawka Miesięczna"
ImportInelo.exe --nieSumDlaIdentycznych NRI:13 IDR2P:1 "NZW:Stawka Miesięczna" - Wyłącza sumowanie dla trzech podanych składników
UWAGA: ta opcja ma priorytet nad sumDlaIdentycznych
--bezR2P - Pozwala wywołać program przy pominięciu etapów bezpośrednio wymagających autoryzacji w programie R2P.
Parametr przyjmuje jedną z dwóch wartości:
- TAK
- NIE
Podanie „TAK” pominie etapy „Werfikacja uprawnień” i „Import danych”. Dzięki temu parametrowi możemy testować konfigurację i dane wejściowe bez dostępu do programu R2P.
Domyślna wartość parametru skonfigurowana w pliku ImportIneloConfig.xml to „NIE”.
| Np. ImportInelo.exe --bezR2P TAK |
--katalogZrodlowy lub --katZr - Pozwala podać ścieżkę do katalogu z danymi do importu. Domyślnie używana jest wartość zdefiniowana w pliku ImportIneloConfig.xml, wartość podana obok tego parametru nadpisze na czas tego importu tą wartość.
Wprowadzenie kropki („.”) w tym parametrze jest równoznaczne z wprowadzeniem wartości „Data” (domyślny katalog danych do importu, jeśli ten nie został zdefiniowany w ImportIneloConfig.xml).
Np. ImportInelo.exe --katZr „C:\mojkatalog”
--trybImportu lub --tImp - Parametr przyjmuje jedną z wartości:
- NADPISUJ – określa, że import składników będzie odbywał się w trybie nadpisywania, zatem jeśli program wykryje, że dany składnik już istnieje, to nadpisze go, zamiast tworzyć nowy
- DODAWAJ – określa, że import składników będzie odbywał się w trybie dodawania, zatem jeśli program wykryje, że dany składnik już istnieje, zignoruje to i doda go drugi raz zgodnie z danymi importu.
- TYLKO_NADPISUJ – określa, że import składników nie będzie dodawał nowych składników dla pracowników, a jedynie nadpisywał aktualnie dodane
Np. ImportInelo.exe --tImp TYLKO_NADPISUJ