Kompleksowy import danych dot. zleceń pracy

Wstęp

Dokument opisuje mechanizm importu do systemu AMAGE kompleksowych informacji określających zlecenia pracy w systemie. Dane te obejmują zarówno podstawowe informacje dotyczące zleceń ale też załączniki/dokumentację ułatwiającą realizację prac, listy materiałowe niezbędne do ich wykonania i historię wykonanych prac.

Dokument opisuje mechanizmy importu i ich wykorzystanie w celu zrealizowania pełnego importu danych do systemu pochodzącego z różnych źródeł, ale w sumie stanowiących pełną informację niezbędną do realizacji określonego celu biznesowego. Tutorial nie opisuje w szczegółach funkcji mechanizmów importera oraz poszczególnych okien. Prosimy odnieść się do instrukcji użytkownika w celu poznania podstawowego interfejsu użytkownika.

Zasada działania

Naszym celem jest zaimportowanie do systemu AMAGE danych pochodzących z różnych obszarów systemów biznesowych przedsiębiorstwa. Nazwijmy je zbiorczo systemem ERP, ale nie jest koniecznością posiadanie tych danych w jednym systemie.

Zwykle do poprawnej pracy potrzebujemy:

  • danych pracowników - pracownicy będą logować się w systemie ale też potrzebujemy danych pracowników, którzy pomimo tego, że nie logują się do systemu to jednak w jakiś sposób istnieją np. stanowią członków brygad wykonawczych z których tylko ich brygadzista ma dostęp do systemu.

  • danych elementów nadzorowanych - zasobów - są to obiekty, na których realizowane są funkcje biznesowe. Czy to są urządzenia, maszyny czy elementy konstrukcyjne to każdy z nich ma swoje dane, parametry oraz odpowiednią kategoryzację typu, producenta.

  • słowniki asortymentu/typów - mogą określać zasoby ale też mogą być wykorzystywane w modułach dotyczących zamówień, dostaw i magazynu jako elementy policzalne bez konkretnej reprezentacji jako zasoby w systemie.

  • zlecenia pracy - zlecenia, które grupują w jednostki pracy czynności do wykonania. Mogą one być powiązanie z asortymentem (co trzeba zamówić, dostarczyć) lub konkretnymi zasobami (co należy zbudować, zamontować, obsłużyć). Do tego potrzebujemy dodatkowych importów zasobów lub typów powiązanych ze zleceniami pracy - utworzą one plany materiałowe lub listy powiązanych zasobów w systemie.

  • dostawy, dokumenty magazynowe - możemy albo wykorzystać istniejące dokumenty z systemu ERP i przenosić je do systemu AMAGE w celu osiągnięcia kompletności danych lub za pomocą tego mechanizmu importować dokumenty dostaw wystawiane przez naszych podwykonawców lub dostawców.

Cały zestaw wymienionych wyżej danych pozwala na wprowadzenie znaczącej ilości informacji do systemu i korzystanie z tych danych w poszczególnych modułach dziedzinowych np. nadzoru, zgłoszeń serwisowych czy inspekcji.

Dalszym etapem automatyzacji jest włączenie opisanych wyżej importów w mechanizm integracji. System może automatycznie pobierać takie pliki z określonych źródeł (email, ftp, katalog na serwerze) i stosować określone w tym tutorialu schematy importu (szablony). Tutaj skupmy się na definicji podstawowych struktur oraz szablonów importu.

Przejdźmy przez wszystkie mechanizmy importu w kolejności opisanej powyżej.

Import użytkowników

Importujemy u↓żytkowników. Arkusz XLS/CSV posiada dane dotyczące użytkownika, login, email, nr telefonu i inne dane.

Wybieramy mechanizm importu z listy dostępnych importerów.

construction workstructure piping import b925c
Rysunek 1. Wybór importu z listy importowanej

Wybieramy plik do importu oraz jeśli już przechodziliśmy te kroki szablon mapowania, który posiadamy. Jeśli go nie mamy, to tworzymy go w kolejnych krokach.

construction workstructure piping import 3af03
Rysunek 2. Wybór pliku oraz mapowania (szablonu)

Definujemy parametry importu. Każdy importer posiada własne specyficzne parametry i zachowania. Tutaj mamy dostępne:

  • dodaj wydziały, pracodawców - automatycznie przy imporcie dodajemy/tworzymy niezbędne dodatkowe rekordy - wydziały, pracodawców itp.

  • deaktywuj brakujących pracowników - traktujemy plik importowy jako jedyne źródło danych i użytkownicy, którzy tam się nie pojawiają zostają automatycznie deaktywowani w tym systemie.

construction workstructure piping import a4a5f
Rysunek 3. Definicje importu

Następnie definiujemy pola i ich znaczenie w importowanym pliku. Tutaj też możemy zapisać wszystkie wcześniej zdefiniowane dane w szablonie pod określoną nazwą. Będziemy mogli go użyć w kolejnych importach lub w automatyzacji procesu.

construction workstructure piping import b3983
Rysunek 4. Mapowanie pól

Wykonujemy import. Pracownicy/użytkownicy znajdują się w systemie.

Import typów

Przechodzimy do importu asortymentu - typów elementów. Zwykle mamy te dane z systemu ERP, z modułu magazynowego lub zamówieniowego. Możemy też importować dane dostarczone przez naszych podwykonawców.

Wybieramy importer z listy.

construction workstructure piping import e41df
Rysunek 5. Wybór typu z listy importów

Definiujmey mapowanie pól i ich znaczenie

construction workstructure piping import a0974
Rysunek 6. Definicja mapowania pól typu

Importujemy dane. Przykładowy wynik importowanych danych z podziałem asortymentu na kategorie przedstawiony jest poniżej.

construction workstructure piping import baa84
Rysunek 7. Wynik importu z kategoriami

Przejdźmy do importu zasobów.

Import zasobów

Wybieramy importer zasobów z listy.

construction workstructure piping import 13608
Rysunek 8. Wybór zasobów z listy importów

Definiujemy dodatkowe informacje oraz parametry. UWAGA. Importer posiada rozbudowany panel parametrów i należy się odnieść do instrukcji użytkownika po dodatkowe informacje o znaczeniu poszczególnych parametrów.

construction workstructure piping import 97180
Rysunek 9. Definicje ogólne

Definiujemy mapowanie pól i ich znaczenie.

construction workstructure piping import f365a
Rysunek 10. Definicja mapowania rekordów

Importujemy dane. W widoku postępu importu otrzymujemy wizualny raport wykonywanych czynności oraz ewentualnych błędów.

construction workstructure piping import cb776
Rysunek 11. Postęp importu - zakończenie

Efektem końcowym są zaimportowane zasoby w systemie wraz z ich powiązaniem w drzewa i odpowiednią kategoryzacją z typami elementów.

construction workstructure piping import 91ef8
Rysunek 12. Wynik importu z elementami podrzędnymi

Mamy gotową strukturę danych, na których możemy wykonywać prace. Teraz zaimportujmy listę zadań do wykonania.

Zlecenia pracy

Wybieramy importer zleceń pracy z listy.

construction workstructure piping import 61477
Rysunek 13. Wybór zleceń pracy z listy importów

Określamy ogólne opcje importera.

construction workstructure piping import 0e0f3
Rysunek 14. Ogólne opcje importera

Mapujemy pola w pliku oraz określamy ich znaczenie.

construction workstructure piping import e9383
Rysunek 15. Mapowanie rekordów

Importujemy do systemu.

construction workstructure piping import 02061
Rysunek 16. Proces importu

W efekcie otrzymujemy listę zadań do wykonania wraz z podzadaniami. Zakres pól do importu jest szeroki (import harmonogramu, przydziału zadań itp.).

construction workstructure piping import 28bc5
Rysunek 17. Wynik importu zleceń pracy

Aby powiązać zadania z zaimportowanymi wcześniej typami elementów oraz zasobami potrzebujemy wykonać dwa dodatkowe importy.

Zlecenia pracy - lista planów materiałowych

Jeden plik zawiera powiązanie asortymentu (typów elementów) ze zleceniami pracy wraz z określeniem ilości danego materiału niezbędnego do wykonania/zamówienia.

Wybieramy importer z listy.

construction workstructure piping import f4161
Rysunek 18. Opcje importu planów

Wybieramy mapowanie pól w arkuszu importowanym i ich znaczenie. Głównym zadaniem jest tutaj wskazanie powiązania pomiędzy typami oraz zleceniami pracy.

construction workstructure piping import de04d
Rysunek 19. Mapowanie pól w arkuszu importowanym

Importujemy dane do systemu.

construction workstructure piping import e1f71
Rysunek 20. Proces importu ze szczegółami danych

W efekcie otrzymujemy w zleceniu pracy listę materiałów a planie materiałowym. Z tego miejsca będziemy mogli je zamówić lub wygenerować zlecenie do magazynu do wydania.

construction workstructure piping import f0055
Rysunek 21. Widok planu w zleceniu pracy

Zlecenia pracy - powiązane zasoby

Drugim powiązaniem jest połączenie zasobów ze zleceniami pracy. Wykonujemy podobne działania.

construction workstructure piping import 2da37
Rysunek 22. Wybór importu z listy importów
construction workstructure piping import bf7a0
Rysunek 23. Mapowanie pól
construction workstructure piping import aff83
Rysunek 24. Postęp importu

W wyniku tych operacji otrzymujemy informację o powiązanych zasobach ze zleceniem pracy. Na podstawie tych danych będzie można prowadzić dalsze automatyzacje lub szybko nawigować pomiędzy zadaniem do wykonania a danymi zasobu (parametry, dokumentacja), który należy wykonać.

construction workstructure piping import 0a7c0
Rysunek 25. Wynik powiązanych zasobów w zleceniu pracy

Załączniki dla zleceń pracy/zasobów

W procesie, który opisujemy często powstaje dodatkowa dokumentacja, która jest bardzo przydatna w trakcie wykonywanych prac. Pozwala na to importer załączników. W odróżnieniu od poprzednich importerów działa on na archiwum ZIP zawierającym pliki oraz arkusz XLS, który zawiera informację do jakich zasobów/zleceń pracy należy dany dokument dołączyć.

Aby wykonać taki importer tworzymy:

  • archiwum zip z wszystkimi plikami (mogą być w podkatalogach) oraz jednym plikiem xls o nazwie import.xls(x)

  • plik import.xlsx zawiera informacje o ścieżce i nazwie pliku oraz informacji o zasobie lub zleceniu pracy, do którego łączymy dany plik.

Takie archiwum wczytujemy do systemu.

należy zwrócić uwagę na rozmiar takiego archiwum. Zaleca się nie przekraczanie 100MB na plik archwum. Jeśli trzeba zaimportować większą liczbę plików należy podzielić je na kilka importów.
construction workstructure piping import a96e0
Rysunek 26. Wybór pliku ZIP oraz szablonu mapowania pól

Definiujemy mapowanie pomiędzy plikiem a zasobem lub innym obiektem obsługiwanym przez ten importer.

construction workstructure piping import 6a6a8
Rysunek 27. Definicja pól

Wykonujemy import.

construction workstructure piping import 159b8
Rysunek 28. Import danych zakończonych sukcesem

W efekcie w określonych zasobach pojawiają się załączniki z możliwością ich przeglądania i pobrania.

construction workstructure piping import 172cf
Rysunek 29. Wynik - lista załączników w strukturze zasobu

Zamówienia

Ostatnim krokiem opisywanym w tym samouczku jest import danych dotyczących zamówień/dostaw. Wykorzystujemy mechanizm importu zamówień.

Wybieramy importer zamóweń.

construction workstructure piping import 1ad24
Rysunek 30. Lista importerów - wybór importu zamówień

Definiujemy mapowanie poszczególnych pól i wykonujemy import.

construction workstructure piping import acfae
Rysunek 31. Mapowanie importu zamówień

W efekcie końcowym otrzymujemy zaimportowane zlecenia dostaw ze szczegółami materiałów.

Dostawy

Importujemy dostawy. Tożsame z pozostałymi operacjami. Wybieramy importer dostaw.

construction workstructure piping import 5df12
Rysunek 32. Lista importerów - wybór importu dostaw

Definiujemy pola i ich znaczenie i wykonujemy import.

construction workstructure piping import bf75b
Rysunek 33. Mapowanie importu dostaw

W systemie pojawiają się dostawy. Możemy za pomocą modułu dostaw zweryfikować ich kompletność, utworzyć reklamacje lub przenieść materiał na magazyny.

Podsumowanie

W taki sposób zaimportowaliśmy znaczny zakres danych z obszaru zamówień, dostaw, struktury danych oraz zleceń pracy. Podzieliliśmy importy na poszczególne etapy i wykorzystaliśmy dostępne funkcje importerów aby dostosować się do posiadanych plików XLS/CSV z danymi. Możemy teraz korzystać z tych danych w systemie.

Kolejnymi krokami może być również dalsza automatyzacja. W trakcie definicji tych importów zapisywaliśmy poszczególne szablony. Teraz możemy włączyć integrację np. przez email i ustawić system, tak gdy przyjdzie plik XLS z dostawą automatycznie pobrać go do systemu i zaimportować względem szablonu dla danego dostawcy. Możliwości są nieograniczone :)

Howto powstało na bazie wersji systemu 1.17.0.15 (08.2022) oraz przedstawia funkcje, które mogą nie być dostępne w Twoim systemie. Zapytaj AMAGE o udostępnienie tej funkcjonalności.
Ze względu na ciągły rozwój systemu niektóre ekrany lub pliki konfiguracji mogą wyglądać nieznacznie inaczej, ale zachowają nadal pełną funkcjonalność tutaj opisaną. Nie wpływa to na zasadnicze funkcje opisywane w tym dokumencie.