Générer un graphique en traitant des marqueurs intelligents

Aspose.Cells Les API fournissent leWorkbookDesignerclasse pour travailler avec des marqueurs intelligents où la mise en forme et les formules sont placées dans les feuilles de calcul du concepteur, puis traitées avecWorkbookDesignerclasse pour remplir les données selon les marqueurs intelligents spécifiés. Il est également possible de créer des graphiques Excel en traitant des marqueurs intelligents, ce qui nécessitera les étapes suivantes.

Création d’une feuille de calcul de concepteur
Traitement de la feuille de calcul du concepteur par rapport à la source de données spécifiée
Création de graphique basé sur des données peuplées

Création d’une feuille de calcul Designer

Une feuille de calcul de concepteur est un simple fichier Excel créé avec l’application Excel Microsoft ou les API Aspose.Cells contenant le formatage visuel, les formules et les marqueurs intelligents, où le contenu peut être rempli au moment de l’exécution.

Par souci de simplicité, nous allons créer la feuille de calcul du concepteur à l’aide du Aspose.Cells for .NET API, puis la traiter par rapport à une source de données créée dynamiquement à des fins de démonstration.

	// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
	// The path to the documents directory.
	string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

	// Create an instance of Workbook
	var book = new Workbook();

	// Access the first, default Worksheet by passing its index
	var dataSheet = book.Worksheets[0];

	// Name the Worksheet for later reference
	dataSheet.Name = "ChartData";

	// Access the CellsCollection of first Worksheet
	var cells = dataSheet.Cells;

	// Insert static data (headers)
	cells["B1"].PutValue("Item 1");
	cells["C1"].PutValue("Item 2");
	cells["D1"].PutValue("Item 3");
	cells["E1"].PutValue("Item 4");
	cells["F1"].PutValue("Item 5");
	cells["G1"].PutValue("Item 6");
	cells["H1"].PutValue("Item 7");
	cells["I1"].PutValue("Item 8");
	cells["J1"].PutValue("Item 9");
	cells["K1"].PutValue("Item 10");
	cells["L1"].PutValue("Item 11");
	cells["M1"].PutValue("Item 12");


	// Place Smart Markers
	cells["A2"].PutValue("&=Sales.Year");
	cells["B2"].PutValue("&=Sales.Item1");
	cells["C2"].PutValue("&=Sales.Item2");
	cells["D2"].PutValue("&=Sales.Item3");
	cells["E2"].PutValue("&=Sales.Item4");
	cells["F2"].PutValue("&=Sales.Item5");
	cells["G2"].PutValue("&=Sales.Item6");
	cells["H2"].PutValue("&=Sales.Item7");
	cells["I2"].PutValue("&=Sales.Item8");
	cells["J2"].PutValue("&=Sales.Item9");
	cells["K2"].PutValue("&=Sales.Item10");
	cells["L2"].PutValue("&=Sales.Item11");
	cells["M2"].PutValue("&=Sales.Item12");

view raw Examples-CSharp-Articles-ManageChartsAndShapes-GenerateChartByProcessingSmartMarkers-CreationOfDesignerSpreadsheet.cs hosted with ❤ by GitHub

Feuille de calcul du concepteur de traitement

Pour traiter la feuille de calcul du concepteur, il faut disposer d’une source de données correspondant aux marqueurs intelligents utilisés dans la feuille de calcul du concepteur. Par exemple, nous avons créé une entrée Smart Marker sous la forme &=Sales.Year, qui représente la colonne Year dans le DataTable Sales. Si une colonne correspondante n’est pas disponible dans la source de données, les API Aspose.Cells ignoreront le traitement pour ce marqueur intelligent particulier et, par conséquent, les données pour le marqueur intelligent particulier ne seront pas renseignées.

Afin de démontrer ce cas d’utilisation, nous allons créer la source de données à partir de zéro et la traiter par rapport à la feuille de calcul du concepteur créée à l’étape précédente. Cependant, dans un scénario en temps réel, les données peuvent déjà être disponibles pour un traitement ultérieur, vous pouvez donc ignorer la création de la source de données si les données sont déjà disponibles.

	// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
	// Create an instance of DataTable and name is according to the Smart Markers
	var table = new DataTable("Sales");
	/*
	* Add columns to the newly created DataTable while specifying the column type
	* It is important that the DataTable should have at least one column for each
	* Smart Marker entry from the designer spreadsheet
	*/
	table.Columns.Add("Year", typeof(string));
	table.Columns.Add("Item1", typeof(int));
	table.Columns.Add("Item2", typeof(int));
	table.Columns.Add("Item3", typeof(int));
	table.Columns.Add("Item4", typeof(int));
	table.Columns.Add("Item5", typeof(int));
	table.Columns.Add("Item6", typeof(int));
	table.Columns.Add("Item7", typeof(int));
	table.Columns.Add("Item8", typeof(int));
	table.Columns.Add("Item9", typeof(int));
	table.Columns.Add("Item10", typeof(int));
	table.Columns.Add("Item11", typeof(int));
	table.Columns.Add("Item12", typeof(int));

	// Add some rows with data to the DataTable
	table.Rows.Add("2000", 2310, 0, 110, 15, 20, 25, 30, 1222, 200, 421, 210, 133);
	table.Rows.Add("2005", 1508, 0, 170, 280, 190, 400, 105, 132, 303, 199, 120, 100);
	table.Rows.Add("2010", 0, 210, 230, 140, 150, 160, 170, 110, 1999, 1229, 1120, 2300);
	table.Rows.Add("2015", 3818, 320, 340, 260, 210, 310, 220, 0, 0, 0, 0, 122);

view raw Examples-CSharp-Articles-ManageChartsAndShapes-GenerateChartByProcessingSmartMarkers-ProcessingDesignerSpreadsheet.cs hosted with ❤ by GitHub

Le traitement des marqueurs intelligents est assez simple, comme le montre l’extrait de code suivant.

	// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET

	// The path to the documents directory.
	string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

	// Create an instance of Workbook
	var book = new Workbook();

	// Access the first, default Worksheet by passing its index
	var dataSheet = book.Worksheets[0];

	// Name the Worksheet for later reference
	dataSheet.Name = "ChartData";

	// Access the CellsCollection of first Worksheet
	var cells = dataSheet.Cells;

	// Insert static data (headers)
	cells["B1"].PutValue("Item 1");
	cells["C1"].PutValue("Item 2");
	cells["D1"].PutValue("Item 3");
	cells["E1"].PutValue("Item 4");
	cells["F1"].PutValue("Item 5");
	cells["G1"].PutValue("Item 6");
	cells["H1"].PutValue("Item 7");
	cells["I1"].PutValue("Item 8");
	cells["J1"].PutValue("Item 9");
	cells["K1"].PutValue("Item 10");
	cells["L1"].PutValue("Item 11");
	cells["M1"].PutValue("Item 12");


	// Place Smart Markers
	cells["A2"].PutValue("&=Sales.Year");
	cells["B2"].PutValue("&=Sales.Item1");
	cells["C2"].PutValue("&=Sales.Item2");
	cells["D2"].PutValue("&=Sales.Item3");
	cells["E2"].PutValue("&=Sales.Item4");
	cells["F2"].PutValue("&=Sales.Item5");
	cells["G2"].PutValue("&=Sales.Item6");
	cells["H2"].PutValue("&=Sales.Item7");
	cells["I2"].PutValue("&=Sales.Item8");
	cells["J2"].PutValue("&=Sales.Item9");
	cells["K2"].PutValue("&=Sales.Item10");
	cells["L2"].PutValue("&=Sales.Item11");
	cells["M2"].PutValue("&=Sales.Item12");

	// Create an instance of DataTable and name is according to the Smart Markers
	var table = new DataTable("Sales");
	/*
	* Add columns to the newly created DataTable while specifying the column type
	* It is important that the DataTable should have at least one column for each
	* Smart Marker entry from the designer spreadsheet
	*/
	table.Columns.Add("Year", typeof(string));
	table.Columns.Add("Item1", typeof(int));
	table.Columns.Add("Item2", typeof(int));
	table.Columns.Add("Item3", typeof(int));
	table.Columns.Add("Item4", typeof(int));
	table.Columns.Add("Item5", typeof(int));
	table.Columns.Add("Item6", typeof(int));
	table.Columns.Add("Item7", typeof(int));
	table.Columns.Add("Item8", typeof(int));
	table.Columns.Add("Item9", typeof(int));
	table.Columns.Add("Item10", typeof(int));
	table.Columns.Add("Item11", typeof(int));
	table.Columns.Add("Item12", typeof(int));

	// Add some rows with data to the DataTable
	table.Rows.Add("2000", 2310, 0, 110, 15, 20, 25, 30, 1222, 200, 421, 210, 133);
	table.Rows.Add("2005", 1508, 0, 170, 280, 190, 400, 105, 132, 303, 199, 120, 100);
	table.Rows.Add("2010", 0, 210, 230, 140, 150, 160, 170, 110, 1999, 1229, 1120, 2300);
	table.Rows.Add("2015", 3818, 320, 340, 260, 210, 310, 220, 0, 0, 0, 0, 122);

	// Create an instance of WorkbookDesigner class
	var designer = new WorkbookDesigner();

	// Assign the Workbook property to the instance of Workbook created in first step
	designer.Workbook = book;

	// Set the data source
	designer.SetDataSource(table);

	// Call Process method to populate data
	designer.Process();

view raw Examples-CSharp-Articles-ManageChartsAndShapes-GenerateChartByProcessingSmartMarkers-ProcessingOfSmartMarkers.cs hosted with ❤ by GitHub

L’extrait de code ci-dessus utilise l’instance existante deCahierclasse créée à la première étape. Si vous disposez déjà du fichier de feuille de calcul du concepteur sur disque ou en mémoire, vous pouvez créer une instance deCahierclasse en chargeant la feuille de calcul de concepteur existante.

Création de graphique

Une fois les données en place, tout ce que nous avons à faire est de créer un graphique basé sur la source de données. Afin de garder l’exemple simple, nous utiliserons leChart.SetChartDataRangeChart.SetChartDataRangeafin que nous n’ayons pas à configurer davantage le graphique.

	// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET

	// The path to the documents directory.
	string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

	// Create an instance of Workbook
	var book = new Workbook();

	// Access the first, default Worksheet by passing its index
	var dataSheet = book.Worksheets[0];

	// Name the Worksheet for later reference
	dataSheet.Name = "ChartData";

	// Access the CellsCollection of first Worksheet
	var cells = dataSheet.Cells;

	// Insert static data (headers)
	cells["B1"].PutValue("Item 1");
	cells["C1"].PutValue("Item 2");
	cells["D1"].PutValue("Item 3");
	cells["E1"].PutValue("Item 4");
	cells["F1"].PutValue("Item 5");
	cells["G1"].PutValue("Item 6");
	cells["H1"].PutValue("Item 7");
	cells["I1"].PutValue("Item 8");
	cells["J1"].PutValue("Item 9");
	cells["K1"].PutValue("Item 10");
	cells["L1"].PutValue("Item 11");
	cells["M1"].PutValue("Item 12");


	// Place Smart Markers
	cells["A2"].PutValue("&=Sales.Year");
	cells["B2"].PutValue("&=Sales.Item1");
	cells["C2"].PutValue("&=Sales.Item2");
	cells["D2"].PutValue("&=Sales.Item3");
	cells["E2"].PutValue("&=Sales.Item4");
	cells["F2"].PutValue("&=Sales.Item5");
	cells["G2"].PutValue("&=Sales.Item6");
	cells["H2"].PutValue("&=Sales.Item7");
	cells["I2"].PutValue("&=Sales.Item8");
	cells["J2"].PutValue("&=Sales.Item9");
	cells["K2"].PutValue("&=Sales.Item10");
	cells["L2"].PutValue("&=Sales.Item11");
	cells["M2"].PutValue("&=Sales.Item12");

	// Create an instance of DataTable and name is according to the Smart Markers
	var table = new DataTable("Sales");
	/*
	* Add columns to the newly created DataTable while specifying the column type
	* It is important that the DataTable should have at least one column for each
	* Smart Marker entry from the designer spreadsheet
	*/
	table.Columns.Add("Year", typeof(string));
	table.Columns.Add("Item1", typeof(int));
	table.Columns.Add("Item2", typeof(int));
	table.Columns.Add("Item3", typeof(int));
	table.Columns.Add("Item4", typeof(int));
	table.Columns.Add("Item5", typeof(int));
	table.Columns.Add("Item6", typeof(int));
	table.Columns.Add("Item7", typeof(int));
	table.Columns.Add("Item8", typeof(int));
	table.Columns.Add("Item9", typeof(int));
	table.Columns.Add("Item10", typeof(int));
	table.Columns.Add("Item11", typeof(int));
	table.Columns.Add("Item12", typeof(int));

	// Add some rows with data to the DataTable
	table.Rows.Add("2000", 2310, 0, 110, 15, 20, 25, 30, 1222, 200, 421, 210, 133);
	table.Rows.Add("2005", 1508, 0, 170, 280, 190, 400, 105, 132, 303, 199, 120, 100);
	table.Rows.Add("2010", 0, 210, 230, 140, 150, 160, 170, 110, 1999, 1229, 1120, 2300);
	table.Rows.Add("2015", 3818, 320, 340, 260, 210, 310, 220, 0, 0, 0, 0, 122);

	// Create an instance of WorkbookDesigner class
	var designer = new WorkbookDesigner();

	// Assign the Workbook property to the instance of Workbook created in first step
	designer.Workbook = book;

	// Set the data source
	designer.SetDataSource(table);

	// Call Process method to populate data
	designer.Process();

	/*
	* Save the number of rows & columns from the source DataTable in seperate variables.
	* These values will be used later to identify the chart's data range from DataSheet
	*/
	int chartRows = table.Rows.Count;
	int chartCols = table.Columns.Count;

	// Add a new Worksheet of type Chart to Workbook
	int chartSheetIdx = book.Worksheets.Add(SheetType.Chart);

	// Access the newly added Worksheet via its index
	var chartSheet = book.Worksheets[chartSheetIdx];

	// Name the Worksheet
	chartSheet.Name = "Chart";

	// Add a chart of type ColumnStacked to newly added Worksheet
	int chartIdx = chartSheet.Charts.Add(ChartType.ColumnStacked, 0, 0, chartRows, chartCols);

	// Access the newly added Chart via its index
	var chart = chartSheet.Charts[chartIdx];

	// Set the data range for the chart
	chart.SetChartDataRange(dataSheet.Name + "!A1:" + CellsHelper.ColumnIndexToName(chartCols - 1) + (chartRows + 1).ToString(), false);

	// Set the chart to size with window
	chart.SizeWithWindow = true;

	// Set the format for the tick labels
	chart.ValueAxis.TickLabels.NumberFormat = "$###,### K";

	// Set chart title
	chart.Title.Text = "Sales Summary";

	// Set ChartSheet an active sheet
	book.Worksheets.ActiveSheetIndex = chartSheetIdx;

	// Save the final result
	book.Save(dataDir + "report_out.xlsx");

view raw Examples-CSharp-Articles-ManageChartsAndShapes-GenerateChartByProcessingSmartMarkers-CreationOfChart.cs hosted with ❤ by GitHub

Obtenir la feuille de calcul du graphique