| Table of Contents |
|---|
| Info |
|---|
EN OBRAS!! |
Reports Management
Overview
Kiuwan Governance provides an out-of-the-box PDF report that you can generate by selecting PDF option in Summary section. Sometimes, that report does not completely suite your needs.
...
| Info |
|---|
Only users granted with “report generation” privilege can create a custom report. Once created, any user can “generate” the report. |
Reports Creation
| Info |
|---|
A Report is composed of widgets. A widget is a graphical element that displays information. When creating a Report, you select the widgets selecting them among those that Kiuwan provides. |
...
Once the report is created, you will publish to make it generally available to the rest of the users. At any time, you will be able to modify any published report.
Reports Structure
A Kiuwan Report follows next structure
1.- Report First-Page
This 1st page contains basically the Title of the report, the Account Name (i.e. the descriptive name of the Kiuwan account, usually it’s the Company name) and the date generation report.
2.- Table of Contents
A Table of Contents (TOC) that shows the different sections of the Report. As you will see later, you decides whether a section appears or not in the TOC.
3.- Pages with designed Widgets
Every selected widget will be presented as a page of the report. At the time of report creation, you decide exactly what information will be included in the widget.
Reports Edition
You create your report by adding widgets from Kiuwan library.
...
And next image shows an example of a page heading.
Reports Generation
Every created report will be available to Kiuwan users.
...
- To select one among any of the pre-defined data ranges that Kiuwan provides (All, Today, This month, Last 30 days, etc)
- To use the active global filter (i.e. that one currently active in the Calendar)
Report Widgets
About Widgets
| Info |
|---|
Kiuwan provides a complete library of widgets that you can use to build your custom report. |
...
Depending on the widget, you can select additional properties to decide the degree of detailed information that will be printed.
Kiuwan's Library of Report Widgets
Below you can find available widgets grouped by cathegory.
Summary Groups
| Info |
|---|
Summary widgets allow to represent display global (aggregated) information about application metrics. |
...
Available widgets:
- Apps Section
- Risk Section
For a fully understanding on Kiuwan Indicators, please visit https://www.kiuwan.com/blog/kiuwan-indicators/ .
...
Apps Section widget allows to include summary data about number and distribution of applications by several criteria:
- Number of Apps and Total size Size (in LOCsKLOCs)
- Frequency of Apps, by Size
- Frequency of Apps, by selected portfolio (Business Value, by default)
<< R_W_01.png>>
Risk Section
Risk Section widget allows to include summary data about number and distribution of applications based on Risk Index metric:
- Average of Risk Index
- Frequency of Apps, by Risk ranges
- Average Risk, by selected portfolio (Business Value, by default)
<< R_W_02.png>>
Security Section
Security Section widget allows to include summary data about number and distribution of applications based on Security Rating metric:
...
Please, visit https://www.kiuwan.com/docs/display/K5/Kiuwan+Code+Security for further information on Code Security.
Quality Section
...
- Average of Global Indicator
- Frequency of Apps, by Global Indicator ranges
- Average Global Indicator, by selected portfolio (Business Value, by default)
Technical Debt Section
...
Technical Debt Widget allows to include summary data about number and distribution of applications based on Global (quality) Indicator metric:
- Total ammount of Technical Debt
- Distribution of Technical Debt, by
- Average of Global Indicator
- Frequency of Apps, by Global Indicator ranges
- Average Global Indicator, by selected portfolio (Business Value, by default)
Decision quadrants
Decision Quadrant widgets allow to represent XXXXX.
Summary widgets allow to include in the report global (aggregated) information about metrics from Governance – Decision Quadrants.
Available widgets:
represent graphically where your applications are depending on their business value, failure probability, maintenance risk and security risk.
Available widgets:
- Business chart
- Production
- Business chart
- Production chart
- Development chart
- Security chart
- Metrics
- Decision quadrants database
...
Business chart Widget graphically displays a quadrant where apps (or groups of apps) are placed according to Business Value (Y-Axis).
X-Axis can be customized to display the available types of Risks:
...
- Diameter (proportional to size in Locs)
- Color (the portfolio value the app belongs to, this option is only available when Color by selector has been set to any to the available portfolios)
<< R_W_03.png>>
Production Chart
Production Chart widget allows to include a Production Decision Quadrant in your report.
The Production quadrant is aimed to identify those applications in your portfolio that could cause problems in production, and if they will be able to recover from these errors easily. The applications with higher exposure to this kind of risk will be those in the upper-right area of the quadrant.
Vertical (Y) axis represents Failure Probability. This indicates if applications are likely to provoke frequent errors in production. Applications with high Failure Probability could be a problem in the short term.
...
- Diameter (proportional to size in Locs)
- Color (the portfolio value the app belongs to, this option is only available when Color by selector has been set to any to the available portfolios)
...
Development Chart
Development Chart widget allows to include a Development Decision Quadrant in your report.
The Development quadrant is aimed to identify those applications in your portfolio exposed in the midterm given the difficulty and associated cost to maintain them. The applications with higher exposure to this kind of risk will be those in the upper-right area of the quadrant.
In the vertical axis we represent the Maintenance Risk: this indicates if applications’ maintenance costs are going to be higher than expected, or if it is going to be complex and costly to add new functionality to them. It is based on the evidence gathered from the code for the maintainability index.
...
- Diameter (proportional to size in Locs)
- Color (the portfolio value the app belongs to, this option is only available when Color by selector has been set to any to the available portfolios)
<< R_W_05.png>>
Security Chart
Security Chart widget allows to include a Security Decision Quadrant in your report.
The Security quadrant is aimed to identify those applications in your portfolio that are exposed to potential internal or external attacks, that can compromise the integrity of you organization, and if these potential vulnerabilities can be easily corrected. The applications with higher exposure to this kind of risk will be those in the upper-right area of the quadrant.
In the vertical axis we represent the Security risk: This indicated how vulnerable an application is to internal or external attacks based on the number of vulnerabilities found in the application’s code as listed by CWE and OWASP.
...
- Diameter (proportional to size in Locs)
- Color (the portfolio value the app belongs to, this option is only available when Color by selector has been set to any to the available portfolios)
...
...
Metrics widget allows to XXXXXX
Decision Quadrants
...
DataTable
Decision Quadrants DataTable widget allows to include a data table of records (one application or group of applications per row) with the following summarized information:
- Business Value
- Complexity
- Risk Index
- Failure Risk
- Maintenance Risk
- Security Risk
Every record can be customized to represent:
...
Additionally, the data table records can be ordered by any of the above columns by using the Order by selector.
<< R_W_07.png>>
Evolution
Evolution widget display timely evolution of an application or a portfolio on a selected metric or indicator.
...
For a fully understanding on Governance - Evolution, please visit https://www.kiuwan.com/docs/display/K5/EvolutionEvolution.
Evolution DataTable
Evolution DataTable widget allows to include timely evolution data of an application or a portfolio on a selected metric or indicator.
Evolution can be tracked on the following metrics/indicators:
- Lines of Code (LOCs)
- Risk Index
- Global Indicator
- Effort to Target
- Effort to 100
- Number of Defects
For a fully understanding on Governance - Evolution, please visit https://www.kiuwan.com/docs/display/K5/Evolution.
Values for these metrics will be “signed” numbers that represent increments (+) or decrements (-) in the metric/indicator during the selected period of time.
Every record can be customized to represent:
- One individual application (setting Group by selector to “Not grouped”)
- Groups of applications (grouped by the different values of selected portfolio in Group by selector)
Additionally, the data table records can be ordered by any of the above columns by using the Order by selector.
Activity
Activity widgets display applications (activity) on a selected metric or indicator during a certain period of time.
Changes in activity can be viewed for a specific application or for those applications that belongs to a selected portfolio.
Available widgets:
- Applications activity datatable
- Deliveries activity datatable
For a fully understanding on Governance - Activity, please visit https://www.kiuwan.com/docs/display/K5/Activity.
...
Applications Activity DataTable
Evolution Applications Activity DataTable widget Widget allows to include timely evolution change data of an application or a portfolio on a selected metric or indicator.
Evolution Activity can be tracked on the following metrics/indicators:
- Lines of Code (LOCs)
- Risk Index
- Global Indicator
- Effort to Target
- Effort to 100
- Number of Defects
...
For a fully understanding on Governance - Evolution, please visit https://www.kiuwan.com/docs/display/K5/Evolution.visit Activity#Applications.
Values for these metrics will be “signed” numbers that represent increments (+) or decrements (-) in the metric/indicator during since the beginning of the selected period of time.
Every record can be customized to represent:
...
Additionally, the data table records can be ordered by any of the above columns by using the Order by selector.<< R_W_07.png>>
Deliveries Activity DataTable (XXXXXXXXXXXXXX)
Ranking
Ranking widgets are those that allow to display rankings of applications (or applications grouped by portfolios) on a selected metric or indicator.
...