Customer Model Views
The purpose of this section is to describe the views that support existing Oracle Utilities Network Management System software, and provide compatibility for this customer model with existing installations.
CES Customers View
The ces_customers view (or table) is derived from the cu_customers, cu_service_locations, cu_meters, cu_service_points, cu_ders, and supply_nodes tables. It provides a flat customer view that is utilized by various Oracle Utilities Network Management System services and applications such as JMService, Web Call Entry and others.
Note: all of the following fields are required.
Displayed Column Name
Originating Table
Column in originating table
id
cu_service_points
serv_point_id
h_cls
supply_nodes
device_cls
h_idx
supply_nodes
device_idx
supply_idx
supply_nodes
h_idx
meter_number
cu_meters
meter_no
device_id
supply_nodes
device_id
account_type
cu_service_points
account_type
account_number (not null)
cu_service_locations
serv_account_number
account_name
cu_customers
cust_name
address_building
cu_service_locations
serv_str_struc
block
cu_service_locations
serv_str_block
address
cu_service_locations
serv_concat_address
city_state
cu_service_locations
serv_city_state
zip_code
cu_service_locations
serv_postcode_1
phone_area
cu_customers
cust_day_ac
phone_number
cu_customers
cust_day_phone
priority
cu_service_locations
serv_cumulative_priority
a_priority
cu_service_locations
serv_a_priority
b_priority
cu_service_locations
serv_b_priority
c_priority
cu_service_locations
serv_c_priority
d_priority
cu_service_locations
serv_d_priority
e_priority
cu_service_locations
serv_e_priority
f_priority
cu_service_locations
serv_f_priority
g_priority
cu_service_locations
serv_g_priority
h_priority
cu_service_locations
serv_h_priority
i_priority
cu_service_locations
serv_i_priority
j_priority
cu_service_locations
serv_j_priority
k_priority
cu_service_locations
serv_k_priority
l_priority
cu_service_locations
serv_l_priority
m_priority
cu_service_locations
serv_m_priority
n_priority
cu_service_locations
serv_n_priority
o_priority
cu_service_locations
serv_o_priority
p_priority
cu_service_locations
serv_p_priority
q_priority
cu_service_locations
serv_q_priority
r_priority
cu_service_locations
serv_r_priority
s_priority
cu_service_locations
serv_s_priority
t_priority
cu_service_locations
serv_t_priority
u_priority
cu_service_locations
serv_u_priority
v_priority
cu_service_locations
serv_v_priority
w_priority
cu_service_locations
serv_w_priority
x_priority
cu_service_locations
serv_x_priority
y_priority
cu_service_locations
serv_y_priority
z_priority
cu_service_locations
serv_z_priority
life_support
cu_service_locations
serv_life_support
avg_revenue
cu_service_locations
serv_revenue_class
name_initials
cu_customers
cust_name_initials
town
cu_service_locations
serv_town
feeder_id
supply_nodes
feeder_id
lot
cu_service_locations
serv_lot
apt
cu_service_locations
serv_apt
cust_id (not null)
cu_customers
cust_id
meter_id (not null)
cu_meters
meter_id
serv_loc_id (not null)
cu_service_locations
serv_loc_id
amr_enabled
cu_meters
amr_enabled
der_unit_count
cu_ders
count of records for the meter_id
x_coord
cu_service_locations
serv_map_loc_x
y_coord
cu_service_locations
serv_map_loc_y
user_geographic_log
cu_service_locations
serv_user_geog_1
CES_CUSTOMERS History
The CES_CUSTOMERS table only holds active records, so the CES_CUSTOMERS_HISTORY was created to hold historical CES_CUSTOMERS records.
When first created, active CES_CUSTOMERS records will be copied to CES_CUSTOMERS_HISTORY and back-dated so that their birth values are January 1, 2000. This is to match potential historical outages for these records. A new death column is added as null for these records.
As the CES_CUSTOMERS changes, the active CES_CUSTOMERS_HISTORY record is set with a death date, and a new record is added with the current date.
NMS_ACCOUNTS_HISTORY
Table NMS_ACCOUNTS_HISTORY maintains history of customer account information in NMS. This information is not used by NMS itself but can be useful for analytics tools.
The NMS_ACCOUNTS_HISTORY table always contains the following columns:
ACCOUNT_NUMBER: Account number. Populated from CES_CUSTOMERS_HISTORY.ACCOUNT_NUMBER
BIRTH: Date/time when this record became active
DEATH: Date/time when this record became inactive (special value '1/1/4000' indicates that the record is currently active)
PTN_DATE: Date/time used for partitioning
TO_DIE: Column used during incremental update procedure
Additional columns can be added to the NMS_ACCOUNTS_HISTORY table through configuration parameters in the CES_PARAMETERS table.
APP: 'BI'
ATTRIB: ACCT_HIST_COLUMN' followed by arbitrary string making the value unique
VALUE: Name of the column of the CES_CUSTOMERS_HISTORY table. Column with the same name will be added to the NMS_ACCOUNTS_HISTORY table.
Example
INSERT INTO CES_PARAMETERS (APP, ATTRIB, VALUE, SITE) VALUES
('BI', 'ACCT_HIST_COLUMN1', 'ACCOUNT_NAME', 'all');
INSERT INTO CES_PARAMETERS (APP, ATTRIB, VALUE, SITE) VALUES
('BI', 'ACCT_HIST_COLUMN2', 'ACCOUNT_TYPE', 'all');
INSERT INTO CES_PARAMETERS (APP, ATTRIB, VALUE, SITE) VALUES
('BI', 'ACCT_HIST_COLUMN3', 'SERV_LOC_ID', 'all');
INSERT INTO CES_PARAMETERS (APP, ATTRIB, VALUE, SITE) VALUES
('BI', 'ACCT_HIST_COLUMN4', 'AVG_REVENUE', 'all');
If column configuration is changed, then the NMS_ACCOUNTS_HISTORY table needs to be dropped. Next execution of the nms-update-customers command will recreate and repopulate the table with the new set of columns.
Customer Sum View
Within Oracle Utilities Network Management System, the customer_sum view (or table) is used primarily by JMService to identify the number of customers, critical customers, etc. on each supply node. The customer_sum view/table is typically generated from the ces_customers table/view. It is simply a summation of the customer model and is designed to provide more efficient outage impact estimates.
Note: all of the following fields are required.
Displayed Column Name
Originating Table
Column in originating table
supply_cls
supply_nodes
h_cls (=994)
supply_idx
supply_nodes
h_idx
device_id
supply_nodes
device_id
revenue
cu_service_locations
serv_revenue_class
customer_count
count(distinct cu_service_points)
cust_id
critical_a
sum(cu_service_locations)
serv_a_priority
critical_b
sum(cu_service_locations)
serv_b_priority
critical_c
sum(cu_service_locations)
serv_c_priority
critical_d
sum(cu_service_locations)
serv_d_priority
critical_e
sum(cu_service_locations)
serv_e_priority
critical_f
sum(cu_service_locations)
serv_f_priority
critical_g
sum(cu_service_locations)
serv_g_priority
critical_h
sum(cu_service_locations)
serv_h_priority
critical_i
sum(cu_service_locations)
serv_i_priority
critical_j
sum(cu_service_locations)
serv_j_priority
critical_k
sum(cu_service_locations)
serv_k_priority
critical_l
sum(cu_service_locations)
serv_l_priority
critical_m
sum(cu_service_locations)
serv_m_priority
critical_n
sum(cu_service_locations)
serv_n_priority
critical_o
sum(cu_service_locations)
serv_o_priority
critical_p
sum(cu_service_locations)
serv_p_priority
critical_q
sum(cu_service_locations)
serv_q_priority
critical_r
sum(cu_service_locations)
serv_r_priority
critical_s
sum(cu_service_locations)
serv_s_priority
critical_t
sum(cu_service_locations)
serv_t_priority
critical_u
sum(cu_service_locations)
serv_u_priority
critical_v
sum(cu_service_locations)
serv_v_priority
critical_w
sum(cu_service_locations)
serv_w_priority
critical_x
sum(cu_service_locations)
serv_x_priority
critical_y
sum(cu_service_locations)
serv_y_priority
critical_z
sum(cu_service_locations)
serv_z_priority
critical_both
sum(cu_service_locations)
Sum of all critical customers of any types.
x_coord
point_coordinates
x_coord
y_coord
point_coordinates
y_coord
ddo
 
Historical – likely should be removed at some point. Often set the same as customer_count to satisfy JMService.
zip_code
ces_customers
zip_code
city_state
ces_customers
city_state
user_geographic_loc
ces_customers
user_geographic_loc