Page tree
Skip to end of metadata
Go to start of metadata

Dear Focused Insights users,

This article explains how to use the SAM data provider. SAM for service availability management.

1. Objectives

The Data provider SAM gives you access to the service availability management application. Data is read from the database tables of the service availability management application. This data is collected after configuring reports in there.

2. Supported renderers

The SAM data provider supports this following renderers:

  • Line Chart
  • Pie Chart
  • Donut Chart
  • Line-Column Chart
  • Dual Line Chart
  • Dual Line-Column
  • Dual Bar-Column
  • Stack Bar Chart
  • Stack Column Chart
  • Stack Column Chart2Label
  • Column Chart
  • Bar Chart
  • Table History Renderer
  • Trend Table Renderer
  • Dynamic Table
  • HTML renderer

3.Filters Description

Here is a table explaining all possible attributes for the metrics:




Default Value

Key figure

List of key figures

No value


List of systems

No value

The filters of the SAM data provider are all grouped into 1 tab which is General

 To add a SAM data provider in the OCC dashboard:

  ●Select data provider SAM. The selection of this data provider will display the group General along with its filters and filters values.

 ●Select Key figure.

 ●Select a System.

Here is the corresponding selection in the System Analysis application:

  • First select the system needed. The system selection is in the scope selection of the Service availability management application.


  • Second select the key figure needed. This is done through the availability settings section.

4. Pre-requisites

In order to be able to display data related to the service availability management, a report is to be created in the section “service availability definition” trough the add button.


In order to configure a report, the below steps need to be made.

  • Specify the title, validity and the entity (a system)

  • Specify the threshold, the reporting period (Monthly or yearly) and the pattern (Daily or weekly) and the start time of the report

  • Maintain the section contractual maintenance as well and go for the save below.


 5. Data Validation

The behavior of the DP SAM in the OCC depends on the definition of the service availability management report.

The definition has two parameters that can affect the behavior of the DP SAM. These two parameters are the “Reporting period” and the “Pattern” parameters.

If we set the “Reporting period” to “monthly”, no yearly data will be collected. So, if we configure a query with the system used in this definition and use “Year” as a resolution, we will not be able to see this data. So, the data provider sets the resolution automatically to “Month”.

The same thing will happen if we set the “Pattern” parameter to “Week” and ask for daily data. The DP will set the resolution automatically to “Week”.

Also, the definition in the service availability management has a validity period, so in order to have data in the DP SAM for the selected system, the validity has group the time range selected in dashboard.


Here is an example of a definition for the A4H ABAP:

In here it has a monthly reporting period and a daily pattern which means we cannot have yearly data using the OCC DP SAM.


In order to validate the key figure needed we need to follow the below rules:

  • Availability considering all outages: Choose the availability setting “All”
  • Availability considering only confirmed outages: Choose the availability setting “Confirmed only”

Here is an example to be validated, with the below selection:

If we choose the period/resolution = LAST_MONTH/day, this is what we will get in the OCC:

 In order to validate this, the parameter availability settings should be set to “All”:


 In the scope selection, we should search for the A4H ABAP system.

Then in the overview, we need to navigate to the selected period which is April 2020 in this case.

If we went and selected the resolution ”Year” with current 2 Year as a period in the OCC, we will get current 2 year per month data since there is no yearly data because the definition of the report is set to ”Monthly”.

Here is the screenshot for the behavior below:

The granularity is yearly and the DP is sending back monthly data.


So, the DP will always send back the data with the resolution selected if it exists otherwise it will send back the resolution that exists according to the report definition in the service availability management application.


  • No labels