Chart Series Coloring in Spreadsheet Document

Note
The example reads the shop data described in The Business Layer.

Chart Series Coloring in Spreadsheet Document

Creating a Column Chart

Practising the following steps, you can insert a Column Chart in MS Excel 2013:

  1. Create a new Workbook.
  2. Click the “Insert” tab, and then click “Insert Column Chart” icon in the Charts group to view the drop-down list.
  3. Select the “100% Stacked Column” and press “OK” to insert the chart and Worksheet template to your Worksheet.
  4. Edit the Worksheet with your data to update the chart. See Chart Data.
  5. Save your Document.

Reporting Requirement

As a report developer, you are required to share contract price by manager dynamically with the following key requirements:

  • The report must show the name of the manager
  • The report must show the total contract price for each manager
  • Series color to be used in chart series
  • The report must be generated in the Spreadsheet Document

Adding Syntax to be evaluated by GroupDocs.Assembly Engine

Chart Title

<Total Contract Prices by Managers<<foreach [m in
managers]>><<x [m.Manager]>>

Legend Entries

="Total Contract Price<<y [m.Total_Contract_Price]>><<seriesColor [color]>>"
Tip
For detailed technical information about syntax, expressions and report generation by the engine, please visit: Working with GroupDocs.Assembly Engine

Download Template

Please download the sample Dynamic Chart Series Color document we created in this article:

Generating The Report

For a chart with dynamic data, you can set colors of chart series dynamically based upon expressions. To use the feature, do the following steps:

  • Declare a chart with dynamic data in the usual way

  • For chart series to be colored dynamically, define corresponding color expressions in names of these series using seriesColor tags having the following syntax:

    <<seriesColor [color_expression]>>
    

A color expression must return a value of one of the following types:

  • A string containing the name of a known color, that is, the case-insensitive name of a member of the KnownColor enumeration such as “red”
  • An integer value defining RGB (red, green, blue) components of the color such as 0xFFFF00 (yellow)
  • A value of the Color type

Following code snippet generates the report:

from groupdocs.assembly import DataSourceInfo, DocumentAssembler
from groupdocs.assembly.data import DocumentTable, DocumentTableOptions

options = DocumentTableOptions()
options.first_row_contains_column_names = True
table = DocumentTable("managers.docx", 1, options)
table.columns["Total_Contract_Price"].type = float

assembler = DocumentAssembler()
assembler.assemble_document("dynamic-chart-series-color.xlsx", "dynamic-chart-series-color-report.xlsx", [
    DataSourceInfo(table, "managers"),
    DataSourceInfo("Coral", "color"),
])

The following sample file is used in this example: dynamic-chart-series-color.xlsx

The following sample file is used in this example: managers.docx

Binary file (XLSX, 13 KB)

Download full output

Close
Loading

Analyzing your prompt, please hold on...

An error occurred while retrieving the results. Please refresh the page and try again.