Field Service

Trabajos en el sitio

MarketplaceOperacionesVersión 0.1.0manifest

Para qué sirve ​

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.

Qué hace y qué no hace el paquete ​

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.

Modelos ​

field_service_job ​

An on-site job for a customer

Grupo de lectura: field_service.user. Grupo de escritura: field_service.user.

CampoTipoClase de datosDatos personalesGrupoLos agentes venDescripción
nametextnonenofield_service.useren claroShort title of the job, for example Replace boiler pump
customer_idref → partynonenofield_service.useren claroThe customer the job is for
site_nametextnonenofield_service.useren claroName of the site, for example Main warehouse
site_addresslongtextinternalsífield_service.userenmascaradoStreet address where the work is done; often a person's home
site_citytextinternalsífield_service.userenmascaradoCity of the site
site_postcodetextinternalsífield_service.userenmascaradoPostcode of the site
site_countrytextnonenofield_service.useren claroCountry of the site
site_contact_nametextinternalsífield_service.userenmascaradoName of the person to meet on site
site_contact_phonetextinternalsífield_service.userenmascaradoPhone number of the person to meet on site
technician_idref → hr_employeeinternalsífield_service.userenmascaradoTechnician assigned to the job
priorityselect (low, normal, high, urgent)nonenofield_service.useren claroHow urgent the job is: low, normal, high, urgent
descriptionlongtextnonenofield_service.useren claroWhat has to be done and what the customer reported
scheduled_ondatenonenofield_service.useren claroPlanned day of the visit (YYYY-MM-DD)
scheduled_start_minutenumbernonenofield_service.useren claroPlanned start in minutes since midnight (540 is 09:00)
planned_minutesnumbernonenofield_service.useren claroPlanned duration in minutes
signature_requiredboolnonenofield_service.useren claroWhether the customer has to sign off the work before it counts as done
signed_bytextinternalsífield_service.userenmascaradoName of the person who signed off the work
signed_ondatenonenofield_service.useren claroDay the customer signed off (YYYY-MM-DD)
work_reportlongtextnonenofield_service.useren claroWhat was done, written by the technician
stateselect (scheduled, en_route, in_progress, done, cancelled)nonenofield_service.useren claroJob status: scheduled, en_route, in_progress, done, cancelled

field_service_part ​

A part or product used on a job

Grupo de lectura: field_service.user. Grupo de escritura: field_service.user.

CampoTipoClase de datosDatos personalesGrupoLos agentes venDescripción
job_idref → field_service_jobnonenofield_service.useren claroThe job the part was used on
product_idref → productnonenofield_service.useren claroThe product that was used
quantitynumbernonenofield_service.useren claroHow many units were used
unit_pricemoneynonenofield_service.useren claroPrice per unit charged to the customer (minor currency units, e.g. cents)
notetextnonenofield_service.useren claroRemark about the part, for example serial number

Flujos de trabajo ​

field_service_job ​

AcciónMueveQuién puede ejecutarlaAprobación
field_service_job.departstate: scheduled → en_routefield_service.userno
field_service_job.startstate: en_route → in_progressfield_service.userno
field_service_job.completestate: in_progress → donefield_service.userno
field_service_job.cancelstate: scheduled → cancelledfield_service.managerno

Grupos de permisos ​

Grupos que usa esta aplicación:

  • field_service.manager
  • field_service.user

Pasos con aprobación ​

Ningún paso de esta aplicación requiere aprobación, salvo eliminar registros.

Qué pueden y qué no pueden hacer los agentes ​

Un agente puede leer, buscar, crear y actualizar registros de esta aplicación, y ejecutar las acciones que no requieren aprobación, dentro de los grupos de permisos de su token.

Solo puede proponer estos pasos, y una persona debe aprobarlos: field_service_job.delete, field_service_part.delete.

Los datos personales se enmascaran como tokens marcadores: 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.

Dependencias ​

  • base
  • product
  • hr

Instalación ​

Instálala desde la aplicación Customize (Marketplace) o desde la línea de comandos:

bash
obop modules install-from field_service

Requiere una base de datos y derechos de administrador.

Crea la tuya ​

La guía de módulos explica cómo se escriben aplicaciones como esta