You are on page 1of 250

990-1040-001, Rev.

ADMIN PORTAL GETTING STARTED GUIDE

WWW

www.taqua.com

Taqua
740 East Campbell Road, Suite 200
Richardson, TX 75081
Main Phone: 1+(972) 692-1800
TAC Support: 1+(866) 792-0198
For software licensing information: e-mail Taqua Marketing at simplify@taqua.com.
Copyright 2010 - 2015 Taqua
dryIse, Admin Portal, ISE, IseHouse, and T7000 are trademarks of Taqua.
CLASS is a service mark of Telcordia Technologies.
All products, names and services are trademarks and registered trademarks of their respective companies.

Disclaimer of Taqua:
Material contained in this document is subject to change without notice. The material herein is solely for information
purposes and does not represent a commitment by Taqua or its representatives. Taqua has prepared the
information contained in this document solely for use by its employees, agents, and customers. Dissemination of
this information and/or concepts to other parties is prohibited without the prior written consent of Taqua. In no event
will Taqua be liable for any incidental or consequential damage in connection with the furnishing, performance or
use of this material.
Taqua reserves the right to revise this publication in accordance with formal change control procedures defined by
Taqua.

A Note About This Edition of the Manual


This manual covers the Admin Portal through Release 4.0

990-1040-001

ii

Admin Portal Getting Started Guide


990-1040-001

Reader Comment Form


Taqua welcomes your comments about this publication.
Please copy this page and e-mail it to TechnicalPubs@Taqua.com. All sections are optional.

Please tell us a little bit about yourself.


How long have you used our products?
Do you use this manual for training?
Do you use this manual for reference?

Please share your comments with us.


Which sections need more information?
Which items were hard to look up?
Where have we made mistakes?
Where is the information incomplete?
Where do we need examples?

Overall, was this manual


Readable?
Well organized?
Complete?
Accurate?
Useful?

What other improvements would you suggest?


Additional comments:
Thank you,
Taqua Technical Publications

iii

Admin Portal Getting Started Guide


990-1040-001

iv

Admin Portal Getting Started Guide


990-1040-001

Table of Contents

Overview
Introducing the Admin Portal ....................................................................2
Logging In To and Logging Out Of the Admin Portal .............................3
Logging In.............................................................................................................. 3
Logging Out........................................................................................................... 5

The Home View


Introducing the Home View .......................................................................8
System Information ............................................................................................... 9
Informational Symbols ........................................................................................... 9
Controls ............................................................................................................... 10

Menu Pane Hierarchy ............................................................................... 11


Menu Categories ................................................................................................. 12
Menu Folders ...................................................................................................... 14
Menu Links .......................................................................................................... 16

The Center Pane ....................................................................................... 20


Center Pane Controls .......................................................................................... 24
Record Count Display ......................................................................................... 25
Navigating a Database ........................................................................................ 27
Navigating a Large Database.............................................................................. 36
Sorting Records................................................................................................... 40
Adding and Removing Fields .............................................................................. 42
Distinguishing Duplicate Field Names ........................................................... 46
Generating a Report ............................................................................................ 47
Displaying a Report in HTML......................................................................... 49
Displaying a Report in Portable Document Format ....................................... 50
Displaying a Report in XML ........................................................................... 51
Downloading a Report in CSV Format .......................................................... 55
Saving a Report in CSV Format .................................................................... 58
Expanding the Center Pane ................................................................................ 59
Resizing Columns ............................................................................................... 61
Moving Columns.................................................................................................. 62
Adding a Preset................................................................................................... 63
Choosing a Preset ............................................................................................... 67

Admin Portal Getting Started Guide


990-1040-001

Table of Contents

iii

Deleting a Preset ................................................................................................. 69


Using the Filter Controls ...................................................................................... 71
Selecting Records Using the Filter Box ......................................................... 71
Finding Records with a Simple Filter (Manual Filtering) ............................. 72
Selecting Records With a Negative Filter ................................................... 74
Selecting Records With Comparison Filters ............................................... 75
Finding Records Using Regular Expressions ............................................. 77
Selecting Records With Multiple Fields ...................................................... 81
Using Automatic Filtering............................................................................... 83
Using Custom Filters ........................................................................................... 84
Managing Custom Filters............................................................................... 85
Creating a Custom Filter............................................................................. 86
Editing a Custom Filter ............................................................................... 93
Renaming a Custom Filter.......................................................................... 97
Deleting a custom filter ............................................................................... 99
Applying a Custom Filter ............................................................................. 100
Database Synchronization ................................................................................ 102
Managing files with fileCleanup ......................................................................... 105

The Right Pane ....................................................................................... 107


userDefined Fields ............................................................................................ 107
Entering Different Types of Data ....................................................................... 107
Number Data ............................................................................................... 108
Text Data ..................................................................................................... 109
Toggle Data ................................................................................................. 110
Choice Data................................................................................................. 111
Displaying and Modifying the Attributes of a Single Record.............................. 113
Displaying and Modifying the Attributes of Multiple Records ............................ 122
Displaying and Modifying a Collection............................................................... 131
Adding Records ................................................................................................. 135
Cloning Records ................................................................................................ 144
Deleting Records ............................................................................................... 156

Other Views
Introducing Selectors ............................................................................. 162
Equipment Type Selector .................................................................................. 162
Equipment Selector ........................................................................................... 164

The Billing View ...................................................................................... 166


The IseHouse View .................................................................................167
The T7000 View ....................................................................................... 168

iv

Table of Contents

Admin Portal Getting Started Guide


990-1040-001

Adding and Removing Screens ......................................................................... 169


Adding Menu Folders ........................................................................................ 178
Deleting Menu Folders ...................................................................................... 184

The T7100 View ....................................................................................... 187


The Taqua Mail View .............................................................................. 188
The User Portal View .............................................................................. 189

Widgets
Introducing Widgets ............................................................................... 192
Accessing T7000 Widgets ................................................................................. 193
Accessing T7100 Widgets ................................................................................. 196

Adding Widgets ...................................................................................... 200


Viewing and Changing Data with Widgets ........................................... 204
TCAP Cache Statistics ...................................................................................... 205
Database Profile................................................................................................ 206
Notice ................................................................................................................ 207
Shelf View ......................................................................................................... 209
Date and Time ................................................................................................... 211
NTP Settings ............................................................................................... 211
DST Settings ............................................................................................... 212
Force NTP Update....................................................................................... 213
Set Date/Time.............................................................................................. 213

UserManager
Overview .................................................................................................. 216
Navigating to the UserManager Screen ................................................ 218
Users ........................................................................................................ 219
Adding a User.................................................................................................... 220
Editing a User .................................................................................................... 223
Deleting a User.................................................................................................. 225

Groups ..................................................................................................... 226


Adding a Group ................................................................................................. 226
Deleting a Group ............................................................................................... 229

Permissions ............................................................................................ 230


Editing a Permission.......................................................................................... 231

Admin Portal Getting Started Guide


990-1040-001

Table of Contents

Appendix A: Factory Defaults


Provisioning T7000 Category Menu Folders ........................................ 234
Resetting the Menu Folders .............................................................................. 239

vi

Table of Contents

Admin Portal Getting Started Guide


990-1040-001

Overview
In this chapter:

Introducing the Admin Portal


Logging In To and Logging Out Of the Admin Portal

Admin Portal Getting Started Guide


990-1040-001

Overview

Introducing the Admin Portal

Introducing the Admin Portal


The Taqua 7000 (T7000TM) is a packet voice switch based on a switch-on-a-card
design. Each card provides dedicated resources for call processing, service logic,
switch fabric, media processing, and signaling. By eliminating common equipment,
the switch greatly improves service margins and gives carriers pinpoint control over
network costs.
You can deploy a fully functional switch with a single card and add expansion cards
with market growth. The switch can be configured with POTS, DS1, DS3, and IP
interface cards.
A T7000 can be managed either with the Admin Portal (AP) or the Command Line
Interface (CLI). Both the AP and the CLI allow you to perform Operations,
Administration, Maintenance, and Provisioning (OAM&P) tasks on the switch.
The CLI is a traditional, console-based craft interface, and is documented in the
T7000 Command Line Interface Manual.
The AP is a Web-based management system that resides on an AP Server. It
functions as the middleware between workstations and switches, and as the
middleware between workstations and the Billing Mediation Server, TaquaMail, and
the IseHouse server. The AP can interface with devices that support the Simple
Object Access Protocol (SOAP) or the Representational State Transfer (REST)
interface.
This guide explains the AP Client interface. Consult the T7000 Provisioning Guide
for detailed provisioning procedures, and the T7000 Maintenance and
Troubleshooting Guide for operations procedures.

Overview

Admin Portal Getting Started Guide


990-1040-001

Logging In

Logging In To and Logging Out Of the Admin Portal


This section describes how to start and end an Admin Portal session.

Logging In
Tip
See your system
administrator if you
need to change
your User ID or
Password.

Your system administrator will assign your User ID and a Password, and provide
you with the Admin Portal (AP) clients IP address.
You access the AP using an internet or company intranet connection, and a web
browser. For the best experience, Taqua recommends using a recent version of
either Mozilla Firefox or Google Chrome. However, the Admin Portal works with
recent versions of any modern browser, such as Apple Safari, Opera, or Microsoft
Internet Explorer.

Tip
If you run into any
problems using the
AP Client, before
contacting Taqua
TAC, make sure that
you have enabled
Javascript, cleared
the browser's
cache, and
disabled all browser
extensions and
plug-ins. See the
help for your
browser for details.

The AP Client looks best when run in full-screen mode, with a screen resolution of
12801024 pixels.

Admin Portal Getting Started Guide


990-1040-001

Overview

Logging In To and Logging Out Of the Admin Portal

The AP Client is written using industry standard protocols, including HTML and
Javascript. The interface looks and operates consistently regardless of the browser
used.
Type the AP Clients IP address in your browsers address bar to navigate to the
Login page. Type your User ID and Password in the appropriate fields, and then
click Login.
The following screenshot shows the Admin Portal Client running on a popular web
browser:

Admin Portal Login Page


If you make a mistake typing either your User ID or your Password, when you click
the Login button, the AP Client clears both fields, but otherwise takes no action.

Overview

Admin Portal Getting Started Guide


990-1040-001

Logging Out

Logging Out
Tip
The AP Client
responds to mouse
clicks whenever the
pointer becomes

The next screenshot shows the initial screen presented by the AP Client after a
successful log in. See the next chapter of this guide for a detailed description of this
screen.

To log out of the AP Client, click the Logout link, which is located in the upper right
of the window.

NOTE: Your session expires after a period of inactivity (1 hour), at which point the AP
Server will automatically log you out.

Admin Portal Getting Started Guide


990-1040-001

Overview

Logging In To and Logging Out Of the Admin Portal

Overview

Admin Portal Getting Started Guide


990-1040-001

The Home View

In this chapter:

Introducing the Home View


Menu Pane Hierarchy
The Center Pane
The Right Pane

Admin Portal Getting Started Guide


990-1040-001

The Home View

Introducing the Home View

Introducing the Home View


Tip
For legibility, the
screenshots for this
publication are
specially-sized
and partial screens
may be depicted for
readability and
focus.

After you log in to the AP, the Home View displays. The lower part of the screen is
divided into the following sections:
The left part of the screen is the Menu pane for navigating through the
Admin Portal interface

The middle part of the screen is the Center pane that presents related
records or representations of systems or data

The right part of the screen is the Right pane for viewing or specifying
values for attributes that relate to a Center pane selection

The panes and controls of the Home View are labeled on the following screen.

Menu pane

Right pane

Center pane

See the following information for more about the panes:


Menu Pane Hierarchy on page 11

The Center Pane on page 20


The Right Pane on page 107

See the following information for details about the Admin Portals controls, System
Information, and Informational Symbols.
System Information on page 9

The Home View

Informational Symbols on page 9


Controls on page 10

Admin Portal Getting Started Guide


990-1040-001

System Information

System Information
A system information area at the top and right of the Admin Portal displays system
information such as the logged in users username, the link to help or
documentation, and informational symbols.

Informational Symbols
The informational symbols that display include those described in the following
table.
Symbol

Meaning
A disk drive symbol indicates that a Collector has
passed the provisioned threshold for maximum disk
space usage. Click the disk symbol to go to AP
Configuration > Network > Collector to view disk
usage information.
A triangle-shaped symbol indicates the most critical
notification for a cluster by color. Click the symbol to go
to the T7000 or T7100 view. Click on the cluster of
interest in the Center pane, and then use the Menu
pane to navigate to Maintenance > Alarms > Current
Alarms for more information.
A pencil overlaid with the universal No symbol
indicates that data for cluster has become read-only.
See Database Synchronization on page 102 for more
information.
A socket and exclamation symbol indicates a
WebSocket communication issue between the Admin
Portal server and the browser. The administrator for
the Admin Portal needs to check that the firewall is
configured to enable an AP-to-browser WebSocket
connection.

Admin Portal Getting Started Guide


990-1040-001

The Home View

Introducing the Home View

Controls
The Admin Portal includes controls for sizing the panes, for filtering Center pane
items and editing custom filters, and for viewing the name of any filter loaded.
.
Click to Auto Filter Center
Pane Items

System Info

Edit Custom Filter button


and Filter Selector

Drag to Size Center and


Right panes

10

The Home View

Admin Portal Getting Started Guide


990-1040-001

Controls

Menu Pane Hierarchy


The Menu pane presents system data in a hierarchical view:
Menu Categories contain one or more Menu Folders

Menu Folders contain one or more Menu Links


Menu Links contents vary. Usually, a Menu Link contains keys to a
database. Exceptions will be pointed out where they occur.

The items you can access at each level of the Menu pane hierarchy are described
in the following sections.

Admin Portal Getting Started Guide


990-1040-001

The Home View

11

Menu Pane Hierarchy

Menu Categories
Menu Categories are the top level of information displayed in the Menu pane. The
following screen excerpt shows the Menu Categories AP Configuration,
Maintenance, and About.

When you hover on a Menu Category, the text displays in bold to indicate that you
can click to expand the folder. The About Menu Category provides software
version information only.
Click a Menu Category to it open it and display the Menu Folders inside. The
expanded AP Configuration Menu Category displays the Network and
UserManager Menu Folders.

You can click an open Menu Category to close it.

12

The Home View

Admin Portal Getting Started Guide


990-1040-001

Menu Categories

When you select a different Menu Category, the current Menu Category closes and
the new Menu Category opens.

Tip
The Maintenance
Menu Category
includes the
Historical Menu
Folder.

For example, you can click the Maintenance Menu Category to open it and
automatically close the AP Configuration Menu Category.

Admin Portal Getting Started Guide


990-1040-001

The Home View

13

Menu Pane Hierarchy

Menu Folders
Menu Folders are the middle level of information displayed in the Menu pane.

When you hover on a Menu Folder, the text changes from black to red to indicate
that the Menu Folder is selected and can be clicked and expanded.

14

The Home View

Admin Portal Getting Started Guide


990-1040-001

Menu Folders

Click a selected Menu Folder to open it and display the Menu Links inside. The
screen excerpt below shows the User Manager Menu Folder open with the Users,
Groups, and Permissions Menu Links visible.

To close a Menu Folder, click it, or click a different Menu Folder.

Admin Portal Getting Started Guide


990-1040-001

The Home View

15

Menu Pane Hierarchy

Menu Links
Menu Links are the lowest level of information displayed in the Menu pane. The AP
Client indents Menu Link names in the Menu pane. In the next screenshot, the
UserManager Menu Folder contains the Users, Groups, and Permissions Menu
Links.

16

The Home View

Admin Portal Getting Started Guide


990-1040-001

Menu Links

When you move the pointer over a Menu Link, the text turns red to indicate that the
Menu Link can be selected.

Admin Portal Getting Started Guide


990-1040-001

The Home View

17

Menu Pane Hierarchy

When you select a Menu Link, the AP Client updates the Center pane to show
information that is associated with the selected Menu Link. The next screenshot
shows the AP Client after a user has logged in, before any Menu Links have been
selected.

The Center pane defaults to this view when you log in. It is displaying the
Equipment Types from the Network Menu Folder in the AP Configuration Category.
These Equipment Types can also be accessed from the Equipment Selector, which
is described on page 162.

Tip
Press F5 to refresh
the current display.

18

The Home View

The next screenshot shows the Center pane after the Users Menu Link is selected.

Admin Portal Getting Started Guide


990-1040-001

Menu Links

The AP Client updates the Center pane with the Users information. It also selects
the first record of the Users database, and displays the database fields of that
record in the Right pane.
This information will be displayed in the Center and Right panes until the user
selects another Menu Link.
See the next section of the guide for a detailed description of the Center pane, see
The Right Pane on page 107 for a detailed description of the Right pane.

Admin Portal Getting Started Guide


990-1040-001

The Home View

19

The Center Pane

The Center Pane


The type of Menu Link in the Menu pane determines the type of information
displayed in the Center pane.
The next screenshot shows the AP Configuration Menu Category, the Network
Menu Folder, and the Network Equipment Types Menu Link.

Tip
These Equipment
Types can also be
accessed from the
Equipment Selector, which is
described on
page 162.

Here, the Center pane displays icons that represent network equipment. Each
yellow cylinder represents a database for managing a type of system that the
Admin Portal recognizes on the network.
Depending on your network, any of the following types of system icons appear:
Billing Taqua Billing contains the settings for Automatic Message
Accounting (AMA), Exchange Message Interface (EMI), and T7000 CDR
export.

20

The Home View

IseHouse Contains the servers used in transporting and querying data:

The BOOTP and TFTP servers download configuration files, boot


files, and other data (software, databases, and announcements) for
cards installed in the T7000.

The DNS Server implements the service for responding to queries


against a directory.

T7000 switch provisioning


T7100 cluster and AP platform software provisioning
TaquaMail T7000 Voice mail server
UserPortal T7000 browser based CLASS feature management

Admin Portal Getting Started Guide


990-1040-001

Menu Links

The next screen shows the AP Configuration Menu Category, the UserManager
Menu Folder, and the Users Menu Link.

Now, the Center pane displays Users. Each User is a key to the Users database.

Admin Portal Getting Started Guide


990-1040-001

The Home View

21

The Center Pane

The next screen shows the T7000 Menu Category, the Network Manager Menu
Folder, and the Network Menu Link.

In this case, the Center pane displays the Network. Each item in the Center pane
is a T7000 switch.
The next screenshot shows the Provisioning Menu Category, the T7000 Home
Menu Folder, and the Dashboard Menu Link.

22

The Home View

Admin Portal Getting Started Guide


990-1040-001

Menu Links

This time the Center pane displays Dashboard items, which are widgets. In the
screenshot, the user has clicked the Add widget menu, which lists the types of
widgets that can be added. See Widgets on page 191 for more information about
the widget menu.

Admin Portal Getting Started Guide


990-1040-001

The Home View

23

The Center Pane

Center Pane Controls


When you use the Center pane to work with data on a T7000 shelf, two Center
pane controls appear.

24

The Home View

The T7000 Flash Database button


initiates a dbFlash on all cards.
Refer to the Command Line Interface Guide for information about
dbFlash.

The TaquaTerm button


lets you start a Telnet session for configuring
the T7000 from the Command Line Interface. For more information, refer
to the T7000 Command Line Interface Guide.

Admin Portal Getting Started Guide


990-1040-001

Record Count Display

Record Count Display


At the left of the top line, the AP Client displays the first and last record number
displayed (in this case, records 1 to 7), and the total number of records in the
Groups database (in this case, also 7).

Admin Portal Getting Started Guide


990-1040-001

The Home View

25

The Center Pane

When there are more records than can be displayed in the Center pane, the AP
Client adds a scroll bar. The next screenshot shows the first 14 records of the
Subscriber database:

The database itself contains 32 records, which you can display in the Center pane
by dragging the scroll bar with the mouse.

26

The Home View

Admin Portal Getting Started Guide


990-1040-001

Navigating a Database

Navigating a Database
When the Center displays a database, you can use the keyboard to navigate the
database records.
In the following screenshot, the Admin Portal is displaying the first 100 records of
the APEventRegistration Menu Link.

The following keys are active:


UP ARROW: see UP ARROW on page 28

DOWN ARROW: see DOWN ARROW on page 29


PAGE UP: see PAGE UP on page 30
PAGE DOWN: see PAGE DOWN on page 31
HOME: see HOME on page 32
END: see END on page 33
LEFT ARROW: see RIGHT ARROW on page 34
RIGHT ARROW: see LEFT ARROW on page 35

Admin Portal Getting Started Guide


990-1040-001

The Home View

27

The Center Pane

UP ARROW This key moves to the previous record. This key has no effect if the
first record is selected.

28

The Home View

Admin Portal Getting Started Guide


990-1040-001

Navigating a Database

DOWN ARROW This key moves to the next record. This key has no effect if the
last record is selected.

Admin Portal Getting Started Guide


990-1040-001

The Home View

29

The Center Pane

PAGE UP This key scrolls up the current screen and selects the first record on the
screen. This key has no effect if the first record is selected.

30

The Home View

Admin Portal Getting Started Guide


990-1040-001

Navigating a Database

PAGE DOWN This key scrolls down the current screen and selects the last record
on the screen. This key has no effect if the last record is selected.

Admin Portal Getting Started Guide


990-1040-001

The Home View

31

The Center Pane

HOME This key moves to the first record on the current screen. This key has no
effect if the first record is selected.

32

The Home View

Admin Portal Getting Started Guide


990-1040-001

Navigating a Database

END This key moves to the last record on the current screen. This key has no effect
if the last record is selected.

Admin Portal Getting Started Guide


990-1040-001

The Home View

33

The Center Pane

RIGHT ARROW This key scrolls data to the left if the Center pane has a horizontal
scroll bar. This key has no effect if the Center pane does not have a horizontal scroll
bar.

34

The Home View

Admin Portal Getting Started Guide


990-1040-001

Navigating a Database

LEFT ARROW This key scrolls data to the right if the Center pane has a horizontal
scroll bar. This key has no effect if the Center pane does not have a horizontal scroll
bar.

To summarize:
the UP ARROW key moves to the previous record

the DOWN ARROW key moves to the next record


the PAGE UP key scrolls data to the previous screen
the PAGE DOWN key scrolls data to the next screen
the HOME key moves to the first record on the first screen
the END key moves to the last record on the last screen
the LEFT ARROW key scrolls data to the right
the RIGHT ARROW key scrolls data to the left

Admin Portal Getting Started Guide


990-1040-001

The Home View

35

The Center Pane

Navigating a Large Database


The Center pane displays up to 100 database records at a time.
When a database has more than 100 records, the AP Client adds navigation
controls to the Center pane.
The following screenshot shows the Permissions database, which contains several
hundred records.

Note that the AP Client is displaying records 1 - 100 of 848 records, and has added
two buttons (marked in red) to the top line in the Center pane.

36

The Home View

Admin Portal Getting Started Guide


990-1040-001

Navigating a Large Database

The screenshots below identify the Next Page and the Last Page buttons.

Click the Next Page button to display the next 100 records in the database.
Click the Last Page button to display the last 100 records in the database.
Once you advance beyond the first 100 records, the AP Client adds two additional
navigation controls (marked in red in the next screenshot) to the Center pane:

Admin Portal Getting Started Guide


990-1040-001

The Home View

37

The Center Pane

The screenshots below identify the First Page and the Previous Page buttons:

Click the Previous Page button to display the previous 100 records in the
database.
Click the First Page button to display the first 100 records in the database.

38

The Home View

Admin Portal Getting Started Guide


990-1040-001

Navigating a Large Database

You can also enter a starting record number in the record number box, as shown
in the next screenshot:

The AP Client uses the value you entered the next time you click a navigation
button.

Admin Portal Getting Started Guide


990-1040-001

The Home View

39

The Center Pane

Sorting Records
By default, the database records are displayed in ascending alphabetical order.

Tip
You can click anywhere on the
database name to
change the sorting
order, not just on the
arrow.

40

The Home View

Click the arrow to reverse the sorting direction.

Admin Portal Getting Started Guide


990-1040-001

Sorting Records

If you sort a large database, such as the Subscribers database, the AP Client may
display an animated busy indicator until the sort completes:

Admin Portal Getting Started Guide


990-1040-001

The Home View

41

The Center Pane

Adding and Removing Fields


Tip
Adding or removing
a field affects a view
for all users. Conversely, other users
can also add or
remove fields, which
will affect your view.
For a way to save
this view so that it is
tied to your log in
ID, see Adding a
Preset on page 63.

The second line of the Center pane contains the names of the fields in the
database. The default view of any database is always the database key, which is
also the name of the database.
However, you can select other fields to display besides the key.
In the next screenshot, the user has selected AP Configuration Menu Category, the
UserManager Menu Folder, and the Users Menu Link.
To display any or all of the other database fields, right-click anywhere on the blue
bar that contains the database name:

A menu appears.

42

The Home View

Admin Portal Getting Started Guide


990-1040-001

Adding and Removing Fields

From the menu, click Add/Remove Columns:

The Choose Columns dialog box appears. This dialog box lists the additional
database fields that can be displayed in the Center pane:

The check boxes indicate the current display status. In the previous screenshot,
none of the other fields of the Users database have been selected.

Admin Portal Getting Started Guide


990-1040-001

The Home View

43

The Center Pane

In the next screenshot, the user has selected the enabled field from the Choose
Columns dialog box. Once the OK button is clicked, that field will also be displayed
in the Center pane, along with the database key:

The AP Client displays the Users database with the fields selected in the Choose
Columns dialog box. In addition, the AP Client remembers these settings and
applies them each time the Users Menu Folder is selected.

44

The Home View

Admin Portal Getting Started Guide


990-1040-001

Adding and Removing Fields

In the next screenshot, all of the database fields of the Users database have been
selected:

However, something is wrong with this window. Although all of the database fields
have been selected, not all of the fields are displayed.
Use any of the following methods to reveal the hidden fields in the Center pane:
resize the AP Client window to make it wider

use the Center panes horizontal scroll bar (see the previous screenshot)
expand the Center pane (see Expanding the Center Pane on page 59)

Admin Portal Getting Started Guide


990-1040-001

The Home View

45

The Center Pane

Distinguishing Duplicate Field Names


If you add fields from similar objects, you will sometimes find that the AP displays
duplicate field names.
For example, in the screenshot below the user has navigated to the Provisioning
Menu Category, the GR303 Menu Folder, the Interface Group Menu Link, and
decided to add the pathStatus fields from the primaryEOCTrunk,
primaryTMCTrunk, secondaryEOCTrunk, and secondaryTMCTrunk.
Note that the Admin Portal displays all four fields simply as pathStatus:

To distinguish which pathStatus belongs to which trunk, rest the mouse on a Field
Name:

46

The Home View

Admin Portal Getting Started Guide


990-1040-001

Generating a Report

Generating a Report
You can generate a database report from any screen that displays database
records, such as the Provisioning or Maintenance screens. You can also generate
a report from most of the other Admin Portal screens, including the Billing,
IseHouse, screens. However, you cannot generate reports from the TaquaMail,
HA-CDR search, or Admin Portal Home screens.
The report consists of the record key, and any fields you chose to display in the
Center pane (see Adding and Removing Fields on page 42).
To generate a report, right-click in the Center pane. A menu appears. Choose
Generate Report.

Admin Portal Getting Started Guide


990-1040-001

The Home View

47

The Center Pane

The Report Format dialog appears:

The Admin Portal can generate the report in any of the following formats:
HTML the report is generated in Hyper Text Markup Language, and is
displayed as a new tab in your browser. See Displaying a Report in
HTML on page 49.

PDF the report is generated in Adobe Portable Document Format, and


is displayed as a new tab in your browser. See Displaying a Report in
Portable Document Format on page 50.

XML the report is generated in eXtensible Markup Language, and is


displayed as a new tab in your browser. See Displaying a Report in XML
on page 51.

CSV (download) the report is generated as a Comma Separated Value


file and downloaded to your computer. Downloading a Report in CSV
Format on page 55.

CSV (export) the report is generated in Comma Separated Value


format and exported to a file on the AP Server. Downloading a Report in
CSV Format on page 55.

In the Report Format dialog, click a format for the report. To include all columns
(fields) for the report, click the Use All Columns check box.
Click OK to generate the report, or click the red close button to cancel the entire
operation.
The following sections present the same report in each of the above formats.

48

The Home View

Admin Portal Getting Started Guide


990-1040-001

Generating a Report

Displaying a Report in HTML

Report contents depend on the type of report.


Close the browser window when you are through viewing the report.

Admin Portal Getting Started Guide


990-1040-001

The Home View

49

The Center Pane

Displaying a Report in Portable Document Format


You must have the Adobe Acrobat Reader, or an equivalent plug-in, installed on
browser to view reports in PDF format. Note that the Acrobat reader can save or
print a report in the Portable Document Format.
Report contents depend on the type of report.
Close the browser window when you are through viewing the report.

50

The Home View

Admin Portal Getting Started Guide


990-1040-001

Generating a Report

Displaying a Report in XML


The contents of a report in XML format depend on the capabilities of your browser.
The following screenshot shows FireFox 3.16 displaying an XLM format report:

Admin Portal Getting Started Guide


990-1040-001

The Home View

51

The Center Pane

This is the same report as displayed by Chrome 10.0:

52

The Home View

Admin Portal Getting Started Guide


990-1040-001

Generating a Report

To display the report with formatting, right-click in the browser window.


A menu appears. From the menu, click Inspect element:

Admin Portal Getting Started Guide


990-1040-001

The Home View

53

The Center Pane

Chrome displays the formatted XML data in a separate pane.

For details, consult the Chrome documentation.


Report contents depend on the type of report.
Close the browser window when you are through viewing the report.

54

The Home View

Admin Portal Getting Started Guide


990-1040-001

Generating a Report

Downloading a Report in CSV Format


A report saved in CSV (Comma Separated Value) format and downloaded to your
computer can be opened with a spreadsheet program, such as Microsoft Excel.
The following screenshots shows the result of choosing the DN_LIST report in CSV
(downloaded) report format:
with Google Chrome 11.0

Admin Portal Getting Started Guide


990-1040-001

Click the download file link (circled in red) to open the file with the
associated program.

The Home View

55

The Center Pane

with Mozilla Firefox 4.0.1:

click the Save File button, then the OK button

in the Downloads dialog, right-click the report. From the menu, click
Open Containing Folder

Tip
If Firefox does not
save the reports
csv file extension,
add a csv extension
to the file name.
That way, the file
will be associated
with your spreadsheet program.

56

The Home View

Admin Portal Getting Started Guide


990-1040-001

Generating a Report

For other browsers, consult your documentation.


The following screenshot shows the file opened with Microsoft Excel 2007:

Report contents depend on the type of report.


Close the browser and spreadsheet windows when you are through viewing the
report.

Admin Portal Getting Started Guide


990-1040-001

The Home View

57

The Center Pane

Saving a Report in CSV Format


A report saved in CSV (Comma Separated Value) format on the Admin Portal can
easily be imported into a spreadsheet program, such as Open Office Calc. The
Admin Portal reports the location of the CSV file in a new browser window:

Report contents depend on the type of report.


Close the browser window when you are through.

58

The Home View

Admin Portal Getting Started Guide


990-1040-001

Expanding the Center Pane

Expanding the Center Pane


Tip
Expanding or hiding the Center pane
affects a view for all
users. Conversely,
other users can also
expand or hide the
Center pane, which
will affect your view.

The splitter control expands and shrinks the Center pane. The Center pane
expands and shrinks at the expense of the Right pane, so when the Center pane
is fully expanded, the Right pane is hidden. The splitter displays as three black
blocks near the Center pane scroll bar. Hover the mouse on the splitter to display
a bi-directional white arrow that indicates you can size by moving left or right. Click
the splitter and a blue guide line guides positioning as you size the panes. You can
double-click the splitter to return to the default sizing of the screen.

For a way to save


this view so that it is
tied to your log in
ID, see Adding a
Preset on page 63.

The splitter and guide line display on the following screen:

Tip
Not every view has
a Right pane. However, the AP Client
always displays the
splitter. When a
view does not have
a Right pane, the
splitter does not
respond to mouse
clicks.

With the Center pane scaled down and the Right pane displayed, you can click the
splitter to open the Center pane to the full default size. If you drag the splitter right
to show as many database fields in the Center pane as possible, you can hide the
Right pane. With the Right pane hidden, can click the splitter to return the Center
pane to its default size and redisplay the Right pane.

Admin Portal Getting Started Guide


990-1040-001

The Home View

59

The Center Pane

The following screen shows the AP Client with the Center pane expanded, and the
Right pane closed. Note that the splitter is still visible at the extreme right of the
window:

Even with the Center pane open to the maximum, the AP Client window may still
be a bit too narrow to display all of the database fields that were selected
If the Center pane is not wide enough to display all of the database fields, the
easiest way to fix this problem is to simply make the AP Client Window wider. As
the AP Client becomes wider or narrower, the width of the Menu pane and Right
pane remain constant, but the width of the Center pane shrinks and expands.
There are times, however, when this will be either inconvenient or impossible. See
the next section for another way to display more data in the Center pane.

60

The Home View

Admin Portal Getting Started Guide


990-1040-001

Resizing Columns

Resizing Columns
You can change the size of any column.
Column size is stored with your login profile. When you resize a column, you are
the only user who is affected by the change.

Tip
The AP Client can
automatically resize
a column: when the
pointer is a
,
double-click, and
the column width
will shrink (or
expand) to the width
of the narrowest (or
widest) value in the
database field.

When the pointer is between two database field names, it becomes a white bidirectional arrow. Left-click and drag the pointer to the left or to the right to resize
the column.

In other words, if the


column is wider
than the width of the
widest entry, the AP
client shrinks the
column.
If the column is narrower than then
width of the widest
entry, the AP Client
expands the
column.
However, if the column is just the right
size, nothing happens when you
double-click,
because nothing
needs to be done.

Admin Portal Getting Started Guide


990-1040-001

The Home View

61

The Center Pane

Moving Columns
You can rearrange the order in which the AP Client displays the database fields.
Column order is stored with your login profile. When you move columns, you are
the only user who is affected by the change.
Left-click and drag the pointer in any database field name to move that field to a
new location.
The following screenshot shows the Center pane after the group field has been
moved to the left of the enabled field.

62

The Home View

Admin Portal Getting Started Guide


990-1040-001

Adding a Preset

Adding a Preset
If you have more than one set and arrangement of database fields, you can save
them in a Preset. Each database can have any number of Presets.
Presets are stored with your login profile. When you add a preset, you are the only
user who is affected by the change.
To create a Preset, right-click a database field name:

A menu appears.

Admin Portal Getting Started Guide


990-1040-001

The Home View

63

The Center Pane

From the menu, click Save Preset:

In Internet Explorer, an information bar may request that you click to allow
scripted windows. Click the Information bar:

64

The Home View

Admin Portal Getting Started Guide


990-1040-001

Adding a Preset

Click Temporarily Allow Scripted Windows. Then right-click on a database field


name and from the menu click Save Preset.

In the Script Prompt dialog box, enter a name for the Preset. When finished, click
the OK button:

Admin Portal Getting Started Guide


990-1040-001

The Home View

65

The Center Pane

In the confirmation dialog box, click the OK button:

Note: Google Chrome asks if you want to prevent the page from creating additional
dialog boxes. Do NOT select the check box (marked in red in the next screenshot)
if you want to be able to create additional Presets.

66

The Home View

Admin Portal Getting Started Guide


990-1040-001

Choosing a Preset

Choosing a Preset
Once you have created some Presets. you can choose one to change the current
Center pane view.
To choose a new Preset, click the arrow in the Presets box:

Click a new Preset to use from the list:

Admin Portal Getting Started Guide


990-1040-001

The Home View

67

The Center Pane

The AP Client displays the Center pane with the settings of the new Preset, and
displays its name in the Preset box:

68

The Home View

Admin Portal Getting Started Guide


990-1040-001

Deleting a Preset

Deleting a Preset
Once you have created a Preset, you can delete it.
To delete a Preset, you must first select it. The AP Client will not delete a Preset
until it has been selected. See Choosing a Preset on page 67.
Next, right-click a database field name:

A menu appears.

Admin Portal Getting Started Guide


990-1040-001

The Home View

69

The Center Pane

From the menu, click Delete Preset:

Tip
The AP Client does
not update Preset
names until you reselect the Menu
Folder. Also, the AP
Client remembers
the current Center
pane view, even if it
is no longer associated with a Preset.

70

The Home View

A confirmation dialog box will appear, naming the deleted Preset. Click the OK
button to dismiss the dialog box.

Admin Portal Getting Started Guide


990-1040-001

Using the Filter Controls

Using the Filter Controls


Tip
Use Custom Filters
for more complex filtering. See Using
Custom Filters on
page 84.

The AP includes controls to help you filter the information displayed.You can use
the Filter controls to reduce the number of records the Admin Portal displays. Use
the Filter box to perform simple to moderate filtering operations on one or more
fields. The Auto Filter button lets you enable or disable automatic filtering. The
Custom Filter button lets you create and edit filters that help you find details of
interest to you. When you use a custom filter, the filter name displays in the Filter
Selector.
See:

Selecting Records Using the Filter Box on page 71


Selecting Records With Multiple Fields on page 81
Using Automatic Filtering on page 83

Selecting Records Using the Filter Box


Red squares indicates the Filter box, the Auto Filter button, the Custom Filter
button and the Filter Selector.

When the Filter box is blank, the AP Client displays all of the records in the
database.
When you type in the Filter box, the AP Client displays only the records in the
database that contain that text. If you enable Automatic Filtering by pressing the
Auto Filter button, the Admin Portal queries the T7000 database as you type each
character. If Auto Filter is disabled, you must press Enter to start the database
query for text you typed.
See:

Finding Records with a Simple Filter (Manual Filtering) on page 72


Selecting Records With a Negative Filter on page 74
Selecting Records With Comparison Filters on page 75
Finding Records Using Regular Expressions on page 77

Admin Portal Getting Started Guide


990-1040-001

The Home View

71

The Center Pane

Finding Records with a Simple Filter (Manual Filtering)

Tip
If the AP Client
does not respond to
your filter text, press
RETURN.

If necessary, click the Auto Filter button to disable Automatic filtering (enable
Manual filtering). With Manual filtering, the AP performs a simple query to display
all records with keys that are an exact match to the typed filter text after you press
Enter.
Filter boxes are not case-sensitive, so typing s and typing S will produce the
same result. The characters you type in a Filter box are treated as an exact match;
to search for the characters of a string in any position (at the beginning, middle or
end of the key), you must use the % wildcard (percent sign).
On the following screen, a filter of %a% has been typed in the Filter box to find
a in a key name wit h any number of characters before and after the a. The
Admin Portal displays every record in the database that contains an a somewhere
in the database key.

72

The Home View

Admin Portal Getting Started Guide


990-1040-001

Using the Filter Controls

On the following screen, the user has added an n to the filter:.

Tip
Filters are not case
sensitive, so AN,
An, aN and an
will produce the
same result.

This filter displays only the keys in the database that contain the string an.

Admin Portal Getting Started Guide


990-1040-001

The Home View

73

The Center Pane

Selecting Records With a Negative Filter


A filter that starts with an exclamation point (!) is a negative filter.
When the Filter box contains a negative filter, the Admin Portal displays only the
records in the database that do not contain the filter text.
The next screenshot shows the results after the user turns the filter in the previous
example into a negative filter.

This filter displays only the keys in the database that do not contain the string an.

74

The Home View

Admin Portal Getting Started Guide


990-1040-001

Using the Filter Controls

Selecting Records With Comparison Filters


A filter that starts with a greater than (>) or a less than (<) character is a
comparison filter:
When the Filter box contains a greater than comparison filter, the Admin Portal
returns all records greater than or equal to the filter
When the Filter box contains a less than comparison filter, the Admin Portal returns
all records less than the filter
The following examples use a very small Subscriber database:

The following screenshot shows the result of filtering the Subscriber key with a
comparison filter of <456. This filter returns all of the records in the database
whose key is less than 456:

Admin Portal Getting Started Guide


990-1040-001

The Home View

75

The Center Pane

The following screenshot shows the result of filtering the Subscriber key with a
comparison filter of >456. This filter returns all of the records in the database
whose key is greater than or equal to 456:

76

The Home View

Admin Portal Getting Started Guide


990-1040-001

Using the Filter Controls

Finding Records Using Regular Expressions

Tip
This section is for
advanced users.
Although quite powerful, learning the
syntax for Regular
Expressions (regex)
can be a daunting
task. To learn more,
search the Internet
for regex primers.

For advanced users: if a filter does not start with a !, <, or >, the Admin Portal
treats it as a POSIX Regular Expression.
In the following screenshot, the simple filter of 123 finds all Subscribers in the
database with the string 123 anywhere in the key:

NOTE: A Subscriber database could contain thousands of records, but the examples in
this document use test databases.

Admin Portal Getting Started Guide


990-1040-001

The Home View

77

The Center Pane

The next example assumes you want to search for records that contain the string
123 at the start of the key.
The regex syntax for this type of search is ^123.+$ which means:
^ look at the beginning of the string, followed by

123 123, followed by


.+ any single character one or more times, followed by
$ the end of the string

In the following screenshot, the regex filter finds all Subscribers in the database
with the string 123 at the beginning of the key:

78

The Home View

Admin Portal Getting Started Guide


990-1040-001

Using the Filter Controls

The next example assumes you want to search for records that contain the string
123 in the middle of the key. The regex syntax for this type of search is ^.123.+$
which means:
^ look at the beginning of the string, followed by

.+ any single character one or more times, followed by


123 123, followed by
.+ any single character one or more times, followed by
$ the end of the string

In the following screenshot, the regex filter finds all Subscribers in the database
with the string 123 in the middle of the key:

Admin Portal Getting Started Guide


990-1040-001

The Home View

79

The Center Pane

The final example assumes you want to limit the search to only records that contain
the string 123 at the end of the key. The regex syntax for this type of search is
^.+123$ which means:
^ look at the beginning of the string, followed by

.+ any single character one or more times, followed by


123 the string, followed by
$ the end of the string

In the following screenshot, the regex filter finds all Subscribers in the database
with the string 123 at the end of the key:

80

The Home View

Admin Portal Getting Started Guide


990-1040-001

Using the Filter Controls

Selecting Records With Multiple Fields

Tip
If you disable Automatic Filtering, the
Admin Portal will not
query the database
until you have finished entering all of
the filters. See
Using Automatic
Filtering on page
83.

When the AP Client displays multiple database fields, you can add a filter for each
field. The next screenshot shows a part of the Subscriber database. The user has
chosen to display the mwiOptions, PRIORITY_CALL and facility fields, in
addition to the database key.

Admin Portal Getting Started Guide


990-1040-001

The Home View

81

The Center Pane

The next screenshot shows the Center pane after the user has added a Stutter
filter to the mwiOptions field.

The AP Client supports multiple filters; here the user has added a TDM filter to
the facility field:

82

The Home View

Admin Portal Getting Started Guide


990-1040-001

Using the Filter Controls

Using Automatic Filtering


When Auto Filtering is enabled, the Admin Portal queries the database as you type
each character of the filter. This was the default Admin Portal behavior prior to the
development of Automatic Filtering.

Tip
When querying a
large database,
such as the Call
Detail Record database, disable
Automatic Filtering.

When Auto Filtering is disabled, the Admin Portal does not query the database until
you press the ENTER key.
Click Auto Filter to toggle the Auto Filtering state. As the following screenshots
show, the Admin Portal displays a ScreenTip with the current Auto Filtering state
when you rest the mouse on the Auto Filter button:

Admin Portal Getting Started Guide


990-1040-001

The Home View

83

The Center Pane

Using Custom Filters


You can reduce the number of records the Admin Portal displays by using a custom
filter. Use custom filters to perform simple, moderate, or complex filtering
operations on one or more fields.
Click Edit Custom Filters to create a new custom filter, or to edit, rename, or
delete a previously defined custom filter.

Click Select custom filter to apply a previously defined custom filter.

See:

84

The Home View

Managing Custom Filters on page 85


Applying a Custom Filter on page 100

Admin Portal Getting Started Guide


990-1040-001

Using Custom Filters

Managing Custom Filters


Click Edit custom filters to create, edit, or delete a custom filter.

The Admin Portal displays the Custom Filters dialog:

See:

Creating a Custom Filter on page 86


Editing a Custom Filter on page 93
Renaming a Custom Filter on page 97
Deleting a custom filter on page 99

Admin Portal Getting Started Guide


990-1040-001

The Home View

85

The Center Pane

Creating a Custom Filter


To create a new custom filter, click New:

In the Filter Properties pane, in the Name box, type the name of the new custom
filter:

86

The Home View

Admin Portal Getting Started Guide


990-1040-001

Using Custom Filters

If you are creating a custom filter you want to share with other Users, select Share:

NOTE: When you share a custom filter, you are sharing it with every User on the Admin
Portal. See Users on page 219.
Also note, only the User who creates a custom filter can edit, rename, or delete it.

In the Filter Properties pane:


In the Attribute list, click the name of the attribute to filter (the contents
of this list depend on the type of database you selected).

In the Test list, click the type of filtering you want the Admin Portal to
perform:

not equal to select records whose attribute value does not equal
Value 1

equal to select records whose attribute value equals Value 1

between select records whose attribute value is greater than Value


1 and less than or equal to Value 2

less than select records whose attribute value is less than or equal
to Value 1

contains select records whose attribute value contains Value 1

greater than select records whose attribute value is greater than


Value 1

does not contain select records whose attribute value does not
contain Value 1

In Value 1 (and optionally, in Value 2), enter the value(s) for the test

NOTE: Value 2 is only enabled for the between test.

Admin Portal Getting Started Guide


990-1040-001

The Home View

87

The Center Pane

Click Add Condition

At this point, your custom filter looks similar to the following screenshot:

If your custom filter is complete, click Save.


If you need to add an additional condition:
Choose an operator for the new condition:

AND select records that satisfy both the previous condition and the
new condition

OR select records that satisfy either the previous condition, the


new condition, or both conditions

repeat the steps to select an Attribute, Test, and Value(s)


be sure to click Add Condition, or the Admin Portal will not save your
new condition

If your custom filter is now complete, click Save. Otherwise, repeat the previous set
of steps to add an additional condition. You can add as many conditions to a
custom filter as you wish.
NOTE: If your custom filter contains both AND and OR conditions, the filter may not return
the result you expected. See Applying Multiple Conditions on page 89 and
Grouping Multiple Conditions on page 91.

88

The Home View

Admin Portal Getting Started Guide


990-1040-001

Using Custom Filters

Applying Multiple Conditions Confusion can arise when your custom filter has
have three or more conditions linked with a mix of AND and OR operators.
To illustrate, first consider the following set of records:
key

FirstName

PIN

9724800000

Alice

0000

9724800001

Bob

0623

9724800002

Charles

1234

6928311000

Diane

0000

6938311001

Edward

2003

6928311002

Fran

1234

Next, assume that the user has set up the following custom filter with the intent of
finding all of the records in the database whose key contains 972480 and whose
PIN is either 0000 or 1234:
Operator

Attribute

Test

Value 1

key

contains

972480

AND

PIN

equals

0000

OR

PIN

equals

1234

The user set up the filter expecting it to select Alice and Charles. But when the
custom filter is applied, the filter selects Alice, Charles, and Fran.

What went wrong?


The AND operator has a higher precedence than the OR operator. Higher
precedence means that Admin Portal processes the conditions connected by an
AND before it processes the conditions connected by an OR.
So when the custom filter contains a set of conditions like this:
key contains 972480 AND pin equals 0000 OR pin equals 1234

Admin Portal Getting Started Guide


990-1040-001

The Home View

89

The Center Pane

the Admin Portal processes the conditions like this:


(key contains 972480 AND pin equals 0000) OR (pin equals 1234)

not this:
(key contains 972480) AND (pin equals 0000 OR pin equals 1234)

In the example, the condition key contains 972480 selects Alice, Bob, and
Charles, and the condition PIN equals 0000 selects Alice and Diane.
The AND operator returns the record(s) satisfying both conditions. In this case, the
only record satisfying both conditions is Alice.
The condition PIN equals 1234 selects Charles and Fran.
The OR operator returns all of the records satisfying either condition. In this case
it added Charles and Fran to result of the previous condition (Alice).
You can override the default operator precedence to alter the order in which the
Admin Portal applies the conditions in the custom filter. SeeGrouping Multiple
Conditions on page 91.

90

The Home View

Admin Portal Getting Started Guide


990-1040-001

Using Custom Filters

Grouping Multiple Conditions Applying Multiple Conditions on page 89


illustrates the confusion that can arise when a set of conditions are linked with AND
and OR operators.
The following screenshot shows the Custom Filters dialog after configuring the
custom filter for that example:

Since the AND operator has a higher precedence than the OR operator, the Admin
Portal applies these conditions as follows:
(key contains 972480 AND pin equals 0000) OR (pin equals 1234)

However, the intent of the custom filter was to apply the conditions in this order:
(key contains 972480) AND (pin equals 0000 OR pin equals 1234)

You can alter the order in which the Admin Portal applies the conditions by editing
the text in the Expression box.
As shown in the previous screenshot, the Expression box contains:
A AND B OR C

The labels in the Condition column correspond to the conditions applied in the
Custom Filter. In this case:
Condition A corresponds to the condition key contains 972480

Condition B corresponds to the condition pin equals 0000


Condition C corresponds to the condition pin equals 1234

Admin Portal Getting Started Guide


990-1040-001

The Home View

91

The Center Pane

To alter the order which the Admin Portal applies the conditions, edit the
Expression box. In this case, you would change the expression to
A AND (B OR C)

Click Save and reapply the Custom Filter, which now works as expected:

92

The Home View

Admin Portal Getting Started Guide


990-1040-001

Using Custom Filters

Editing a Custom Filter

Tip
You cannot edit a
shared custom filter
created by another
user.

Edit a custom filter by adding a condition, changing a condition, or deleting a


condition.
To edit a custom filter, in the Filters box, click the custom filters name:

See:

Adding a Condition on page 94


Changing a Condition on page 95
Deleting a Condition on page 96

Admin Portal Getting Started Guide


990-1040-001

The Home View

93

The Center Pane

Adding a Condition To add a condition:

In the Filter Properties pane:


Choose an operator for the new condition

In the Attribute list, click the name of the attribute to filter (the contents
of this list depend on the type of database you selected)

In the Test list, click the type of filtering you want the Admin Portal to
perform

Click Add Condition


Click Save

For details, see Creating a Custom Filter on page 86.

94

The Home View

Admin Portal Getting Started Guide


990-1040-001

Using Custom Filters

Changing a Condition To change a condition:

In the Filter Properties pane:


Click any or all of the following:

Attribute
Test
Value 1
Value 2

Click Save

For details, see Creating a Custom Filter on page 86.

Admin Portal Getting Started Guide


990-1040-001

The Home View

95

The Center Pane

Deleting a Condition To delete a condition:

In the Filter Properties pane:


On the condition you wish to delete, click Remove Condition

Edit the Expression box

NOTE: when you delete a condition, the Admin Portal does not automatically update the
text in the Expression box. At a minimum, you must delete the letter
corresponding to the condition you deleted.

96

The Home View

Click Save

Admin Portal Getting Started Guide


990-1040-001

Using Custom Filters

Renaming a Custom Filter

Tip
You cannot rename
a shared custom filter created by
another user.

To rename a custom filter, in the Filters box, click the custom filters name:

Click Rename:

The rename custom filter dialog appears:

Enter a new name for the filter and click OK:

Admin Portal Getting Started Guide


990-1040-001

The Home View

97

The Center Pane

The Admin Portal updates the custom filter with the new name:

98

The Home View

Admin Portal Getting Started Guide


990-1040-001

Using Custom Filters

Deleting a custom filter

Tip
You cannot delete a
shared custom filter
created by another
user.

To delete a custom filter, in the Filters box, click the custom filters name:

Click Delete:

The Admin Portal deletes the custom filter:

Admin Portal Getting Started Guide


990-1040-001

The Home View

99

The Center Pane

Applying a Custom Filter


To apply a custom filter, click Select custom filter:

From the menu, click the name of the custom filter you wish to apply:

The Admin Portal applies the selected filter to the database:

100

The Home View

Admin Portal Getting Started Guide


990-1040-001

Using Custom Filters

To return to an unfiltered view of the database, click Select custom filter and from
the menu click No filter.

Admin Portal Getting Started Guide


990-1040-001

The Home View

101

The Center Pane

Database Synchronization
Normally, the switch pushes database updates to the AP. Occasionally, however,
the version of a database on the switch and the version of the same database on
the AP Server do not match. This can happen for any number of reasons, such as
network congestion, or perhaps because a large provisioning script ran on the
switch.
When the AP detects that its version of a database does not match, it displays a
Database Synchronization information message to inform you that it is
synchronizing databases.
In the following screenshot, the AP has detected that its version of the Subscribers
database no longer matches the version on the switch, and has initiated the
synchronization process:

102

The Home View

Admin Portal Getting Started Guide


990-1040-001

Database Synchronization

In the next screenshot, the AP has started reading the new Subscriber records from
the switchs Subscriber database:

These could be entirely new Subscribers, deleted Subscribers, or simply changes


to existing Subscribers. In every case, the AP Subscriber database no longer
matches the switchs version.

Tip
Each dot represents
100 records. The
AP Client always
displays at least one
dot, even if less
than 100 records
require
synchronization.

The update process can take some time, so the AP Client displays a series of dots
(circled in red) to indicate progress, as the next screenshot shows:

Admin Portal Getting Started Guide


990-1040-001

The Home View

103

The Center Pane

When synchronization is complete, the Admin Portal briefly displays a summary of


the synchronization activity before it automatically closes the Synchronization
dialog:

104

The Home View

Admin Portal Getting Started Guide


990-1040-001

Managing files with fileCleanup

Managing files with fileCleanup


From the Center Pane context (right-click) menu, you can create and run a
fileCleanup task. A fileCleanup task lets you automate the preservation and clean
up of system administration files for a database.
1.

From the Home View, navigate to AP Configuration > Network >


Collectors.

2.

Right-click the Center Pane, and then click Insert fileCleanup to add a
fileCleanup task. The fields for the fileCleanup task display in the Right Pane.

3.

Specify the task by choosing values for the following fields in the Right Pane:
Attribute
name

Description
A user-specified descriptive name for the task. For example,
you might name the fileCleanup task for preserving and
purging Log files in the /var/log folder TaquaLogs.
Tip: Junk CDRs, sysmon files, database backup files,
performance statistics files, and Taqua Terminal files are file
types that you may want to preserve and manage file
deletion for as required to keep files for durations that work
for your network.

folder

Specify the directory path that leads to the folder where the
files to be managed are located.

maxAge

The maximum number of days a file in the specified path is


allowed to age before deletion by the task. The default value
is 30.
Range: 1 to 90

Admin Portal Getting Started Guide


990-1040-001

The Home View

105

The Center Pane

Attribute

Description

recursive

Click the check box to enable recursion for the files in the
sub-folders in the path specified in the folder field. Click the
enabled (checked) check box to clear recursion for files in
the sub-folders in the folder path.

enabled

Click the check box to enable the task to run when you
choose Run Task Now on the Center Pane's right-click
menu. If the task is enabled (checked) click to clear the
check box and disable the task.
NOTE: When you run a task from the Center Pane, you can
specify a different maxAge to adjust the cleanup for
your immediate needs.

4.

106

The Home View

Click the first check box at the top left of the Right Pane ( ) to Commit all
changes and save the task you specified. To Cancel all changes you have
specified for fields in the Right Pane, click the second check box ( ).

Admin Portal Getting Started Guide


990-1040-001

userDefined Fields

The Right Pane


Tip
The Right pane is
only visible when
the splitter is open.
For more information, see
Expanding the
Center Pane on
page 59.

The Right pane displays the database record that is selected in the Center pane.
Use the Right pane to modify, create, and clone records.

userDefined Fields
Many records that display in the Right pane now include a userDefined field that
you can click to create custom or site-specific fields on the Admin Portal.
To create a userDefined field, click Click to add new field.

Type the name of the new attribute in the text box that appears. Press Enter to add
the new field. The new field is visible to and editable by users with the appropriate
database permissions.
NOTE: When you add a userDefined field, it is stored on the AP in a SQL database and
not in the switch configuration database. Add fields that you plan to use long term
as userDefined fields; deletion of userDefined fields from the SQL database
requires technical assistance.

Entering Different Types of Data


As a user of the AP Client, you will enter the following types of data:
Number: see Number Data on page 108

Text: see Text Data on page 109


Toggle: see Toggle Data on page 110
Choice: see Choice Data on page 111

Admin Portal Getting Started Guide


990-1040-001

The Home View

107

The Right Pane

Number Data
Number data are numeric values in the switch database.
Depending on the attribute, the ScreenTip may display either or both of the
following types of information:
the Range, which is the minimum and maximum permitted values for this
field. In this case, the Range is from 1 to 999.

the Default, is the value that the switch will supply when you create a
record using the Command Line Interface.

See Displaying and Modifying the Attributes of a Single Record on page 113 for
an example of entering Number data.

108

The Home View

Admin Portal Getting Started Guide


990-1040-001

Entering Different Types of Data

Text Data

Tip
Text data with a
value of 123 may
look like a number,
but the switch treats
it as a text string.

Text data are string values in the switch database. The Text data ScreenTip will tell
you the minimum and maximum lengths of the Text data, if they exist. Text data
usually do not have a Default.

See Adding Records on page 135 for an example of entering Text data.

Admin Portal Getting Started Guide


990-1040-001

The Home View

109

The Right Pane

Toggle Data

Tip
You will usually find
Toggle data inside a
Click to open field.

Toggle data are individual attributes that can be toggled ON or OFF, like a light
switch. When the Toggle data is ON (the attribute has been selected), the AP Client
displays a box with check. When the Toggle data is OFF (the attribute has not been
selected), the AP Client displays a box without a check.
Toggle data has a Default, which is usually OFF.
In the following screenshot, subscribedServices has been clicked, revealing
Toggle data. The CALLER_ID, and CALLING_NAME attributes have been
selected. The other displayed attributes have not been selected.

See Displaying and Modifying the Attributes of Multiple Records on page 122 for
an example of entering Toggle data.

110

The Home View

Admin Portal Getting Started Guide


990-1040-001

Entering Different Types of Data

Choice Data
When the switch database has assigned a set of mutually exclusive values to an
attribute, the AP Client displays them as Choice data.
When Choice data has a default, the AP Client uses the default value to initialize
the field.
In the following screenshot (taken from the Subscribers Menu Link), the
ScreenTip shows that mwiOptions is Choice data:

Clicking the mwiOptions value reveals the top of the mwiOptions Choice menu:

Click anywhere on the top of the Choice menu to display additional values for
mwiOptions:

Admin Portal Getting Started Guide


990-1040-001

The Home View

111

The Right Pane

Click the new value:

The AP Client displays the value you selected at the top of the Choice menu:

Click anywhere in the Attribute column to replace the Choice menu with the value
you selected:

The AP Client displays the green Commit and the red Cancel check boxes. Follow
the procedure on page 116 to complete the update.

112

The Home View

Admin Portal Getting Started Guide


990-1040-001

Displaying and Modifying the Attributes of a Single Record

Displaying and Modifying the Attributes of a Single Record


In the following screenshot, the user has selected the AP Configuration Menu
Category, the UserManager Menu Folder, the Groups Menu Link, and the Pawns
record. The Pawns record is displayed with a blue background. The Right pane
displays the database attributes and values:

Tip
Once a value is
selected, use the
TAB key to move to
the next read-write
field, and the SHIFT
TAB key to move to
the previous readwrite field.

Note that the AP Client displays the Value of the name field in gray, and the Value
of the level field in blue.
A Value displayed in gray is read-only. You cannot modify it.
A Value displayed in blue is read-write, and can be modified.
Besides color, another way to tell if a Value can be modified is to look at the pointer:
when the pointer is an
the field is read-only, and cannot be modified

when the pointer is a

the field is read-write, and can be modified

The AP Client will display a ScreenTip if you rest the pointer on a fields Value.

Admin Portal Getting Started Guide


990-1040-001

The Home View

113

The Right Pane

The next screenshot shows the pointer resting on level, the second attribute of a
Groups database record:

This ScreenTip gives the name of the field and the data type of this field, which in
this case is Number. See Entering Different Types of Data on page 107 for more
information about the different types of switch data.

114

The Home View

Admin Portal Getting Started Guide


990-1040-001

Displaying and Modifying the Attributes of a Single Record

In the following screenshot, the user has selected the level field, and is in the
process of changing the Value from 1 to 2:

Admin Portal Getting Started Guide


990-1040-001

The Home View

115

The Right Pane

Once the user presses ENTER, the AP Client displays two check boxes (marked
in red in the next screenshot) to the left of the level field:

Click the green Commit check box on the left to update the field with the new value,
or the red Cancel check box on the right to cancel the update operation on the
selected field:

116

The Home View

Admin Portal Getting Started Guide


990-1040-001

Displaying and Modifying the Attributes of a Single Record

Once the user presses ENTER, the AP Client also displays two check boxes
(marked in red in the next screenshot) on the Attributes and Values title:

Tip
When a record has
only one field that
can be modified,
there is no difference between
Commit/Cancel
Changes and Commit/Cancel All
Changes.

Click the green Commit All Changes check box on the left to update the record
with the new values for all fields, or the red Cancel All Changes check box on the
right to cancel the entire update operation:

Commit/Cancel All
Changes is more
useful when you are
updating multiple
fields in a record.

Admin Portal Getting Started Guide


990-1040-001

The Home View

117

The Right Pane

After clicking the Commit or Commit All Changes check box, the AP Client
displays the results of modifying the record.
In the next screenshot, the user successfully changed the value of level from 1 to
2. The AP Client indicates success by briefly displaying the attribute name in green
italics:

118

The Home View

Admin Portal Getting Started Guide


990-1040-001

Displaying and Modifying the Attributes of a Single Record

Wherever possible, the AP Client verifies your intended changes against the
database metadata.
For example, on page 108 the ScreenTip for the level attribute showed that its
value must be a number between 1 and 999.
In the next screenshot, the user has attempted to set the value of level to 000.
Because this value is outside the permitted range, the record cannot be modified.
The AP Client displays an information message to inform you of the error:

Dismiss the information message by clicking the OK button, then enter a value
within the permitted range.

Admin Portal Getting Started Guide


990-1040-001

The Home View

119

The Right Pane

Some errors, however, cannot be caught until the AP Client attempts to modify the
record.
In the next screenshot, the user has selected the AP Configuration Menu Category,
the UserManager Menu Folder, the Users Menu Link, and the bob record. The user
is attempting to change the value of the changePassword attribute, but does not
have permission to do so.

The AP Client cannot detect this type of error, so it attempts to update the record.

120

The Home View

Admin Portal Getting Started Guide


990-1040-001

Displaying and Modifying the Attributes of a Single Record

The database catches the permissions problem, and rejects the update. The AP
Client indicates failure by redisplaying the original value of the attribute, and by
displaying the attribute name itself in red italics.

Click on the attribute name for a information message with an explanation of why
the update failed:

Dismiss the information message by clicking the OK button.

Admin Portal Getting Started Guide


990-1040-001

The Home View

121

The Right Pane

Displaying and Modifying the Attributes of Multiple Records


You can make changes to multiple records on most of the T7000 databases.
In this example, the user is going to assign the SPEED_DIAL30 service to those
subscribers who currently have the SPEED_DIAL8 service.
In the following screenshot, the user has selected the T7000 View, the Provisioning
Menu Category, the Subscriber Menu Folder, and the Subscribers Menu Link.
The user has also added the SPEED_DIAL30 and the SPEED_DIAL8 fields to the
Center pane (see Adding and Removing Fields on page 42 for details), and
selected all of the Subscribers who have the SPEED_DIAL8 feature, but do not
have the SPEED_DIAL30 feature (see Selecting Records With Multiple Fields on
page 81 for details):

122

The Home View

Admin Portal Getting Started Guide


990-1040-001

Displaying and Modifying the Attributes of Multiple Records

In the next screenshot, the user has selected the first Subscriber record in the
usual way (by clicking the Subscriber record):

Note that the AP Client is displaying the selected record with a blue background.
To select the remaining Subscribers, the user depresses the SHIFT key and clicks
the last Subscriber record:

Note that the AP Client is now displaying all records with a blue background.

Admin Portal Getting Started Guide


990-1040-001

The Home View

123

The Right Pane

You can select or deselect individual records by depressing the CTRL key and
clicking the record with the mouse.
In the next screenshot, the user has decided to modify the only the first and third
records:

To summarize:
select a range of multiple records by:

The Home View

clicking the first record, and


CTRL-clicking each additional record

de-select individual records by:

124

SHIFT-clicking the last record

select individual records by:

clicking the first record, and

CRTL-clicking a selected record

Admin Portal Getting Started Guide


990-1040-001

Displaying and Modifying the Attributes of Multiple Records

For this example, all three records will be updated.


In the next screenshot, the user re-selected the second record, and used the
splitter control to shrink the Center pane, expanding the Right pane (see
Expanding the Center Pane on page 59 for details).
In the Right pane, the user has scrolled down to the subscribedServices field.
The value of this field is Click to open. This means that the subscribedServices
field contains multiple sub-fields that the AP Client does not normally display.

Click the subscribedServices Value to expand the subscribedServices field.

Admin Portal Getting Started Guide


990-1040-001

The Home View

125

The Right Pane

The next screenshot shows the Control pane after the user clicks the
subscribedServices Value:

The subscribedServices Value is now Click to close. Click it to collapse the field.

126

The Home View

Admin Portal Getting Started Guide


990-1040-001

Displaying and Modifying the Attributes of Multiple Records

In the next screenshot, the user has scrolled down the list of subscribedServices
and found the SPEED_DIAL30 and SPEED_DIAL8 fields. Note that the
SPEED_DIAL8 check box is selected, and that the SPEED_DIAL30 check box is
clear:

In the next screenshot, the user has clicked the check boxes to add the
SPEED_DIAL30 service and remove the SPEED_DIAL8 service, and is about to
commit the changes to the database:

Note that the Center pane still shows all three records selected.

Admin Portal Getting Started Guide


990-1040-001

The Home View

127

The Right Pane

After the user clicks the Commit All Changes check box, the AP Client applies the
updates to the selected records. The next screenshot shows the AP Client in the
process of updating both fields:

Note that the Value column for both SPEED_DIAL8 and SPEED_DIAL8 display a
busy indicator.
The next screenshot shows the AP Client after SPEED_DIAL30 has been updated:

The SPEED_DIAL8 Value still shows the busy indicator.

128

The Home View

Admin Portal Getting Started Guide


990-1040-001

Displaying and Modifying the Attributes of Multiple Records

In the next screenshot, both fields have been successfully updated:

As a check, the next screenshot shows that the Center pane filters can no longer
find any Subscribers with the SPEED_DIAL8 service:

Admin Portal Getting Started Guide


990-1040-001

The Home View

129

The Right Pane

For simplicity, the examples shown so far have either shown only the
subscribedServices field in the Right pane or have shown the Center pane fully
expanded.
The following screenshot shows what you might see when:
both the Center pane and the Right pane are displayed

you have selected multiple Subscriber records


multiple fields are visible in the Right pane:

Note that the Admin Portal is displaying specific values for most of the fields, but
the values for version, key, lastName, and firstName are displayed as ???.
When the Admin Portal is displaying multiple records and all of the selected records
share the same value for a field, the Admin Portal displays that value. However,
when two or more of the selected records have different values for a field, the
Admin Portal cannot display all of them. In this case, the Admin Portal displays the
triple question marks to let you know that the selected records do not have the
same value for that field.

130

The Home View

Admin Portal Getting Started Guide


990-1040-001

Displaying and Modifying a Collection

Displaying and Modifying a Collection


A database record may contain one or more Collections.
A Collection is a group of one or more items. The items in a Collection may be
simple data types or they may be objects.
For example:
a T7000 OfficeParms objects countryCodes Collection is a set of
numbers. Each number represents a country code.

a T7000 NANPRoutingList objects routes Collection is a set of route list


objects. Each route list object in turn may be a Trunk Group route list, a
Digit route list, a Facility route list, or a Service route list.

When you view a database record that contains one or more Collections, the Admin
Portal displays a plus
in front of the name of the database record.
For example, the following screenshot shows the officeParms database. The
Admin Portal displays a plus
in front of the name of the TaquaTx database
record to show that it contains at least one Collection.

Clicking the plus


in front of the database records key expands and collapses
the database records Collection(s).

Admin Portal Getting Started Guide


990-1040-001

The Home View

131

The Right Pane

The following screenshot shows that the TaquaTx database record after the user
has clicked on the plus
. This database record contains the OSSInfoDigits
Collection and the countryCodes Collection:

Clicking the plus


Collection.

in front of a Collection expands and collapses the items in the

The following screenshot shows the TaquaTx database record after the user has
clicked the plus
in front of the countryCodes Collection:

132

The Home View

Admin Portal Getting Started Guide


990-1040-001

Displaying and Modifying a Collection

To add an item to a Collection, right-click anywhere in the expanded Collection, or


right-click the data object.
A menu appears.
From the menu, click Insert:

The Right pane displays the attributes of the new item. The contents vary,
depending on the type of item you are adding to the Collection. For details, see the
T7000 or T7100 documentation.
To remove an item from the Collection, right-click the item.
A menu appears.

Admin Portal Getting Started Guide


990-1040-001

The Home View

133

The Right Pane

From the menu, click Delete:

In the Confirm dialog, click OK:

134

The Home View

Admin Portal Getting Started Guide


990-1040-001

Adding Records

Adding Records
You can add records to a database. In the next screenshot, the user is adding a
record to the Groups folder of the UserManager Menu Category.
To add a record, move the pointer to the Center pane and right-click anywhere in
the Center pane:

A menu appears.

Admin Portal Getting Started Guide


990-1040-001

The Home View

135

The Right Pane

From the menu, click Add:

Tip
The Right pane is
only visible when
the splitter is open.
For more information, see
Expanding the
Center Pane on
page 59.

A new record appears in the Right pane.

The AP Client reads the field names from the database, and displays them in the
Attributes column. Fields that require a value are marked with a red asterisk to the
right of the Attribute name. In this case, all fields require a value.

136

The Home View

Admin Portal Getting Started Guide


990-1040-001

Adding Records

The next screenshot shows the pointer resting on name, the first attribute of a
Groups database record:

Tip
The ScreenTip displays the fields data
type. See Entering
Different Types of
Data on page 107
for more about different types of data.

The AP Client will display a ScreenTip if you rest the pointer on a fields Value. The
ScreenTip gives the name of the field and the data type of the field, which in this
case is Text.
For name, the minimum and maximum length is from 1 to 32 characters.
Note that name does not have a default value.

Admin Portal Getting Started Guide


990-1040-001

The Home View

137

The Right Pane

The next screenshot shows the pointer resting on level, the second attribute of a
Groups database record:

Tip
The ScreenTip displays the fields data
type. See Entering
Different Types of
Data on page 107
for more about different types of data.

This ScreenTip gives the name of the field and the data type of this field, which in
this case is Number.
For level, the Range is from 1 to 999, and the Default is 1.
To summarize the current example:
both the name field and the level field require values, because both have
a red asterisk next to them

138

The Home View

the name field requires a value, because it does not have a default
the level field requires a value. Even though it has a default, the AP
ignores it.

Admin Portal Getting Started Guide


990-1040-001

Adding Records

In the next screenshot, the user has clicked on the Value column of the name field,
and has decided to create an Archbishops group:

Once the user presses ENTER, the AP Client displays a check box (marked in red)
to the left of the name field, and two more check boxes (also marked in red) on the
Attributes and Values title:

These check boxes are described on page 140 and page 141.

Admin Portal Getting Started Guide


990-1040-001

The Home View

139

The Right Pane

In the next screenshot, the user has clicked Value column of the level field and is
entering a value of 75:

Once the user presses ENTER, the AP Client displays a Cancel check box
(marked in red) to the left of the level field, This check box and the check box to
the left of the name field can be used to cancel the value of the respective field:

140

The Home View

Admin Portal Getting Started Guide


990-1040-001

Adding Records

Once the user has entered values for at least one field, two check boxes are
displayed on the Attributes and Values title.

Tip
Dont click the Create Object check
box until you have
entered values for
all required fields.

Click the green Create Object check box on the left to create the object, or the red
Cancel Create check box on the right to cancel the create operation:

Admin Portal Getting Started Guide


990-1040-001

The Home View

141

The Right Pane

The following screenshot shows the Center pane and Right pane after the user
clicks the Create Object check box:

A new record (marked in red) has been created and inserted into the Groups
database.
The following screenshots demonstrates what happens if the user attempts to
create a record that does not have all of the required fields:

142

The Home View

Admin Portal Getting Started Guide


990-1040-001

Adding Records

In this case, the user has entered a value for level, but not for name. Because
name is a required field, but it does not has a default, the record cannot be created.
The AP Client displays an information message to inform you of the error:

Dismiss the information message by clicking the OK button, and then add a value
for each missing field.

Admin Portal Getting Started Guide


990-1040-001

The Home View

143

The Right Pane

Cloning Records
A clone is a copy of a record. When a record has many fields, it is sometimes faster
to create a new record by copying an existing record and changing a few fields than
it is to create the new record entirely from scratch.
In the next screenshot, the user has selected the T7000 Menu Category, the
Provisioning Menu Folder, the Carriers Menu Link, and the ATT record:

The AP Client displays the selected record with a blue background.


Not all fields in the selected record can be cloned:
fields (including fields in the Center pane) displayed in gray have readonly attribute definitions. When the record is cloned, the Admin Portal
does not copy read-only fields to the cloned record. For example,

144

The Home View

version and key are read-only fields and are not copied to the cloned
record.

fields displayed in blue are read-write. When the record is cloned, the
Admin Portal copies the value of the field to the cloned record, unless its
attribute definition is UNIQUE. For example,

code is read-write, but its attribute definition is marked UNIQUE, so


the field is not copied to the cloned record

intraLata, interLata, international, and the remaining fields are


read-write and are not marked UNIQUE, so the fields are copied to
the cloned record.

Admin Portal Getting Started Guide


990-1040-001

Cloning Records

In the next screenshot, the user has clicked on the


Carrier record:

button to expand the ATT

The deniedInfoDigits field in the Center pane is read-only and is not copied to the
cloned record.
To clone a record, move the pointer to the Center pane and right-click the record
to be cloned:

A menu appears.

Admin Portal Getting Started Guide


990-1040-001

The Home View

145

The Right Pane

From the menu, click Clone:

The cloned (copied) record is displayed in the Right pane:

Fields that require a value are blank, and are marked with a red asterisk to the right
of the Attribute name. In this case, both key and code were not cloned, and both
require a value.

146

The Home View

Admin Portal Getting Started Guide


990-1040-001

Cloning Records

Fields that do not require a value are blank and are not marked. In this case, neither
version nor PCAC were cloned
Some blank fields can be edited, and some cannot. You can tell the difference by
resting your pointer on the Value for the field:
If you rest the pointer on a Value and the Admin Portal displays an arrow
, the Value cannot be edited.

If you rest the pointer on a Value and the Admin Portal displays a hand
, the Value can be edited.

When a Value can be edited, the Admin Portal also displays a ScreenTip that
provides additional information about the valid values for the field.
The next screenshot shows the pointer resting on key, the first attribute of a Carrier
database record:

The ScreenTip supplies the name of the field and the fields data type, which in this
case is Text. Depending on the field, other information, such as a default value,
may also be included.
Note that key does not have a default value.

Admin Portal Getting Started Guide


990-1040-001

The Home View

147

The Right Pane

The next screenshot shows the pointer resting on code, the second attribute of a
Carrier database record:

This ScreenTip also gives the name of the field and the data type of this field,
which in this case is Text.
Depending on the type of field, other information such as a default value may also
be included. For example, in the case of this Text field, the ScreenTip includes the
length, which is 4.
Note that code does not have a default value.
To summarize the current example:
both the key field and the code field require values, because both have
a red asterisk next to them

148

The Home View

both the key field and the code field require you to enter a value, because
neither of them has a default.

Admin Portal Getting Started Guide


990-1040-001

Cloning Records

In the next screenshot, the user has selected the Value column of the key field, and
is entering the name of the new Carrier:

Once the user presses ENTER, the AP Client displays a check box (marked in red
in the next screenshot) to the left of the key field:

Admin Portal Getting Started Guide


990-1040-001

The Home View

149

The Right Pane

Click the red Cancel check box on the right to cancel the update operation on the
selected field:

150

The Home View

Admin Portal Getting Started Guide


990-1040-001

Cloning Records

Also, once the user presses ENTER, the AP Client displays two check boxes
(marked in red in the next screenshot) on the Attributes and Values title:

Tip
Dont click the
Clone Object check
box until you have
entered values for
all required fields.

Click the green Clone Object check box on the left to update the record with the
new values for all fields, or the red Cancel Clone check box on the right to cancel
the entire update operation:

In this example, the


user still needs to
enter a value for the
code field.

Admin Portal Getting Started Guide


990-1040-001

The Home View

151

The Right Pane

In the next screenshot, the user has clicked the Value column of the code field and
is entering a value of 0012:

Once the user presses ENTER, the AP Client displays the Commit and Cancel
check boxes to the left of the code field:

152

The Home View

Admin Portal Getting Started Guide


990-1040-001

Cloning Records

Note any field displayed in blue can also be changed before creating the new
record. In the next screenshot, the user is in the process of changing the intraLata
field of the cloned Carrier record:

The following screenshot shows the Center pane and Right pane after the user
clicks the Clone Object check box:

A new record (marked in red) has been created and inserted into the Carrier
database.

Admin Portal Getting Started Guide


990-1040-001

The Home View

153

The Right Pane

The following screenshots demonstrates what happens if the user attempts to


clone a record that does not have all of the required fields:

In this case, the user has entered a value for key, but not for code. Because code
is a required field, but it does not has a default, the cloned record cannot be
created.

154

The Home View

Admin Portal Getting Started Guide


990-1040-001

Cloning Records

When the user clicks the Clone Object check box, the AP Client display an
information message to inform you of the error:

Dismiss the information message by clicking the OK button, and then add a value
for each missing field.

Admin Portal Getting Started Guide


990-1040-001

The Home View

155

The Right Pane

Deleting Records
You can remove records from a database. In the next screenshot, the user is
removing a record from the Groups folder of the UserManager Menu Category:

Note the AP Client displays the selected record with a blue background.

156

The Home View

Admin Portal Getting Started Guide


990-1040-001

Deleting Records

To delete a record, move the pointer to the Center pane and right-click the record
to be deleted:

A menu appears.
From the menu, click Delete:

Admin Portal Getting Started Guide


990-1040-001

The Home View

157

The Right Pane

In the confirmation dialog box, click OK:

158

The Home View

Admin Portal Getting Started Guide


990-1040-001

Deleting Records

The following screenshot shows the Center pane and Right pane after the user
clicks the OK button:

The AP Client updates the Center pane and the Right pane to show that the record
has been deleted.

Admin Portal Getting Started Guide


990-1040-001

The Home View

159

The Right Pane

160

The Home View

Admin Portal Getting Started Guide


990-1040-001

Other Views
In this chapter:

Introducing Selectors
The Billing View
The IseHouse View
The T7000 View
The T7100 View
The Taqua Mail View
The User Portal View

Admin Portal Getting Started Guide


990-1040-001

Other Views

161

Introducing Selectors

Introducing Selectors
Equipment Type Selector
The next screenshot identifies the Equipment Type Selector.

Use this control to quickly navigate to the following AP Client Views:

162

Other Views

The Home View


The T7100 View
The Billing View
The T7100 View
The User Portal View

Admin Portal Getting Started Guide


990-1040-001

Introducing Selectors

Open the Equipment Type Selector by clicking the arrow:

From the list, click the next Equipment Type to display in the Center pane.
Note that at this moment, clicking an Equipment Type from the Equipment Type
Selector and clicking an icon in the Center pane are equivalent.

Admin Portal Getting Started Guide


990-1040-001

Other Views

163

Introducing Selectors

Equipment Selector
Use the Equipment Selector to quickly navigate from one Equipment Type to
another.
The following screenshot identifies the Equipment Selector. This selector
appears after you have chosen an Equipment Type. In the next screenshot, the
user has chosen the T7000 Equipment Type.

164

Other Views

Admin Portal Getting Started Guide


990-1040-001

Introducing Selectors

Open the Equipment Selector by clicking the arrow:

From the list, click the next Equipment to display in the Center pane.
Note that at this moment, clicking an Equipment from the Equipment Selector and
clicking an icon in the Center pane are equivalent.
Use the Equipment Selector to quickly navigate from one Equipment to another,
including the All Equipment view shown here.

Admin Portal Getting Started Guide


990-1040-001

Other Views

165

The Billing View

The Billing View


The Billing view lists the Taqua Billing Servers in your Network.
A Taqua Billing Server converts Taqua Call Detail Records into an industry
standard format.
The next screenshot shows a typical Billing view:

This AP Client is managing one Billing.


See the T7000 Taqua Billing Guide for details.

166

Other Views

Admin Portal Getting Started Guide


990-1040-001

The IseHouse View

The IseHouse View


The IseHouse view lists the IseHouse Servers in your Network.
When a card is inserted into a shelf, or is reset, a IseHouse Server assigns the card
an IP Address, and downloads the card with software.
The next screenshot shows a typical IseHouse view:
This AP Client is managing one IseHouse server.

See the T7000 Admin Portal Provisioning Guide for details

Admin Portal Getting Started Guide


990-1040-001

Other Views

167

The T7000 View

The T7000 View


The T7000 view lists the switches in your Network. The next screenshot shows a
typical T7000 view:

This AP Client is managing a network of seven T7000 switches.


Click a T7000 icon to switch to the Provisioning Category.
Use the T7000 view to add, delete and browse switches in your network. See the
T7000 Admin Portal Provisioning Guide for details.
See:

168

Other Views

Adding and Removing Screens on page 169


Adding Menu Folders on page 178
Deleting Menu Folders on page 184

Admin Portal Getting Started Guide


990-1040-001

The T7000 View

Adding and Removing Screens


Tip
You need Administrator level account
to add or remove
screens.

After you click on a switch in the T7000 view, the AP Client presents the
Provisioning Category. The following screenshot shows this view with the Central
Office Folder selected:

Also, see Provisioning T7000


Category Menu
Folders on page
234 for the Provisioning Category
Factory settings.

Admin Portal Getting Started Guide


990-1040-001

Other Views

169

The T7000 View

The following screenshot shows the Menu Links of the Central Office Folder:

In this screenshot, the Central Office Folder contains the following screens, or
Menu Links:

170

Other Views

Carrier
OfficeParms
Prefix
RateCenter
ScreenList

Admin Portal Getting Started Guide


990-1040-001

The T7000 View

You can configure which screens are displayed under any of the Menu Folders of
the Provisioning Category.
Use this feature to hide databases that are not used on your switch.
You can also use this feature to display the same screen under more than one
Menu Folder for provisioning convenience.
For example, Trunk Groups displayed under both the Trunk Groups Menu Folder
and also by category. For example:

the Menu Link for H.248 Trunk Groups is listed in both the H248 Menu
Folder and the Trunk Groups Menu Folder

the Menu Link for SS7 Trunk Groups is listed in both the SS7 Menu Folder
and the Trunk Groups folder

However, no matter how many times a Menu Link is displayed in a Menu Folder, all
Menu Links point to the same screen.
When you configure the Provisioning Category Menu Folders, the changes are
visible to every user. Each switch in the network can be configured differently.
To change the screens that are displayed, right-click on the Folder name:

A menu appears.

Admin Portal Getting Started Guide


990-1040-001

Other Views

171

The T7000 View

From the menu, click Add/Remove Screens:

The Folder databases dialog box appears:

172

Other Views

Admin Portal Getting Started Guide


990-1040-001

The T7000 View

From Folder databases dialog box,

click an unchecked database name to add it to the Menu Link


click an checked database name to remove it from the Menu Link

You can add or remove any number of databases to or from a Menu Link this way.

When you are finished, click the OK button to exit the dialog and commit your
changes, or the Cancel button to exit the dialog without committing your changes.

Admin Portal Getting Started Guide


990-1040-001

Other Views

173

The T7000 View

Renaming Menu Folders


Tip
You need an Administrator level
account to add or
remove screens.

174

Other Views

After you click on a switch in the T7000 view, the AP Client presents the
Provisioning Category. The following screenshot shows this view with the Central
Office Folder selected:

Admin Portal Getting Started Guide


990-1040-001

The T7000 View

To rename a Menu Folder, right-click on the Folder name:

A menu appears.

Admin Portal Getting Started Guide


990-1040-001

Other Views

175

The T7000 View

From the menu, click Rename Folder:

The AP Client puts the Menu Folder name in a text box.

176

Other Views

Admin Portal Getting Started Guide


990-1040-001

The T7000 View

Type a new name for the Menu Folder:

Press ENTER to confirm the change.

Admin Portal Getting Started Guide


990-1040-001

Other Views

177

The T7000 View

Adding Menu Folders


Tip
You need an Administrator level
account to add
menu folders.

You can add Menu Folders to the Provisioning Category. These can display any of
the switchs databases.
The next screenshot shows the Provisioning Category selected:

To add a Menu Folder, right-click on the Provisioning Category:

A menu appears.

178

Other Views

Admin Portal Getting Started Guide


990-1040-001

The T7000 View

From the menu, click Add Folder:

Admin Portal Getting Started Guide


990-1040-001

Other Views

179

The T7000 View

The AP Client creates a text box with the default name of New Folder:

180

Other Views

Admin Portal Getting Started Guide


990-1040-001

The T7000 View

Type a new name for the Menu Folder:

When you are finished entering the name of the new Folder, press ENTER.

Admin Portal Getting Started Guide


990-1040-001

Other Views

181

The T7000 View

Tip
To add one or more
a databases to your
new Folder, see
Adding and
Removing Screens
on page 169.

182

Other Views

The AP Client automatically adds the new Folder to the Menu Folder list in
alphabetical order.:

Admin Portal Getting Started Guide


990-1040-001

The T7000 View

The AP Client generates an information message if you attempt to create a Folder


with a name that already exists:

Dismiss the information message by clicking the OK button, then enter a unique
name for the new Folder.

Admin Portal Getting Started Guide


990-1040-001

Other Views

183

The T7000 View

Deleting Menu Folders


Tip
You need an Administrator level
account to delete
menu folders.

You can delete any of the Menu Folders to the Provisioning Category.

CAUTION
Once you delete a Folder, there is no undelete function to restore it!
If you accidentally delete a Folder, you will have to re-create it, by adding a
Folder with the same name, and re-adding databases to it.
See Adding Menu Folders on page 178. and Adding and Removing
Screens on page 169 for more information.

The next screenshot shows the Tandem Data Folder selected:

184

Other Views

Admin Portal Getting Started Guide


990-1040-001

The T7000 View

To delete a Menu Folder, right-click on the Folder name:

A menu appears.

Admin Portal Getting Started Guide


990-1040-001

Other Views

185

The T7000 View

From the menu, click Delete Folder:

A confirmation message appears:


Click the OK button to confirm the Folder deletion, or the Cancel button to cancel
the delete operation:

186

Other Views

Admin Portal Getting Started Guide


990-1040-001

The T7100 View

The T7100 View


The T7100 view lists the clusters in your Network. The next screenshot shows a
typical T7100 view:

This AP Client is managing a network of several T7100 clusters.


Click a T7100 icon to switch to the Provisioning Category.
Use the T7100 view to add, delete and browse clusters in your network. See the
T7100 Getting Started Guide and the T7100 Performance Monitoring and
Maintenance Guide for details.

Admin Portal Getting Started Guide


990-1040-001

Other Views

187

The Taqua Mail View

The Taqua Mail View


The Taqua Mail view lists the TaquaMail Servers in your Network. The next
screenshot shows a typical Taqua Mail view:

See the T7000 Provisioning Guide for details.

188

Other Views

Admin Portal Getting Started Guide


990-1040-001

The User Portal View

The User Portal View


The User Portal view lists the UserPortal Servers in your Network. The next
screenshot shows a typical User Portal view:
This AP Client is managing one UserPortal server.

See the T7000 Admin Portal Provisioning Guide for details

Admin Portal Getting Started Guide


990-1040-001

Other Views

189

The User Portal View

190

Other Views

Admin Portal Getting Started Guide


990-1040-001

Widgets
In this chapter:

Introducing Widgets
Adding Widgets
Viewing and Changing Data with Widgets

Admin Portal Getting Started Guide


990-1040-001

Widgets

191

Introducing Widgets

Introducing Widgets
A widget is a small auxiliary program that can be called by the AP Client. Widgets
are used to extend the AP Client functionality.
The AP Client ships with an assortment of widgets, and Taqua plans to release
more widgets in the future.
See:

192

Widgets

Accessing T7000 Widgets on page 193


Accessing T7100 Widgets on page 196

Admin Portal Getting Started Guide


990-1040-001

Introducing Widgets

Accessing T7000 Widgets


To access T7000 widgets from the Home View, click the Equipment Type Selector
and select the T7000 Equipment Type or, click the T7000 icon in the Center pane:

The T7000 View appears.

Admin Portal Getting Started Guide


990-1040-001

Widgets

193

Introducing Widgets

From the T7000 View, double-click a switch:

The Provisioning Menu Category appears.


If necessary, expand the Provisioning Menu Category:

194

Widgets

Admin Portal Getting Started Guide


990-1040-001

Introducing Widgets

If necessary, expand the T7000 Home Menu Folder:

Cick the Dashboard Menu Link:

In the Center pane, the AP Client displays the name of the element that will be the
focus of a widget and the Add widget Selector.

Admin Portal Getting Started Guide


990-1040-001

Widgets

195

Introducing Widgets

Accessing T7100 Widgets


To access widgets from the Home View, click the Equipment Type Selector and
select T7100, or click the T7100 icon in the Center pane:

The T7100 View appears.

196

Widgets

Admin Portal Getting Started Guide


990-1040-001

Introducing Widgets

From the T7100 View, double-click a cluster:

The Provisioning Menu Category appears.

Admin Portal Getting Started Guide


990-1040-001

Widgets

197

Introducing Widgets

If necessary, expand the Provisioning Menu Category:

If necessary, expand the Home Menu Folder:

198

Widgets

Admin Portal Getting Started Guide


990-1040-001

Introducing Widgets

If necessary, and click the Dashboard Menu Link:

In the Center pane, the AP Client displays the name of the element that will be the
focus of a widget and the Add widget Selector.

Admin Portal Getting Started Guide


990-1040-001

Widgets

199

Adding Widgets

Adding Widgets
To add a widget to the Dashboard, first navigate to the Dashboard Menu Link. See
Accessing T7000 Widgets on page 193 or Accessing T7100 Widgets on page
196 for details.

Tip
These screenshots
show the T7000.
Although the
supported widgets
differ, steps to add
a Widget are the
same on the T7000
and the T7100.

200

Widgets

From the Dashboard Menu Link, click the Add widget Selector:

Admin Portal Getting Started Guide


990-1040-001

Adding Widgets

The Add widget Selector lists the widgets you can add on T7000:

Click the widget you want to add:

Admin Portal Getting Started Guide


990-1040-001

Widgets

201

Adding Widgets

The widget that you selected appears in the Center pane:

You can open multiple widgets in the Center pane.

202

Widgets

Admin Portal Getting Started Guide


990-1040-001

Adding Widgets

To make optimal use of the space in the Center pane, you can re-position and close
widgets by clicking Close
on the top right of the widget. The Notice widget is to
be closed in the following screenshot:

Admin Portal Getting Started Guide


990-1040-001

Widgets

203

Viewing and Changing Data with Widgets

Viewing and Changing Data with Widgets


See the following information to view or change element configuration data using
widgets:

204

Widgets

TCAP Cache Statistics


Database Profile
Notice
Shelf View
Date and Time

Admin Portal Getting Started Guide


990-1040-001

Viewing and Changing Data with Widgets

TCAP Cache Statistics


To access the Dashboard Menu Link, see Accessing T7000 Widgets on page
193.
The TCAP Cache Statistics widget shows settings and statistics related to the
Transaction Capabilities Part protocol for SS7 networks.
TCAP Cache Statistics information displayed includes counts of records, cache hits
and misses, and memory usage as they relate to TCAP data for Calling Name
(CNAME) and Local Number Portability (LNP).

Tip
These screenshots
show the T7000, but
the procedure is
exactly the same for
the T7100.

From the Dashboard Menu Link, you can display the TCAP Cache Statistics
widget by clicking the Add widget selector and choosing TCAP Cache Statistics:

The information displayed for TCAP Cache Statistics can be interpreted as follows:
Statistic

Description

Max records

Displays the maximum number of records set for


CNAME and LNP.

Time to live

Displays the Time to live (in days) set for CNAME and
LNP.

Record count

Displays the total number of records detected for


CNAME and LNP.

Cache hits

Displays cache usage data for CNAME and LNP.

Cache misses

Displays cache usage data for CNAME and LNP.

Memory usage

Displays memory usage data for CNAME and LNP.

Admin Portal Getting Started Guide


990-1040-001

Widgets

205

Viewing and Changing Data with Widgets

Database Profile
To access the Dashboard Menu Link, see Accessing T7000 Widgets on page
193.
The Database Profile widget lists data configuration table names and shows a
count of the records contained. You can use the record counts to estimate changes
in system resource usage and such as memory capacity and disk space.

Tip
These screenshots
show the T7000, but
the procedure is
exactly the same for
the T7100.

From the Dashboard Menu Link, click the Add widget selector and choose
Database Profile to display the widget:

You can reposition the Database Profile widget as required to view multiple widgets
in the Center pane. Use the scroll bar to view the full list of configuration table
names.

206

Widgets

Admin Portal Getting Started Guide


990-1040-001

Viewing and Changing Data with Widgets

Notice
To access the Dashboard Menu Link, see Accessing T7000 Widgets on page
193.
The Notice widget lists lets you specify a message for network administrators. Any
user of the AP Client will be able to view messages you type using the Notice
Widget.

Tip
These screenshots
show the T7000, but
the procedure is
exactly the same for
the T7100.

From the Dashboard Menu Link, click the Add widget Selector and choose
Notice when you need to provide information to the other network administrators
monitoring and maintaining equipment:

The Notice widget works like a notepad that displays reminders or other helpful
information to the users of the AP Client. Click the Notice widget on the yellow
display area to open the Enter new text dialog box.
Type the message for network administrators and click OK:

Admin Portal Getting Started Guide


990-1040-001

Widgets

207

Viewing and Changing Data with Widgets

The message you typed displays.

To close the Notice widget, click Close


. The message you type remains in the
Notice widget (even after you close the widget) until you clear it by typing spaces
or by typing a new message.

208

Widgets

Admin Portal Getting Started Guide


990-1040-001

Viewing and Changing Data with Widgets

Shelf View
To access the Dashboard Menu Link, see Accessing T7000 Widgets on page
193.
The Shelf widget lets you view a representation of the cards installed on a shelf.
You can check LEDs and make a card the Substitution Manager from the Shelf
View widget.

Tip
These screenshots
show the T7000, but
the procedure is
exactly the same for
the T7100.

From the Dashboard Menu Link, click the Add widget Selector and choose Shelf
View to see a representation of the cards on a shelf:

Admin Portal Getting Started Guide


990-1040-001

Widgets

209

Viewing and Changing Data with Widgets

Click a card to see the Facilities Tree for that card:

Right-click a card to see options for that card on a shortcut menu:


Option

210

Widgets

Description

Force DBMaster

Make the database on this card the master database.

Make Substitution Group


Manager

Make the card responsible managing substitution for the


group of cards.

Delete Substitution
Manager

Take the group substitution manager responsibility from


the card.

Swact to #

Switch the activity on this card to the card number


indicated in the option.

Add to Substitution Group

Add the selected card to the Substitution group.

Remove from Substitution


Group

Remove the selected card from the Substitution group.

Reset Revertive
Switchback

Set the Revertive Switchback property for the card to


the default setting.

Admin Portal Getting Started Guide


990-1040-001

Viewing and Changing Data with Widgets

Date and Time


To access the Dashboard Menu Link, see Accessing T7000 Widgets on page
193.
The Date and Time widget lists lets you view and set date and time information for
network equipment.

Tip
These screenshots
show the T7000, but
the procedure is
exactly the same for
the T7100.

From the Dashboard Menu Link, click the Add widget Selector and choose Date
and Time:

The Date and Time widget shows the Greenwich Mean Time as a reference along
with the current local time. Four buttons on the widget let you specify and update
types of date and time information.

NTP Settings
Press the NTP Settings button on the Date and Time widget to set Network Time
Protocol information:

Click the Enabled check box to enable the use of the Network Time Protocol.
Click the Log Level drop-down list and click a number to indicate how many levels
of logging to allow.

Admin Portal Getting Started Guide


990-1040-001

Widgets

211

Viewing and Changing Data with Widgets

Click the Add button for the NTP Servers field. The Enter Value dialog box
appears with the NTP Server text box active.

Use one of the indicated formats to type the IP address of the NTP server you want
to add and click OK.

DST Settings
Click the DST Settings button on the Date and Time widget to set Daylight Savings
Time information:

Click the Enabled check box to enable Daylight Saving Time Configuration.
Click the Type drop-down list and click Relative or Absolute as the Daylight
Saving Time type.
Click the Hemisphere drop-down list and indicate whether Daylight Saving Time
information specified is for the Northern or Southern hemisphere.
Use the Month, Week, Day, and Hour fields to set the day and hour information of
Daylight Saving Time for the first and second half of the year.

212

Widgets

Admin Portal Getting Started Guide


990-1040-001

Viewing and Changing Data with Widgets

Force NTP Update


Click the Force NTP Update button on the Date and Time widget to force the
Network Time Protocol settings to update. There is no information display for this
action.

Set Date/Time
Click the Set Date/Time button on the Date and Time widget to specify time and
date information:

Type the Date, Time, and TZ Offset in the formats indicated on the Set Date &
Time dialog, then click OK.

Admin Portal Getting Started Guide


990-1040-001

Widgets

213

Viewing and Changing Data with Widgets

214

Widgets

Admin Portal Getting Started Guide


990-1040-001

UserManager
See:

Overview on page 216


Navigating to the UserManager Screen on page 218
Users on page 219
Groups on page 226
Permissions on page 230

Admin Portal Getting Started Guide


990-1040-001

UserManager

215

Overview

Overview
Tip
The Admin Portal
Getting Started
Guide explains the
Admin Portal interface in detail.

Use the User Manager to configure users, groups, and permissions.


A User contains the account information needed to gain access to the Admin
Portal. See Users on page 219.
A User belongs to a Group. A Group defines the permission level of every User
in the Group. A permission level is one of: Read/Write; Read-Only; or No-Access.
The Admin Portal automatically creates a set of permission for each group. The set
consists of one permission for each Element Type, Element ID, and Screen that
the Admin Portal manages
Element Types are the top level category of data managed by the Admin Portal and
correspond to one of the following:

the Equipment Type icons displayed on the Home Page, such as T7000,
T7100, Billing, or IseHouse

the Admin Portal menu folders in the Left Pane displayed in the Home
Page, such as AP Configuration> User Manager > Groups, or
Maintenance > Cleanup > SQL Cleanup

Element IDs are the mid-level category of data managed by the Admin Portal.
Each Element ID is an instance of the Element Type, for example,

localhost for the Billing Element Type


a specific shelf name for T7000 Element Type.
a cluster name for the T7100 Element Type

Screens are the bottom level category of data managed by the Admin Portal. A
screen corresponds to a Menu Link, for example,

216

UserManager

Billing > Office Settings > Network


T7000 > Provisioning > Central Office > OfficeParms
T7100 > Provisioning > SIP > SipTrunkGroup

Admin Portal Getting Started Guide


990-1040-001

Overview

Tip
The default password on the admin
account is admin.

The Admin Portal ships with one User account defined: the admin User.
The Admin Portal ships with two groups defined:

the Administrator Group. Members of this group have the Read/Write


permission for every screen in the system. The admin user is a member
of this group.

the User Group. Members of this group have the Read-Only permission
to every screen in the system. This group is initially empty.

Users on page 219

See:

Groups on page 226


Permissions on page 230

Admin Portal Getting Started Guide


990-1040-001

UserManager

217

Navigating to the UserManager Screen

Navigating to the UserManager Screen


After logging in to the Admin Portal, from any view, click the Equipment Type
selector, and choose the Home View:

The AP Configuration menu category appears. Click the UserManager Menu


Folder.

218

UserManager

Admin Portal Getting Started Guide


990-1040-001

Users

Users
See:

Adding a User on page 220


Editing a User on page 223
Deleting a User on page 225

Admin Portal Getting Started Guide


990-1040-001

UserManager

219

Users

Adding a User
Tip
Only members of
the Administrator
Group can add
users.

To navigate to this screen:

See Navigating to the UserManager Screen on page 218


If necessary, expand the User Manager menu folder
If necessary, click the Users menu link

Tip
Clicking anywhere
in the Center pane
will make the menu
appear.

220

UserManager

In the Center pane of the Users Menu Category, right-click. A menu appears.
From the menu, click Add:

Admin Portal Getting Started Guide


990-1040-001

Users

The Admin Portal displays the new Users attributes in the Right pane:

The following fields are mandatory:


Attribute
userName

Description
Unique name of the new User.
Length: 1 16 characters

password

Case sensitive password of the new User.

Tip
When an Administrator sets the password, the Admin
Portal does not place any restrictions on the types of
characters in the password. However, when a User
sets the password, the Admin Portal checks for the
presence of certain types of characters. For more
information, see changePassword on page 222.

Length: 8 16 characters.
group

Admin Portal Getting Started Guide


990-1040-001

Click the value field and choose a Group from the


menu.

UserManager

221

Users

Attribute
enabled

Description (Continued)
Click the value field and choose:
YES (default) the account can be used
NO the account cannot be used

changePassword

Click the value field and choose:


YES (default) the User will be prompted to change
the password the first time the User logs on. The
Users password must contain a mix of upper and
lower case letters, and one or more special
characters. After the User changes the password, the
Admin Portal sets this attribute to NO and only a User
who is a member of the Administrator group can
change the password.
NO the account cannot be used

changePassword

Click the value field and choose:


Yes the User change the account password
No the User cannot change the account password

When you are finished, click the green Create Object check box (outlined in red)
to add the User, or the red Cancel Create check box (outlined in red) to cancel
the entire operation.

222

UserManager

Admin Portal Getting Started Guide


990-1040-001

Users

Editing a User
Tip
Only members of
the Administrator
Group can edit
users.

To navigate to this screen:

See Navigating to the UserManager Screen on page 218


If necessary, expand the User Manager menu folder
If necessary, click the Users menu link

In the Center pane of the Users Menu Category, click a User. The Admin Portal
displays the selected record in blue, and the Users attributes in the Right pane:

Values displayed in gray are read-only, and cannot be provisioned.


Values displayed in blue are read-write, and can be provisioned.
For attribute definitions, see Adding a User on page 220.

Admin Portal Getting Started Guide


990-1040-001

UserManager

223

Users

When you are finished, click the green Commit All Changes check box
(outlinedin red) to update the User, or the red Cancel All Changes check box
(outlined in red) to cancel the entire operation:

224

UserManager

Admin Portal Getting Started Guide


990-1040-001

Users

Deleting a User
Tip
Only members of
the Administrator
Group can delete
users.

To navigate to this screen:

See Navigating to the UserManager Screen on page 218


If necessary, expand the User Manager menu folder
If necessary, click the Users menu link

In the Center pane, right-click a User. A menu appears.


From the menu, click Delete:

In the Confirm dialog, click OK:

Admin Portal Getting Started Guide


990-1040-001

UserManager

225

Groups

Groups
See:

Adding a Group on page 226


Deleting a Group on page 229

Adding a Group
To navigate to this screen:

See Navigating to the UserManager Screen on page 218


If necessary, expand the User Manager Menu Folder
If necessary, click the Groups Menu Link

Tip
Clicking anywhere
in the Center pane
will make the menu
appear.

226

UserManager

In the Center pane of the Groups Menu Category, right-click. A menu appears.
From the menu, click Add:

Admin Portal Getting Started Guide


990-1040-001

Groups

The Admin Portal displays the new Groups attributes in the Right pane:

The following fields are mandatory:


Attribute
name

Description
Unique name of the new Group.
Length: 1 32 characters

Admin Portal Getting Started Guide


990-1040-001

UserManager

227

Groups

When you are finished, click the green Create Object check box (outlined in red)
to add the Group, or the red Cancel Create check box (outlined in red) to cancel
the entire operation:

228

UserManager

Admin Portal Getting Started Guide


990-1040-001

Groups

Deleting a Group
To navigate to this screen:

See Navigating to the UserManager Screen on page 218


If necessary, expand the User Manager Menu Folder
If necessary, click the Groups Menu Link

In the Center pane, right-click a Group. A menu appears.


From the menu, click Delete:

In the Confirm dialog, click OK:

Admin Portal Getting Started Guide


990-1040-001

UserManager

229

Permissions

Permissions
Permissions control access to elementTypes. The Admin Portal automatically
creates a permission for each elementType, elementID and group in your
network.
NOTE: when you add a group, the Admin Portal creates permissions for each
elementType and elementID with an access level of Read-Only. See Adding a
Group on page 226 and access on page 232.

Only members of the Administrator group are allowed to create, modify, or delete
any of the items in the UserManager folder. This is true even if you assign readwrite access to these items to non-members of the Administrator group.
See

230

UserManager

Editing a Permission on page 231

Admin Portal Getting Started Guide


990-1040-001

Permissions

Editing a Permission
To navigate to this screen:

See Navigating to the UserManager Screen on page 218


If necessary, expand the User Manager Menu Folder
If necessary, click the Permissions Menu Link

Tip
Permissions are
stored by Key,
which is not descriptive. To quickly find
a Permission, add
the screen column
to the Center pane,
then filter on the
name of the screen
you wish to edit.

In the Center pane, click a Key. The Admin Portal displays the selected record in
blue, and the Keys attributes in the Right pane:

Consult the AP Getting Started Guide


for details on adding
a column and using
a filter.

Admin Portal Getting Started Guide


990-1040-001

UserManager

231

Permissions

Values displayed in gray are read-only, and cannot be provisioned.


Values displayed in blue are read-write, and can be provisioned.
Attribute

Description

key

The permission database key.

elementType

The type of element for this permission. For example,


the T7000 and the T7100 are different element types.

elementID

The name of the element for this elementType. The


Admin Portal automatically creates and deletes entries
in the Permissions table for each screen when you add
and delete an elementType (for example, a T7000
switch or a T7100 cluster).

screen

The name of the Menu Link where the elementType is


found.

group

The name of the Group for this Permission. The Admin


Portal automatically creates and deletes entries in the
Permissions table for each screen when you add and
delete a group. See Adding a Group on page 226 for
details.

access

The type of access for this group. Choices are:


Read/Write members of the group can read and
write elementType
Read-Only members of the group can read the
elementType, but cannot change it.
No-Access members of the group cannot read or
change the elementType.

When you are finished, click the green Commit All Changes check box (outlinedin
red) to add the modify the Permission, or the red Cancel All Changes check box
(outlined in red) to cancel the entire operation:

232

UserManager

Admin Portal Getting Started Guide


990-1040-001

Appendix A: Factory Defaults


In this chapter:

Provisioning T7000 Category Menu Folders

Admin Portal Getting Started Guide


990-1040-001

Appendix A: Factory Defaults

233

Provisioning T7000 Category Menu Folders

Provisioning T7000 Category Menu Folders


Tip
For provisioning
convenience, a
Menu Link may
appear under
multiple Menu
Folders

The AP Client ships with the T7000 Provisioning Category configured with the
following Menu Folders and Menu Links:
Provisioning
T7000 Home
Dashboard
Shelf
CardConfiguration
Facility Tree
AIN
AccountCodeProfile
AcctCodePatternProfile
CalledNumberProfile
CalltypeProfile
EscapeCodePatternProfile
N11PatternProfile
N11Profile
OffHookDelayProfile
OffHookImmediateProfile
OutPulseProfile
PFCPatternProfile
PublicFeatureCodeProfile
SDSPatternProfile
ServiceProfile
SpecificDigitStrProfile
TermAttemptProfile
Alarm Definitions
AlarmDef
APEventRegistration
CALEA
CALEADeliveryFunction
CALEAParms
LEACase
LEAProfile
Central Office
Carrier
OfficeParms
Prefix
RateCenter
ScreenList

234

Appendix A: Factory Defaults

Admin Portal Getting Started Guide


990-1040-001

Provisioning T7000 Category Menu Folders

CMTS Endpoint
PacketCableCmts
PCMMCmts
Facilities
CardProperties
DS3Properties
FEIProperties
LineProperties
SpanProperties
TrunkProperties
FTRS
FTRSPretransProfile
FTRSProfile
InboundActionProfile
OutboundActionProfile
GR303
GR303Rdt
InterfaceGroup
H248
ACLProfile
BearerGroup
CodecProfile
CodecProfileList
H248Announcments
H248Controller
H248Gateway
H248GatewayProfile
H248Termination
H248TerminationProfile
H248TrunkGroup
MediaParam
MCGP
ACLProfile
BearerGroup
CodecProfile
CodecProfileList
DigitMap
MediaParam
MGCPGateway
MGCPGatewayProfile
MGCPTrunkGroup
MGTermination
MGTerminationProfile

Admin Portal Getting Started Guide


990-1040-001

Appendix A: Factory Defaults

235

Provisioning T7000 Category Menu Folders

Routing
CarrierRouteList
HuntGroup
LNPRouteList
NANPRouteList
RoutingGroup
TandemAniRouteList
TandemCarrierRouteList
TandemTGRoutelist
SIP
ACLProfile
BearerGroup
CodecProfile
CodecProfileList
DRSNNamespace
DSNNamespace
HostIPAddrPair
IPTrunkGroup
MediaParam
Q735Namespace
SipAgwEndpoint
SipAgwEndpointProfile
SipEsgwEndpoint
SipEsgwEndpointProfile
SipNamespace
SipNamespaceList
SipNgwEndpoint
SipNgwEndpointProfile
SipProxy
SS7
SCCPNode
SS7Link
SS7LinkSet
SS7Network
SS7Node
SS7Route
SS7TrunkGroup
TCAPService
Subscribers
AniSubscriber
IPTVProfile
ServiceScreenList
SdInfo
Subscriber
Substitution
SubstitutionGroup

236

Appendix A: Factory Defaults

Admin Portal Getting Started Guide


990-1040-001

Provisioning T7000 Category Menu Folders

Trunk Groups
CASTrunkGroup
CLRTrunkGroup
H248TrunkGroup
HuntGroup
IPTrunkGroup
MGCPTrunkGroup
NailedUpCircuit
PRITrunkGroup
SS7TrunkGroup
Voicemail
sipVMS
SMDIParms
TcapMwiParms
ALL
AccountCodeProfile
AcctCodePatternProfile
ACLProfile
AlarmDef
AniSubscriber
Announcment
APEventRegistration
BearerGroup
CALEADeliveryFunction
CALEAParms
CalledNumberProfile
CalltypeProfile
CardConfiguration
CardProperties
Carrier
CarrierRouteList
CASTrunkGroup
CFBInfo
CFDInfo
CFFInfo
CFVInfo
CLRTrunkGroup
CMTSEndpoint
CodecProfile
CodecProfileList
DatabaseVersion
DigitMap
DRSNNamespace
DS3Properties
DSNNamespace
E1SpanProperties
EscapeCodePatternProfile
FEIProperties
Firmware

Admin Portal Getting Started Guide


990-1040-001

Appendix A: Factory Defaults

237

Provisioning T7000 Category Menu Folders

FTRSPretransProfile
FTRSProfile
GR303Rdt
H248Announcments
H248Controller
H248Gateway
H248GatewayProfile
H248Termination
H248TerminationProfile
H248TrunkGroup
HostIPAddrPair
HuntGroup
InboundActionProfile
InterfaceGroup
IPTrunkGroup
IPTVProfile
Isu
LEACase
LEAProfile
LineProperties
LNPRouteList
MediaParam
MGCPGateway
MGCPGatewayProfile
MGCPTrunkGroup
MGTermination
MGTerminationProfile
N11PatternProfile
N11Profile
NailedUpCircuit
NANPRouteList
OffHookDelayProfile
OffHookImmediateProfile
OfficeParms
OutboundActionProfile
OutpulseProfile
PacketCableCmts
PCMMCmts
PFCPatternProfile
Prefix
PRITrunkGroup
PublicFeatureCodeProfile
Q735Namespace
RateCenter
RcfInfo
RouteList
RoutingGroup
SCCPNode
Schedule
SCFInfo
238

Appendix A: Factory Defaults

Admin Portal Getting Started Guide


990-1040-001

Provisioning T7000 Category Menu Folders

ScreenList
Schedule
ScreenList
SdInfo
SDSPatternProfile
ServiceProfile
ServiceScreenList
Shelf
SipAgwEndpoint
SipAgwEndpointProfile
SipEsgwEndpoint
SipEsgwEndpointProfile
SipNamespace
SipNamespaceList
SipNgwEndpoint
SipNgwEndpointProfile
SipProxy
sipVMS
SMDIParms
SpanProperties
SpecificDigitStrProfile
SS7Link
SS7LinkSet
SS7Network
SS7Node
SS7Route
SS7TrunkGroup
Subscriber
SubstitutionGroup
TandemAniRouteList
TandemCarrierRouteList
TandemTGRoutelist
TcapMwiParms
TCAPService
TermAttemptProfile
TrunkGroup
TrunkProperties

Resetting the Menu Folders


You can reset the Menu Folders by following the Adding and Removing Screens
procedure on page 169. If you are comfortable using the Linux command line, you
can also reset the Menu Folders as follows:
Open a terminal session on the Admin Portal and enter the following commands:
cd /var/www/AdministrationPortal/T7000
php classicMenu.php <shelfname>

Admin Portal Getting Started Guide


990-1040-001

Appendix A: Factory Defaults

239

Provisioning T7000 Category Menu Folders

where <shelfname> is the name of the shelf you want to reset.

240

Appendix A: Factory Defaults

Admin Portal Getting Started Guide


990-1040-001

Index

A
Accessing widgets 193, 196
Adding menu folders 178
Adding records 135
Adding widgets 200
Apple Safari 3

B
Billing view 166
Buttons
First Page 38
Last Page 37
Next Page 37
Previous Page 38

Deleting records 156


Displaying multiple records 122
Displaying records 113

E
Element Type Selector 163
Equipment Selector 164, 165
Equipment Type Selector 162

F
fileCleanup task 105
Filter box 71, 74, 75, 81
Firefox 3
First Page button 38

Cancel All Changes check box 117


Cancel check box 116, 140, 150
Cancel Clone check box 151
Cancel Create check box 141
Center pane 8, 20, 59
Choose Columns dialog box 43, 44
Chrome 3, 66
Clone Object check box 151, 153
Cloning records 144
Columns
adding 42
moving 62
removing 42
resizing 61
Commit All Changes check box 117, 128
Commit check box 116
Create Object check box 141, 142

Google Chrome 3, 66

D
Deleting menu folders 184

Admin Portal Getting Started Guide


990-1040-001

H
Home View 8
Center pane 8
Menu pane 8

I
IE (Internet Explorer) 3, 64
Internet Explorer 3, 64
IseHouse view 167

L
Last Page button 37
Logging In 3
Logging Out 5
Logout link 5

Index

241

Menu Categories 12
Menu Folders 14
Menu Links 16
Menu pane 8
Menu Categories 12
Menu Folders 14
Menu Links 16
Microsoft IE 3, 64
Modifying multiple records 122
Modifying records 113
Mozilla Firefox 3

Safari 3
ScreenTips
Number 114, 138
Text 137, 148
Sorting records 40
splitter control 59, 107, 125
Supported browsers
Apple Safari 3
Google Chrome 3
Microsoft IE 3
Mozilla Firefox 3
Opera 3

N
Next Page button 37

O
Opera 3

T
T7000 view 168, 187
adding menu folders 178
configuring screens 171
deleting menu folders 184
renaming menu folders 174
Taqua Mail view 188

Presets
adding 63
choosing 67
deleting 69
Previous Page button 38

Web Browsers 3
troubleshooting problems 3
widgets 192
accessing 193, 196
adding 200
Database Profile 206
Date and Time 211
Notice 207, 209
TCAP Cache Statistics 205

recommended 3
Recommended Browsers
Chrome 3
Firefox 3
record number box 39
Records
adding 135
cloning 144
deleting 156
displaying 113
multiple 122
modifying 113
multiple 122
Regular Expressions 77
Removing records 156
Renaming menu folders 174
Right pane 8, 59, 107

242

Index

User Portal view 189

Admin Portal Getting Started Guide


990-1040-001

You might also like