Vous êtes sur la page 1sur 46

[ ]

TEMS™ DISCOVERY ENTERPRISE


TRAINING SESSION, PART 1
12-Jun-2014

TEMS Discovery Enterprise 10.0, 2014 © Ascom 1


[ ]

Agenda

 TDE 10.0.4 New Features


 Report Template Builder
 Script Builder

TEMS Discovery Enterprise 10.0, 2014 © Ascom 2


[ TDE 10.0.4 NEW FEATURES ]

TDE 10.0.4 New Features

 Data import as a service


 Support for Tems Route Reader 10.1
 TD Management Console
 Automatic M2M and M2F matching
 Flexible network configuration selection
 PCap decoding for Samsung Jade device

TEMS Discovery Enterprise 10.0, 2014 © Ascom 3


[ REPORT TEMPLATE BUILDER ]

Report Template Builder


 Exceptionally powerfull and flexible
 All TD events and metrics supported
 Full array of statistical attributes
 User-defined metrics supported
 Drag and drop into any desired cell
 Support for MS Excel functions
 Comprehensive data filtering options
 Problem sets
 Repetition in report
 Integrated maps
 MS Excel, Word and Power Point
output format

TEMS Discovery Enterprise 10.0, 2014 © Ascom 4


[ REPORT TEMPLATE BUILDER ]

Basics
 Report template based on MS Office Excel format
 Measurement or statistic data used as a data
source for reports
 Data objects dragged-and-dropped to the Report
Editor from the Metric List window
 Any TEMS Discovery supported or user-defined
events and metrics can be added to the report
template
 Final report template formatting done in Excel
 MS Office Word and Power Point report templates
can be paired with an existing Excel template

TEMS Discovery Enterprise 10.0, 2014 © Ascom 5


[ REPORT TEMPLATE BUILDER ]

Add Report Element

Additional filtering options Once an information


element is dropped
into the Report
Select the report type and Editor, the Report
Select measurement descriptives; Optionally apply Self Type window will
or statistic data as the restriction or apply Geo-binning pop up
source of the report

Self restriction applies a threshold


or a range to filter data points; Up
to two logical expressions can be
applied to the selected metric.

Drag-and-drop any IE
from the Metric List tab
into the Report Editor

TEMS Discovery Enterprise 10.0, 2014 © Ascom 6


[ REPORT TEMPLATE BUILDER ]

Report Types

 Chart (single and multi series chart over metric plot band)
 Correlation Chart (correlation chart between 2 or more metrics)
 Correlation Key (chart with correlated metric used for X-axis)
 Map View (Metric plot on the GIS source or online map)
 Multi-dimension Statistic View (selected statistic over multiple
attribute dimensions)
 Name (metric name)
 Single Value (selected statistic over entire set of data)
 SetGlobal (global value that can be retrieved by GetGlobal flag)
 Statistic Data (selected statistic over metric plot band)
 Tabular (list all distinct metric values)
 Trend Chart (hourly, daily, weekly and monthly resolution supported)

TEMS Discovery Enterprise 10.0, 2014 © Ascom 7


[ REPORT TEMPLATE BUILDER ]

Additional Options
Data filtering based
on one or more
device attributes Optionally, generate
the delta between the
data of two different
Select one or more condition filters attribute sets
based on condition expression
defined under Script Builder;
Condition filters can be applied at
the time of report generation too.

Enable UDR filtering and optionally


use UDR index and attribute based
filtering

TEMS Discovery Enterprise 10.0, 2014 © Ascom 8


[ REPORT TEMPLATE BUILDER ]

Context Menu
Report Template
Builder right-click
context menu

Remove the Chart definition and clean up the chart area


Remove the Map View definition and clean up the chart area
Remove the Correlation Chart definition and clean up the chart area
Define repetition options
Define Repetition Flag
Define GetGlobal flag
Define a chart skeleton
TEMS Discovery version tag
Tag for reporting the date report is generated
Tag for reporting the report options
Tag for reporting the project and dataset names
Data collection date and time tags
Tag to report the name of the cluster (based on cluster index)
File details tags

TEMS Discovery Enterprise 10.0, 2014 © Ascom 9


[ REPORT TEMPLATE BUILDER ]

Save Report

Save report
template once
it is finalized

Multiple tabs can


be added to the
report template

TEMS Discovery Enterprise 10.0, 2014 © Ascom 10


[ REPORT TEMPLATE BUILDER ]

Generate Report (Measurement Data)

Optionally filter
measurement data
by date/time, sector
group, condition
expression or UDR

Select the
report template

Select ‘Generate Report’


option from right click context
menu on the dataset, device
or file in Data Explorer

TEMS Discovery Enterprise 10.0, 2014 © Ascom 11


[ REPORT TEMPLATE BUILDER ]

Chart Report
 By default, the X-values of the chart will be
the plot band of the metric (default plot band
will be used unless ‘Define plot bands’
option is selected)
 In case CorrelationKey is defined, the X
values will be the plot bands of the
correlated metric
 The Descriptive determines the operation
applied to the metric in each of plot bands
(e.g. Count, % of Total, Mean, etc.)
 ‘% Meeting Cond’ descriptive requires self
restriction condition(s) to be set
 Geo-binned data can be used as an option
 Optionally apply condition filters, device
attributes or UDR filtering on the ‘Additional
Options’ tab

TEMS Discovery Enterprise 10.0, 2014 © Ascom 12


[ REPORT TEMPLATE BUILDER ]

Chart Report
 Define the chart size by left-clicking at the
bottom-right corner of the desired chart area
once report type, descriptive and additional
conditions are selected
 Excluding ‘Definition’ row, all remaining chart
definitions can be manually updated (e.g.
chart, series or axis titles, chart type, etc.)
 ‘Display’ options include Value, PDF and CDF
 ‘Chart Type’ can select any chart type
available in MS Office Excel
 ‘Plot By’ options include Column and Row
 ‘# of Bands’ limits the number of bands to be
included on the chart
 ‘Sort Order’ defines the order for sorting the
Y-axis values and it can be set to Ascending,
Descending or None

TEMS Discovery Enterprise 10.0, 2014 © Ascom 13


[ REPORT TEMPLATE BUILDER ]

Chart Report
 Multiple series can be added to the chart
by dragging-and-dropping another IE into
the column immediately after the previous
series
 The chart type for different series can be set
to different types however mixed type chart
can only be defined for 2D chart types

TEMS Discovery Enterprise 10.0, 2014 © Ascom 14


[ REPORT TEMPLATE BUILDER ]

Chart Report
 In case when correlated metric is defined, a
chart will have one IE’s descriptive
calculated over another IE’s plot band
 Correlated metric is defined after original
chart area is created by dragging-and-
dropping another IE into the correlation cell
with CorrelationKey selected as a report
type

TEMS Discovery Enterprise 10.0, 2014 © Ascom 15


[ REPORT TEMPLATE BUILDER ]

Trend Chart Report


 Same process followed as in case of the
standard chart report except that periodicity
need to be selected
 Hourly, daily, weekly, and monthly resolution
supported

TEMS Discovery Enterprise 10.0, 2014 © Ascom 16


[ REPORT TEMPLATE BUILDER ]

Correlation Chart Report


 Correlation chart is generated for a minimum
of two metrics
 Uses ‘Correlation Chart’ report type
 One or more of the correlation view options
need to be included:
 Draw fitting curve with 1~4 fitting degree
 Draw scatter points
 Draw aggregation curve
 The second and subsequent metrics needs to
be dragged-and-dropped into the gray chart
space created for the first metric using the
same ‘Correlation Chart’ report type
 With default aggregation curve selection TD
will find ranges from all available data points
and automatically assign aggregation steps
 ‘Customize’ option is recommended for
predictable X-axis steps
TEMS Discovery Enterprise 10.0, 2014 © Ascom 17
[ REPORT TEMPLATE BUILDER ]

Map View Report


 Map view may include one or multiple metrics
 Customize map view by selections made in
‘Option #1’ and ‘Option #2’ tabs including:
 Cell site inclusion, specify icon size and position
with respect to the dataset route
 GIS map source inclusion and type (both user
GIS data and online maps supported)
 GIS map grayscale option
 Legend inclusion, specify legend title and its
placement with respect to the map
 Metric offset options
 Print area selection
 Data label inclusion and size
 Data point icon size
 Map resolution multiplier

TEMS Discovery Enterprise 10.0, 2014 © Ascom 18


[ REPORT TEMPLATE BUILDER ]

Statistic Data Report


 Statistic data calculated for the selected
metric plot band ranges
 The metric cannot be dropped into the left
most column of the report editor
spreadsheet as one column space is
required for the range column
 The descriptives include ‘% Meeting Cond’,
‘% of Total’, Count, Duration, First, ‘Linear
Average’, Max, Mean, Min, Sum and
‘Unique Count’
 ‘% Meeting Cond’ descriptive requires self
restriction condition(s) to be set

TEMS Discovery Enterprise 10.0, 2014 © Ascom 19


[ REPORT TEMPLATE BUILDER ]

Statistic Data Report


 Drag-and-drop another metric with
CorrelationKey as a report type for
correlation report between two metrics
 CorrelationKey metric should be dropped to
the cell between the range placement
reference and sorting reference cells (B5,
C5, etc. in the given example)

TEMS Discovery Enterprise 10.0, 2014 © Ascom 20


[ REPORT TEMPLATE BUILDER ]

Multi-dimension Statistic Report


 Multi-dimension statistic report calculates
measurements statistics for all available
combinations of dimensions
 The report can include multiple dimensions
and measurements
 Any TD pre-defined or user-defined metric
can be added to the list of dimensions in
addition to device attributes and date/time
dimensions
 Any TD supported or user-defined metric
can be added to the list of measurements
 Each of the measurements can be included
with multiple descriptives (e.g. Average,
Count, Max, Min, Sum, Stdev, etc.)

TEMS Discovery Enterprise 10.0, 2014 © Ascom 21


[ REPORT TEMPLATE BUILDER ]

Tabular Report
 Tabular report lists all distinct values for the
selected metric
 Timestamp and location can be included in
the report in which case extra column space
left of the metric column should be reserved
(1 extra column for timestamp and 2 for
location)

TEMS Discovery Enterprise 10.0, 2014 © Ascom 22


[ REPORT TEMPLATE BUILDER ]

Name and Single Value Report


 Name report provides the name of the
selected metric
 Single Value report provides singular
statistical output calculated for all data
samples the selected descriptive
 The descriptives include %-ile, ‘% Meeting
Cond’, Count, Duration, First, ‘Linear
Average’, Max, Mean, Min, ‘Standard
Deviation’, Sum, ‘Unique Count’ and
Variance
 %-ile descriptive requires percentile value
to be set
 ‘% Meeting Cond’ descriptive requires self
restriction condition(s) to be set

TEMS Discovery Enterprise 10.0, 2014 © Ascom 23


[ REPORT TEMPLATE BUILDER ]

Repetition in Report Standard Map View


report template element

 Repetition in Report feature is used to generate


a report with repetitive information (e.g., for
each cell id, device attribute, cluster UDR, etc.)
 Step 1 – Define reporting block using standard
available report types and descriptives (e.g.
map view, chart, single value, etc.)
 Step 2 – Define ‘Repetition in Report’ option
(accessed from the right click context menu on
the spreadsheet) in the first cell immediately
below of left of the selected reporting block
including the following:
 Name ‘Repetition Flag’
 Select ‘Repetition Key’
 Define repetition block size and direction
 Add UDR filtering (optional)
 Step 3 – Add ‘Repetition Flag’ placeholder
(accessed from the right click context menu on
the spreadsheet) to be replaced by the value of Step 2: Define ‘Repetition
in Report’ option
‘Repetition Key’ during report generation

TEMS Discovery Enterprise 10.0, 2014 © Ascom 24


[ REPORT TEMPLATE BUILDER ]
‘Repetition Flag’ replaced
by actual ‘Repetition Key’
Repetition in Report EARFCN_Cell_Identity
value

‘Repetition Flag’ PCI added to the


row above the map and it is part of
the repetition block

Standard Map View report template Map generated for


element using [!Mid].[&LTE Cell Scan - All each distinct LTE
EARFCNs].[EARFCN_Cell_Identity].[Spec scanner EARFCN
ific: EARFCN_Cell_Identity].[<real value>] – PCI combo
metric

LTE scanner EARFCN_Cell_Identity


defined as a ‘Repetition Key’ PCI,
repetition block includes 20 rows above

TEMS Discovery Enterprise 10.0, 2014 © Ascom 25


[ REPORT TEMPLATE BUILDER ]

MS Word and Power Point Templates


 MS Word and Power Point report templates
are based on Excel 2007 (.xlsx) template
defined with the same name except for the
file extension
 Charts, maps and tabular report types are
supported
 Word or Power Point template can have
static content that is not updated during
report generation
 Individual reports are referenced by a
placeholder included in Word or Power
Point template file
 To include Chart and Trend Chart report in
Word or Power Point add a line with the text
{chart:<Chart Title>}, where <Chart Title> is
a unique chart title copied from the .xlsx
template
TEMS Discovery Enterprise 10.0, 2014 © Ascom 26
[ REPORT TEMPLATE BUILDER ]

MS Word and Power Point Templates


 To include Map View and Correlation Chart report in Word or Power Point define Unique ID
under ‘Report Type’ and add a line with the text {Image:<Unique ID>.jpg}

TEMS Discovery Enterprise 10.0, 2014 © Ascom 27


[ REPORT TEMPLATE BUILDER ]

MS Word and Power Point Templates


 To include any of tabular reports (Statistic Data, Tabular or Single Value) in Word or Power Point
denote the rows above and below the table in Excel template with [Table:Start-<table name>]
and [TableEnd-<table name>] respectively, and add a line with the text {Table:<table name>} to
Word or Power Point template

TEMS Discovery Enterprise 10.0, 2014 © Ascom 28


[ REPORT TEMPLATE BUILDER ]

Problem Sets

Drag-and-drop a metric into the


Report Editor using ‘Name’ report
type (column A) and then using
‘Single Value’ report type with
‘Count’ descriptive (column B) to
add it to the problem set

TEMS Discovery Enterprise 10.0, 2014 © Ascom 29


[ REPORT TEMPLATE BUILDER ]

Problem Sets

Save the report template


as ‘Problem Set’ in a
chosen technology folder

TEMS Discovery Enterprise 10.0, 2014 © Ascom 30


[ SCRIPT BUILDER ]

Script Builder
 Advanced function to extract data from
messages and apply customized
algorithms to generate new metrics
and events
 Generate new metrics, events or
filtering criteria accessible from all
system tools and reports
 Simple drag-n-drop access to
 All metrics
 All IEs in layer 3 messages
 Scripts written in C# language

TEMS Discovery Enterprise 10.0, 2014 © Ascom 31


[ SCRIPT BUILDER ]

Script Types
 Advanced Metric & Event – define multiple new metrics and
events (e.g. define call setup time as a new metric, call setup
time over a threshold as a new event and signal strength at the
time of the event as an associated event information)
 Condition Expression – define criteria for filtering of
measurement data to be included in data views, statistics and
reports (e.g. display or report only coverage below a certain
signal strength)
 Custom Metric – define a single metric (e.g. define WCDMA
coverage class based on Ec/Io and RSCP measurements)
 Global Parameter – extract a specific metric per file/device
(e.g. N300 and T300 parameter in WCDMA)

TEMS Discovery Enterprise 10.0, 2014 © Ascom 32


[ SCRIPT BUILDER ]

User Interface Create new script Check script syntax


Save script Import/export scripts
Save as script Icon management
Rename script Search spreadsheet
Delete script Help

Select script
type and actual Alias – Declare data objects used in the script
script from the Static – Declare static variables
drop down list Metrics – Script output metrics
Events – Script output events
Report Variables – Additional variables
reported at around the time of the event
Technologies Related – Determine script
visibility under a particular technology

Drag-and-drop data
object from the Metric
List, RRC IEs, Threshold,
Built-in or Category tab
into the Source Data C# script editor;
column of the Alias tab to ‘Private Functions’ editor is
declare it and define alias used to create internal
used as variable in the procedures that can be only
script used internally by the script

TEMS Discovery Enterprise 10.0, 2014 © Ascom 33


[ SCRIPT BUILDER ]

Advanced Metric & Event Script

Step 1: Drag-and-drop data


objects into the Source Data
column of the Alias tab,
define Alias and Data Type

TEMS Discovery Enterprise 10.0, 2014 © Ascom 34


[ SCRIPT BUILDER ]

Advanced Metric & Event Script

Step 2: Define output


metrics, metric category,
data type and plot band

TEMS Discovery Enterprise 10.0, 2014 © Ascom 35


[ SCRIPT BUILDER ]

Advanced Metric & Event Script

Step 3: Define output events, event


category, event description, event sorting
priority, associated analysis set, event color
(relevant for time-series chart view), event
icon and event attributes (included in the
tooltip when viewing the event in the map)

TEMS Discovery Enterprise 10.0, 2014 © Ascom 36


[ SCRIPT BUILDER ]

Advanced Metric & Event Script

Step 4: Define report


variables and reporting
search window

TEMS Discovery Enterprise 10.0, 2014 © Ascom 37


[ SCRIPT BUILDER ]

Advanced Metric & Event Script

Step 5: Write the script code in


C#, define all output metrics and
events, use EVENT_TYPE flag to
add a new event to the collection,
validate syntax and save the script

TEMS Discovery Enterprise 10.0, 2014 © Ascom 38


[ SCRIPT BUILDER ]

Advanced Metric & Event Script


Tooltip includes
Event Description
and Event Attributes

Step 6: Run the script by


dragging-and-dropping new
metrics and events into the TD Message detail
views (map, table, message, includes Report
time-series chart, etc.) Variables and
Metrics

Plot events
on the map

Summary of Events,
Metrics and Report
Variables

TEMS Discovery Enterprise 10.0, 2014 © Ascom 39


[ SCRIPT BUILDER ]

Condition Expression Script

Step 1: Drag-and-drop data


objects into the Source Data
column of the Alias tab,
define Alias and Data Type

TEMS Discovery Enterprise 10.0, 2014 © Ascom 40


[ SCRIPT BUILDER ]

Condition Expression Script

Step 2: Write script


code in C# to define
condition expression

TEMS Discovery Enterprise 10.0, 2014 © Ascom 41


[ SCRIPT BUILDER ]

Condition Expression Script

Step 3: Validate values of


any user defined threshold
included in the script

TEMS Discovery Enterprise 10.0, 2014 © Ascom 42


[ SCRIPT BUILDER ]

Condition Expression Script


Step 4: Apply new condition
to the dataset when
displaying measurements

Agg. Ec/Io plot Agg. Ec/Io


without the plot with the
new condition new condition
applied applied

TEMS Discovery Enterprise 10.0, 2014 © Ascom 43


[ SCRIPT BUILDER ]

Condition Expression Script

Step 4: Generate
report with the new
condition applied

TEMS Discovery Enterprise 10.0, 2014 © Ascom 44


[ ]

Q&A

TEMS Discovery Enterprise 10.0, 2014 © Ascom 45


[ ]

THANK YOU!

TEMS Discovery Enterprise 10.0, 2014 © Ascom 47

Vous aimerez peut-être aussi