Upload
ramaraju-manthena
View
219
Download
0
Tags:
Embed Size (px)
DESCRIPTION
gladiator report generation
Citation preview
Gladiator Custom Design Center Training
Custom Design Center
Page 204/21/2023
OverviewCustom design center
Ability to create new reports in Gladiator
Ability to customize existing reports
Reports can be produced inExcel or HTML files
Custom Design Center
Page 304/21/2023
Overview
Three ways to access CDC
Icon in Toolbar
From MenuTools Custom Designer Center
F10 shortcut key
Custom Design Center
Page 404/21/2023
Main menu
Allows ability to manage CDC reports such as:
Open: allow user to open a existing report.
Create new: enable user to create a new report.
Delete: allow user to delete a existing report.
Copy: enable user to make a copy of the report and assign a new name to it.
Rename: allow user to rename the report.
Import/Export: enables user to import or export a report and share them across different machines.
Overview
Custom Design Center
Page 504/21/2023
Five items to configure
Data Source
To create devices for Scanner and Phone
Parameter Tables
To create input parameters for the report
Procedures
To create calculations, statistics and
Histograms, etc…
Outputs
To create tables, graphs and map
Layout
To create layouts
Overview
Custom Design Center
Page 604/21/2023
Data Sources are used as inputs to the report
Data sources can be seen as generic devices from a certain technology and drive test tool
For each data source created, the user will need to specify a device when running the report
System data sources can be used to process system data. It is possible to correlate drive test and system information using both types of data sources
Data Sources
Custom Design Center
Page 704/21/2023
Right click on the Data source node and select New Device
Choose the equipment, technology, and Device type
Data Sources
Custom Design Center
Page 804/21/2023
Parameter Tables are used to create input parameters for the report
Several parameters of different types can be created in a parameter table
Use different parameter tables in order to better organize parameters. Parameters can be grouped by type, or by functionality within the report
Parameter Tables
Parameters from the same parameter table will be grouped in the report execution GUI
Custom Design Center
Page 904/21/2023
Right click on the Parameter tables node and select New Parameter table
Right click on a parameter table and select one of the options from the menu
Parameter Tables
Custom Design Center
Page 1004/21/2023
Text – can be used to add any user specified text to the report layout.
Integer – integer numbers that can be used almost anywhere in the report. For example, as a reference value for a KPI.
Float – floating point numbers that can be used almost anywhere in the report. For example, as a threshold for a statistics procedure.
Boolean – A true/false parameter that can be used to control report options. For example, to save or not a map to the workspace. In the report execution GUI it is displayed as a checkbox.
Color – color parameters can be used almost anywhere where a color can be set. For example, to set the color of graphs.
Parameter Types
Custom Design Center
Page 1104/21/2023
Date – dates can be used in several ways inside the report. They can be used to filter data from a certain period of time, for example.
Vector – can be used to add user selected vectors to a map
System – can be used to add user selected systems to a map
Map – can be used to select a map area for map zooming
Polygon – can be used to filter data by a specific region. The polygon for the desired area must be created in advance
There are also some pre-defined parameters that can be used as information on the report.
Any of the parameters described above can be used by just draging and dropping them into any field where a number or expression is required.
Parameter Types
Custom Design Center
Page 1204/21/2023
Data sets represent the information that will be gathered for processing in the report.
Several types of data sets are available. Each of them will be described in detail.
Data sets are always in the first level in the tree view below the procedures node. They are used as input for the procedures below.
Tips for using data sets more effectivelly:
Always think of a data set as a table containing some relevant raw data that is going to be further processed within the report
Datasets can comprise of any of standard frame of (Tables starting with “G_”) or any other table in the workspace
Data Sets
Custom Design Center
Page 1304/21/2023
To create a Data set
Right click on the Procedures node and select one of the options from the menu
Data Sets
Custom Design Center
Page 1404/21/2023
A custom data set can be used in order to build a custom table by selecting columns from several original tables.
The available original tables are listed according to the technology and drive test tool selected from the data source.
Many columns from different tables can be combined in a single data set.
Users can change the internal name of the columns to be used within the report by clicking the “properties” button.
The order of the columns can be changed using the up and down arrows.
Custom Data Set
Custom Design Center
Page 1504/21/2023
Define the Data source
Preview the data set
Available measuremen
ts
Selected measuremen
ts
Define the order and
properties for the columns
Select measuremen
ts Shows query in SQL
Custom Data Set
Save the preview table to
the Result
node in open
Workspace
Custom Design Center
Page 1604/21/2023
KPI data sets can be used to take advantage of several pre-defined KPIs existing in Gladiator.
The KPIs listed depend on the technology of the selected data source.
Some KPIs already provide the final result for the report, hence no need for further processing.
Some other KPIs, called “optimization” KPIs, provide tables from which the final KPIs can be calculated. These raw tables can be used to draw maps, for instance.
All thresholds can be taken from parameters instead of directly typing the number. This makes the report more flexible, so the user can define the thresholds from the GUI, when running the report.
KPI Data Set
Custom Design Center
Page 1704/21/2023
Define the Data source
Preview the data set
Available KPIs
Define the thresholds for
the KPI
KPI Data Set
Custom Design Center
Page 1804/21/2023
SQL data sets can be used by advanced users in order to directly manipulate tables using SQL server
Three types of SQL data set are available:
Stored procedure – can be used to call a stored procedure from the database. Gladiator will read the input parameters for the procedure and display them in Gladiator. Users can directly type values or drag and drop parameters to the corresponding fields. Even data sources can be dragged and dropped to be used as a File Id input parameter.
Table – selects a whole table from the SQL server. User just needs to type the name of the table (as it is on the SQL database).
Query – User can freely type any SQL query to be executed in the database.
SQL Data Set
Custom Design Center
Page 1904/21/2023
Type the name of a stored procedure,
table or SQL Query
Preview the data set
Select the type of SQL
dataset
Define the input
parameters for the
procedure
SQL Data Set
Custom Design Center
Page 2004/21/2023
Select a ADS script to be
used
Preview the data set
Define the input
parameters for the script
ADS Data Set
ADS data set enables any ADS script to be used as a data set, as long as it returns a table.
User can define the input parameters for the ADS script by either typing them directly or draging and dropping from parameters node.
Data sources can also be dragged and dropped to be used as File Id.
Define the input
parameters for the
script. Drag and drop.
Custom Design Center
Page 2104/21/2023
System data set can be used in order to manipulate system data inside the report.
In order for a system data set to be created, a system data source must be defined first.
A list of all available parameters for the selected element type will be displayed on the left side of the screen.
They can be selected to the right side in order to create the data set, just like in the custom data set.
The order of the columns can be changed by using the up and down arrows.
System Data Set
Custom Design Center
Page 2204/21/2023
Select a ADS script to be
used
Preview the data set
Define the system data
source
System Data Set
Available measuremen
ts
Selected measuremen
tsSelect measuremen
ts
Define the element
type
Custom Design Center
Page 2304/21/2023
Merge Data Set
Merge data set enables the user to create a new data set from merging the outputs of any existing procedures or other data sets. The two procedures are merged veritically.
Columns with the same name are merged into one. The other columns will be also added to the data set, but they will just have blank values on the lines where data comes from a table where they don’t exist.
Select the procedures to be merged
Preview the data set
Custom Design Center
Page 2404/21/2023
Join data set can be used to join two tables by using one column as reference. Tables are merged horizontally.
Note that only two tables can be joined at a time
The “Where” clause is the condition on which the tables will be joined and it can be generated by choosing culoms for each table and setting the codition.
Join Data Set
Custom Design Center
Page 2504/21/2023
The line return options are the following:
Return only matching rows – only rows matching the condition on the “where” clause will be returned.
Return all rows from first table – All rows from first table will be returned, but only rows matching the “where” clause will be returned for the second table.
Return all rows from second table - All rows from second table will be returned, but only rows matching the “where” clause will be returned for the first table.
Return all rows from both tables – returns all rows from both tables, regardless of the “where” condition. The rows where the condition is met will be presented first.
Join Data Set
Custom Design Center
Page 2604/21/2023
Preview the data set
Select tables to join
Join Data Set
Select one of the return
options
Custom Design Center
Page 2704/21/2023
Right click on a data set and select one of the procedures below:
Calculation
Compress
Copy previous
Statistics
Histogram
Joint histogram
ADS script
State machine
Parsing vectors
Procedures
Note: Procedures are used to process a table from a data set or from other procedures.
Custom Design Center
Page 2804/21/2023
Calculations allow further customization in the form of functions to be performed on the input table.
Users can further remove columns from the input table or rename them.
Other capabilities include filtering the table based on certain criteria as can be done in Gladiator’s Table view filter feature.
Users also have the power of performing familiar SQL operations such as ‘Group by’ and ‘Top’.
Calculation Procedure
Custom Design Center
Page 2904/21/2023
One of the most power features is the ability to completely replace a column with an expression that can include any combination of other column variables, mathematical operators and excel like functions. For example the user can sum up multiple column variables using the sum function, multiply it by number x, and divide result by 100.
User can sort the result table by any column (ascending or descending).
Parameters can be used in the expressions.
Columns can be reorganized using the up and down arrows.
Calculation Procedure Cont.
Custom Design Center
Page 3004/21/2023
Calculation Procedure
Allows to apply filters
Create Expression
Group by option
Custom Design Center
Page 3104/21/2023
Compress procedure compresses the input table identical to the way a table can be compressed in Gladiator’s workspace.
All Gladiator compression methods are available.
User can also define exceptions and exception groups.
Parameters can also be used to specify bin size.
Compression schemes can be saved and loaded. Same compression schemes can be used in Gladiator workspace or Custom Design Center.
Compression is useful when there is a need to compare data that is sampled in different time intervals. Another use is to make data “lighter” for drawing a map.
Compress Procedure
Custom Design Center
Page 3204/21/2023
Compress Procedure
Select a type and method
for compression
Custom Design Center
Page 3304/21/2023
Copy Previous Procedure
Before
Fill null values with previous information
Custom Design Center
Page 3404/21/2023
Statistics Procedure
Easy way to calculate Statistics
Select the column from which to calculate the statistics
Insert the “Percentage at value” and “Value at percentage” thresholds. Parameters can be used in these fields.
Custom Design Center
Page 3504/21/2023
Histogram Procedure
Histogram
Calculates the count, percentage and cumulative percentage for each range.
Select the column
Select a Color Scheme or type the range
Range values are separated by comma.
Text parameters can be used as range.
Custom Design Center
Page 3604/21/2023
Joint Histogram Procedure
Select a Color Scheme or
type the range
Select columns that will be used
Ability to compare different information in the same Histogram
Very useful for creating 3D graphs
Custom Design Center
Page 3704/21/2023
ADS Procedure
Select the ADS script to be
used Type the input parameters
Any ADS procedure can be used to process a data set table as long as it receives and returns a table.
The first parameter must be a table. This is automatically assigned to the data set table.
The other parameters can be either typed directly or dragged and dropped from the parameters node.
Custom Design Center
Page 3804/21/2023
State machine procedure can be used to run a state machine on each row of the input table.
For each row the condition will be checked and if true, the following will happen:
State will be changed from the current state to the one specified in “Set state to”.
Variables will be set according to the expressions specified in “Set variables”.
Outputs will be set according to the expresisons specified in “Set outputs”.
The output table will contain all columns from the input table, plus one column for each specified output.
The output values for each row will be included in the corresponding output column.
State Machine Procedure
Custom Design Center
Page 3904/21/2023
The conditions will be checked in the order they are displayed. Order can be changed using the up and down arrows.
When a condition is met, the state will be changed and the state machine goes to the next row of the input table. The conditions will start to be checked again from the first one, considering the new state.
The state machine procedure is often used with layer 3 messages in order to perform some call analysis, but it can be used with any other information as well.
State Machine Procedure
Custom Design Center
Page 4004/21/2023
State Machine Procedure
Create the states Create the
variables
Create the outputs
Add conditions
Set variables and outputs
Preview the
procedure
Custom Design Center
Page 4104/21/2023
Parsing vector procedure
Certain drive test tools report entries in rows as vector entries
Since these rows are not parsed, the data cannot be used for display in any of the Gladiator views.
A CDC procedure was developed to parse this data. It allows the following functionality:
Parsing of data using two different methods: By column or by row
Parsing using different parsing rules depending on the type of data
User can specify invalid values to be omitted from the parsing procedure
Custom Design Center
Page 4204/21/2023
Parsing vector procedure
Specify columns to be parsedSpecify
delimiter
Specify vector
indexes to parse
Specify invalid
values to be
replacedSpecify parsing method:
By column or by row
Custom Design Center
Page 4304/21/2023
Right click on the outputs node and select one of the options below:
Table
Graph
Map
Disk
Output group
Outputs are used to present the results of the report.
Any table coming from a data set or procedure can be used in the outputs.
The outputs preview show how the data will be displayed in the layout of the report.
Outputs
Custom Design Center
Page 4404/21/2023
Table Output
Allows users to configure table formatting options
Color
Borders
Fonts
User can select which columns will be displayed in the table
Custom Design Center
Page 4504/21/2023
Graph Output Types
Select graph type
Available graphs
Custom Design Center
Page 4604/21/2023
Graph Output Data Source
Select the source data for the Graph
Select the series and values
Graph source
For “line column”
graphs, select which column will be used to draw the line and column
Identify the columns to be
used
Custom Design Center
Page 4704/21/2023
Graph Output Colors
Select the data color
Select background color
Select the Grid color
Information color.
Background color.
Grid color
Colors can be taken from parameter tables.
Custom Design Center
Page 4804/21/2023
Graph Output Labels
Configure titles and labels
Configure the interval for the values’ axis
Configure the margins
Insert the titles and label.
User can configure the
range’s interval.
Set the margins
Custom Design Center
Page 4904/21/2023
Graph Output Legend
Define Properties for Legend
Location
Size
Margins
Font
Custom Design Center
Page 5004/21/2023
Graph Output Fonts
Define font properties for the titles and labels
Custom Design Center
Page 5104/21/2023
3D Graph Output
3D properties will be enabled when Pie or 3D graphs are selected
Rotation properties
Perspective properties
Custom Design Center
Page 5204/21/2023
Line Graph Output
Line properties will be enabled when Area, Line or Line column graphs are selected
Smoothness
Show data points
Custom Design Center
Page 5304/21/2023
Map Output Data Source
Map data source
Layer order: Use arrows to assign layer order. Higher elements will
be on top
System and vector layers are parameter
s
Click on ‘+’ icon to add
Data, System and Vector
layers to map.
Properties allows to
configure color scheme, icon
size and legend
Custom Design Center
Page 5404/21/2023
Map Output Options
Output Name.
Configure zoom options
Configure where the legend will be displayed
Configure if legend will display and position
Custom Design Center
Page 5504/21/2023
Map Output Saving Options
Allows exporting to MapInfo.
Possibility to save the map into Gladiator workspace.
Boolean parameters can be user in order to define these options. This lets the user choose if he wants maps to be saved or not during report execution.
Custom Design Center
Page 5604/21/2023
Map Legend separate output
If desired the legend can be created as child output.
Hence can be placed conveniently outside of the map in layouts.
Custom Design Center
Page 5704/21/2023
Output Group
Allows Outputs to be grouped
Allows user to toggle whether a group will be included in report using a condition.
Boolean parameters are used to define these options.
Custom Design Center
Page 5804/21/2023
Right click on the Layouts node and select one of the options below:
HTML Layout
Excel Layout
HTML block
Layouts are used to organize the outputs in the final report layout.
When report is run, all defined layouts are saved in the selected report folder.
Layouts
HTML layouts can be published on the web.
Excel Layouts can be used when there is a pre-defined Excel template.
Excel Layouts are also useful when data needs to be further manipulated by using Excel formulas.
HTML block is an HTML layout that can be placed within the parent HTML layout and allows the user to control under what conditions it will be shown.
Custom Design Center
Page 5904/21/2023
Users can create the HTML layout directly in Gladiator’s HTML editor or open an existing HTML file to be used as a template.
Ouputs can be easily dragged and dropped to the layout and repositioned or resized at any time.
Simple HTML Layouts can be quickly created within Gladiator.
HTML Layouts are ready to be published on the web.
HTML Layout
Custom Design Center
Page 6004/21/2023
HTML Layout
Drag and drop the outputs to
the desired position in the
layout
Use HTML editor tools in order to create
your HTML
Freely resize the outputs to set their size in the layout
Custom Design Center
Page 6104/21/2023
Excel Layout
Excel layouts paste the results on an existing Excel file and then saves it on the selected report folder.
Sheet name, row and column can be chosen for each individual output.
Width and height can be configured for pictures (Graphs and Maps)
Identify the template
Select which information
will be exported to
Excel
Custom Design Center
Page 6204/21/2023
HTML block
HTML blocks are grouped outputs that are added to the main HTML layout.
If outputs do not produce any data the user can choose to have the block omitted from the main HTML layout
Can specify to show block if all outputs have data or at least one
Drag and drop to main layout when finished creating HTML block
Create an HTML block as you would an HTML layout
Custom Design Center
Page 6304/21/2023
Running the Reports
Select a report to run
Set the input parameters
Select the devices
Choose folder and report
name