Document toolboxDocument toolbox

14.1 sp111_jobs

This table contains the top level details of a requirement for an employee to visit a customer site to perform some job. This job may be either an appointment or a fault fixing activity. The lower level details of the requirement are contained in the job_locations, job_details, job skills and job_equipment tables. 

HouseKeeping

This table is tidied by sp_dbtidy's Job group


 

Table Definition

Field
Type
Default
Nullable
job_nonumber(9) (error)
job_refvarchar2(50) (error)
creation_datedatesysdate(tick)
bkg_location_nonumber(2) (error)
job_typenumber(2) (error)
customer_refvarchar2(30) (tick)
customer_namevarchar2(50) (tick)
address1varchar2(50) (tick)
address2varchar2(50) (tick)
address3varchar2(50) (tick)
address4varchar2(50) (tick)
postcodevarchar2(30) (error)
phone1varchar2(40) (tick)
phone2varchar2(40) (tick)
contact_namevarchar2(50) (tick)
prioritynumber(2) (error)
description1varchar2(500) (tick)
description2varchar2(500) (tick)
description3varchar2(500) (tick)
description4varchar2(500) (tick)
job_statusnumber(2) (error)
force_gonumber(1)0(error)
importancenumber(1) (tick)
on_holdnumber(1) (tick)
customer_group_idvarchar2(30) (tick)
site_idvarchar2(30) (tick)
delivery_sizenumber(9) (tick)
collection_sizenumber(9) (tick)
transaction_idnumber(9) (tick)
dependency_group_idvarchar2(50) (tick)
capacity_category_nonumber(9) (tick)

Keys 

primary key (job_no) 
unique (job_ref) 
foreign key (bkg_location_no) references 14.1 sp218_booking_locations (bkg_location_no) 
foreign key (job_type) references 14.1 sp105_activity_types (activity_type) 
foreign key (job_status) references 14.1 sp285_job_status (job_status) 
foreign key (capacity_category_no) references sp350_capacity_categories (capacity_category_no)

Primary Key Referenced From

 

Column Descriptions

FieldDescription
 job_no ServiceOptimizer-generated unique identifier.
 job_ref End users' unique identifier.
creation_dateThe date and time at which the record was created. Uses the time zone of the DBMS server machine.
bkg_location_noIdentifier of the location / external system from which the job details were received by ServiceOptimizer.
job_typeActivity type identifier.
customer_refCustomer reference.
customer_nameCustomer name ...
address1address ...
address2 
address3 
address4 
postcode... and postcode.
phone1Telephone number
phone2Telephone number
contact_nameA customer contact name.
priorityThe job priority. The higher the numeric value, the higher the priority, and the higher the cost of the job being late as specified in table sp313.
description1Free text description of the requirement.
description2These description fields are copied into sp100_activities.notes
description3when the job is booked. Modifications to the job's notes affect
description4sp100_activities.notes but leave these fields unchanged.
job_status

Job Status (not same as Dispatch Status):

0 - normal

1 - reserved

4 - cleared

8 - All Day Job

9 - reserved

(12 - All day cleared is not required since 'cleared' refers to a 'phone clear' in which case the cleared state replaces the all day state)

force_goA value of 1 indicates that the job should be scheduled even if spares are not available.
importanceRecords the importance assigned to the job when it was booked.
on_holdSet if the job has been marked 'on hold' to stop it being allocated automatically.
customer_group_idA customer group ID.
site_idA site group ID.
delivery_sizeis the amount of space occupied by the equipment to be removed from the employee's vehicle as part of this job.
collection_sizeis the amount of space occupied by equipment that will be loaded onto the employee's vehicle as part of this job.
transaction_idSee SP599_TRANSACTION_AUDIT for details.
dependency_group_idThe dependency group for the job (if any).
capacity_category_noCapacity Category for the job.