Field Service

Zlecenia u klienta

MarketplaceOperacjeWersja 0.1.0manifest

Do czego służy ​

Schedule on-site jobs for customers: who does the work, where, when, which parts were used and whether the customer must sign off. Site addresses and contacts are personal data and treated as such.

Co pakiet robi, a czego nie robi ​

On-site jobs for customers, done by a technician: scheduled, en route, in progress, done or cancelled. A job records the customer, the site, the technician, the planned day and start (minutes since midnight), the parts used and whether the customer must sign off. Site address and contact details are personal data. Needs the Human Resources and Products packages.

Modele ​

field_service_job ​

An on-site job for a customer

Grupa odczytu: field_service.user. Grupa zapisu: field_service.user.

PoleRodzajKlasa danychDane osoboweGrupaAgenci widząOpis
nametextnoneniefield_service.userjawnieShort title of the job, for example Replace boiler pump
customer_idref → partynoneniefield_service.userjawnieThe customer the job is for
site_nametextnoneniefield_service.userjawnieName of the site, for example Main warehouse
site_addresslongtextinternaltakfield_service.userzamaskowaneStreet address where the work is done; often a person's home
site_citytextinternaltakfield_service.userzamaskowaneCity of the site
site_postcodetextinternaltakfield_service.userzamaskowanePostcode of the site
site_countrytextnoneniefield_service.userjawnieCountry of the site
site_contact_nametextinternaltakfield_service.userzamaskowaneName of the person to meet on site
site_contact_phonetextinternaltakfield_service.userzamaskowanePhone number of the person to meet on site
technician_idref → hr_employeeinternaltakfield_service.userzamaskowaneTechnician assigned to the job
priorityselect (low, normal, high, urgent)noneniefield_service.userjawnieHow urgent the job is: low, normal, high, urgent
descriptionlongtextnoneniefield_service.userjawnieWhat has to be done and what the customer reported
scheduled_ondatenoneniefield_service.userjawniePlanned day of the visit (YYYY-MM-DD)
scheduled_start_minutenumbernoneniefield_service.userjawniePlanned start in minutes since midnight (540 is 09:00)
planned_minutesnumbernoneniefield_service.userjawniePlanned duration in minutes
signature_requiredboolnoneniefield_service.userjawnieWhether the customer has to sign off the work before it counts as done
signed_bytextinternaltakfield_service.userzamaskowaneName of the person who signed off the work
signed_ondatenoneniefield_service.userjawnieDay the customer signed off (YYYY-MM-DD)
work_reportlongtextnoneniefield_service.userjawnieWhat was done, written by the technician
stateselect (scheduled, en_route, in_progress, done, cancelled)noneniefield_service.userjawnieJob status: scheduled, en_route, in_progress, done, cancelled

field_service_part ​

A part or product used on a job

Grupa odczytu: field_service.user. Grupa zapisu: field_service.user.

PoleRodzajKlasa danychDane osoboweGrupaAgenci widząOpis
job_idref → field_service_jobnoneniefield_service.userjawnieThe job the part was used on
product_idref → productnoneniefield_service.userjawnieThe product that was used
quantitynumbernoneniefield_service.userjawnieHow many units were used
unit_pricemoneynoneniefield_service.userjawniePrice per unit charged to the customer (minor currency units, e.g. cents)
notetextnoneniefield_service.userjawnieRemark about the part, for example serial number

Przepływy pracy ​

field_service_job ​

AkcjaPrzenosiKto może uruchomićZatwierdzenie
field_service_job.departstate: scheduled → en_routefield_service.usernie
field_service_job.startstate: en_route → in_progressfield_service.usernie
field_service_job.completestate: in_progress → donefield_service.usernie
field_service_job.cancelstate: scheduled → cancelledfield_service.managernie

Grupy uprawnień ​

Grupy używane przez tę aplikację:

  • field_service.manager
  • field_service.user

Kroki zatwierdzania ​

Żaden krok w tej aplikacji nie wymaga zatwierdzenia, poza usuwaniem rekordów.

Co agenci mogą, a czego nie mogą ​

Agent może odczytywać, wyszukiwać, tworzyć i aktualizować rekordy tej aplikacji oraz uruchamiać akcje niewymagające zatwierdzenia, w ramach grup uprawnień swojego tokenu.

Te kroki może tylko zaproponować, a człowiek musi je zatwierdzić: field_service_job.delete, field_service_part.delete.

Dane osobowe są maskowane jako tokeny zastępcze: field_service_job.site_address, field_service_job.site_city, field_service_job.site_postcode, field_service_job.site_contact_name, field_service_job.site_contact_phone, field_service_job.technician_id, field_service_job.signed_by.

Zależności ​

  • base
  • product
  • hr

Instalacja ​

Zainstaluj ją w aplikacji Customize (Marketplace) lub z wiersza poleceń:

bash
obop modules install-from field_service

Wymaga bazy danych i uprawnień administratora.

Zbuduj własną ​

Przewodnik po modułach pokazuje, jak pisze się takie aplikacje