CSG Vantage ACP OverviewOracle

CSG Vantage ACP Overview

CSG Vantage ACP Overview

Vantage ACP TablesHouse Tables

CHX_CUS_HSE

This table includes the start and end dates for connected service and provides the necessary keys to link customer billing and dwelling data to a customer account. Vantage retains the customer house relationship for up to two years after you disconnect service at the house.

Vantage ACP TablesIn ACP there is no longer a house to subscriber relationship like we have in legacy. So if you look at the HIU screen in ACP, the three fields on the right side of the HIU screen, where we used to see the current subscriber account number and the two previous account numbers, is no longer there.

So, how do we join house to sbb? We are going to have to start using another join. We are going to bring in the CHX_CUS_HSE table. This table contains the customer account number and house key. Here is what we will do:WHERE HSE_KEY_HSE = HSE_KEY_CHXAND CUST_ACCT_NO_CHX = CUST_ACCT_NO_SBBAdditionally, there may be more than one subscriber for the customer account sbb. One way to reduce the amount of "garbage" you bring back is to add this one additional Where clause for active accounts:AND END_DTE_CHX = '0001-01-01' The end date is 0001-01-01 until all services for the customer in that house are disconnected. So you need to use this additional line in your queries when trying to join house to sbb for active accounts.

Vantage ACP TablesSubscriber Tables

CUS_BASE This table includes customer information such as address, creation date, Name, and Drivers License #. It can be used instead of or in conjunction with the HSE_BASE and the SBB_BASE tables.

Join to this table using the CUST_ACCT_NO_XXX field.

Vantage ACP TablesSubscriber Tables continued

OCI_CUR_ITEM This table contains information about all of a customers current services similar to what the SBS_SERV_CODES table does for you in the Legacy System.

Example Query - ALL ACTIVE SUBSCRIBERS WHO HAVE BOTH SERVICE CODES AA & BB

QUERY IN ACP:SELECT SUB_ACCT_NO_OCIFROM OCI_CUR_ITEM AWHERE A.SERV_CDE_OCI = AAAND EXISTS (SELECT 1FROM OCI_CUR_ITEM BWHERE A.SUB_ACCT_NO_OCI = B.SUB_ACCT_NO_OCIAND B.SERV_CDE_OCI = BB

Vantage ACP TablesOrder TablesOOR_ORDER_OPEN Corresponding legacy table is WOO_BASE_OPENOCR_ORDER_COMPCorresponding legacy table is WOC_BASE_COMPOTR_TROUBLE_CALLCorresponding legacy table is TBC_BASE

Common fields to join the OOR, OCR, and OTR are - CUST_ACCT_NO_XXXORDER_NO_XXX corresponding legacy field is the WO_KEY_XXX

Vantage ACP Tables

Job TablesOJB_JOBSThis table contains information on scheduling and technicians associated with a particular job. Main fields contained in the table Job completion information Bill start/stop information Scheduling times/units Dispatch information Custom fields

Vantage ACP TablesJob Tables continued

OJA_JOBS_ALT_ADDRThis table contains information about jobs containing an address other than the bill-to address.

Main Fields contained in this table - Alternate AddressAlternate City, State, and ZipAlternate Name for mailing purposes.

Vantage ACP Tables

Item TablesOPI_OPEN_ITEM contains information about a customers services that currently have changes pending through an order.

OHI_HIST_ITEM This table contains information on all of the services previously stored on pending and current tables (e.g., OCI_CUR_ITEM and OPI_OPEN_ITEM tables)

Vantage ACP Tables

Item Tables continuedOBI_BASELINE_ITEMThe OBI_BASELINE_ITEM provides a more accessible way for you to identify items that are active at the account customer-location levels at the time you add or remove another item. It provides a snap-shot of the customer-location items after you add or remove items. (CSG is retaining two years of historical data on this table in Vantage.)Benefit: The OBI_BASELINE_ITEM table allows you to view your customers items at a given point in time. This provides the ability to measure the effectiveness of cross-sells and up-sells. In addition, you can analyze the items that a customer or account had when you downgraded or upgraded particular items.

Vantage ACP TablesOptional Tables

Auditing Order and Jobs (replaces WOA)OAJ_AUDIT Job Audit Table OAO_AUDIT Order Audit Table

Vantage Columns (cont)IndexesIndexes allow database to rapidly and efficiently locate specific records rather than examining each row in a table Indexes are placed on frequently used columns such asCustomer Account NumberSubscriber Account NumberOrder Number Job NumberHouse KeyEquipment Serial Number

Vantage Columns (cont)JoinsNecessary when data is in different tablesLike data fields, (Cust Acct No, Sub Acct No, Order Number, House Key) are join candidatesUse column 5 on table layouts to determine join candidate fields

NOTE: When linking some tables together, more than one join may be required. Example: ALA, PKS, EQS, OCI, OHI & OPI. Please contact your Information Specialist if you are unsure of how many joins to use.

JoinsMany queries will contain 2 or more Vantage tablesTables are joined by comparing like columns in each tableExampleCUST_ACCT_NO_SBB = CUST_ACCT_NO_OCRORDER_NO_OCR = ORDER_NO_OHISUB_ACCT_NO_SBB = EQP_LOCAL_EQP

Join Example 1Select RES_NAME_SBB, ADDR1_HSE, RES_CITY_HSE, RES_STATE_HSE, POSTAL_CDE_HSEFrom SBB_BASE, HSE_BASE, CHX_CUS_HSE Where HSE_KEY_HSE = HSE_KEY_CHX AND CUST_ACCT_NO_CHX = CUST_ACCT_NO_SBBAND END_DTE_CHX = '0001-01-01'And EXT_STAT_SBB = And MGMT_AREA_HSE = 01

Shows active accounts that reside in management area 01

Join Example 2Select DISTINCT RES_NAME_SBB, SALESREP_OCRFrom SBB_BASE, OCR_ORDER_COMP, OHI_HIST_ITEMWhere CUST _ACCT_NO_SBB = CUST_ACCT_NO_OCRAnd ORDER_NO_OCR = ORDER_NO_OHIAnd SERV_CDE_OHI = IAAnd DELQ_AMT_SBB > 0And EXT_STAT_SBB = And LS_CHG_DTE_OCR > 2004-03-01

Shows active accounts who connected after March 1, 2004, had install code IA on the connect Order, and are delinquent

Join Example 3Select SUB_ACCT_NO_SBB, HOME_PHONE_SBBFrom SBB_BASE, OCR_ORDER_COMPWhere CUST_ACCT_NO_OCR = CUST_ACCT_NO_SBBAnd ORD_STAT_OCR = CAnd LS_CHG_DTE_OCR Between 2004-01-01 and 2004-03-31

Shows all account records that had an Order completed between January 1 and March 31, 2004.

Top ACP Vantage Data Columns

1. ORDER_NO_OCR, OOR, OTR, OJB, OCI, OHI, OPIThe Order number is a key field for all Orders, Job and Items tables because it is used to join these tables to each other. Each ACP Order that is generated will be assigned a unique 16 digit, alpha-numeric order number.In CSG there is a Last Number Used file, used by all ACP clients which generates Order numbers. The Order number is a randomly generated sequential number. Random because the order number does not relate to anything such as house key, zip code, account number, etc. Sequential because each order number coming out of the last number used file will be incremented by one from the previous order number that was generated. There are approximately 900 billion possible order numbers.Due to the way the order numbers are generated and used across all ACP clients, it is unlikely that you will see two sequential order numbers on a single account.Example: ORDER_NO_OCR = ORDER_NO_OHI ORDER_NO_OTR > ORDER_NO_OCR

2. JOB_SEQ_NO_OJB, OCI, OHI, OPIThe Job sequence number is a key field for the Job and Items tables. It is a 7 digit numerical field.There can be multiple jobs on a single order, and the possibility of multiple items on each job. When the job and item tables are properly joined, using the job sequence number, it keeps each item in the Items table correlated to the specific job in the Jobs table.If an Item did not have a Job associated with it because a technician was not required, the default value of 0 will be displayed in the job sequence number field for that item.

3. ORD_RSN_OCR, OOR, OTR Contains an 8 character alphanumeric fieldContains up to 4, 2 character Order reasonsMust use the Substring function when used as part of the Where ClauseExampleSUBSTR(ORD_RSN_OCR,1,2) = 20SUBSTR(ORD_RSN_OTR,3,2) = BP

4. COMPL_CDE_OCR, OOR, OTRContains a 18 character alphanumeric fieldContains up to 6, 3 character completion codes on an OrderMust use the Substring function when used as part of the Where Clause

Examples(SUBSTR(COMPL_CDE_OCR, 1, 3) = 100 or SUBSTR(COMPL_CDE_OCR, 4, 3) = 100)

5. CREATE_DTE_OCR, OOR, OTRContains the date the Order was created and entered into the systemField set by ACP system, cannot be modified from terminalsExampleCREATE_DTE_OOR = TRUNC(SYSDATE) -1CREATE_DTE_OTR >= 2004-05-01

6. DUE_DTE_OCR, OOR, OTRContains the date the Order is scheduled to be worked if there is no Job.If there is a job, the Due date defaults to the scheduled begin date of the job.Will be 0001-01-01 if the Order is unscheduled.ExampleDUE_DTE_OOR >= TRUNC(SYSDATE) - 7

7. SALESREP_OCR, OOR, OTR, OCI, OHI, OPIContains the sales representative number associated with the order or item.Alphanumeric field.ExampleSALESREP_OCR Between 12000000 and 13999999NOTE: The SALESREP column is an 8 character alphanumeric field and requires the use of tick marks when used in a query. Please note that your system may not use the full 8 characters. Vantage does not pad the Salesrep field out to the full 8 character length.

8. CAMP_CDE_OCR, OOR, OTR, OCI, OHI, OPIContains a 3 character alphanumeric fieldContains the campaign code associated with the Order or Item.

ExampleCAMP_CDE_OCR = HHHCAMP_CDE_OPI = SHO

9. LS_CHG_DTE_OCR, OOR, OTR, OJB, OCI, OHI, OPIContains the date of the last change made to the Order, Job, or ItemField set by ACP system, cannot be modified from terminalsUse this field when trying to write queries that tie back to ACP production reportsIs an indexed fieldExampleLS_CHG_DTE_OCR Between 2004-02-22 and 2004-03-21LS_CHG_DTE_OJB > TRUNC(SYSDATE) 3

10. COMPL_DTE_OCR, OOR, OTR, OJBContains the date the Order/Job was completedEntered by CSR when closing the Order and can be backdated up to 30 daysAutomatically defaults to current date if not entered by CSRExampleCOMPL_DTE_OCR between 2004-03-01 and 2004-03-31COMPL_DTE_OJB >= TRUNC(SYSDATE) 7

11. ORD_STAT_OCR, OOR, OTR Contains the Order status Different Values exist in different tables

C CompletedOCR/OTR TablesO OpenOOR/OTR TablesX - CancelledOOR/OTR Tables

ExampleORD_STAT_OOR = OORD_STAT_OTR NOT IN (O,X)

12. ORD_CLASS_OCR, OOR, OTR

Class of the OrderValid Values:S - Service Order: Connect, Reconnect, Restart, Change of Service, DisconnectT - Trouble CallM - Special Request: Verify service, Pickup Equipment, Bury Drop, etc.ExampleORD_CLASS_OCR = S

13. JOB_CLASS_OJB

Class of the JobValid Values:CConnectDDisconnectRRestartSService ChangeTTrouble CallZ Special RequestExample: JOB_CLASS_OJB In (C,R)Note: Not all Orders will have a job associated with them.

14. IR_TECH_OJBContains the technician code on the Job. Order tables do not contain the technician code.Alphanumeric fieldExampleIR_TECH_OJB Between 11000000 and 11999999IR_TECH_OJB = 38097063NOTE: The IR_TECH column is a 8 character alphanumeric field and does require the use of tick marks when used in a query. Please note that your system may not use the full 8 characters for IR_TECH_OJB. Vantage does not pad the technician field out to the full 8 character length.

15. JOB_TYP_OJBIndicates the type of JobDetermines connects, restarts, reconnects, disconnects, upgrades, downgrades, special requestsCode Table CTD-32 describes Job TypesExampleJOB_TYP_OJB In (NC,RC,RS)JOB_TYP_OJB In (VD,NP,UP)JOB_TYP_OJB In (TC,FN)

16. JOB_STAT_OJBContains the status of that Job on the OrderPossible Job Status values:C Completed as OrderedD Completed Different than OrderedH HeldO OpenR RescheduledX Canceled

ExampleJOB_STAT_OJB = C

17. ITEM_STATUS_OCI, OHI, OPIItem status is a 1 character, alpha-numeric field.In the Current Items table, the current status of that item will be displayed.In the Historical Items table, the status of the Item as it relates to the Order will be displayed.In the Pending Items table, this field will display the current status of the Item as it awaits a pending change.Possible values: Space, A,B,C,H,O,P,R,X.Where table will you find a specific status in?OCI_CUR_ITEM: C,ROHI_HIST_ITEM: B,C,O,P,XOPI_OPEN_ITEM: Space, A, H

18. ITEM_STATUS_OCI, OPI, OHI (contd)Item Status and DescriptionsSpace: Pending connect/disconnect items that require manual intervention to complete. A truck roll is required. Tech has to do something.A: Auto-Provisionable. Pending upgrade/downgrade items that can be completed by an addressable controller. No technician required.B: Billing Change. Current items with pending billing changes such as a bill code, discount code, and account number changes.C: Current Item. This item status represents the current state of billing and non billing data.H: Held. Completed items that are held from the Current Item file.O: Other Change. Current items with pending non-billing changes such as outlet changes.P: Provisioned Items. Completed upgrade/downgrade items. All required provisioning has been completed.R: Restart Item. These items are used during an account restart. They will only be found on the Current Item file.X: Cancelled Item. This status will only be found in the History Item file.

19. SERV_CDE_OCI, OHI, OPIContains a single, 5 character ala carte Item codeExamplesSERV_CDE_OCI = HBSERV_CDE_OCI In (HB, CX, DS, MC)NOTE: In ACP, each service code (item) can be displayed multiple times, equivalent to the quantity of that item. If a subscriber has 3 DC digital converters on their account, there will be 3 lines of DC, each with a quantity of one. In the case of bulk charge Items, those will normally have only one line and will have a quantity > 1. Additionally, for Items on Orders, ACP displays the items along with their billing codes, no matter what their ala-carte or package status is. Items are always broken out on the Order, auto-packaged or not, which was not always the case in the legacy work order system.For OHI/OPI Items tables, this column displays Items present on the Order. Only those Items which are being affected on that order will be displayed in the OHI and OPI tables. Install items are found in this columnExample: SERV_CDE_OPI = BA

20. BILL_CDE_OCI, OHI, OPIContains billing/package code on the account that is associated with the ala-carte item code.ExamplesBILL_CDE_OCI = XXBILL_CDE_OHI In ( BT, D4, K2, S5, XD ) ACP displays billing/package codes only in the BILL_CDE_OCI/OHI/OPI column. ACP always breaks down the package codes in the Items tables, no matter what the package/auto-package status is. In legacy, a non auto-packaged code would display in both the service code and billing code columns. ACP does not allow that. This makes it much easier to see which components were added without joining to the package tables to break out components.

21. DSC_CDE_OCI, OHI, OPIIdentifies a permanent or temporary discount code associated with a specific ItemDiscounts are alphanumeric Discounts can be up to five characters

ExampleDSC_CDE_OHI = 36

22. BEF_QTY_OCI, OHI, OPIFor the Current Items tables, the BEF_QTY_OCI will be either 0, 1, or in the case of bulk services may be greater than 1.For Historical and Open Items tables, BEF_QTY_OHI/OPI will contain the quantity of each Item on an order> 0 if Item is present before Order= 0 if Item is not present before Order

ExampleBEF_QTY_OHI > 0and SERV_CDE_OHI = SH

23. AFT_QTY_OCI, OHI, OPIFor the Current Items table, the AFT_QTY_OCI will display the quantity of the Item on the account, and will = 1, or in the case of bulk services may be greater than 1.For Historical and Open Items tables, AFT_QTY_OHI/OPI will display the quantity of each Item on an order> 0 if Item is present after the Order= 0 if Item is not present after OrderExampleAFT_QTY_OHI > 0and SERV_CDE_OHI = AO NOTE: When a customer disconnects, the AFT_QTY_OHI for each Item on the Order will remain as it was prior to the Order. For Disconnect Jobs, the AFT_QTY_OHI does not go to 0.