ExcelReportExtensions
OfficeIMO.Excel.Reports
Business report presets for worksheets: KPI, trend, variance and contribution charts, dashboards and subtotal summaries. Each preset is built on the general chart, table and outline APIs of ExcelSheet.
Inheritance
- object
- ExcelReportExtensions
Methods
public static ExcelChart AddContributionChart(ExcelSheet sheet, string dataRangeA1, int row, int column, string title = "Contribution", OfficeLength? width = null, OfficeLength? height = null, bool hasHeaders = true, bool includeCachedData = true) #Adds a doughnut chart with category/percent labels for contribution and mix analysis.
Parameters
- sheet OfficeIMO.Excel.ExcelSheet
- dataRangeA1 string
- row int
- column int
- title string = "Contribution"
- width OfficeIMO.OfficeLength? = null
- height OfficeIMO.OfficeLength? = null
- hasHeaders bool = true
- includeCachedData bool = true
Returns
ExcelChartpublic static ExcelDashboardResult AddDashboard(ExcelSheet sheet, DataTable data, ExcelDashboardOptions? options = null) #Builds a dashboard table and optional chart from a data table.
Parameters
- sheet OfficeIMO.Excel.ExcelSheet
- Worksheet that receives the dashboard.
- data System.Data.DataTable
- Tabular data to write.
- options OfficeIMO.Excel.Reports.ExcelDashboardOptions? = null
- Dashboard layout and styling options.
public static ExcelChart AddDashboardChart(ExcelSheet sheet, ExcelDashboardChartOptions options) #Adds a dashboard-ready chart from a range or table and applies preset styling.
Parameters
- sheet OfficeIMO.Excel.ExcelSheet
- Worksheet that receives the chart.
- options OfficeIMO.Excel.Reports.ExcelDashboardChartOptions
- Dashboard chart options.
public static ExcelChart AddKpiScorecardChart(ExcelSheet sheet, string dataRangeA1, int row, int column, string title = "KPI Scorecard", OfficeLength? width = null, OfficeLength? height = null, bool hasHeaders = true, bool includeCachedData = true) #Adds a compact column chart with value callouts and dashboard-friendly defaults for KPI scorecards.
Parameters
- sheet OfficeIMO.Excel.ExcelSheet
- dataRangeA1 string
- row int
- column int
- title string = "KPI Scorecard"
- width OfficeIMO.OfficeLength? = null
- height OfficeIMO.OfficeLength? = null
- hasHeaders bool = true
- includeCachedData bool = true
Returns
ExcelChartpublic static ExcelChart AddRevenueTrendChart(ExcelSheet sheet, string dataRangeA1, int row, int column, string title = "Revenue Trend", OfficeLength? width = null, OfficeLength? height = null, bool hasHeaders = true, bool includeCachedData = true) #Adds a line chart with dashboard-friendly defaults for time-series revenue or volume trends.
Parameters
- sheet OfficeIMO.Excel.ExcelSheet
- dataRangeA1 string
- row int
- column int
- title string = "Revenue Trend"
- width OfficeIMO.OfficeLength? = null
- height OfficeIMO.OfficeLength? = null
- hasHeaders bool = true
- includeCachedData bool = true
Returns
ExcelChartpublic static ExcelChart AddStatusBreakdownChart(ExcelSheet sheet, string dataRangeA1, int row, int column, string title = "Status Breakdown", OfficeLength? width = null, OfficeLength? height = null, bool hasHeaders = true, bool includeCachedData = true) #Adds a doughnut chart with dashboard-friendly defaults for status, category, or allocation breakdowns.
Parameters
- sheet OfficeIMO.Excel.ExcelSheet
- dataRangeA1 string
- row int
- column int
- title string = "Status Breakdown"
- width OfficeIMO.OfficeLength? = null
- height OfficeIMO.OfficeLength? = null
- hasHeaders bool = true
- includeCachedData bool = true
Returns
ExcelChartpublic static ExcelSubtotalResult AddSubtotalSummary(ExcelSheet sheet, ExcelSubtotalOptions options) #Creates a grouped subtotal summary block from a contiguous worksheet data range.
Parameters
- sheet OfficeIMO.Excel.ExcelSheet
- Worksheet that holds the data.
- options OfficeIMO.Excel.Reports.ExcelSubtotalOptions
- Subtotal generation options.
public static ExcelChart AddTopNBarChart(ExcelSheet sheet, string dataRangeA1, int row, int column, string title = "Top Items", OfficeLength? width = null, OfficeLength? height = null, bool hasHeaders = true, bool includeCachedData = true) #Adds a horizontal bar chart with dashboard-friendly defaults for top-N rankings.
Parameters
- sheet OfficeIMO.Excel.ExcelSheet
- dataRangeA1 string
- row int
- column int
- title string = "Top Items"
- width OfficeIMO.OfficeLength? = null
- height OfficeIMO.OfficeLength? = null
- hasHeaders bool = true
- includeCachedData bool = true
Returns
ExcelChartpublic static ExcelChart AddVarianceColumnChart(ExcelSheet sheet, string dataRangeA1, int row, int column, string title = "Variance", OfficeLength? width = null, OfficeLength? height = null, bool hasHeaders = true, bool includeCachedData = true) #Adds a clustered column chart with dashboard-friendly defaults for variance comparisons.
Parameters
- sheet OfficeIMO.Excel.ExcelSheet
- dataRangeA1 string
- row int
- column int
- title string = "Variance"
- width OfficeIMO.OfficeLength? = null
- height OfficeIMO.OfficeLength? = null
- hasHeaders bool = true
- includeCachedData bool = true
Returns
ExcelChartpublic static ExcelChart AddVarianceWaterfallChart(ExcelSheet sheet, string dataRangeA1, int row, int column, string title = "Variance Bridge", OfficeLength? width = null, OfficeLength? height = null, bool hasHeaders = true, bool includeCachedData = true) #Adds a waterfall-style stacked column chart for variance bridges prepared with helper series.
Parameters
- sheet OfficeIMO.Excel.ExcelSheet
- dataRangeA1 string
- row int
- column int
- title string = "Variance Bridge"
- width OfficeIMO.OfficeLength? = null
- height OfficeIMO.OfficeLength? = null
- hasHeaders bool = true
- includeCachedData bool = true
Returns
ExcelChartpublic static ExcelChart ApplyDashboardPreset(ExcelChart chart, ExcelDashboardChartPreset preset = Comparison, int? styleId = null, int? colorStyleId = null) #Applies a dashboard preset's style, legend and data labels to an existing chart.
Parameters
- chart OfficeIMO.Excel.ExcelChart
- Chart to restyle.
- preset OfficeIMO.Excel.Reports.ExcelDashboardChartPreset = Comparison
- The dashboard appearance preset.
- styleId int? = null
- Optional chart style override.
- colorStyleId int? = null
- Optional chart color-style override.