Qwest Information Technologies

User Support Guide

BOM Editor Release 1.0
September 17, 2009

Prepared By: Bill Mauser System Engineer on the CPE-System Consolidation Team

Abstract This document provides user support and troubleshooting information for the BomEditor web application.

Confidential Use Only Disclose and Distribute Only to Qwest Employees Having a Legitimate Business Need to Know. Disclosure Outside of Qwest is Prohibited Without Authorization

User Support Guide

BomEditor Release 1.0

Document Information
This section identifies information specific to this document.

Document History
All revisions to this document are listed in chronological order. Drafts are indicated by decimals (for example 00.01). Final versions are whole numbers (for example 01.00).
Version 01.00 01.01 Date 09/14/2009 09/17/2009 Description of Changes Version 1 Updated Contacts and added Remedy Groups

This document was created by the CPE System Consolidation Team within Qwest Information Technologies, Inc. Qwest Information Technologies has made every effort to ensure this document is accurate at the time of printing. This document was created by: Bill Mauser (wmauser@qwest.com)

Trademarks
The trademarks contained in this document are the property of their respective owners.

Copyright
Copyright 2009 Qwest All Rights Reserved Unpublished and Confidential Property of Qwest.

09/14/2009 Confidential Use Only Disclose and Distribute Only to Qwest Employees Having a Legitimate Business Need to Know. Disclosure Outside of Qwest is Prohibited Without Authorization

ii

User Support Guide

BomEditor Release 1.0

Table of Contents
User Support Guide ...........................................................................................i 1.0 Overview........................................................................................................1 2.0 Troubleshooting Guide................................................................................4 3.0 Saving Spreadsheets as Excel 2007 (*.xlsx)...............................................8 4.0 Upload Rules.................................................................................................8

09/14/2009 Confidential Use Only Disclose and Distribute Only to Qwest Employees Having a Legitimate Business Need to Know. Disclosure Outside of Qwest is Prohibited Without Authorization

iii

User Support Guide

BomEditor Release 1.0

1.0 Overview
1.1 Application Description
The BOM Editor .NET web application allows the user to upload Excel spreadsheets CPE BOMs (Bill of Material), manipulate the data, and save it as Xml to their desktop. The Xml can then be uploaded into the BOM Repository via the BOM Upload tool available in Qcentral portal. The users are Qwest SEs (Sales Engineers) who sell CPE (Customer Premise Equipment). The SEs use Nortels web-based EC (Enterprise Configurator) tool to create the Nortel quote. The exported quote data from EC is the input for the BOM Editor.

1.2 Context Diagram

1.3 Infrastructure description and basic architecture

The BOM Editor is a .Net (aspx) web-based application using the .NET framework 3.5. There are no system interfaces or web/bus service calls. There is no database interaction. No COM objects (server side office automation) are used. The Excel spreadsheet is read in using MS recommended server side method of Open XML file formats Open XML file formats that let developers create, edit, read, and transform file content on the server side. These file formats use the System.IO.Package.IO namespace in the Microsoft .NET 3.x Framework to edit Office files without using the Office client applications themselves. This is the recommended and supported method for handling changes to Office files from a service. Once the spreadsheet is uploaded, it is stored in memory as a DataTable object. The DataTable object is maintained in Session State between HTML posts. The user has the ability to modify the data via the web GUI. The user can save the data to their desktop as Xml or view the Xml in a browser.

09/14/2009 Confidential Use Only Disclose and Distribute Only to Qwest Employees Having a Legitimate Business Need to Know. Disclosure Outside of Qwest is Prohibited Without Authorization

User Support Guide

BomEditor Release 1.0

1.4 User Access

Since the application is a stand-alone application that has no data storage, system interfaces, or confidential information, there are no logon requirements. There is user authentication or authorization. The user only needs access to the Qwest Intranet. Production URL: http://bomeditor.ad.qintra.com/BomEditor.aspx

1.5 Core Business Hours/Days

Core use 8am -5pm Mon- Fri. Weekend use may occur. Heaviest use will occur at month end.

1.6 Hours of availability

24x7 excluding regular maintenance windows (DOTNET = Tues/Thurs 1am-4am MST).

1.7 Number of Users Total/Concurrent

100 total users/10 concurrent

1.8 Exception Alarming and Logging

All user-initiated event handler methods catch and handle any exceptions. In addition, each ASPX page overrides the OnError method. The OnError method will alarm the unhandled exception and redirect to the Error.aspx. Global.asax.cs file will be created with the exception handling logic placed in the Application_Error method. All exceptions will be log in the windows event viewer. All critical exceptions will be Sentry alarmed. Sentry alarming is implemented per the Enterprise Manageability Tools team specification for Dot Net exception handling, http://emt.uswc.uswest.com/manageability/dotnet/exception.html In addition to the application Sentry Alarming, the production .NET AIP group will monitor the application via SiteScope. If the application becomes unavailable, the AIP group will be notified.

1.9 Production Servers

QTOMANETAC35 cluster DATA CENTER BUILDING 1201 FARNAM ST OMAHA NE 68102 Server Name IP Machine Model QTOMANETVW018 155.70.31.231 HP BL480C BLADE SERVER OS WINDOWS 2003 R2 SERVER STANDARD EDITION

09/14/2009 Confidential Use Only Disclose and Distribute Only to Qwest Employees Having a Legitimate Business Need to Know. Disclosure Outside of Qwest is Prohibited Without Authorization

User Support Guide

BomEditor Release 1.0

Server Name IP Machine Model QTOMANETVW019 155.70.31.232 HP BL480C BLADE SERVER QTOMANETVW020 155.70.31.233 HP BL480C BLADE SERVER QTOMANETVW021 155.70.31.234 HP BL480C BLADE SERVER

OS WINDOWS 2003 R2 SERVER STANDARD EDITION WINDOWS 2003 R2 SERVER STANDARD EDITION WINDOWS 2003 R2 SERVER STANDARD EDITION

1.10 Related documentation

End-User Guide

http://global.qintra.com:60097/idc/groups/public/@public/@bmg/documents/helpsystem/il ink041077.mht

1.11 Contact List

Contact CIC (Customer Interaction Center) Reason for Contact Tier I First point of contact for CIC.Group@qwest.com CIC Manager Rick Faust (614 215 end-user. Client notifications and initial disruption 5772) assessment AIP-BOMEDITOR-DOTNET Tier II Application Support PIN 93850 Call-out APP-BOMEDITOR-DEVCALLOUT Tier III Application Support PIN 93849 Call-out http://emd.uswc.uswest.com/emd/s AIP - Production application earch.html?f_mnetid=435179 support person. http://emd.uswc.uswest.com/emd/s Tier 3 Development support earch.html?f_mnetid=491951 http://emd.uswc.uswest.com/emd/s System Engineer and Tier 3 earch.html?f_mnetid=070827 Development support http://emd.uswc.uswest.com/emd/s Tier 3 Development support earch.html?f_mnetid=487304 http://emd.uswc.uswest.com/emd/s Qwest Bangalore Technical earch.html?f_mnetid=487302 Manager Telephone/Pager/Cell

AIP BOM Editor NET TOOL Call-out Developer BOM Editor NET TOOL Call-out Teresa Sanchez Suresh Venkatasubramani Qwest Bangalore Technical Lead Bill Mauser System Engineer Poonam Singh A.R Mohanasundaram Siddhan

09/14/2009 Confidential Use Only Disclose and Distribute Only to Qwest Employees Having a Legitimate Business Need to Know. Disclosure Outside of Qwest is Prohibited Without Authorization

User Support Guide

BomEditor Release 1.0

Contact Niranjan Mamillapalli Robert Groenig

Telephone/Pager/Cell Reason for Contact http://emd.uswc.uswest.com/emd/s QB Technical Manager earch.html?f_mnetid=568787 http://emd.uswc.uswest.com/emd/s On-Shore Manager SW earch.html?f_mnetid=128799 Development http://emd.uswc.uswest.com/emd/s On-Shore Lead SW earch.html?f_mnetid=126480 Developer

Teri Anderson

1.12 Remedy Ticket Groups

APP-BOMEDITOR-DEV APP-DOTNET1-AIP

2.0 Troubleshooting Guide

Trouble Can not reach application Internet Explorer cannot display the webpage Description Environment Problem The user attempts to access the BOMEditor web application via the production URL a HTTP error is encountered. For example: HTTP 404 Not Found HTTP 500 Internal Server Error Page displayed stating that The application is experiencing technical difficulties Application error This page is displayed when a global error is caught. This error would be encountered before the page (code behind) logic would have a chance to execute. Corrective Action(s) Attempt to access the production URL http://bomeditor.ad.qintra.com/BomEditor.aspx If youre able to access the BOMEditor, have the user close all browser windows and try again. If not able to reach the application, contact the Application support (AIP) NET TOOL AIP-BOMEDITOR-DOTNET Instruct user to close all browsers windows and attempt action again. If problem persists when the user is uploading an Excel spreadsheet. Verify that the file size is not larger then 10MB. If the problem still persists, then contact development support team. Development team will need to open Windows event log (BOMEDIT), and analyze log entry to determine root cause and solution. Instruct user to close all browsers windows and attempt action again. If the problem still persists, then contact development support team. Development
4

Error Message Displayed in GUI: Error encountered saving. Please try again.

Application error This event is triggered when an exception is caught in the ButtonSaveXml _Click

09/14/2009 Confidential Use Only Disclose and Distribute Only to Qwest Employees Having a Legitimate Business Need to Know. Disclosure Outside of Qwest is Prohibited Without Authorization

User Support Guide

BomEditor Release 1.0

method. The ButtonSaveXml _Click method is called when the user saves BOM Items as Xml data If this event is encountered, the user will see an error message displayed in the GUI. Error Message Displayed in GUI: Error encountered assigning parent part. Please try again. Application error This event is triggered when an exception is caught in the ButtonAssignParentParts _Click method. The ButtonAssignParentParts _Click method is called when the user assigns parent parts to the BOM Items. If this event is encountered, the user will see an error message displayed in the GUI. Application error This event is triggered when an exception is caught in the ButtonAssignWorksheet_Click method. The ButtonAssignWorksheet _Click method is called when the user assigns worksheet names to the BOM Items. If this event is encountered, the user will see an error message displayed in the GUI. Application error This event is triggered when an exception is caught in the ButtonUpload_Click method. The ButtonUpload_Click method is called when the user uploads a file. Server side validation code is implemented in this method to verify that the file is valid and in the correct format. If the is event is encountered, the user will see an error message displayed in the GUI. If this event is encountered, the user will see an error message displayed in the GUI.

team will need to open Windows event log (BOMEDIT), and analyze log entry to determine root cause and solution.

Instruct user to close all browsers windows and attempt action again. If the problem still persists, then contact development support team. Development team will need to open Windows event log (BOMEDIT), and analyze log entry to determine root cause and solution.

Error Message Displayed in GUI: Error encountered assigning worksheet(s). Please try again.

Instruct user to close all browsers windows and attempt action again. If the problem still persists, then contact development support team. Development team will need to open Windows event log (BOMEDIT), and analyze log entry to determine root cause and solution.

Error Message Displayed in GUI: Error encountered uploading file. Check source file and try again.

Instruct user to do the following 1. Close all browsers windows. 2. Open the file in Excel and verify that it is readable 3. Save the file as Workbook 2007 (see instructions (section 3.0) in this document on how to save as Excel 2007) 4. Try upload again. If the problem still persists, then contact development support team. Development team will need to open Windows event log (BOMEDIT), and analyze log entry to determine root cause and solution.

09/14/2009 Confidential Use Only Disclose and Distribute Only to Qwest Employees Having a Legitimate Business Need to Know. Disclosure Outside of Qwest is Prohibited Without Authorization

User Support Guide

BomEditor Release 1.0

Error Message Displayed in GUI: Page Failed to Load

Application error This event is triggered when an exception is caught in the Page_Load method. The Page_Load method initializes the page upon HTTP request. Possible causes could include not being able to load dropdown lists with values from configuration file, not being able to load InputMap.xml configuration or not being able to set server controls and objects from SessionState or ViewState. If this event is encountered, the user may see an error message displayed in the GUI. User Error Rows that do not contain a valid value for quantity, part, and description are considered invalid. There must be a quantity (integer value), part, and part description found in the row; otherwise it will not be considered as valid row. If there are no valid rows in the spreadsheet, this error message will be displayed to the user.

Instruct user to close all browsers windows and attempt action again. If the problem still persists, then contact development support team. Development team will need to open Windows event log (BOMEDIT), and analyze log entry to determine root cause and solution.

Error Message Displayed in GUI: No valid rows found. Check input file and try again.

Instruct the user to view the Upload Audit Report, make any necessary corrections, and retry. The audit report can be displayed by clicking on the Show Upload Audit Report button on the Upload page. The audit report will show the following information, Upload time File name File size Upload rules used Sheet name used Total rows in sheet A List of all column/rows that were read and if they were used or not used Summary count of total rows read, parts uploaded, and rows not used.

Ask the following questions: Was the correct file used? Are the quantity, part, and part description Excel columns correctly defined? Was the correct worksheet read?

Error Message Displayed in GUI:

User Error

See Section 4.0 Upload Rules for more information Instruct the user to do the following.

09/14/2009 Confidential Use Only Disclose and Distribute Only to Qwest Employees Having a Legitimate Business Need to Know. Disclosure Outside of Qwest is Prohibited Without Authorization

User Support Guide

BomEditor Release 1.0

The file (" + file.FileName + ") you are trying to upload is invalid. The file must be an Excel 2007 document (*.xlsx)

The upload file must be saved as Excel 2007 Workbook. This error is generated when the file extension is not xlsx

1. Close all browsers windows. 2. Open the file in Excel and verify that it is readable 3. Save the file as Workbook 2007 (see instructions section 3.0 in this document on how to save as Excel 2007) 4. Try upload again. Instruct the user to use the browse button to the locate file.

Error Message Displayed in GUI: You must specify a valid file name and path. Use the browse button to the locate file. Error Message Displayed in GUI: The file size ({0} megabytes) that you're attempting to upload exceeds the maximum size ({1} megabytes) allowed for this application. Error Message Displayed in GUI: You must populate all Spreadsheet Input Rules required fields

User Error The user did not specify a valid path and file name in the User Error The BOM Editor will not allow a user to upload a file larger than 4 megabytes. User Error This error occurs when the user has selected the User Defined Spreadsheet Type on the upload page, and did not enter the required data User Error User complains that they are not getting the expected results after uploading Excel spreadsheet. This could be the wrong number of items, or the items are not in the expected columns.

Instruct the user to open in Excel the file and delete any unnecessary data and/or worksheets.

Instruct the user to enter all the required fields as indicate on the GUI with asterisks.

Upload successful, but BOM list does not have the correct data.

Instruct the user to view the Upload Audit Report, make any necessary corrections, and retry. The audit report can be displayed by clicking on the Show Upload Audit Report button on the Upload page. The audit report will show the following information, Upload time File name File size Upload rules used Sheet name used Total rows in sheet A List of all column/rows that were read and if they were used or not used Summary count of total rows read, parts uploaded, and rows not used.

Ask the following questions: Was the correct file used? Are the quantity, part, and part
7

09/14/2009 Confidential Use Only Disclose and Distribute Only to Qwest Employees Having a Legitimate Business Need to Know. Disclosure Outside of Qwest is Prohibited Without Authorization

User Support Guide

BomEditor Release 1.0

description Excel columns correctly defined? Was the correct worksheet read?

See Section 4.0 Upload Rules for more information

3.0 Saving Spreadsheets as Excel 2007 (*.xlsx)

The Excel spreadsheet must be saved as Excel 2007 Workbook (*.xlsx). The Qwest desktop standard is Excel 2003 (SP3) which allows spreadsheets to be saved as Excel 2007. All Qwest users should be able to save files in the 2007 format. If users are unable to save as 2007, they can download the Office 2007 Compatibility patch from the TheQ Software Center site (http://sci.qintra.com/Production/Commercial/); click on the Microsoft link.

Instructions:

Open the spreadsheet and save as Excel 2007 Workbook (*.xlsx). Select Save As option from the File menu This will launch the Save As dialog. Select the folder location where you want save the file Provide a file name Set the Save as type: as Excel 2007 Workbook(*.xlsx)

Click the Save button in Save As dialog

4.0 Upload Rules

General Upload Rules: The Excel spreadsheet must be saved as Excel 2007 Workbook (*.xlsx). Qwest users who have Excel 2003 can download the Office 2007 Compatibility patch from the TheQ Software Center site (http://sci.qintra.com/Production/Commercial/); click on the Microsoft link. Rows that do not contain an integer value that represents a quantity are not considered valid. Rows that do not contain a valid value for quantity, part, and description considered invalid The BOM Editor will not allow a user to upload a file larger than 4 megabytes. The user can define Spreadsheet Input Rules by choosing a pre-defined or user-defined spreadsheet type.
09/14/2009 Confidential Use Only Disclose and Distribute Only to Qwest Employees Having a Legitimate Business Need to Know. Disclosure Outside of Qwest is Prohibited Without Authorization 8

User Support Guide

BomEditor Release 1.0

Pre-defined types match current Nortel EC output. If you choose this option, the input rules are automatically set to match the spreadsheet type that you are uploading. User-defined allows the user to enter the following input rules. User defined Rules Quantity Column Part Number Column Descirption Column Excel Worksheet Index Vendor Name QRN Find String Required Yes Yes Yes Yes Yes No Description Excel column name (e.g. A) where the item quantity is located. Excel Column (e.g. B) where the item part number is located. Excel Column (e.g. C) where the item part description number is located. This is the index of the worksheet within the Excel workbook. Example: if the data is found in the first worksheet, this value needs to be set to 1. This is the vendor name that will be associated with all the items that are uploaded. This is the string which is used to find the QRN value. The search always looks in column A. QRN (Quote Reference Number) will be obtained from the column A where the row contains the character string Product Quote Reference Number: Example: Product Quote Reference Number: AUS0894411. The QRN Value can be changed after the spreadsheet is uploaded. This is the string which is used to find the worksheet values. The search always looks in column A. The worksheet name will precede the items. Worksheet name assignments can be changed after the spreadsheet is uploaded.

WorkSheet Find String

No

09/14/2009 Confidential Use Only Disclose and Distribute Only to Qwest Employees Having a Legitimate Business Need to Know. Disclosure Outside of Qwest is Prohibited Without Authorization