W module RaportyXML utworzono definicję raportu, który tworzy plik CSV
z kartoteki stanów magazynowych KSOM.
Raport prezentuje aktualne stany dostępne oraz ilości planowane do zakupu
wskazanego asortymentu.
Obecnie raport jest tworzony ręcznie kilka razy dziennie.
Potrzeba
Zautomatyzować proces tworzenie raportu.
Okresowo, np. co 2 godziny, automatycznie tworzyć plik raportu wg definicji
w RaportyXML.
2. Rozwiązanie: Zastosowanie alertów
W Trawers5 TUI (wersja znakowa)
Konfigurowanie automatycznego uruchamiania raportu XML i alertu.
Kolejne kroki:1. Pobranie definicji raportu XML z ftp
PM > Raporty XML > Definicje raportów > Pobieranie definicji z ftp.tres.pl
--> Pobrać plik: MG0002.xml
Symbol raportu 'MG0002' jest znaczący, jeśli zmienimy, to trzeba zaktualizować
także w:
- zapytaniu alertu (Query)
- nagłówku alertu
Najlepiej pozostawić symbol bez zmian.
Patrz dalej - treść definicji raportu2. Pobranie definicji alertu z ftp
AD > Alerty Tabela > Opracowanie > F8 > Pobierz z ftp
--> Pobrać plik: Zapis-KSOM-do-CSV.xml
Alert wykonuje funkcję TrExtLang: ţRaport{@SYMBOL}, która:
- uruchamia funkcje i tworzy raport
- zapisuje (eksportuje) go do pliku (domyślnie: ../trtres/trinout/)
- zwraca ścieżkę do utworzonego pliku
Alert działa automatycznie co godzinę i zapisuje raport.
Patrz dalej - treść definicji alertu3. Skrypt uruchamiający alerty
Pobrać skrypt z ftp:
https://ftp.tres.pl/dodatki-linux/skrypty/tr-alert.sh
-------------------------------------------------------------------
#!/bin/bash
cd /opt/trawers/dane/bin
if [ -z "$(pgrep -f proces=AD_PAL10)" ] ;
then
./tr5x64.exe //gtnul --firma=HA --operator=AA --proces=AD_PAL10
fi
-------------------------------------------------------------------
Zmodyfikować:
- katalog docelowy
- symbol firmy
- symbol operatora
4. Dodanie skryptu do CRON-a
- Otworzyć edycję crona:
bash
crontab -e
- Dodać wpis:
bash
30 4-22 * * * /trawers/bin/tr-alert.sh
Ten wpis uruchamia skrypt co godzinę, między 4:30 a 22:30
* --> kazdy dzień, każdy m-c, każdy dzień tygodnia
Uwaga:
Raz uruchomiony proces alertów działa bez przerwy i zajmuje jedną sesje.
Po wdrożeniu można sprawdzić poprawność działania alertu, przeglądając
logi systemowe lub katalog `trinout`, aby upewnić się, że raporty
są generowane zgodnie z harmonogramem.
3. RaportyXML i Alert. Korzyści
Opisane rozwiązanie z raportem XML i alertem w Trawers ERP pomaga firmie
automatycznie tworzyć i zapisywać raporty, bez potrzeby ręcznego
uruchamiania ich przez operatora.
Korzyści:
- Automatyzacja pracy:
System sam co godzinę uruchamia raport i zapisuje jego wynik w pliku.
Dzięki temu dane są zawsze aktualne, a operatorzy nie muszą pamiętać
o ręcznym generowaniu raportu.
- Oszczędność czasu:
Wszystko dzieje się w tle - wystarczy raz ustawić alert i harmonogram w systemie (CRON),
a raporty będą tworzone automatycznie.
- Większa niezawodność:
Skrypt i alert działają według ustalonego planu, więc ryzyko pominięcia
raportu lub błędu ludzkiego jest minimalne.
- Łatwy dostęp do danych:
Raporty są zapisywane w określonym katalogu, więc można je łatwo znaleźć
i wykorzystać w analizach lub przesłać dalej.
W skrócie
To rozwiązanie sprawia, że system sam pilnuje raportowania, a użytkownicy
mogą skupić się na analizie wyników zamiast na technicznych czynnościach.
To jest podobne do 'automatycznego przypomnienia', które nie tylko przypomina,
ale od razu wykonuje zadanie za operatora.
4. Definicja raportu
Raport: MG0002 Kartoteka KSOM ze stanami dostępnymi
-------------------------------------------------- PM5 (pm_zap20) --
Definicja raportu
--------------------------------------------------------------------
Eksport do katalogu ../trtres/trinout/aa
Eksport do pliku ksom.csv
W formacie CSV
System MG
Zbiór rodzica 224 Kartot mag KSOM MG
Numerować linie ? N
Ująć pozycje ? T
Wyszczególnić sumy ? T
Okres względny ? N
Okres Nie dotyczy
Zbiory:
224 Kartot mag KSOM MG
Pola:
BLOKADTN [ ][T] Zablokowana
FREZER Il w fa sprzed NA (niezatw)(-)
INDEKS Indeks
MAG Mag
MILOSC Ilość w KSOM/LOT/SER
MREZER Il w otw zamów sprzed NA (-)
PREZER Il w otw zlec prod ZP (-)
229 Indeksy KIM MG
Pola:
INAZWA Nazwa indeksu
JM Jm zapasu
Pola dodatkowo zdefiniowane w raporcie:
DOSTEPNE Dostępne
224->milosc-(224->uiqc+224->mrezer+224->frezer+224->wrezer+224->rezmag+224->prezer)
PLANZAKU Planowany zakup
MG_KsomPlanZakup(224->mag,224->indeks)
Relacje:
MG 224 INDEKS MG 229 INDEKS
5. Definicja alertu
Alerty: PM0005 Zapis KSOM do CSV
o-- Alert ------------------------------------------------------------------[X]o
| Symbol PM0005 Zapis KSOM do CSV Priorytet 0 |
| Status |
| System PM Raporty i statystyki |
| Zbiór 345 RaportyXML_Nag PM Ilość okresów 0 |
| |
| Wykonać co 0 dni 1 godz. 0 min. W godzinach 00:00 - 00:00 |
|Ująć ponownie T po 0 dn. 1 godz. 0 min. |
...
o-- Alert. Definicja raportu -----------------------------------------------[X]o
| Temat Zapis KSOM do CSV |
o- Nagłówek -------------------------------------------------------------------o
|ţRaport{@SYMBOL} |
| |
...
o-- Warunek [RaportyXML_Nag PM] ----------------------------------------[X]o
| [Symbol raportu] jest = 'MG0002' |
| |
...