Getting Notifications while Merging Data with Smart Markers

Aspose.Cells APIs provide the WorkbookDesigner class to work with Smart Markers where the formatting & formulas are placed in the designer spreadsheets and then processed with WorkbookDesigner class to fill up the data according to specified Smart Markers. Sometimes, it may be required to get the notifications about the cell reference or the particular Smart Marker being processed. This can be achieved using the WorkbookDesigner.CallBack property and ISmartMarkerCallBack interface exposed with the release of Aspose.Cells for Java 8.6.2.

Get Notifications while Merging Data with Smart Markers

The following piece of code demonstrates the usage of ISmartMarkerCallBack interface to define a new class that handles the call back for WorkbookDesigner.process method.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
public class SmartMarkerCallBack implements ISmartMarkerCallBack {
	Workbook workbook;

	SmartMarkerCallBack(Workbook workbook) {
		this.workbook = workbook;
	}

	@Override
	public void process(int sheetIndex, int rowIndex, int colIndex, String tableName, String columnName) {
		System.out.println("Processing Cell : " + workbook.getWorksheets().get(sheetIndex).getName() + "!"
				+ CellsHelper.cellIndexToName(rowIndex, colIndex));
		System.out.println("Processing Marker : " + tableName + "." + columnName);
	}
}

In order to keep the example simple and to the point, the following snippet creates an empty designer spreadsheet, inserts a Smart Marker and processes it with the dynamically created data source.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(GetNotificationsWhileMergingData.class);
// Instantiate a new Workbook designer
WorkbookDesigner report = new WorkbookDesigner();

// Get the first worksheet of the workbook
Worksheet sheet = report.getWorkbook().getWorksheets().get(0);

/*
 * Set the Variable Array marker to a cell. You may also place this Smart Marker into a template file manually using Excel
 * and then open this file via WorkbookDesigner
 */
sheet.getCells().get("A1").putValue("&=$VariableArray");

// Set the data source for the marker(s)
report.setDataSource("VariableArray", new String[] { "English", "Arabic", "Hindi", "Urdu", "French" });

// Set the CallBack property
report.setCallBack(new SmartMarkerCallBack(report.getWorkbook()));

// Process the markers
report.process(false);

// Save the result
report.getWorkbook().save(dataDir);