Serwis

Raporty serwisowe

Raport zdarzeń serwisowych

Raport zdarzeń serwisowych jest raportem ogólnym wyświetlającym listę zdarzeń serwisowych.

  • Nazwa oryginalna pliku: ServiceEvents.java

  • UUID raportu: c9b17ea9-da41-4aaa-9772-053e369bc2d5

  • Plikiem wejściowym do aplikacji jest plik z rozszerzeniem jasper.

Konfiguracja wejściowa raportu

String productUuid - UUID produktu, dla którego zgłoszone są zdarzenia String elementGroupUuid - UUID grupy elementów String elementUuid - UUID elementu String userUuid - UUID użytkownika, który zgłosił String typeUuidList - Lista UUID typu zdarzenia serwisowego. Separator PIPE (|) String stateUuidList - Lista UUID stanu zdarzenia serwisowego. Separator PIPE (|) String elementTypeUuid - UUID typu elementów DateFields dateFields - ALL, TODAY, YESTERDAY, TOMORROW, THIS_WEEK, LAST_WEEK, NEXT_WEEK, THIS_MONTH, LAST_MONTH, THIS_YEAR, LAST_YEAR - selektor dat boolean specificDate - czy zdefiniowana określona data utworzenia zdarzeń Date dateFrom - określona data Od Date dateTo - określona data Do String limitToName - NONE, ONLY_PRODUCT_EVENTS, ONLY_ELEMENT_EVENTS - limit tylko do zdarzeń określonego źródła (produkty, elementy) boolean children - pokazuj zdarzenia obiektu (np. produkt) oraz zgłoszenia podrzędne

Pola

Pola dla pojedynczego rekordu zgłoszenia serwisowego są takie same jak dla raportu szczegółów zgłoszenia serwisowego. Odnieś się do dokumentacji tego raportu po szczegóły.

Zmienne

nazwa opis typ

groupingByName

pozwala na ograniczenie wyświetlanych danych poprzez użycie filtru "Użytkownik"

string

Źródło danych

Brak dodatkowych danych.

Raport notatek serwisowych

Raport notatek serwisowych jest raportem ogólnym wyświetlającym listę notatek serwisowych sporządzonych przez danego użytkownika.

  • Nazwa oryginalna pliku: ServiceNotes.java

  • UUID raportu: f317d96d-3564-484f-9279-3ea6819902ad

  • Plikiem wejściowym do aplikacji jest plik z rozszerzeniem jasper.

Konfiguracja wejściowa raportu

  • String userUuid - UUID użytkownika, który utworzył notatkę

  • String type - TEXT, SPEECH, AUDIO, PHOTO, BINARY - typ pliku

  • String locationUuid - UUID lokalizacji

  • String mobileUuid - UUID urządzenia mobilnego, z którego zgłoszono zdarzenie

  • String description - treść opisu zdarzenia

  • DateFields dateFields - ALL, TODAY, YESTERDAY, TOMORROW, THIS_WEEK, LAST_WEEK, NEXT_WEEK, THIS_MONTH, LAST_MONTH, THIS_YEAR, LAST_YEAR - selektor dat

  • boolean specificDate - czy zdefiniowana określona data utworzenia zdarzeń

  • Date dateFrom - określona data Od

  • Date dateTo - określona data Do

Pola

nazwa opis typ

date

wyświetla datę utworzenia notatki serwisowej

date

type

pokazuje jakiego typu jest notatka

string

user

pokazuje przez kogo notatka została utworzona

string

location

wyświetla informacje na temat gdzie została utworzona notatka serwisowa

string

device

wyświetla informacje na temat z jakiego urządzenia została sporządzona notatka

string

text

wyświetla podsumowanie (komentarz) użytkownika

string

Zmiennne

nazwa opis typ

imgNoteType

pozwala na ograniczenie wyświetlanych danych poprzez użycie filtru "Typ"

image

groupingByName

pozwala na ograniczenie wyświetlanych danych poprzez użycie filtru "Użytkownik"

string

Źródło danych

Brak dodatkowych danych.

Szczegółowy raport zdarzenia serwisowego

Szczegółowy raport zdarzenia serwisowego jest raportem ogólnym wyświetlający szczegółowe informacje na temat zdarzenia serwisowego. Raport jest możliwy do wygenerowania tylko po utworzeniu zdarzenia serwisowego. W skład raportu wchodzą podraporty: notatki,komentarze,załączniki.

  • Nazwa oryginalna pliku: ServiceEventDetail.java

  • UUID raportu: ca24bdb9-d02a-44a6-962a-658388157a43

  • Plikiem wejściowym do aplikacji jest plik z rozszerzeniem jasper.

Konfiguracja wejściowa raportu

  • String serviceEventUuid - UUID zdarzenia serwisowego

Pola

nazwa opis typ

concerns

wyświetla tekst czego dotyczy zdarzenie serwisowe

string

number

wyświetla numer zdarzenia serwisowego

long

type

pokazuje typ zdarzenia serwisowego

string

state

wyświetla stan zdarzenia serwisowego

string

created, date

wyświetla datę utworzenia zdarzenia serwisowego

date

lastChange

wyświetla datę ostatniej zmiany

date

submitter

wyświetla nazwę użytkownika zgłaszającego

string

submitter_position

Stanowisko osoby zgłaszającej

string

device

Pokazuje nazwę urządzenia jeżeli zdarzenie serwisowe zostało utworzone na urządzeniu mobilnym

string

product

wyświetla nazwę produktu, do którego zostało przypisane zdarzenie serwisowe

string

element

wyświetla nazwę elementu

string

element_type

wyświetla typ elementu

string

elementgroup

wyświetla nazwę grupy elementu

string

elementgroup_type

wyświetla typ grupy elementu

string

identifier

wyświetla identyfikator, który był odczytany przy tworzeniu zdarzenia

string

location

wyświetla lokalizacje przypisaną do zdarzenia serwisowego

string

ds_comments

obiekt datasource, zawiera informacje (dane) podraportu, które mają być wyświetlane w raporcie głównym

object

ds_notes

obiekt datasource, zawiera informacje (dane) podraportu, które mają być wyświetlane w raporcie głównym

object

ds_attachments

obiekt datasource, zawiera informacje (dane) podraportu, które mają być wyświetlane w raporcie głównym

object

ds_serviceitemexpenditures

obiekt datasource, zawiera informacje (dane) podraportu, o usługach dopiętych do zgłoszenia

object

ds_warehouseexpenditures

obiekt datasource, zawiera informacje (dane) podraportu, o pobraniach z magazynu dopiętych do zgłoszenia

object

notes_img

Ikona typu check, jeśli zgłoszenie posiada notatki serwisowe

java.awt.Image

description

wyświetla opis, komentarz użytkownika do zdarzenia serwisowego

string

product_type

wyświetla typ produktu

string

assigned

pokazuje użytkownika przypisanego do aktualnego zdarzenia serwisowego

string

assigned_position

stanowisko osoby przypisanej

string

resolution_date

wyświetla datę rozwiązania zdarzenia serwisowego

date

object_type

nazwa typu obiektu

string

object_type_order_number

nazwa numeru zamówieniowego obiektu

string

object_date_of_production

data produkcji

date

object_date_of_commisioning

data wdrożenia

date

object_serial_number

numer seryjny

string

object_location_merged

drzewo lokalizacji <root> - <lok1> - <lok2> …​

string

contract

Numer umowy/kontraktu

string

protocol_number

numer protokołu z wykorzystaniem licznika zgłoszeń

string

customer_name

nazwa klienta

string

customer_address

adres <ulica, kod pocztowy, miasto>

string

customer_tax_number

numer podatkowy <NIP>

string

customer_contact_name

nazwa zgłaszającego

string

customer_representative_name

nazwa osoby odpowiedzialnej ze strony klienta

string

customer_contact_phone

telefon zgłaszającego

string

customer_order_number

numer zlecenia klienta

string

internal_order_number

wewnętrzny numer zamówienia

string

event_source

źródło zgłoszenia

string

img_type

obraz (ikona) wybranego typu zdarzenia serwisowego

java.awt.Image

img_state

obraz (ikona) aktualnego stanu zdarzenia serwisowego

java.awt.Image

inventory_object

zwraca nazwę obiektu inwentaryzacji spiętego ze zgłoszeniem

string

public_access

czy zdarzenie jest publiczne (dostępne przez portal)

boolean

serviceitem_total_cost

Suma kosztów usług

BigDecimal

warehouse_total_cost

Suma kosztów materiałów pobranych z magazynu

BigDecimal

notes_count

liczba notatek

Integer

root_product_name

nazwa nadrzędnego produktu, obiektu do którego należy zdarzenie

String

parameter_*

Dowolny parametr. Nazwa parametru musi być umieszczona dokładnie tak jak jest w danym typie obiektu. Wyszukiwanie we wszystkich obiektach nadrzednych na ścieżce Element → Grupa Elementów → Produkt

string

person_state_*

Dostarcza informację o ostatniej osobie (imię i nazwisko), która zmieniła stan na podany w parametrze. Nazwa stanu musi być dokładnie taka jak ustalone w definicjach słownikowych systemu

string

date_state_*

Dostarcza informację o ostatniej dacie zmiany stanu na podany w parametrze. Nazwa stanu musi być dokładnie taka jak ustalone w definicjach słownikowych systemu

date

serviceitem_total_cost_<CODE>

Koszt (ilość * wartość) wszystkich usług o kodzie <CODE>

BigDecimal

serviceitem_total_count_<CODE>

Ilość wszystkich usług o kodzie <CODE>

BigDecimal

Zmienne

nazwa opis typ

imgSignatureWorker

obraz podpisu wykonującego prace z komentarzy do zdarzenia

java.awt.Image

imgSignatureChecker

obraz podpisu sprawdzającego prace z komentarzy do zdarzenia

java.awt.Image

imgSignatureContractor

obraz podpisu klienta z komentarzy do zdarzenia

java.awt.Image

Źródło danych

Brak dodatkowych danych.

Podraporty

Załączniki
nazwa opis typ

filetype

wyświetla typ załączanego pliku

string

filename

wyświetla nazwę pliku

string

filesize

pokazuje rozmiar pliku w bajtach

long

date

wyświetla datę załączenia pliku

date
Komentarze
nazwa opis typ

timestamp

data utworzenia komentarza

date

user

pokazuję nazwę użytkownika,przez którego został dodany komentarz

string

message

wyświetla treść komentarza

string

public

czy dany komentarz jest publiczny

boolean
Notatki

Podraport notatki zawiera swój podraport "załączniki do notatek", który pobiera wszystkie załączniki umieszczone w tej notatce.

nazwa opis typ

noteType

wyświetla typ notatki serwisowej

string

date

pokazuje datę utworzenia notatki serwisowej

date

user

wyświetla nazwę użytkownika, przez którego została utworzona notatka serwisowa

string

attachmentCount

wyświetla ilość dołączanych załączników do notatki serwisowej

integer

ds_attachments

pokazuje zawartość pod-raportu "załączniki do notatek"

object
Załączniki do notatek
nazwa opis typ

filetype

wyświetla typ załączanego pliku

string

filename

wyświetla nazwę pliku

string

filesize

pokazuje rozmiar pliku w bajtach

long

date

wyświetla datę załączenia pliku

date
Zrealizowane usługi
nazwa opis typ

name

nazwa usługi

string

code

kod usługi

string

type

typ usługi

string

unit_price

cena jednostkowa usługi

BigDecimal

item_count

ilość

BigDecimal

item_price

cena wprowadzona usługi

BigDecimal

supplier

dostawca

string

document

dokument

string

description

opis

string
Pobrania z magazynu
nazwa opis typ

manufacturer

producent elementu

string

name

nazwa elementu

string

item_order_number

Numer zamówieniowy typu

string

item_warehouse_index

Indeks magazynowy

string

state

stan elementu (rozliczone, nie rozliczone)

string

unit_price

cen jednostkowa

BigDecimal

item_count

ilość pobrana

BigDecimal

item_unit

jednostka miary

string

Raport różnic w czasie raportowania

Raport pozwala na wyświetlenie różnic w czasie pomiędzy raportowaniem poszczególnych stanów.

  • Nazwa oryginalna pliku: ServiceEventsTimeDiff.jasper

  • UUID raportu: 29c33c90-c1bc-4e5e-98d2-03f010e4cdff

  • Plikiem wejściowym do aplikacji jest plik z rozszerzeniem jasper.

Konfiguracja wejściowa raportu

  • String stateStartUuid - UUID początkowego stanu zdarzenia serwisowego

  • String stateEndUuid - UUID końcowego stanu zdarzenia serwisowego

  • boolean specificDate - czy zdefiniowana określona data

  • Date dateFrom - określona data Od

  • Date dateTo - określona data Do

Pola

nazwa opis typ

number

numer zdarzenia

long

concerns

którego zasobu zdarzenie dotyczy

string

date_start

data pierwszego zdarzenia

date

date_end

data drugiego zdarzenia

date

duration

różnica czasów

Duration

duration_text

tekstowo różnica czasów w formie HHH:mm:SS

string

duration_sum

suma czasów tekstowo w formie HHH:mm:SS

string

duration_avg

średnia czasów w formacie HHH:mm:SS

string

Zmienne

Brak.

Źródło danych

Brak dodatkowych danych.

Raport protokołu serwisowego

Raport protokołu serwisowego. Raport dla pojedynczego rekordu protokołu. Generowany na żądane użytkownika lub przez systemy automatyczne. Parametrem wejściowym jest obiekt protokołu serwisowego.

  • Nazwa oryginalna pliku: ServiceProtocolDocument.java

  • UUID raportu: 702d6c40-c44b-4721-b8a1-82a197a6dddb

  • Plikiem wejściowym do aplikacji jest plik z rozszerzeniem jasper.

Konfiguracja wejściowa raportu

boolean hideWarehouseExpenditure - ukryj sekcję wydań z magazynu boolean hideServiceItemExpenditure - ukryj sekcję wykonanych usług boolean hideParticipants - ukryj sekcję uczestników prac serwisowych UUID serviceProtocolUuid - UUID protokołu serwisowego do wyświetlenia

Pola

nazwa opis typ

customer_name

Nazwa klienta

string

customer_place

Lokalizacja klienta

string

customer_contact_name

Imię i nazwisko osoby kontaktowej (reprezentant)

string

customer_contact_phone

Telefon do osoby kontaktowej (reprezentant)

string

customer_additional_info

Opis w polu klienta

string

service_reporter_name

Imię i nazwisko osoby raportującej (zgłaszającej)

string

service_event_type

Typ zgłoszenia serwisowego

string

service_time_registered

Czy czas jest rejestrowany

boolean

service_start_hour

Data rozpoczęcia usługi

date

service_end_hour

Data zakończenia usługi

date

service_contract_number

Numer kontraktu

string

service_order_number

Numer zamówienia

string

service_event_source

Źródło zgłoszenia serwisowego

string

product_name

Nazwa produktu

string

product_serial_number

Numer seryjny produktu

string

product_info

Notatka z produktu

string

element_name

Nazwa elementu

string

element_info

Notatka z elementu

string

element_serial_number

Numer seryjny elementu

string

protocol_number

numer protokołu serwisowego

string

protocol_text

tekst - opis - protokołu serwisowego

string

created_by

Imię i nazwisko osoby tworzącej protokół

string

created_by_position

Stanowisko osoby tworzącej protokół

string

accepted_by

Imię i nazwisko osoby kontaktowej (reprezentant) a jeśli nie ma to osoby raportującej (zgłaszającej)

string

tstamp

Data utworzenia protokołu

date

protocol_part_status_taken

Flaga - części zabrane

boolean

protocol_part_status_left

Flaga - części pozostawione

boolean

protocol_part_status_notapplicable

Flaga - N/D

boolean

protocol_service_type_warranty

Flaga - gwarancja

boolean

protocol_service_type_post_warranty

Flaga - pogwarancyjne

boolean

protocol_service_type_cooperative

Flaga - współpraca

boolean

protocol_service_type_paid

Flaga - płatne

boolean

protocol_service_type_free

Flaga - bezpłatne

boolean

dangerous_situation

Niebezpieczna sytuacja

boolean

dangerous_situation_text

Opis niebezpiecznej sytuacji

string

executed_correctly

Wykonane poprawnie

boolean

cost_type_direct

Koszty wprowadzane bezpośrednio

boolean

cost_type_byagreement

Koszty zgodnie z ustaleniami (umową)

boolean

cost_type_todetermine

Koszty do ustalenia (później)

boolean

manhour_count

Ilość roboczogodzin

BigDecimal

manhour_unit_cost

Cena za rbh

BigDecimal

parts_cost

Cena za części

BigDecimal

drive_length

Długość jazdy

BigDecimal

drive_length_unit_cost

Cena za jednostkę jazdy

BigDecimal

ds_participants

DataSource dla uczestników (j/n)

object

ds_warehouseexpenditure

DataSource dla wydań z magazynu (j/n)

object

ds_serviceitemexpenditure

DataSource dla usług (j/n)

object

Zmiennne

nazwa opis typ

imgSignatureCreatedBy

Podpis osoby tworzącej protokół

image

imgSignatureAcceptedBy

Podpis osoby akceptującej protokół

image

Źródło danych

Brak

Podraporty

Uczestnicy

Źródło danych ds_participants

nazwa opis typ

first_name

Imię

string

last_name

Nazwisko

string

login

Login

string

position

Stanowisko

string

email

Email

string

phone

Telefon

string

contractor_name

Nazwa kontrahenta przypisanego do pracownika

string
Zużycie materiałowe

Źródło danych ds_warehouseexpenditure

nazwa opis typ

timestamp

Data & Czas wydania elementu

string

user

Użytkownik pobierający

string

item_type

Typ elementu

string

item_order_number

Numer zamówieniowy typu

string

item_warehouse_index

Indeks magazynowy

string

item_manufacturer

Producent elementu

string

item_count

Ilość pobrana

BigDecimal

item_unit_price

Cena jednostkowa

BigDecimal

item_settled

Czy rozliczone dokumentem magazynowym

boolean

serial_numbers

Numery seryjne

string
Usługi

Źródło danych ds_serviceitemexpenditure

nazwa opis typ

name

nazwa usługi

string

is_enumerated

czy usługa wyliczeniowa

boolean

is_descriptive

czy usługa opisowa

boolean

code

kod usługi

string

description

opis usługi

string

item_unit

jednostka

string

item_unit_price

cena jednostkowa

BigDecimal

item_count

ilość

BigDecimal

timestamp

Data & czas utworzenia

string

user_fullname

imię i nazwisko osoby tworzącej zapis

string

item_price

cena usługi

BigDecimal

supplier

dostawca

string

document

dokument

string

item_description

opis

string