Field Service

Interventions sur site

Place de marchéOpérationsVersion 0.1.0manifest

À quoi elle sert ​

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.

Ce que fait et ne fait pas le paquet ​

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.

Modèles ​

field_service_job ​

An on-site job for a customer

Groupe de lecture: field_service.user. Groupe d'écriture: field_service.user.

ChampTypeClasse de donnéesDonnées personnellesGroupeVu par les agentsDescription
nametextnonenonfield_service.useren clairShort title of the job, for example Replace boiler pump
customer_idref → partynonenonfield_service.useren clairThe customer the job is for
site_nametextnonenonfield_service.useren clairName of the site, for example Main warehouse
site_addresslongtextinternalouifield_service.usermasquéStreet address where the work is done; often a person's home
site_citytextinternalouifield_service.usermasquéCity of the site
site_postcodetextinternalouifield_service.usermasquéPostcode of the site
site_countrytextnonenonfield_service.useren clairCountry of the site
site_contact_nametextinternalouifield_service.usermasquéName of the person to meet on site
site_contact_phonetextinternalouifield_service.usermasquéPhone number of the person to meet on site
technician_idref → hr_employeeinternalouifield_service.usermasquéTechnician assigned to the job
priorityselect (low, normal, high, urgent)nonenonfield_service.useren clairHow urgent the job is: low, normal, high, urgent
descriptionlongtextnonenonfield_service.useren clairWhat has to be done and what the customer reported
scheduled_ondatenonenonfield_service.useren clairPlanned day of the visit (YYYY-MM-DD)
scheduled_start_minutenumbernonenonfield_service.useren clairPlanned start in minutes since midnight (540 is 09:00)
planned_minutesnumbernonenonfield_service.useren clairPlanned duration in minutes
signature_requiredboolnonenonfield_service.useren clairWhether the customer has to sign off the work before it counts as done
signed_bytextinternalouifield_service.usermasquéName of the person who signed off the work
signed_ondatenonenonfield_service.useren clairDay the customer signed off (YYYY-MM-DD)
work_reportlongtextnonenonfield_service.useren clairWhat was done, written by the technician
stateselect (scheduled, en_route, in_progress, done, cancelled)nonenonfield_service.useren clairJob status: scheduled, en_route, in_progress, done, cancelled

field_service_part ​

A part or product used on a job

Groupe de lecture: field_service.user. Groupe d'écriture: field_service.user.

ChampTypeClasse de donnéesDonnées personnellesGroupeVu par les agentsDescription
job_idref → field_service_jobnonenonfield_service.useren clairThe job the part was used on
product_idref → productnonenonfield_service.useren clairThe product that was used
quantitynumbernonenonfield_service.useren clairHow many units were used
unit_pricemoneynonenonfield_service.useren clairPrice per unit charged to the customer (minor currency units, e.g. cents)
notetextnonenonfield_service.useren clairRemark about the part, for example serial number

Flux de travail ​

field_service_job ​

ActionTransitionQui peut l'exécuterApprobation
field_service_job.departstate: scheduled → en_routefield_service.usernon
field_service_job.startstate: en_route → in_progressfield_service.usernon
field_service_job.completestate: in_progress → donefield_service.usernon
field_service_job.cancelstate: scheduled → cancelledfield_service.managernon

Groupes de permissions ​

Groupes utilisés par cette application :

  • field_service.manager
  • field_service.user

Étapes d'approbation ​

Aucune étape de cette application ne requiert d'approbation, hormis la suppression d'enregistrements.

Ce que les agents peuvent et ne peuvent pas faire ​

Un agent peut lire, rechercher, créer et modifier les enregistrements de cette application, et exécuter les actions qui ne requièrent pas d'approbation, dans les limites des groupes de permissions de son jeton.

Il ne peut que proposer ces étapes, qu'une personne doit approuver : field_service_job.delete, field_service_part.delete.

Les données personnelles sont masquées sous forme de jetons de substitution : 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.

Dépendances ​

  • base
  • product
  • hr

Installation ​

Installez-la depuis l'application Customize (Place de marché), ou en ligne de commande :

bash
obop modules install-from field_service

Nécessite une base de données et des droits d'administrateur.

Créer la vôtre ​

Le guide des modules montre comment sont écrites les applications de ce type