Field Service

Uppdrag på plats

MarknadsplatsVerksamhetVersion 0.1.0manifest

Vad den är till för ​

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.

Vad paketet gör och inte gör ​

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.

Modeller ​

field_service_job ​

An on-site job for a customer

Läsgrupp: field_service.user. Skrivgrupp: field_service.user.

FältTypDataklassPersonuppgiftGruppAgenter serBeskrivning
nametextnonenejfield_service.useri klartextShort title of the job, for example Replace boiler pump
customer_idref → partynonenejfield_service.useri klartextThe customer the job is for
site_nametextnonenejfield_service.useri klartextName of the site, for example Main warehouse
site_addresslongtextinternaljafield_service.usermaskeradStreet address where the work is done; often a person's home
site_citytextinternaljafield_service.usermaskeradCity of the site
site_postcodetextinternaljafield_service.usermaskeradPostcode of the site
site_countrytextnonenejfield_service.useri klartextCountry of the site
site_contact_nametextinternaljafield_service.usermaskeradName of the person to meet on site
site_contact_phonetextinternaljafield_service.usermaskeradPhone number of the person to meet on site
technician_idref → hr_employeeinternaljafield_service.usermaskeradTechnician assigned to the job
priorityselect (low, normal, high, urgent)nonenejfield_service.useri klartextHow urgent the job is: low, normal, high, urgent
descriptionlongtextnonenejfield_service.useri klartextWhat has to be done and what the customer reported
scheduled_ondatenonenejfield_service.useri klartextPlanned day of the visit (YYYY-MM-DD)
scheduled_start_minutenumbernonenejfield_service.useri klartextPlanned start in minutes since midnight (540 is 09:00)
planned_minutesnumbernonenejfield_service.useri klartextPlanned duration in minutes
signature_requiredboolnonenejfield_service.useri klartextWhether the customer has to sign off the work before it counts as done
signed_bytextinternaljafield_service.usermaskeradName of the person who signed off the work
signed_ondatenonenejfield_service.useri klartextDay the customer signed off (YYYY-MM-DD)
work_reportlongtextnonenejfield_service.useri klartextWhat was done, written by the technician
stateselect (scheduled, en_route, in_progress, done, cancelled)nonenejfield_service.useri klartextJob status: scheduled, en_route, in_progress, done, cancelled

field_service_part ​

A part or product used on a job

Läsgrupp: field_service.user. Skrivgrupp: field_service.user.

FältTypDataklassPersonuppgiftGruppAgenter serBeskrivning
job_idref → field_service_jobnonenejfield_service.useri klartextThe job the part was used on
product_idref → productnonenejfield_service.useri klartextThe product that was used
quantitynumbernonenejfield_service.useri klartextHow many units were used
unit_pricemoneynonenejfield_service.useri klartextPrice per unit charged to the customer (minor currency units, e.g. cents)
notetextnonenejfield_service.useri klartextRemark about the part, for example serial number

Arbetsflöden ​

field_service_job ​

ÅtgärdFlyttarVem får köra denGodkännande
field_service_job.departstate: scheduled → en_routefield_service.usernej
field_service_job.startstate: en_route → in_progressfield_service.usernej
field_service_job.completestate: in_progress → donefield_service.usernej
field_service_job.cancelstate: scheduled → cancelledfield_service.managernej

Behörighetsgrupper ​

Grupper som den här appen använder:

  • field_service.manager
  • field_service.user

Steg som kräver godkännande ​

Inget steg i den här appen kräver godkännande, förutom att ta bort poster.

Vad agenter kan och inte kan göra ​

En agent kan läsa, söka, skapa och uppdatera poster i den här appen, och köra de åtgärder som inte kräver godkännande, inom behörighetsgrupperna för sin token.

Den kan bara föreslå de här stegen, och en person måste godkänna dem: field_service_job.delete, field_service_part.delete.

Personuppgifter maskeras som platshållare: 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.

Beroenden ​

  • base
  • product
  • hr

Installera ​

Installera den från appen Customize (Marknadsplats), eller från kommandoraden:

bash
obop modules install-from field_service

Kräver en databas och administratörsbehörighet.

Bygg din egen ​

Modulguiden visar hur appar som den här skrivs