NBB RFP - B1.1 - Annex 22 - Telcordia Network Engineer Design Assistant Guide
NBB RFP - B1.1 - Annex 22 - Telcordia Network Engineer Design Assistant Guide
Network Engineer
Network Engineer
Design Assistant User’s Guide
BD-NE-6.1-DA-USRADM-001 Issue 1, January 2010
TELCORDIA TECHNOLOGIES, INC. CONFIDENTIAL - RESTRICTED ACCESS
This document and the confidential information it contains shall be distributed, routed or made available solely to authorized persons
having a need to know within Telcordia, except with written permission of Telcordia..
Table of Contents BD-NE-6.1-DA-USRADM-001
Issue 1, January 2010
Copyright Page
Copyright © 1997-2009 Telcordia Technologies, Inc. All rights reserved.
Portions of this documentation are copyrighted by ESRI.
Trademark Acknowledgements
Network Engineer is a product of Telcordia Technologies, Inc. ESRI is a registered trademark of Environmental Systems Research
Institute, Inc. ArcInfo is a registered trademark of Environmental Systems Research Institute, Inc. Spatial Database Engine and SDE
are trademarks of Environmental Systems Research Institute, Inc. ArcMap, ArcCatalog, ArcView, and ArcToolbox are trademarks of
Environmental Systems Research Institute, Inc. Microsoft is a registered trademark of the Microsoft Corporation. Microsoft SQL
Server is a registered trademark. Windows 2000 and Windows XP are trademarks of the Microsoft Corporation. Oracle is a registered
trademark of Oracle Corporation.
2
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Table of Contents
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Getting Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Online Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Navigating the Help Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Getting Help While You Work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
1 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
3
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Table of Contents BD-NE-6.1-DA-USRADM-001
Issue 1, January 2010
Rule Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Rule Set Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Serving Point Rule Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Transmedia Rule Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Route Rule Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Service Rule Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Sample Rule Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
4
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Table of Contents
Release 6.1
Spans . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Span Units. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Equipment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Transmedia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Splice Closure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Design Assistant Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Creating Complex Structure Models . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
5
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Table of Contents BD-NE-6.1-DA-USRADM-001
Issue 1, January 2010
6
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Table of Contents
Release 6.1
Task Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
INEDAIdentification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
INEDATask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Opening the Task Definition Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Dialog Box Element Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Adding Tasks Types and Associating the COM Components . . . . . . . . . . . 99
Removing COM Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Removing a Task Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
7
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Table of Contents BD-NE-6.1-DA-USRADM-001
Issue 1, January 2010
8
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Table of Contents
Release 6.1
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Dialog Box Element Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
9
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Table of Contents BD-NE-6.1-DA-USRADM-001
Issue 1, January 2010
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
10
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Introduction
Using Network Engineer Design Assistant, an administrator defines planning policies that
govern how networks are build based upon the location and demand data provided.
Individual planning policies (or rule sets) are then combined into wizards that represent the
step-by-step process of building network systems. Separating policies from data and allowing
policies to be combined into wizards maximizes the reuse of each policy and reduces the
work required to maintain them.
The Design Assistant software consists of two main components: configuration (wizard and
rule set definitions) and the design wizard toolbar. Once installed on a Network Engineer
administrator client machine, the configuration component tools are automatically added to
the Network Engineer Toolbox application for defining rule sets and wizards. After the
administrator uses the configuration tools to define network design wizards, it is integrated
into the Network Engineer application.
• Customized rule sets. The administrator defines company policy in terms of rule sets.
The rule sets are guidelines that Design Assistant uses to connect the start point to the
customer demand points.
• A wizard helps planners to define the start location and the customer demand locations.
• Structures, spans, equipment and transmedia are automatically placed and connectivity
is established with minimal user intervention.
All graphical user interface elements are printed in SMALL CAPS text. For example:
Click PROPERTIES.
-and-
11
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Introduction BD-NE-6.1-DA-USRADM-001
Using this Document Issue 1, January 2010
Key combinations you should press display in uppercase letters with SMALL CAPS text. If joined
with a plus sign (+), press and hold the first key while you press the remaining one(s). For
example:
Press CTRL + F.
File names, folder selections and directory paths are printed in the courier new font. For
example:
Instruction sets, menus and corresponding submenu commands are indicated by the use of
right brackets “>”. For example:…select START > PROGRAMS > TELCORDIA TECHNOLOGIES >
NETWORK ENGINEER > NETWORK ENGINEER tells you to click on the Start menu and go through the
Programs, Telcordia Technologies, and Network Engineer submenus to select the Network
Engineer command.
Note: It is recommended that you establish a practice of checking the ToolTips and prompts
each time you use a command.
As you select different commands in the product, the prompts in the status bar change with
each command. In the following example, the button ZOOM IN is selected. Notice the Tooltip
ZOOM IN displays near the selected button. This defines the name of the command for you.
Zoom in by clicking a point or dragging a box. The displayed prompt provides you with
helpful information about using the command.
12
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineers Programmer API Guide Introduction
Release 6.1 Getting Information
Getting Information
Related Documents
The following documents are available on the Network Engineer DVD 1 in Adobe PDF format.
You will need Adobe Acrobat Reader 4.x or greater to view the documents. You can choose to
install these documents onto your client system hard drive during installation.
13
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Introduction BD-NE-6.1-DA-USRADM-001
Getting Information Issue 1, January 2010
Online Help
Once you install your software, details and how-to information are just a click away in online
Help. The Help menu provides commands to open the Help window to see the Table of
Contents or search the index.
14
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineers Programmer API Guide Introduction
Release 6.1 Getting Information
CONTENTS Contains headings with topics listed below. Click the plus sign (+) to
expand the heading and see the topics.
INDEX Contains index terms. Click this tab to view and search index entries.
SEARCH Enables you to do keyword searches. Key in the keyword(s) you are
looking for and click DISPLAY.
Glossary Contains terms specific to the product.
You can open or close the navigation pane, select a tab, and resize or reposition the Help
window.
Concepts, terms, features, Select HELP menu > CONTENTS, or press F1 to display the Help
menu commands window. Click SEARCH and then type in keywords you are
looking for. Click DISPLAY to see a list of topics containing the
keyword.
Windows or panes Highlight a pane and press F1 to display the Help window.
Dialog boxes Press F1 to display the Help window.
Menu commands and Pause your cursor over the command or button until a
toolbar buttons screentip displays.
Technical Support
The Telcordia Geospatial Solutions Customer Support Center (CSC) is the primary contact for
questions and technical requests concerning the Network Engineer product. Please refer to
the Network Engineer Customer Care Handbook, delivered with your Network Engineer
software, for a description of the CSC functions and the information necessary to determine
when, how, and who to call at the CSC with questions and/or technical requests.
15
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Introduction BD-NE-6.1-DA-USRADM-001
Getting Information Issue 1, January 2010
16
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
1
Installation
The Design Assistant application consists of two components. The configuration component is
installed in the NE Toolbox application. The Design Assistant Wizard toolbar is installed in the
Network Engineer application. You must have the complete installation of Network Engineer
on at least an administrator client machine and you need a Network Engineer geodatabase
on your server. The complete installation of Network Engineer includes database
administration tools, the Model Builder and NE Toolbox applications. See the Telcordia
Network Engineer Administrators Installation Guide for information.
Warning! Uninstalling Network Engineer before any Assistant product can cause unsuccessful
product installation or function and require significant work to correct. Please follow the order
given below to prevent issues.
3 From the list of installed programs, select TELCORDIA NETWORK ENGINEER - DESIGN ASSISTANT
and click REMOVE.
17
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Installation BD-NE-6.1-DA-USRADM-001
Preparing the System Issue 1, January 2010
For Network Engineer and Design Assistant to be compatible, the version numbers should be
the same down to the two-digit core build number. (For example, Network Engineer version
[Link] and Design Assistant version 6.0.0.1101 are compatible.)
1 If you are installing a new version of Network Engineer, locate the product version
information on your Network Engineer packaging materials.
- or -
If you already have Network Engineer installed, Select START MENU > SETTINGS > CONTROL
PANEL > ADD OR REMOVE PROGRAMS. Select NETWORK ENGINEER from the list of programs and
click the CLICK HERE FOR SUPPORT INFORMATION link. The SUPPORT INFO message box
displays:
2 If the products are compatible and you do not intend to install a newer version, then
continue on to “Installing or Upgrading Design Assistant,” on page 19.
- or -
If the products are not compatible, then continue on to the next section, “Uninstalling
Network Engineer”.
Before you can uninstall Network Engineer, you must first uninstall any additional
Assistant products — Integration Assistant, Field Assistant, or Schematics Assistant —
from the system. You can reinstall these products at any time after you install Network
Engineer. To do so, please see the User Guides delivered with the product.
18
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Installation
Release 6.0 Installing or Upgrading Design Assistant
3 Select each product from the list of installed programs, (for example TELCORDIA NETWORK
ENGINEER - INTEGRATION ASSISTANT) and click REMOVE. Follow the prompts to successfully
uninstall the product.
4 From the list of installed programs, select TELCORDIA NETWORK ENGINEER and click REMOVE.
Follow the prompts to successfully uninstall Network Engineer.
To install Network Engineer, follow the instructions in the Telcordia Network Engineer
Administrators Installation Guide. To access this document, select the START MENU > ALL
PROGRAMS > TELCORDIA TECHNOLOGIES > NETWORK ENGINEER > DOCUMENTATION LIBRARY help file.
Important: Please make sure that you have completed all the necessary steps in “Preparing
the System,” on page 17.
19
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Installation BD-NE-6.1-DA-USRADM-001
Installing or Upgrading Design Assistant Issue 1, January 2010
1 Insert the Telcordia Network Engineer Design Assistant DVD. The DESIGN ASSISTANT SETUP
screen displays.
2 Click NEXT.
20
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Installation
Release 6.0 Installing or Upgrading Design Assistant
3 From the READY TO INSTALL screen, click NEXT to start the installation process.
- or -
21
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Installation BD-NE-6.1-DA-USRADM-001
Upgrading or Installing Design Assistant in the Network Engineer Database Issue 1, January 2010
5 Once the installation is complete, the screen below displays. Click FINISH to complete the
installation.
• If you are upgrading Design Assistant — meaning that you have previously used Design
Assistant on this database — then you run the [Link] file. You do
not run the [Link] file.
22
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Installation
Release 6.0 Upgrading or Installing Design Assistant in the Network Engineer Database
• If you are installing Design Assistant — meaning that you have never used Design
Assistant on this database — then you will modify the [Link] file to
reflect your landbase coordinate system, run the modified file, and then run the
[Link] files.
Continue with the next section “Determining Whether You Need to Modify and Run the
[Link] File” to ensure that you run the necessary files.
1 Select the START > ALL PROGRAMS > ARCGIS > ARCCATALOG menu item. The ARCCATALOG
dialog box displays.
2 Double-click the SDE connection in the treeview for the database you are upgrading.
3 Review the items in the CONTENTS tab to determine if the [Link] SDE
feature dataset is present. Proceed as follows:
• If the [Link] SDE feature dataset is listed, then you have previously
used Design Assistant on this database. Do not modify or run the
23
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Installation BD-NE-6.1-DA-USRADM-001
Upgrading or Installing Design Assistant in the Network Engineer Database Issue 1, January 2010
• If the [Link] SDE feature dataset is not listed, then you have not
used Design Assistant on this database. You must modify and run the
[Link] file to use your landbase coordinate system. Continue
with “Modifying the [Link] File for a Custom Coordinate
System.,” on page 24.
24
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Installation
Release 6.0 Upgrading or Installing Design Assistant in the Network Engineer Database
Use the [Link] from the Network Engineer\NEDatabase\Bin directory to add the
Design Assistant Feature Classes to the database. The Inferred Node and route Line feature
classes are created.
25
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Installation BD-NE-6.1-DA-USRADM-001
Upgrading or Installing Design Assistant in the Network Engineer Database Issue 1, January 2010
2 Click ADD CONNECTION at the bottom of the grid to select the SDE connection file of the
Network Engineer database. The ADD DATABASE CONNECTION dialog box displays.
a In the LABEL/NAME field, key in a short, descriptive name for the database. This
name displays in the CONNECTION column of the DB UPGRADE dialog box.
b In the SDE CONNECTION field, use the BROWSE button to select the SDE connection
file.
c Use the pull-down menu in the TYPE field to select CONTROL AND INSTANCE DATA.
d Click ORACLE CONNECTION and key in the required connection information as well as
the Oracle and NE passwords.
e Click TEST CONNECTION to ensure that the service, instance, database, username and
password are valid. If the TEST CONNECTION button is disabled, the test is successful.
26
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Installation
Release 6.0 Upgrading or Installing Design Assistant in the Network Engineer Database
Tip! You can add connections to upgrade multiple databases at one time if
all of the databases meet the same requirements for running one or both of
the xml files. See “Determining Whether You Need to Modify and Run the
[Link] File,” on page 23 for more information.
f Click SAVE to exit the ADD DATABASE CONNECTION dialog box. The connection file
displays in the grid.
3 Follow the steps below to first run the [Link] file, if required.
If you are unsure whether you need to run the [Link] file,
repeat the steps in “Determining Whether You Need to Modify and Run the
[Link] File,” on page 23. Then follow the same steps to run
the [Link] file. You run the [Link] file regardless
of whether you are installing or upgrading Design Assistant.
a Click the BROWSE button in the SCRIPT file section and navigate to the following
directory:
c Click GO to start the update process. The STATUS dialog box displays.
d When the process finishes, click CLOSE button on the STATUS dialog box.
- or -
If errors are encountered, see “Using the DBUpgrade Progress Dialog Box,” on
page 28 to start and stop the database upgrade process.
27
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Installation BD-NE-6.1-DA-USRADM-001
Upgrading or Installing Design Assistant in the Network Engineer Database Issue 1, January 2010
• STATUS — progress for the step as well as any returned output information.
28
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Installation
Release 6.0 Upgrading or Installing Design Assistant in the Network Engineer Database
• See detailed results, errors, or other details for a specific step. Select the step and click
VIEW STEP OUTPUT. The STEP RESULTS dialog box displays a read-only view of the current
step’s status.
• Stop the upgrade process. Click STOP from the PROGRESS dialog box.
• Restart the upgrade process. Select the script file and check the AUTO RESUME option
(this button displays only after the first use of DBUpgrade). This enables the utility to
start at the point where it the process was interrupted.
29
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Installation BD-NE-6.1-DA-USRADM-001
Upgrading or Installing Design Assistant in the Network Engineer Database Issue 1, January 2010
30
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
2
Design Assistant Key
Concepts
The Design Assistant application provides tools to aid in the design and layout of new
networks based on a customized set of guidelines. Design Assistant offers the following
major features:
• Configuration tools that enable administrators to establish guidelines or rule sets for
creating required network types. A Wizard Builder tool also lets administrators create
customized wizards which are used to walk planners through the network design
process in Network Engineer.
• Network consistency. Administrators can select certain models for use in network plans.
The pre-selected models are placed in the Design Assistant Wizard where they can be
selected by planners. This promotes standardization of equipment, spans, structures,
and transmedia. It also ensures that planners use the best models to use in the given
scenario.
• Connectivity establishment. Design Assistant determines how the placed models must
be connected to form the network.
31
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Key Concepts BD-NE-6.1-DA-USRADM-001
Design Assistant Components Issue 1, January 2010
32
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Key Concepts
Release 6.0 Design Assistant Components
For example, to create an underground copper network, you can define a rule set that
specifies the following:
For a fiber network, you can use the same spans and structures as for the underground
copper network, but you can also specify fiber cables, fiber splices and equipment.
Once networks and rule sets are defined, the configuration tools include a wizard builder that
enables you to apply your rule sets to create an automated workflow for Network Engineer
planners.
The Design Assistant configuration tools reside within the NE Toolbox application and are
discussed in detail in “Design Assistant Configuration Tasks”.
33
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Key Concepts BD-NE-6.1-DA-USRADM-001
Three-Tier Network Solution Issue 1, January 2010
34
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Key Concepts
Release 6.0 Three-Tier Network Solution
• Possible routes.
The three network tier types listed above are the default names provided with Design
Assistant.
2 Serving Points. The equipment location, which provides service to one or more demand
points. The Serving Point itself is provided service by the Provide Point.
3 Demand Locations. The actual location where copper pairs and/or fiber strands are
needed to supply service. The Customer Demand Point is provided service from the
Serving Point.
Using the Design Assistant configuration tools in NE Toolbox, you can change the names of
the network tier types and use the supplied default values. Or, you can create your own
network tier types; however, the network tier type you create must still provide one of the
three defined functions.
35
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Key Concepts BD-NE-6.1-DA-USRADM-001
Three-Tier Network Solution Issue 1, January 2010
Rule sets can be created for different parts of the network. The rule sets can also be
subdivided by network category to allow a rule set to define just the network between the
Provide Point and Serving Points. This provides the flexibility to apply multiple rule sets on
the same part of the network (Provide Network) but apply different rules depending on the
network category of the items (Copper or Fiber transmedia, for example).
Generated Networks
The Provide and Supply networks that connect the network tier types are automatically
generated from rule sets available in a Design Assistant Wizard in the Network Engineer
application.
Provide Network
This network connects the provide point to the serving point(s). This network is generated
from the following user information.
• Provide point.
• Placed and fully connected route line—including connection to the provide point.
• List of serving point locations.
• Demand at each serving point location.
36
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Key Concepts
Release 6.0 Design Assistant Feature Classes
Supply Network
The supply network connects between the generated serving point and demand points. This
network is generated from the following user information.
2 Use the administrative Design Assistant tools in NE Toolbox to define your rule sets and
create the wizards for the planners. Refer to “Design Assistant Configuration Tasks”.
3 Make sure the Network Engineer client is installed on each client machine and is
properly connected to the required server.
4 Planners can then open Network Engineer, create a work order and use the Design
Assistant Wizard to assist them in creating the desired networks.
37
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Key Concepts BD-NE-6.1-DA-USRADM-001
Where to Go from Here Issue 1, January 2010
38
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
3
Design Assistant
Configuration Tasks
The first step in using the Design Assistant is to define the rule sets for wizards as well as
select models to be used within Network Engineer. This chapter describes each Design
Assistant configuration tool provided in the NE Toolbox application and explains how to set up
models in Model Builder.
Make sure you have already installed the Network Engineer, Model Builder and NE Toolbox
applications on at least one client machine.
Rule Sets
The rule set is used to implement planning policies and derive standard, repeatable behavior.
Each rule consists of the following:
The evaluation of arrays is specific to what they are being applied to. For example, in using
Copper transmedia, the Design Assistant will use the cheapest form (smallest) of copper
cable first.
• Serving Point
• Transmedia
• Route
• Service
Use the Design Assistant Toolbox tools to set up the attribute values available for each of the
rule set types and then create your own customized rule sets based on these types.
39
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Rule Sets Issue 1, January 2010
• In the owning structure of the demand point. For example, in an apartment, the serving
point may be located on the same floor (parent structure).
• In some other “ancestor” structure of the demand point; for example, in the building
rather than the floor.
Note: Transmedia rule sets need to be created for using complex models such as MDUs
(multiple dwelling units). You need to take into account all elements comprising a complex
model to create the needed rule sets for the supply and serving point transmedia.
Route rule sets act upon route lines. Route lines of different types can invoke different rule
sets. The route lines can result from the different sources listed below.
• Manually placed. Typically this covers the creation of the spine route.
• Identified from a selection set. Users have the option to select existing spans and place
route lines following the selected spans.
• Inferred. Route lines that are automatically generated based on the rule set definitions.
These route lines are generated between the serving point to the customer demand
locations.
40
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Security
You can modify these rule sets to meet your needs as well as create rule sets of your own.
The attributes and default values for these rule sets are listed later in “Sample Rule Set
Attributes and Default Values”. Models being used by these sample rule sets are also
provided with Design Assistant and are discussed in detail in “Modelling for Optimization”.
Security
Users must have Oracle system administrator and Network Engineer administrator privileges
to use NE Toolbox Design Assistant tools. The Design Assistant Security model is available in
the Engineer and Administrator usergroups. For more information about security
management in Network Engineer, refer to the security tool section in the NE Toolbox User’s
Guide.
41
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Creating Required Models Issue 1, January 2010
• It is recommended that the Point Status attribute for models be set to OLD. This enables
the model to be used by Design Assistant, even if it was placed before a wizard is run.
If the network demand is 200, Design Assistant selects two of the 100-pair cables
(2*0.4 < 1*1.0), but if the demand goes to 210, Design Assistant selects the 250 pair
cable (3*0.4 > 1*1.0).
• When creating ports to be used in splitter equipment, you must define two port
attributes: port direction and port connector type. Support for the port type and port
direction attributes enables Design Assistant to pick the correct equipment and connect
it properly. Example situations include:
• Placing terminating equipment. Design Assistant looks at the number of Out ports.
• Connecting from an equipment. Design Assistant looks at the number of out ports.
The port direction values are IN, OUT, or IN/OUT. The IN/OUT value is the default
setting. An attribute in a Transmedia rule set indicates which port types the rules set
should be connecting to.
42
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Creating Required Models
Note: If you deleted any of these Network Engineer models and you do want to use the
Design Assistant sample data set, contact Telcordia customer service for further instructions.
Structures
• HANDHOLE
• PEDESTAL
• Small Cabinet (pad)
• Large Cabinet (pad)
• MANHOLE
Spans
• Duct Str
• Joint Trench
• Trench
Span Units
• 4" PVC Duct
• 1" Duct
Equipment
• 2 Port Tap
• 4 Port Tap
• 8 Port Tap
• 25 PR TERM
• 50 PR TERM
• 100 PR TERM
• 900X-X Conn
43
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Creating Required Models Issue 1, January 2010
Transmedia
• 25x24-B
• 50x24-B
• 100x24-B
• 200x24-B
• 900x26
Splice Closure
• Underground Copper (UG) Splice
• Spine
• Rider
• Lead-in
• Define the type and number of structure units to place inside the complex structure.
• Perform the required cabling from the serving point into the structure units.
44
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Creating Required Models
For example, planners can quickly build an apartment building consisting of multiple floors
and rooms (generated complex model is not to scale). The necessary cabling running to each
room can also be created in minutes.
When planners go through the wizard, the Complex Structure Placement tool displays when
the system detects that a complex model has been placed. For this detection to occur, you
must use the Model Builder application to mark each structure model you want to use as
complex.
1 Open the Model Builder application: START menu > PROGRAMS > TELCORDIA TECHNOLOGIES >
MODEL BUILDER.
2 Select the STRUCTURE node under the PLACEABLE MODELS tree view. All structure models
display in the right-hand list pane.
4 Scroll to the COMPLEX STRUCTURE attribute. Double-click in the field to enable a pulldown
list and select Y (Yes).
45
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Modelling for Optimization Issue 1, January 2010
Note: Design Assistant places inferred nodes to represent structure units inside a building
model.
6 Once validation is successful, click SAVE to save your edits and then exit the MODEL
BUILDER ATTRIBUTE EDITOR screen.
7 Once the model is validated and ready for production, you can select it in the Design
Assistant wizard builder. As your planners run the wizard, they can select from your
specified complex models.
3 Sizing structures.
For Design Assistant to perform these operations, you must define specific attributes for the
models being used in the network. Required attributes and model classes are listed below.
Span Unit HEIGHT Determines if the span unit can fit in the span.
WIDTH
Span WIDTH
46
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Modelling for Optimization
Table 3-1 Required Attribute Definitions for Models Used in a Network (Continued)
47
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Tool Summary and Workflow Issue 1, January 2010
• Add chassis and structure units (i.e., racks) to existing equipment models.
2 Network Category/Type Definition. Use this tool to define one of the three network tier
types. Network categories (copper vs. fiber, for example) can be created by the
Administrator to define each network tier type.
3 Rule Set Attribute Definition. Use this tool to define customer-specific attributes per rule
set type.
4 Rule Set Definition. Use this tool to create rule sets based on the type and individual
attribute settings. The rule set defines the values of the attributes that were created in
the Rule Set Attribute Definition tool.
5 Rule Set Mapping. Use this tool to associate route rule sets to route line inventory
objects by class, category, and type.
6 Task Definition. Use this tool to define a task and associate a custom tool/library to
implement the task.
7 Wizard Builder. Use this tool to define, save, modify, and delete the definition of a plan
as a wizard that can be run in Network Engineer. Once you have created the necessary
wizards, planners can open Network Engineer and follow the wizards to create the
network(s).
The remaining sections in this chapter describe how to use each of these tools.
48
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Displaying the Design Assistant Toolset in NE Toolbox
4 Place a checkmark beside all the tools that are listed and click OK.
Note: If the equipment model is defined down to the port in Model Builder, the Extended
Equipment Definition tool is not needed.
Prerequisites
To enable Design Assistant to use the equipment defined in this tool, you must set the
Dimensions and Weighting (see “Creating Required Models”) attributes for the equipment
models created/modified in Model Builder. Weighting is a relative prioritization of models and
is used to determine the order of placement. Weighting also determines what transmedia to
place to satisfy the demand. Design Assistant picks the smallest weighting.
Use the Model Builder application to create the required equipment models and provide
values for these attributes before using the Extended Equipment Definition tool. Otherwise,
the Design Assistant application will not be able to determine the sizes of the equipment as
they are placed.
49
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Extended Equipment Definition Issue 1, January 2010
Extending Equipment
Follow the steps below to expand equipment models.
1 From the NE Toolbox tree, select EXTENDED EQUIPMENT DEFINITION under the Design
Assistant toolset. The EXTENDED EQUIPMENT DEFINITION dialog box displays.
Note: If you could not add the Design Assistant toolset, please contact your Telcordia
customer support for further instructions.
- or -
Click ADD DEFINITION. An empty row is added to the bottom of the grid.
50
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Extended Equipment Definition
3 Click in the EQUIPMENT MODEL column to display a BROWSE button. Click the BROWSE button
to open the MODEL SELECTOR dialog box.
4 From the MODEL list, double-click on the equipment model you want to use. The model
displays in the EQUIPMENT MODEL field.
5 Click in the CHASSIS MODEL field to display a BROWSE button. Click the BROWSE button to
open the MODEL SELECTOR dialog box. Select the chassis model you want to associate to
the equipment model.
6 Click in the MAXIMUM NUMBER column and key in the number of chassis that can be placed
inside the equipment model.
7 Click in the STRUCTURE UNIT MODEL column. Click the BROWSE button to open the MODEL
SELECTOR dialog box and choose a structure unit to be associated to the equipment.
51
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Network Category/Type Definition Issue 1, January 2010
8 Click in the MAXIMUM STRUCTURE column and key in the number of structure units that can
be placed inside the equipment model.
Note: The Extended Equipment tool does not perform checking as far as ensuring the fit
of chassis into the equipment. You must define the dimensions (height, width and
depth) correctly on the models to help Design Assistant size and associate the items
properly.
9 Click OK to save your changes when you are finished. If you modify an equipment
model, your edits take effect the next time the equipment model is placed. Any
equipment models that have already been placed do not change.
- or -
11 Click REMOVE DEFINITION. The expansions to the model are now removed. This
removal does not effect any of the selected equipment models that have already been
placed.
• Serving Points. The eventual equipment location, which provides service to one or more
demand points. The Serving Point itself is provided service by the Provide Point and acts
as a distribution point to its customer/demand points.
• Customer Demand Points. The actual location where copper pairs and/or fiber strands
are needed to supply service. The Demand Point is provided service from the Serving
Point.
52
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Network Category/Type Definition
You can change the names of the network tier types and use them. Or, you can create your
own network tier types; however, the type you create must still provide one of the three
defined functions.
Network Categories
Rule sets can be created for different parts of the network. The rule sets can also be
subdivided by network category to allow a rule set to define a specific network. For example,
a network category that specifies just the network between a provide point and serving
points. Categories can be defined to the desired level as determined by customer needs such
as subdividing the copper category into inside plant copper and outside plant copper
categories.
Prerequisites
Before you use the Network Category/Type Definition tool, plan out your category and types
that you need as well as the naming scheme. This will help you once you begin the creation
process. If category or type names (domains) are changed once networks are built, they
become invalid.
53
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Network Category/Type Definition Issue 1, January 2010
Note: If you could not add the Design Assistant toolset, please contact your Telcordia
customer representative for further instructions.
54
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Network Category/Type Definition
2 In the Name field, delete the current name and key in your desired name. Then delete
the current description in the DESCRIPTION field and key in a new one.
- or -
- or -
Click CANCEL to close the dialog box and undo the edits.
55
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Network Category/Type Definition Issue 1, January 2010
1 From the NETWORK TYPE/CATEGORY DEFINITIONS dialog box, click the ADD TYPE button.
NEW TYPE and NEW DESCRIPTION display in the NAME and DESCRIPTION fields.
2 Delete the text and key in the type name and a brief description (up to fifty characters).
The new type and description display in the TYPES PER CATEGORY pane.
- or -
- or -
Click CANCEL to close the dialog box and undo the additions.
56
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Network Category/Type Definition
1 From the NETWORK TYPE/CATEGORY DEFINITIONS dialog box, click the ADD CATEGORY
button. NEW CATEGORY and NEW DESCRIPTION display in the NAME and DESCRIPTION fields.
2 Delete the text and key in the category name and a brief description.
- or -
- or -
Click CANCEL to close the dialog box and undo the additions.
57
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Rule Set Attribute Definition Issue 1, January 2010
- or -
Click DELETE CATEGORY to remove the item from the display list.
- or -
- or -
Click CANCEL to close the dialog box and undo the changes.
Any categories and/or types that are removed are no longer available for work sessions from
the time of deletion forward.
Caution! When you delete a category or type, the existing planning definition, rule sets, and
any reference models can be affected. It is recommended that you only remove categories
and types you know that are not in use.
Use this tool to perform the following for each rule set type.
• Add an attribute.
• Remove an attribute.
58
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Rule Set Attribute Definition
Before you begin, take a few minutes to review the attributes that can be selected for each
rule set type.
59
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Rule Set Attribute Definition Issue 1, January 2010
• Trace. Apply route to existing route lines and do not deviate from those lines. This
can be used for explicit networking from serving point to demand [Link] the map
the route line-spine is shown in red, the trace route only follows the route line, it
does not connect the demand points-SDU.
60
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Rule Set Attribute Definition
• Direct. Apply straight-line for the route from serving point to demand point
typically for direct feed either via underground or aerial. The route line is drawn
from the cabinet in the street centerline, the direct route type draws the route to
the demand point -SDU directly from the inferred node- serving point.
61
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Rule Set Attribute Definition Issue 1, January 2010
• Rider. Run parallel to existing route lines with a perpendicular route to the demand
point. The rider route type is the most commonly used route policy type, the routes
are drawn from the route line-spine and create perpendicular connections to the
demand points-SDU.
62
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Rule Set Attribute Definition
• Snap. Run perpendicular to existing route lines. The Snap is very similar to the
Rider route type.
• RIDER_ROUTE_LINE_MODEL. The model used for the parallel aspects in a Rider route
policy.
63
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Rule Set Attribute Definition Issue 1, January 2010
• LEADIN_ROUTE_LINE_MODEL. The model used for the inferred route line in a Snap
route policy, or the last leg of the Rider policy.
• INTERNAL_ROUTE_LINE_MODEL. The model used for the placement of route lines for
complex structures.
• START_OBJECT_CATEGORY. Network category that identifies the start of the network for
this rule set.
• SPLICE_TRANSMEDIA. Priority list of splice types starting with the smallest (i.e, used to
splice two small transmedia). The splice type is related to the transmedia; pressurized
rule sets use pressurized splice kits. It is cheaper to have less splices in a network.
64
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Rule Set Attribute Definition
• TERMINATE_EXCESS. If enabled (set to YES), any transmedia greater than the demand
is fully terminated at the terminating equipment. For example, if the demand is for
three pairs, but the minimum cable is five pairs, then all five pairs are terminated, if
ports are available. Typically, a YES value is set for the provide network and NO for the
supply network.
• Percentage. Planner must enter a percentage value, typically greater than 100%.
For example, a value of 110 means set the cable to 110% of the of the geographic
length.
• Fixed. Planner must set a fixed value to add to each cable that is placed. For
example, if the fixed value is set to 10, Design Assistant would add 10 units (where
a unit is determined by the measurement being used) to each cable that is placed.
65
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Rule Set Attribute Definition Issue 1, January 2010
• PORT_CONNECTOR_TYPE. Defines which port type the rule set can connect to. The
default value is ANY. When creating ports to be used in splitter equipment, you must
define two port attributes: port direction and port connector type in Model Builder.
Support for the port type and port direction attributes enables Design Assistant to pick
the correct equipment and connect it properly. The port direction values are IN, OUT, or
IN/OUT. The IN/OUT value is the default setting.
• END_STRUCTURE. End structures are placed along span paths that change from one
span type to another and cross over route line rule sets. A typical example of this is a
reducer placed at the end of a run between a Rider and Lead-in to the customer demand
location.
• SPAN_MODEL. Span model to be placed on the route line when the network is created.
• SPAN_UNIT_MODEL. Model to be used for additional span units if the initial model is
insufficient.
66
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Rule Set Attribute Definition
• ATTENUATION_LINE_LOSS_1. Maximum line loss value for the network that cannot be
exceeded.
Note: If line loss, wavelength, and frequency values are not set in the rule set, line loss is not
used by Design Assistant.
67
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Rule Set Attribute Definition Issue 1, January 2010
68
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Rule Set Attribute Definition
69
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Rule Set Attribute Definition Issue 1, January 2010
Table 3-3 Sample Transmedia Rule Sets, Attributes, and Default Values (Continued)
70
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Rule Set Attribute Definition
71
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Rule Set Attribute Definition Issue 1, January 2010
Table 3-4 Sample Route Rule Sets, Attributes, and Default Values (Continued)
72
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Rule Set Attribute Definition
• Create a COM object for the system to pick up the attribute, as well as handle existing
rule set attributes.
• Add any new domains. Design Assistant comes with a predefined set of categories and
types that you can use, or you can add new domains.
Creating Models
Use the Model Builder application to create all models needed for the networks your end
users/planners need to build their networks. Model Builder provides a base set of models that
you can modify, or you can create your own from the ground up to suit your needs. Refer to
the Model Builder User’s Guide.
Once the required models have been created, you can control the models that end users or
planners can select and use through these Design Assistant toolbox tools.
• Range domain. A range domain specifies a valid range of values for a numeric attribute.
For example, you can set the minimum and maximum length for cables in your system.
A range domain specifies this range of values.
• Coded value domain. A coded value domain can apply to any type of attribute—text,
numeric, date, and so on. Coded value domains specify a valid set of values for an
attribute. The coded value domain includes both the actual value that is stored in the
database (the CODE column in the DOMAIN EDITOR window) and a more user-friendly
description of what that value actually means (the VALUE column).
73
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Rule Set Attribute Definition Issue 1, January 2010
• SQL Statement. A range of attribute values defined by an SQL statement. The WHERE
clause is used to specify that only certain rows of the table are displayed, based on the
criteria described in that WHERE clause. The attributes are displayed in the NETWORK
ENGINEER ATTRIBUTE EDITOR dialog box. The SQL statement applies to domains that handle
a one-to-many relationship such as setting product lines and associated manufacturers.
You can have multiple product lines associated to a single manufacturer.
• User domain. You can write your own .dll to create a domain. The .dll must access the
Network Engineer IUserDomain interface.
The VALIDATE DOMAIN column enables or disables the validation of the values users enter for
the domain.
74
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Rule Set Attribute Definition
If you want attributes to use a new domain, you must first use the Attribute Domain tool in
NE Toolbox to add the desired domain. Follow the steps below to create a domain.
1 From the NE Toolbox tree, select INVENTORY CONTROL > ATTRIBUTE CONTROL > ATTRIBUTE
DOMAIN. The DOMAIN EDITOR window displays.
2 Scroll down to the bottom of the table and key in the domain name in a blank row.
Domains for Design Assistant must have the prefix DADL_. Then key in a brief
description.
3 Use the pull-down menu in the DOMAIN TYPE column to select the type of domain you
need (CODED VALUE, RANGE, SQL or USER).
4 Click NEXT to continue. Key in the remaining information; the options provided are based
on the selected domain type.
75
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Rule Set Attribute Definition Issue 1, January 2010
Element Description
Removes an attribute from the rule set. A warning message will display
about removing attributes that have already been saved to the database.
Expands the dialog box to display the columns and automatically sizes
the grid.
RULE SET TYPE Pulldown menu used to select a rule set.
76
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Rule Set Attribute Definition
Attributes
• Name. Name of the attribute. Used internally by the COM object. Do not change the name
unless you are implementing a custom COM object.
• Display Name. Attribute name that displays in the Rule Set Definition tool.
• Attribute Type. Select one of the value types below that must be used for the attribute
in the Rule Set Definition tool.
• Model List. Requires that a prioritized model list be created for the attribute. Select
the model class to be used for the list in the LIST/MODEL CLASS NAME column in the
Rule Set Definition tool.
• List/Model Class Name. Sets the class that models must be belong to for the attribute.
For example, if the STRUCTURE CLASS and MODEL LIST values are set, then in the Rule Set
Definition tool, you can only create a prioritized list of models within the structure class.
• Display Sequence. Enables you to define the order in which to display the attributes
when defining a rule set.
Adding an Attribute
Follow the steps below to add an attribute. If you are adding a new attribute, you must
create a COM object using defined Design Assistant interfaces for the attribute to be used.
The delivered COM objects do not contain a definition for the new attributes.
1 From the RULE SET ATTRIBUTES dialog box, use the pulldown menu to select a rule set
type.
77
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Rule Set Attribute Definition Issue 1, January 2010
2 Click ADD. An empty row at the bottom of the grid is highlighted. Type in the
attribute name. Then set the remaining column options.
- or -
- or -
Click CANCEL to close the dialog box and undo the changes.
78
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Rule Set Attribute Definition
Caution! You can change the display name, but should only do so if implementing a
custom COM object.
- or -
- or -
Click CANCEL to close the dialog box and undo the changes.
79
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Rule Set Definition Issue 1, January 2010
Removing an Attribute
Caution! Removing an attribute that is currently being used within a rule set can cause
problems. Make sure the attribute is not used before removing it.
1 From the RULE SET ATTRIBUTES dialog box, use the pulldown menu to select a rule set
type.
3 Click DELETE.
4 At the warning prompt, click YES to continue with the deletion or NO to cancel.
- or -
- or -
Click CANCEL to close the dialog box and undo the changes.
Telcordia recommends that you create your rule sets in the following order: Serving Point,
Route, Transmedia, Service.
80
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Rule Set Definition
Prerequisites
You must set up all the attributes for each rule set type using the Rule Set Attribute
Definition tool.
81
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Rule Set Definition Issue 1, January 2010
Element Description
SELECT RULE SET TYPE Lists the four rule set types.
RULE SET ATTRIBUTES Lists the attributes defined for the selected rule set type.
• Validating wizards. In the Rule Set Definition tool, validation is automatically run before
a rule set is import or exported.
• Validating all wizards and rule sets. Use this toolbox tool (see “Validating All Wizards
and Rule Sets”) to check the wizards and rule sets in the current database.
The results of the validation process display in the VALIDATING WIZARDS/RULE SETS dialog box. A
tree view, containing the wizard and rule set nodes, lists all critical errors and warnings that
were found. Expand the RULE SET node in the tree view to see a description of the critical
errors and/or warnings that occurred for each rule set. Valid items are indicated by a
checkmark and listed as VALID. The figure below is an example validation report.
82
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Rule Set Definition
The following icons denote critical errors, warnings, and validation confirmations.
Icon Description
Critical error. The wizard or rule set will not validate until all critical errors are
corrected.
Warning. The wizard or rule set will validate on warnings, but there could be
problems that occur once the item is in use within Network Engineer.
Valid. The wizard or rule set has been successfully validated.
• Maximum demand points, maximum distance, and maximum demand are greater
than zero.
83
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Rule Set Definition Issue 1, January 2010
• Rider, Lead-in, and Direct Route Line models must be defined (at least one) and
available for placement.
• Internal Route Line models must be defined (at least one) and available for
placement.
• Terminating Structure points have at least one entry and all entries existent or
available for placement models.
• Intersection Structure points have at least one entry and all entries are existent
models.
• Mid Span Structure points have at least one entry and all entries are existent
models.
• End Structure points have at least one entry and all entries are existent models.
• Corner Structure points have at least one entry and all entries are existent models.
• Span Structure points have at least one entry and all entries are existent models.
• Span Unit Structure points have at least one entry and all entries are existent
models.
• Terminating equipment has at least one entry and all entries are existent models.
84
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Rule Set Definition
• Terminating transmedia has at least one entry and all entries are existent models.
• Splice transmedia has at least one entry and all entries are existent models.
How To
Follow the steps below to use the VALIDATE RULE SET command in the Rule Set Definition tool.
1 From the RULE SET DEFINITION dialog box, use the pull-down menus to set the type and
then the name of the rule set definition you want to check.
85
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Rule Set Definition Issue 1, January 2010
2 Click VALIDATE RULE SETS to open the WIZARD/RULE SET VALIDATION dialog box.
3 Expand the RULE SET node in the tree view to see any critical errors or warnings.
4 Click SAVE to save the validation results to a text file. From the SAVE AS dialog box, go to
the desired file location and type in the file name followed by the .txt extension, or
browse to overwrite an existing text file. Click SAVE to close the dialog box.
86
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Rule Set Definition
The file is a textual display of the tree view, divided into two main sections, Rule Sets
and Wizards. An example text file is shown below.
5 Click CLOSE when you have finished to dismiss the WIZARD/RULE SET VALIDATION dialog box.
You can then run steps 1 - 4 to repeat validation until you have eliminated at least all
critical errors.
2 Click NEW RULE SET. Key in the name of the rule set in the NAME attribute field and
press ENTER. The rule set name displays at the top of the attribute list.
3 Go through the attributes for the rule set and define values for the attribute.
For attributes where model lists must be set, the MODEL PRIORITIES dialog box displays.
87
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Rule Set Definition Issue 1, January 2010
- or -
For attributes requiring a single model to be selected, the MODEL SELECTOR dialog box
displays. Because the class was defined for the attribute in the Rule Set Attribution
Definition tool, only the models available for the class display. You cannot select another
class from the MODEL SELECTOR dialog box.
- or -
For attributes where model lists must be set, select models the planner can use.
The models display in the MODEL PRIORITIES dialog box. The models are listed by their
priority level starting at the top of the list. To change the priority, select the model and
use the UP or DOWN arrow keys or click DELETE to remove a model from the list.
88
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Rule Set Definition
Click OK when you have finished to close the MODEL PRIORITIES dialog box. The model
listed first in the priority list displays in the attribute field.
- or -
For attributes requiring a single model to be selected, select the model you want to add.
Click ADD and then click CLOSE.
7 Continue setting up attributes for the rule set and click APPLY.
8 Repeat steps 2 through 7 for each rule set you want to add.
1 From the RULE SET DEFINITION dialog box, use the pull-down menu to select the Rule Set
type.
2 Then from the RULE SET ATTRIBUTES field, use the pull-down menu to select the name of
the rule set you want to copy.
89
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Rule Set Definition Issue 1, January 2010
4 In the NAME field, replace NEW RULE SET DEFINITION text with the name you want to use
for the new rule set.
5 Click APPLY when you have finished. The new rule set name displays in the pull-down
menu under the RULE SET ATTRIBUTES dialog box.
6 You can now make changes to the attributes for the new rule set as well as run
validation.
7 Click OK when you have finished to close the RULE SET DEFINITION dialog box.
2 Use the pulldown menu to select a rule set. Attribute values selected for the rule set
then display.
90
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Rule Set Definition
3 You can change the name of the rule set. Double-click the rule set NAME field and key in
the desired name. Press ENTER when you are done. The new rule set name displays at
the top of the attribute list.
4 Go through the attributes for the rule set and change attribute values.
5 To change models or the priority of models for certain attributes, use the pulldown
menu to select MODIFY LIST. The MODEL PRIORITIES dialog box displays.
You can add or remove models from the list. Use the UP and DOWN arrow keys to change
the priority list. Click OK when you have finished to close the MODEL PRIORITIES dialog
box. The model listed first in the priority list displays in the attribute field.
- or -
To change a single model for an attribute, use the pulldown menu to select MODIFY LIST.
The MODEL SELECTOR dialog box displays.
Select the model you want and click ADD. Click CLOSE when you have finished. The
model displays in the attribute field.
6 Continue changing the desired attributes for the rule set and click APPLY.
7 Repeat steps 2 through 6 for each rule set you want to change.
8 Click OK when you have finished to close the RULE SET DEFINITION dialog box.
2 Use the pulldown menu to select a rule set. Attribute values selected for the rule set
then display.
3 Click DELETE RULE SET. At the prompt, click YES to continue or NO to cancel the
deletion.
Caution! When you delete a rule set, any wizards that use the rule set will no longer
work. Removal of rule sets do not affect networks that have already been created.
91
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Rule Set Definition Issue 1, January 2010
1 From the RULE SET DEFINITION dialog box, click IMPORT RULE SETS.
2 Click BROWSE and locate the XML file containing the rule set(s) you want to import (you
can import multiple rule sets). Click OPEN. The selected XML file displays in the IMPORT
FROM FILE field.
3 In the ITEMS IN FILE TO IMPORT display, all rule sets contained in the selected XML file
display and are automatically checked for import, as shown in the figure above. For any
rule set(s) in the list you do not want to import, click the corresponding checkbox to
unselect it. Click IMPORT to start the import process.
During the import process, if a rule set already exists in your Design Assistant database with
the same name as one of the rule sets you are importing, you are prompted to either
92
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Rule Set Definition
overwrite the existing rule set, rename the rule set being imported, or cancel the operation.
You will receive the prompt for each duplicated rule set name.
Once the import has completed, the new wizards can now be selected when using the Design
Assistant Wizard command in Network Engineer. To see the new rule sets, use the RULE SET
DEFINITION NE Toolbox tool.
1 From the RULE SET DEFINITION dialog box, click EXPORT RULE SETS. The WIZARD/RULE SET
EXPORT dialog box opens.
In the ITEMS IN DATASET TO EXPORT display, all rule sets contained in the selected XML file
display and are automatically checked for export, as shown in the figure above. For any
rule set(s) in the list you do not want to export, click the corresponding checkbox to
unselect it. Click EXPORT to start the export process.
93
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Rule Set Mapping Issue 1, January 2010
2 Under EXPORT TO FILE, click BROWSE to open the SAVE AS dialog box. Select the location of
the XML file and type in the desired file name. Click SAVE. The XML file displays in the
EXPORT TO FILE field.
3 In the ITEMS IN DATASET TO EXPORT display, click the checkbox next to one or more rule
sets in the list and click EXPORT to start the export process.
During the export process, if a rule set already exists in your Network Engineer
database with the same name as one of the rule sets you are exporting, you are
prompted to either overwrite the existing rule set, rename the rule set being exported,
or cancel the operation. You will receive the prompt for each duplicated rule set name.
Once the export has completed, use the IMPORT WIZARD command to load the rule sets to
another Network Engineer database.
Prerequisites
The network tier types and categories must be defined (see “Network Category/Type
Definition”). Also, the route line rule sets must be defined (see “Rule Set Definition”).
94
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Rule Set Mapping
Element Description
Adds a new Route Line class that can be mapped to a network category, type,
and rule set.
Removes the mapping association.
95
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Rule Set Mapping Issue 1, January 2010
Element Description
2 Use the pulldown menus to select the Network Category and Type to associate to route
line inventory objects.
3 Use the pulldown menu to select the RULE SET you want to use.
- or -
- or -
Click CANCEL to close the dialog box and undo the changes.
Note: The same rule set can be associated to multiple classes, categories and/or types.
Removing Associations
1 From the ROUTE LINE RULE SET MAPPING dialog box, select the mapping row you want to
remove.
96
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Task Definition
- or -
- or -
Click CANCEL to close the dialog box and undo the changes.
Note: Deleting an association does not affect networks that were previously created.
Task Definition
The Task Definition tool enables you to create a task type and assign a COM component to
perform that task. You can create a variety of custom tools for use within Network Engineer
to assist in creating your network.
Prerequisites
Create the COM object. Design Assistant has defined COM interfaces that you must use.
Locate [Link] in your Design Assistant\Bin directory. You must implement
both the INEDAIdentification and INEDATask interfaces when creating your COM object.
INEDAIdentification
• Task Name and Description. Name and a brief description of the task.
• Task Type. The task type code defined in the Task Definition tool.
INEDATask
• Initialize. Initializes the COM object.
97
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Task Definition Issue 1, January 2010
98
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Task Definition
Element Description
Add a COM component. Opens a BROWSE dialog box for you to select
the .dll file of the component to implement the task.
Remove the selected task association.
Opens the TASK TYPE DEFINITION dialog box to add or remove a task
type.
TASK TYPE Lists the task types defined using the TASK TYPE DEFINITION dialog box.
TASK NAME Shows the name that displays in the wizards you will build. The task
name is taken from the COM component .dll.
TASK DESCRIPTION Shows a brief description of the task. The description is also taken
from the COM component .dll.
Select Starting NE Design Assistant Select Starting Identifies a starting point in the
Point Point network.
Serving Point Design Assistant Serving Point Rule Design Assistant serving point rule
Rule Set Set Object set object.
Route Line Rule Design Assistant Route Rule Set Design Assistant route rule set
Set Object object.
NE Design Design Assistant Wizard Object Design Assistant wizard object.
Assistant
Wizard
Address Dress Generation - Non Complex Dress generation for non-complex
Generation - Structures structures.
Non Complex
99
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Task Definition Issue 1, January 2010
1 From the TASK DEFINITION dialog box, click ADD/REMOVE TASK TYPE.
100
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Task Definition
2 Click NEW TASK TYPE. The cursor moves to the last row in the grid. Enter the task
type code (maximum twenty characters) and description from the COM component you
will use in the TASK TYPE CODE and DESCRIPTION columns.
Caution! Do not remove or change the delivered task type codes because the delivered
COM objects are using these codes.
3 Click APPLY to save your changes and continue adding or removing types.
- or -
The new task(s) displays in the TASK TYPE DEFINITION dialog box.
4 Select the new task in the grid and click ADD A COMPONENT. A browse dialog box
displays. Navigate to the directory containing your component and select the .dll. Click
OPEN to select the file and close the BROWSE dialog box.
The task name and description taken from the COM component display in the grid.
- or -
Click OK to save your changes and close the TASK DEFINITION dialog box.
- or -
Click CANCEL to close the dialog box and undo the changes.
1 From the TASK DEFINITION dialog box, select the row containing the COM component you
want to remove.
101
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Task Definition Issue 1, January 2010
2 Select the task type you want to delete and click DELETE TASK TYPE. The task type is
removed from the display grid.
- or -
- or -
Click CANCEL to close the dialog box and undo the changes.
Caution! Any network that was created using the removed task type is not affected.
However, any COM objects using that task ID code cannot be created if the task code is
removed or changed.
102
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Wizard Builder
Wizard Builder
The Wizard Builder tool enables administrators to create wizards that guide planners through
the process of network development. Each wizard can implement specific rule sets defined
for a specific network tier type.
Prerequisites
The following tasks need to be performed before building the wizards.
• Creating the rule sets (see “Rule Set Definition”). Each rule set contains a set of defined
attributes (see “Rule Set Attribute Definition”).
• Map the route rule sets to routing inventory objects (see “Rule Set Mapping”).
• Create COM objects that implement specific tasks (see “Task Definition”).
103
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Wizard Builder Issue 1, January 2010
2 Click NEXT to continue. The Wizard Builder steps you through each of the available
options:
• Copying a wizard
• Importing a wizard
104
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Wizard Builder
• Exporting a wizard
• Validating wizards
As you are going through the wizard, click NEXT to continue to the next operation. Click BACK
to return to the previous operation to make changes, or click CANCEL to end the process.
Wizard Information
3 Key in a wizard name in the ENTER NEW WIZARD NAME field. You can use up to 32 alpha-
numeric characters. If you attempt to use a name that is already being used, the wizard
will not allow the name and will prompt you to enter a different name.
4 In the DESCRIPTION field, key in a brief description of the wizard for the planner to view.
105
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Wizard Builder Issue 1, January 2010
5 By default, NEW SITE is already selected. Currently, Design Assistant only supports new
site development.
6 Click NEXT.
Map Import
7 Click YES to import a background map. When the planner runs the wizard you are
creating, a BROWSE dialog box displays for the planner to select the required raster map
file to be added to the map.
- or -
The SELECT DEMAND POINTS display list shows the demand point structures that will be
displayed for use in the planner’s Network Engineer model palette.
106
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Wizard Builder
9 Click YES to enable the planner to place demand points. Continue with the remaining
steps in this section.
- or -
Click NO to disallow planners from placing demand points. Click NEXT to move to the
next section.
10 Click ALL to allow the planner to use all demand point structure models in the database.
- or -
d Close the MODEL SELECTOR dialog box when you have finished.
- or -
107
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Wizard Builder Issue 1, January 2010
Route Lines
This option indicates whether or not the planner can place new route lines. It also defines the
route lines that can be placed.
15 Click YES to enable planners to place route lines. Continue with the remaining steps in
this section.
- or -
Click NO to disallow planners from placing new route lines. Click NEXT to move to the
next section.
The SELECT ROUTE LINE MODELS display list shows the route line modes that will be
displayed for use in the planner’s Network Engineer model palette.
16 Click ALL to allow the planner to use all route line models in the database.
- or -
d Close the MODEL SELECTOR dialog box when you have finished.
108
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Wizard Builder
This section defines the rule sets planners can use when determining the serving point
locations.
19 Click the PLUS button to open the SELECT RULE SET dialog box. You can select one or
more rule sets from the list. Use the CTRL+ or SHIFT+ keys when selecting multiple rule
sets. Click ADD to place the selected rule sets in the serving point rule set display.
20 Once rule sets are added, use the up and down arrow buttons to change the order of the
rule sets.
109
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Wizard Builder Issue 1, January 2010
21 Click CLOSE when you have finished to close the Select Rule Set dialog box.
22 Use the up and down arrow buttons to set up the display order of the rule set.
23 If there is no rule set defined, then that step will be skipped when the wizard definition
is executed by the planner.
This section defines the rule sets planners can use when determining the transmedia and
equipment that need to be used. You can select rule sets for both provide and supply
transmedia.
25 Click the PLUS button to open the SELECT RULE SET dialog box. Use the CTRL+ or
SHIFT+ keys to select multiple rule sets. Click ADD to place the selected rule sets in the
transmedia rule set display.
26 Once rule sets are added, use the up and down arrow buttons to change the order of the
rule sets.
27 Click CLOSE when you have finished to close the SELECT RULE SET dialog box.
28 Use the UP and DOWN arrow buttons to set up the display order of the rule set.
If there is no rule set defined for a particular category, then that step will be skipped
when the wizard is executed by the planner.
110
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Wizard Builder
This section defines the rule sets planners can use when determining line loss.
30 Click the PLUS key to open the SELECT RULE SET dialog box. Use the CTRL+ or SHIFT+
keys to select multiple rule sets. Click ADD to place the selected rule sets in the
transmedia rule set display.
31 Once rule sets are added, use the UP and DOWN arrow buttons to change the order of the
rule sets.
32 Click CLOSE when you have finished to dismiss the SELECT RULE SET dialog box.
33 Use the UP and DOWN arrow buttons to set up the display order of the rule set.
If there is no rule set defined for a particular category, then that step will be skipped
when the wizard is executed by the planner.
111
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Wizard Builder Issue 1, January 2010
This section sets options on whether or not the planner can edit serving point information or
move routes, structures, spans, equipment and transmedia after placement.
35 For each question, click YES to allow the planner to perform the action, or NO to the
planner from performing the action.
112
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Wizard Builder
37 Set options for structure sizing and automatic transmedia associations, as follows:
• DISPLAY ADDRESS DIALOG. Select NO if you do not want the SIMPLE ADDRESS dialog box
to display when the user gets to the Place Demand Points step in the wizard.
• OPTIMIZE STRUCTURE LOCATIONS. Select NO to skip the extra internal processing that
minimizes the number of transmedia splice points based on rearrangement of mid-
span structures. This is a processing step with no user interaction. This could also
be turned off during testing of new wizards to allow for faster processing through
all the wizard steps.
• AUTOMATICALLY SIZE STRUCTURES. If you select YES, you must have size information
defined for span unit and structure models to be used. Without these attributes
defined, Design Assistant displays an error message for every structure being
placed because it cannot properly size the model. Select NO to skip the structure
sizing optimization step. This enables the user to turn this option off until these
attributes are defined or for quickly testing a wizard or rule set. Additionally it may
be determined by the user that only one structure is to be placed for each of the
structures types, in which case there is no sizing optimization to be performed. Any
structure changes deemed necessary by the user can be handled at the edit point
by replacing it with the correct structures.
Note: To enable the optimization of sizing and associations, you must provide values for
specific model attributes. These attributes are listed in “Creating Required Models”.
113
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Wizard Builder Issue 1, January 2010
Track Processes
39 Click YES to prompt the planner to enter information for each edit point. This enables
you to track/audit any modifications to the network design. The prompt only displays if
the user has made an edit at the edit step.
- or -
Repeat these steps for each wizard you want to create for planners. You will need to go
over these wizards with your planner before the planners begin using them in Network
Engineer.
Copying a Wizard
Use the COPY WIZARD option if you need to create a wizard that is similar to an existing one.
This enables you to copy all attribute settings and rule sets from the wizard and then modify
the ones you need to update.
1 From the NE Toolbox tree, select Wizard Builder under the Design Assistant toolset. The
WIZARD BUILDER INTRODUCTION screen displays.
114
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Wizard Builder
4 Use the pull-down menu to select a wizard in the current NE database. Then click NEXT
to continue.
115
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Wizard Builder Issue 1, January 2010
Demand Points
8 Click YES if you want to enable the planner to place demand points.
Use the +/- buttons to add or remove models to serve as demand points. Click ALL to
display all demand point structure models in your database.
- or -
- or -
Click NO so that planners will not be able to use existing demand points.
116
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Wizard Builder
Route Lines
Use the +/- buttons to add or remove route line models. Click ALL to display all route line
models in your database.
- or -
Any rule sets already contained in the original wizard you copied display in the list.
117
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Wizard Builder Issue 1, January 2010
14 You can add to or remove the rule sets. These are the rule sets planners can use when
determining the serving point locations.
• Use the UP and DOWN arrow buttons to set up the display order of the rule
set.
If there is no rule set defined, then that step will be skipped when the wizard definition
is executed by the planner.
Any rule sets already contained in the original wizard you copied display in the list.
16 You can add to or remove the rule sets. These are the rule sets planners can use when
determining the serving point locations.
• Use the UP and DOWN arrow buttons to set up the display order of the rule
set.
If there is no rule set defined, then that step will be skipped when the wizard definition
is executed by the planner.
118
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Wizard Builder
This section defines the rule sets planners can use when determining line loss. Any rule sets
already contained in the original wizard you copied display in the list.
18 You can add to or remove the rule sets. These are the rule sets planners can use when
determining the serving point locations.
• Use the UP and DOWN arrow buttons to set up the display order of the rule
set.
If there is no rule set defined, then that step will be skipped when the wizard definition
is executed by the planner.
119
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Wizard Builder Issue 1, January 2010
This section sets options on whether or not the planner can edit serving point information or
move routes, structures, spans, equipment and transmedia after placement.
20 For each question, click YES to allow the planner to perform the action, or NO to the
planner from performing the action.
120
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Wizard Builder
22 Set options for structure sizing and automatic transmedia associations, as follows:
• DISPLAY ADDRESS DIALOG. Select NO if you do not want the SIMPLE ADDRESS dialog box
to display when the user gets to the Place Demand Points step in the wizard.
• OPTIMIZE STRUCTURE LOCATIONS. Select NO to skip the extra internal processing that
minimizes the number of transmedia splice points based on rearrangement of mid-
span structures. This is a processing step with no user interaction. This could also
be turned off during testing of new wizards to allow for faster processing through
all the wizard steps.
• AUTOMATICALLY SIZE STRUCTURES. If you select YES, you must have size information
defined for span unit and structure models to be used. Without these attributes
defined, Design Assistant displays an error message for every structure being
placed because it cannot properly size the model. Select NO to skip the structure
sizing optimization step. This enables the user to turn this option off until these
attributes are defined or for quickly testing a wizard or rule set. Additionally it may
be determined by the user that only one structure is to be placed for each of the
structures types, in which case there is no sizing optimization to be performed. Any
structure changes deemed necessary by the user can be handled at the edit point
by replacing it with the correct structures.
Note: To enable the optimization of sizing and associations, you must provide values for
specific model attributes. These attributes are listed in “Creating Required Models”.
121
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Wizard Builder Issue 1, January 2010
Track Processes
24 Click YES to prompt the planner to enter information for each edit point. This enables
you to track/audit any modifications to the network design. The prompt only displays if
the user has made an edit at the edit step.
- or -
25 Click FINISH. You have now created a new wizard from the original.
Repeat these steps for each wizard you want to copy. You will need to go over these
wizards with your planner before the planners begin using them in Network Engineer.
1 From the NE Toolbox tree, select Wizard Builder under the Design Assistant toolset. The
WIZARD BUILDER INTRODUCTION screen displays.
122
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Wizard Builder
6 Click NEXT.
7 The wizard builder takes you through all available options to make any required
changes.
8 Click FINISH to save your changes and close the WIZARD BUILDER dialog box.
- or -
Click CANCEL to close the WIZARD BUILDER without saving any edits.
Repeat these steps for each wizard you want to copy. You will need to go over the
changes to the wizards with your planner before the planners begin using them in
Network Engineer.
1 From the NE Toolbox tree, select Wizard Builder under the Design Assistant toolset. The
WIZARD BUILDER INTRODUCTION screen displays.
123
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Wizard Builder Issue 1, January 2010
6 Click FINISH to remove the wizard. Then close the WIZARD BUILDER dialog box.
- or -
Click CANCEL to end the edit session and close the WIZARD BUILDER dialog box.
Make sure your planners are aware that you have deleted the wizard.
Importing a Wizard
Use this tool to import a wizard and all associated rule sets from one Network Engineer
database for use in another Network Engineer database. All Design Assistant wizards and
their corresponding rule sets are stored in XML files for importing and exporting.
1 From the NE Toolbox tree, select Wizard Builder under the Design Assistant toolset. The
WIZARD BUILDER INTRODUCTION screen displays.
124
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Wizard Builder
5 Click BROWSE and locate the XML file containing the wizard and then click OPEN. The
selected XML file displays in the IMPORT FROM FILE field.
In the ITEMS IN FILE TO IMPORT display, all wizards contained in the selected XML file display
and are automatically checked for import.
6 For any wizard in the list you do not want to import, click the corresponding checkbox to
unselect it.
During the import process, if a wizard already exists in your Design Assistant database
with the same name as one of the wizards you are importing, you are prompted to
either overwrite the existing wizard, rename the wizard being imported, or cancel the
operation. You will receive the prompt for each duplicated wizard name.
Once the import has completed, the new wizards can now be selected when using the Design
Assistant Wizard command in Network Engineer. To see the new rule sets, use the Rule Set
Definition NE Toolbox tool.
125
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Wizard Builder Issue 1, January 2010
Exporting a Wizard
You can export a wizard and all associated rule sets to an XML file that can be imported into
another Network Engineer database.
1 From the NE Toolbox tree, select Wizard Builder under the Design Assistant toolset. The
WIZARD BUILDER INTRODUCTION screen displays.
126
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Wizard Builder
6 Select the location of the XML file and type in the file name. Click SAVE.
In the ITEMS IN DATASET TO EXPORT display, all wizards contained in the selected XML file
display and are automatically checked for export.
7 For any wizard(s) in the list you do not want to export, click the corresponding checkbox
to unselect it.
8 Click EXPORT to start the export process. All rule sets associated to the selected wizards
will be included in the XML file.
Once the export has completed, use the IMPORT WIZARD command to load the wizards to
another Design Assistant database.
127
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Wizard Builder Issue 1, January 2010
Validating Wizards
Before you begin, take a few minutes to review the validation report that displays as well as
the attributes being checked for wizards and rule sets during the validation process.
You can use the Validating Wizards option in the Wizard Builder tool at any time to check
your wizards and rule sets. The results of the validation process display in the VALIDATING
WIZARDS/RULE SETS dialog box. Expand the tree view nodes to see the wizards and rule sets
checked during the validation process. Further expand each node to see the wizard or rule
set name and then a description of the critical error or warning message.
• Serving Point rule sets used in the wizard are valid, and at least one must exist.
• Provide Side Transmedia rule sets used in the wizard are current and valid.
• Supply Side Transmedia rule sets used in the wizard are valid.
Each rule set type also has specific items and attributes that are checked during validation.
For information on validation checking for rule sets, refer to “Rule Set Validation Checks”.
128
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Wizard Builder
How To
1 From the NE Toolbox tree, select Wizard Builder under the Design Assistant toolset. The
WIZARD BUILDER INTRODUCTION screen displays.
4 Click NEXT and use the pull-down menu to select the wizard you want to check.
129
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Wizard Builder Issue 1, January 2010
8 From the SAVE AS dialog box, go to the desired file location and type in the file name
(using a .txt file type), or browse to overwrite an existing text file. Click SAVE.
The file is a textual display of the tree view, divided into two main sections, Rule Sets
and Wizards.
9 Click CLOSE when you have finished to dismiss the WIZARD/RULE SET VALIDATION dialog box.
10 Repeat these steps validation until you have eliminated at least all critical errors.
130
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Validating All Wizards and Rule Sets
1 From the NE Toolbox tree, select Wizard Ruleset Validation Tool under the Design
Assistant toolset. This automatically starts the validation process on all rule sets and
wizards in the current database.
When the process is complete, the WIZARD/RULE SET VALIDATION screen displays with the
results. The figure below is an example validation report.
2 Expand the RULE SET or WIZARD nodes in the tree view to see any critical errors or
warnings.
4 From the SAVE AS dialog box, go to the desired file location and type in the file name
(using a .txt file type), or browse to overwrite an existing text file. Click SAVE.
131
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Using the Sample Wizard Issue 1, January 2010
The file is a textual display of the tree view, divided into two main sections, Rule Sets
and Wizards.
5 Click CLOSE when you have finished to dismiss the WIZARD/RULE SET VALIDATION dialog box.
You can then run steps 1-3 to repeat validation until you have eliminated at least all
critical errors.
6 Repeat these steps validation until you have eliminated at least all critical errors.
132
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Using the Sample Wizard
2 Place structures by locating the Models tab and select the Structure class, place a Large
Cabinet as the structure to hold the equipment-Starting Point. Place SDUs as the
Demand Points.
3 Select the DSX1 120 from the Equipment Class and place in the cabinet.
4 Place the Spine Route Line from the Rout Line Class, extending the linear from the
equipment along a route that will encompass the demand points placed in the map.
133
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Using the Sample Wizard Issue 1, January 2010
An admin label has not been assigned to the equipment that is playing the UND admin label
as undefined.
5 Select the Design Assistant Wizard to select the Copper Rider sample.
134
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Using the Sample Wizard
Select the right arrow to have the wizard recognize the Demand Points that have been
placed, the Point Status of the builds is NEW since they have been placed in a new work
order. If the buildings (SDU) had been placed and the work order had been closed and
reopened, the Point Status attributes would need to be changed to NEW from OLD. The same
applies the Route Line.
7 When the Demand Points are recognized by the wizard, the Starting Point Equipment
must be selected.
135
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Using the Sample Wizard Issue 1, January 2010
8 Navigate to the PORT under the equipment, when the port is selected the Demand
Required and Total Ports fields will be populated with information from the equipment.
136
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Using the Sample Wizard
9 Select the External Network Location, the Narrowband Network Category, and the
provide Point Network Type from the drop down selections. With the required
information in these fields, the OK button becomes active. Select OK to continue.
10 The wizard is now ready to identify the route, since the Spine route was placed and
exists in the work area, select the right arrow to continue with the wizard.
137
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Using the Sample Wizard Issue 1, January 2010
11 The wizard distributes the load to the serving points, if the load needs to be modified
the Serving Point Groups dialog is displayed.
138
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Using the Sample Wizard
By selecting an entry underneath the Rider the service can be dragged and dropped to
another serving point. When the service is rearranged, the services will be red until the Apply
button is selected and the changes are accepted. When all changes are made, if any changes
need to be made, select the X in the top of the display to exit the dialog.
139
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Using the Sample Wizard Issue 1, January 2010
12 Select the right arrow, the edits have been made to the serving areas. Continue with the
wizard to determine the Supply Route. Depending upon the Route Type the route can
vary. The default route type is the Rider.
13 The routes to the demand points are placed, make edits if needed. Select the right
arrow to continue with the wizard.
140
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Using the Sample Wizard
The Span network is created next, the wizard places the spans according to the settings
made in Toolbox for the Route rule set types.
14 If any edits need to be made to the spans placed, these changes can take place or
continue with the wizard by selecting the right arrow.
141
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Using the Sample Wizard Issue 1, January 2010
15 As the wizard adds network or other tasks defined in the rules, the Design Assistant
progress dialog is available to alert the user of the progress. The progress dialogs are
helpful in describing the processes taking place and/or the work being performed by the
wizard.
142
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Using the Sample Wizard
16 Select the right arrow to continue or make edits if needed then continue with the
wizard.
143
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Using the Sample Wizard Issue 1, January 2010
17 As the service is being completed, the Network Engineer Issues dialog appears to later
the suer of any errors or warnings. In this case there are warnings of the cable
exceeding the line loss as defined in the rule set definitions. Warnings need to be
addressed and the wizard will continue, errors must be resolved before the wizard will
continue to the next step.
144
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Design Assistant Configuration Tasks
Release 6.0 Using the Sample Wizard
18 The wizard has completed the design for the design area.
145
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Design Assistant Configuration Tasks BD-NE-6.1-DA-USRADM-001
Using the Sample Wizard Issue 1, January 2010
146
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
4
Using Design Assistant in
Network Engineer
Once the Administrator has defined the rule sets and wizards using the Design Assistant
Toolbox tools (as explained in “Design Assistant Configuration Tasks”), the planners working
in Network Engineer develop networks using the Design Assistant wizards from within the
Network Engineer application. Each wizard walks the planner through the steps needed to
create the network based on rule sets that determine the network composition.
This chapter provides instructions for the planner to use a wizard to step through the process
of creating a customized network.
Before you begin, Design Assistant users need to have the following information:
• Where are the locations or demand points the network service is providing?
• Where are the locations or serving points the network service is coming from?
• What serving equipment is to be used as the starting point for the network?
• Check the direction where you want the new network to go.
• If existing spans are used, Design Assistant checks and verifies them against span rules
set in the current rule set. If the spans cannot be validated, a warning message
displays.
• Do not use offsets. Design Assistant does not recognize any offset network items such
as an offset splice closure on a span.
• When using existing transmedia, you can use a downstream trace to see what cables
can be re-used.
147
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Using Design Assistant in Network Engineer BD-NE-6.1-DA-USRADM-001
Getting Started Issue 1, January 2010
• Rule sets can be defined to find any cables that divert off of the main path so the cables
can be re-used. Check with your administrator to see if this option has been defined
within the wizard you are using.
Note: Design Assistant does not modify an existing network. It only tries to use what is
available rather than re-design the network.
Getting Started
In order to use the Design Assistant component in Network Engineer, you must load the
Design Assistant data set, display of the Design Assistant toolbar, and select a starting point
for the wizard.
3 From the ADD DATA dialog box, select [Link] and click ADD.
148
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Using Design Assistant in Network Engineer
Release 6.0 Getting Started
From this toolbar, you can start a wizard plan and step through it. This toolbar also informs
you of the current processing step in the wizard.
Element Description
Moves back one step in the wizard plan and performs an “undo” of the
previous wizard action (up to approximately 32 edits). This button is only
enabled at certain points in the execution of the wizard.
Note: To undo only manual edits and leave the Design Assistant
automated processes unchanged, use the ESRI UNDO command. If you
click the BACK button in the DESIGN ASSISTANT WIZARD, your edits are
undone as well as the previous edits and processes performed by the
wizard. For example, if you edit serving points after Design Assistant has
determined the locations of the serving points, clicking the BACK button in
the wizard will undo your edits as well as the serving point
determinations made by Design Assistant.
Moves to the next step in the wizard plan. This button may be disabled
when required tasks must be performed before moving forward.
PROMPT AREA Inform you of the step currently being performed in the wizard.
HELPER TOOLS Provides commands that are specific for the step being performed in the
wizard.
149
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Using Design Assistant in Network Engineer BD-NE-6.1-DA-USRADM-001
Troubleshooting Issue 1, January 2010
2 If you are creating a new network, place your starting point equipment on the map. If
you are adding to an existing network, select the equipment to be used as the starting
point for the addition.
Troubleshooting
The ISSUES dialog box displays any problems Design Assistant encounters when creating the
network.
You cannot close this dialog box until all the issues entries have been removed. However, you
can make the dialog box semi-transparent using the slider bar. Depending on the severity of
the problem(s), you may be able to continue on through the wizard without resolving the
problems. For example, if the network becomes disconnected, Design Assistant would not be
able to continue. It is highly recommended that you resolve the problems and close this
dialog box before continuing to the next step in the wizard.
150
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Using Design Assistant in Network Engineer
Release 6.0 Stopping and Restarting the Wizard
An errors icon ( ) displays on the right side of the DESIGN ASSISTANT toolbar after processes
where errors are likely to occur. Click this icon to maximize and minimize the ISSUES dialog
box as you review the problems.
Element Description
Deletes the selected row. Delete the error entry once you
have fixed the problem.
Highlights the feature on the map described in the selected
entry row. For example, if you encounter a line loss error,
use this option to show where on the cable the line loss is
exceeded.
Selects feature. Highlights the feature on the map and places
it into the selection set. You can then edit the feature to
resolve the problem.
Zooms to feature. Zooms in to the area on the map
described in the selected entry row.
Navigates through affected features. Moves you from one
feature to the next for an error that involves multiple
features.
Issue sorting. Sorts the issue list by either severity or
occurrence when you click the corresponding header row.
Click a header row once to sort in ascending order. Click a
second time to sort in descending order.
151
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Using Design Assistant in Network Engineer BD-NE-6.1-DA-USRADM-001
Stopping and Restarting the Wizard Issue 1, January 2010
Process Summary
The save, stop and re-open process is outlined below:
1 When you re-open the work order containing the saved edits, you can select the wizard
you were using. Design Assistant checks to see if the work order had been saved while
the wizard was running.
2 If the work order and completed wizard steps have been saved, a message box similar
to the one below displays.
In the example message box, Copper Rider Wizard is the name of the wizard being
used.
3 Click YES to restore the wizard to the previously-saved step and continue the wizard
from that point forward.
-or-
Click NO to clear out previously-saved wizard information. The selected wizard will be
started from the beginning.
-or-
Click CANCEL to continue work in Network Engineer without opening a wizard. Any saved
wizard data is left as is. This enables you to start the wizard where you left off at a later
time.
Note: If the work order was not saved during the wizard execution, you must re-select the
wizard and start from the beginning.
152
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Using Design Assistant in Network Engineer
Release 6.0 Stopping and Restarting the Wizard
Saving Edits
When you save edits, a progress bar displays at the bottom of the Network Engineer window
showing that data is being saved and/or stored. There are a few limitations to the wizard
operations when a work order is saved. Please keep these in mind when saving your edits
during wizard operation.
• The best place to save edits is at any edit point or step of the wizard where the system
is waiting for user input. Saving edits as the system is processing a wizard step may
cause unpredictable results. For example, the system may attempt to save a step that is
only half finished in an operation. You can save your work as often as you need.
• Within the saved work order, you cannot use the wizard restoration process as an
“undo” or a way to restore back to a save point. For example, you have saved steps
1 through 4 in the wizard. At step 9, you decide you do not want any of the new edits
performed after step 4. You cannot re-open the wizard to remove edits to return the
system back to step 4.
• If you make any edits outside of the wizard in between save points, the wizard may not
be able to run from its last save point. Situations where restoring to a previously-saved
state will not be allowed are listed below.
• The starting wizard step also has an effect on what may or may not be allowed to
be missing from the stored data. Missing a structure before finding the inferred
node locations may have little effect on continuing within a wizard. However,
missing a structure before the CREATE TRANSMEDIA step occurs may cause Design
Assistant to stop the wizard process.
153
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Using Design Assistant in Network Engineer BD-NE-6.1-DA-USRADM-001
Wizard Workflow — Creating a Network Issue 1, January 2010
Example graphics are given throughout the workflow to illustrate the steps performed by
Design Assistant. Pertinent areas are indicated by a red, dotted-line callout.
2 Select the required wizard. (Ask your administrator if you are unsure which wizard to
use.)
3 Click OK.
154
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Using Design Assistant in Network Engineer
Release 6.0 Wizard Workflow — Creating a Network
Current filters include file types .bmp, .jpg, .gif, .tiff, .dxf, .dwg, .dgn and *.*. The file is
attached to the map as a new layer and the GeoReferencing tools are launched.
Standard ESRI tools will guide you in placing, rotating, and resizing the imported map
file using control points. See Georeferencing a Raster in the ESRI ArcMAP Help File for
more information.
5 Place the models on the map. Each demand point structure that is placed will be added
to an internal list for use in analyzing the network.
• The demand points are connected based on the order in which they are placed on
the map.
• The spacing between structures determines the grouping of items in the network.
155
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Using Design Assistant in Network Engineer BD-NE-6.1-DA-USRADM-001
Wizard Workflow — Creating a Network Issue 1, January 2010
The fields in the ADDRESS section provide a way to build a plot ID value (street address)
such as NE 101 MAIN STREET. In this example, NE is the Prefix, 101 is the value and Main
St is the suffix. If you want to continue placing houses up the street, you can enter an
INCREMENT value. If the increment is set to 2, the next house is NE 103 MAIN ST; then NE
105 MAIN ST, and so on. This enables you to place all houses on the street and have the
plot ID value automatically filled as you go rather than having to enter it in each time.
Each time a structure is placed, the increment is added to the current value field in
preparation for the next structure placement.
156
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Using Design Assistant in Network Engineer
Release 6.0 Wizard Workflow — Creating a Network
• PLOT ID and ADDRESS. Type in the ID and address of the demand point.
• UNITS. Defines the structure units or floors to place inside the structure. Click the
MODEL SELECTOR tool to pick the floor model to use as well as the number of floors
that will be placed. You can also designate the type of cabling for each floor and the
sub-plot ID or address of each floor.
157
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Using Design Assistant in Network Engineer BD-NE-6.1-DA-USRADM-001
Wizard Workflow — Creating a Network Issue 1, January 2010
• MODEL SELECTION:
• SERVICE TYPE. Use the pulldown menu to select the service type.
• MODEL AND SERVING POINT DEFINITION. Click the MODEL SELECTOR tool to pick a sub-
unit model to place inside each of the floors. Key in the number of sub-units
that will be placed on each floor and the demand at each sub-unit.
• OBJECT TYPE. Use the pulldown menu to select the transmedia rule set to be
used.
• SERVING POINT LOCATION AND TYPE. Select the serving point (inferred node) that
will provide service to each sub-unit.
• CLEAR VALUES. Once you enter settings, they are saved and automatically
display the next time the dialog box is opened. If you do not want to use the
values, click CLEAR VALUES to empty the value fields.
• All floors are generated the same. For example, if you have a ten-story building
and the top floor only has one sub-unit on it but the rest have five sub-units, you
must define all ten stories to have five sub-units using the wizard. You can then
manually edit the top floor and remove the extra units.
• Only the parent structure is displayed on the map for a complex model.
• All the floors and sub-units are internal to the complex model and are not
displayed.
• To apply the rule sets, inferred nodes are generated and associated to the sub-
units to model the connections of cable and duct internal to the structure.
• Scaling for the internal spans and transmedia cable lengths is not accurate. It
merely provides a means for end-to-end connectivity from the sub-unit to the
outside of the structure.
• You can define each floor unit to have both narrowband and wideband sub-units.
• No shared category sub-units are allowed. You cannot place one sub-unit model
and have it contain both narrowband and wideband service; you must place two
separate sub-units with one being narrowband and the other wideband.
• Inferred nodes are placed by Design Assistant to represent structure units inside
the building.
158
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Using Design Assistant in Network Engineer
Release 6.0 Wizard Workflow — Creating a Network
When you have finished, click OK to save your edits and close this dialog box.
8 If you have not already done so, set the following attributes for the placed structure
models:
a Click the MASS ATTRIBUTE EDITOR to set the attributes of all placed structures.
• Demand point
• Transmedia demand
9 Select UPDATE ALL to update attributes for all demand point structures you placed. Save
your edits and close the ATTRIBUTE EDITOR dialog box.
159
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Using Design Assistant in Network Engineer BD-NE-6.1-DA-USRADM-001
Wizard Workflow — Creating a Network Issue 1, January 2010
11 Click MASS ATTRIBUTE EDITOR to set the following attributes for all placed structures if
you have not already done so:
• Demand point
• Transmedia demand
12 Select UPDATE ALL to update attributes for all demand points you placed.
13 Save your edits and close the ATTRIBUTE EDITOR dialog box.
160
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Using Design Assistant in Network Engineer
Release 6.0 Wizard Workflow — Creating a Network
15 Click SELECT FEATURES and highlight the equipment you want to use.
-or-
If you have not yet placed the equipment, click the MODEL SELECTOR button to select the
equipment and place it on the map. Then return to this dialog box and click SELECT
FEATURES.
161
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Using Design Assistant in Network Engineer BD-NE-6.1-DA-USRADM-001
Wizard Workflow — Creating a Network Issue 1, January 2010
• SELECTION TYPE:
• SELECT PORT RANGE. Use the SHIFT+ or CTRL+ keys to select a range of ports. The
range of ports MUST be at least equal to or greater than the required demand;
otherwise, you cannot continue.
• NETWORK INFORMATION. Use the NETWORK LOCATION, CATEGORY and TYPE pulldown
menus to select the correct values for those fields.
Once the network information has been entered for the selected port(s), the OK button
is enabled.
17 Click OK to continue.
162
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Using Design Assistant in Network Engineer
Release 6.0 Wizard Workflow — Creating a Network
18 Use the required models to place a new route line. Each route line represents a potential
path in the network that will be generated.
Important: Accuracy of the network creation depends on how accurately you place the
route lines. For example, if you need a specific distance in the network, that distance
must be set up by the route lines.
All route lines must be broken at intersection points. Any two route lines that cross each
other but are not broken at the intersection point are treated as independent lines.
Likewise, any route line that ends on top of another route line, but not at an intersection
point, is considered independent.
Figure 4-2 Route Lines Representing Potential Network Path Determined by Design
Assistant
163
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Using Design Assistant in Network Engineer BD-NE-6.1-DA-USRADM-001
Wizard Workflow — Creating a Network Issue 1, January 2010
20 Click the SPAN TO ROUTE LINE button on the wizard toolbar. The SPAN TO ROUTE LINE
dialog box opens with the selected spans listed.
21 Select a route line model to place along the path of the selected span.
22 Click APPLY. A new route line will be generated using the points from the existing span.
23 Check the ASSOCIATE SPAN CATEGORY/TYPE TO SELECTED ROUTE LINE option to associate the
route line model chosen for all similar spans in the list after the first one has been
defined. If this option is not selected, you must define a route line model for each span
in the list separately.
164
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Using Design Assistant in Network Engineer
Release 6.0 Wizard Workflow — Creating a Network
Figure 4-3 Serving Point Locations Placed Along Route Lines Determined by Design
Assistant
165
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Using Design Assistant in Network Engineer BD-NE-6.1-DA-USRADM-001
Wizard Workflow — Creating a Network Issue 1, January 2010
Element Description
Finds items in the tree view. Select a feature on your map and then
click this button to highlight the selected feature in the tree view.
CHANGE You can drag demand points from one INFERRED_NODE to another
RELATIONSHIPS to change the relationships between the items. You can change
which nodes supply the demand to the indicated demand points set
by the Design Assistant software.
Using your cursor, select an item in the tree view and drag it to the
desired location. You can also change the group of items to which it
serves. All changed nodes are highlighted in red.
27 Click APPLY to make your changes and then close the dialog box.
166
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Using Design Assistant in Network Engineer
Release 6.0 Wizard Workflow — Creating a Network
29 Click OK to continue.
Figure 4-4 Route Lines from Serving Point to Each Structure Demand Point Placed by
Design Assistant
167
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Using Design Assistant in Network Engineer BD-NE-6.1-DA-USRADM-001
Wizard Workflow — Creating a Network Issue 1, January 2010
Note: If your administrator turned on the Auditing feature for the wizard, the NE Design
Assistant Edits dialog box below displays whenever you make any edits.
a Corner structures
b End structures
c Terminating structures
d Intersecting structures
e Mid-span structure
• Max Span Distance. If the route line is longer than the maximum span distance,
the route line is broken and the mid-span structure model is placed. If the route
line is longer than the maximum span distance, the location of the mid-span
structures are evenly spaced along the route line. If optimization is enabled,
Design Assistant then attempts to minimize the number of splices.
• Span Model. For each route line found, a span is created using the available span
model type.
168
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Using Design Assistant in Network Engineer
Release 6.0 Wizard Workflow — Creating a Network
• Mid-Span Structure Model. If the route line exceeds the Max Span Distance, then
the first structure indicated is placed. The wizard can also be set to minimize
splices on long span runs. It looks at the maximum transmedia length and adjusts
spacing to remove splices along a path.
• Intersection Structure Model. If the route line has an intersection (three or more
spans), the first structure model listed is placed.
• Corner Structure Model. If the route line has any corners in it that is less than the
Corner Angle value, the first structure listed is placed.
Figure 4-5 Required Spans and Other Structure Models Placed by Design Assistant
Mid-span Structure
Span
Corner Structure
35 Use the TELCO menu > REPLACE command to replace multiple models. See Network
Engineer Online Help for information on using the REPLACE function. If Auditing is enabled
for the wizard, an EDITS dialog box displays for you to type in a brief explanation for any
change(s).
169
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Using Design Assistant in Network Engineer BD-NE-6.1-DA-USRADM-001
Wizard Workflow — Creating a Network Issue 1, January 2010
The provide and supply networks determine the best possible route for the transmedia
and spans that have been generated along that route. Along with the span, a calculated
demand for each span segment is used for the number of pairs or fibers needed to
satisfy the demand in the plan. Using the demand along the segment and the list of
possible transmedia options from the transmedia rule set, a transmedia cable that has
sufficient capacity is selected.
170
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Using Design Assistant in Network Engineer
Release 6.0 Wizard Workflow — Creating a Network
Finish!
41 The network design has been completed.
-or-
If you have not closed or saved the current work order session, you can remove the
network and start again; or step back through the wizard to undo edits and re-start.
Note: Once you save your edits or close the work order session, you cannot undo changes
through the Design Assistant wizard.
You can continue working to create other networks within the work order.
171
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Using Design Assistant in Network Engineer BD-NE-6.1-DA-USRADM-001
Tracing a Design Assistant Network Issue 1, January 2010
The steps below outline the process of using the Network Engineer Trace command.
2 Select TELCO menu > TRACE NETWORK command. The system displays the TRACE NETWORK
dialog box.
3 Use the pulldown menu to select DOWNSTREAM as the direction for the trace.
172
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Network Engineer Release Content Letter Using Design Assistant in Network Engineer
Release 6.0 Tracing a Design Assistant Network
4 Click the TRACE CONFIGURATION button to have a connection status included in the
trace. The TRACE CONFIGURATION dialog box displays.
5 Select one or more connection statuses and set additional options as desired. Click the
CLOSE button to dismiss the TRACE CONFIGURATION dialog box.
6 Select the starting equipment from the SOURCE pulldown menu on the TRACE NETWORK
dialog box.
173
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Using Design Assistant in Network Engineer BD-NE-6.1-DA-USRADM-001
Tracing a Design Assistant Network Issue 1, January 2010
7 Click OK to accept your changes and dismiss the TRACE NETWORK dialog box. The system
displays the BROWSE TRACE dialog box.
8 Select an item in the BRANCHES tree view to view its features in the TRACED FEATURES grid
and enable any commands.
9 Select REPORT if you need to display the NETWORK ENGINEER TRACE REPORT after the
command executes.
174
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Glossary
Complex Models
Complex models are structure-class models like MDUs (multiple dwelling units) and MBUs
(multiple business unit) that can be comprised of equipment and/or structure unit models.
Direct/Aerial Policy
Policy that applies a straight-line for the route from serving point to demand point. This is
typically used for a direct feed either via underground or aerial.
Network Category
A network category defines the type of network to be created.
Rider Policy
Policy that runs routes parallel to existing route lines with a perpendicular route to the
demand point.
Rule Set
Rule sets represent your company’s specific policies, procedures and network requirements.
Defined networks and rule sets enable you to use the Design Assistant to meet many
different scenarios.
175
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Glossary BD-NE-6.1-DA-USRADM-001
Issue 1, January 2010
Snap Policy
Policy that runs routes perpendicular to existing route lines.
Weighting
Weighting is a relative prioritization of models and is used to determine the order of
placement in a Design Assistant-generated network.
176
Telcordia Technologies, Inc. confidential — restricted access. See confidentiality restrictions on title page.
Index
A rule set 77
rule sets 48, 58
adding
sample rule set 67
attributes to rule sets 73, 77
service rule set 67
domains 73
service rule set samples 72
equipment models 50
serving point
network categories 57
rule set attributes 59
network types 56
serving point rule set samples 68
rule sets 87
span unit 46
task types 99
structures 47
address generation - complex structure dia-
transmedia 46
log box 157
rule set attributes 64
address generation dialog box 156
transmedia rule set samples 69
addresses
audit trails
generating for demand points 156
prompting user for 114, 122
associating
COM components to task types 99
B
route line inventory objects to rule sets
route line inventory objects building
associating to rule sets 96 wizards 48, 103
transmedia to span units 170
transmedia to span units automatically C
112, 120
categories
transmedia to spans automatically 112,
networks 48, 52, 53, 57, 58
120
changing
associations
network descriptions 55
removing 96
network names 55
attributes
checks for validation 83
adding to rule sets 73, 77
editing in rule sets 79 classes
removing from rule sets 80 design assistant features 37
route rule set 66 COM components
route rule set samples 71 associating to task types 99
names
networks 55
O
naming opening 76
wizards 105, 115 network category/type definition tool 54
rule set attribute definition tool 76
NE toolbar
rule set definition tool 81
elements 149
rule set mapping tool 95
network category type definition dialog box
task definition tool 98
54, 55, 56, 57
wizard builder tool 104
network category/type definition tool
optimizing
opening 54
modelling 46
prerequisites 53
structure locations 112, 120
summary 48
using 52
P
network engineer design assistant dialog box
154 placing
network loading demand point 155
determined by design assistant 168 new demand points 106, 116
processes routes
tracking 114, 122 placing lines 164
span unit
attributes 46 T
span units tables
associating transmedia with 170 default task types provided with design as-
sistant 99
sizing for spans 46
required attribute definitions for models
spans used in a network 46
allowing planners to edit after placement sample route rule sets, attributes, and de-
112, 120 fault values 71
editing 169 sample service rule sets, attributes, and
models 43 default values 72