Cambios en la API pública en Aspose.Cells 8.6.0

Este documento describe los cambios en la API de Aspose.Cells desde la versión 8.5.2 a la 8.6.0 que pueden ser de interés para los desarrolladores de módulos/aplicaciones. Incluye no solo nuevos y actualizados métodos públicos, clases agregadas, etc, sino también una descripción de cualquier cambio en el comportamiento detrás de escena en Aspose.Cells.

APIs Añadidas

Soporte para Manipulación de Metadatos Sin Crear un Objeto de Libro de Trabajo

Esta versión de Aspose.Cells for Java API ha expuesto dos nuevas clases, a saber WorkbookMetadata y MetadataOptions junto con una nueva enumeración MetadataType que ahora permite manipular las propiedades del documento (metadatos) sin crear una instancia de Workbook. La clase WorkbookMetadata es ligera y proporciona un mecanismo muy fácil de usar y eficiente para leer, escribir y actualizar propiedades del documento sin afectar el rendimiento general.

A continuación se muestra un escenario de uso simple.

Java

 //Open Workbook metadata while specifying the appropriate MetadataType

MetadataOptions options = new MetadataOptions(MetadataType.DOCUMENT_PROPERTIES);

WorkbookMetadata metaWorkbook = new WorkbookMetadata("sample.xlsx", options);

//Set some properties

metaWorkbook.getCustomDocumentProperties().add("test", "test");

//Save the metadata information to the spreadsheet file

metaWorkbook.save(filePath);

Se agregó la propiedad HtmlSaveOptions.ExportFrameScriptsAndProperties

Aspose.Cells for Java 8.6.0 ha expuesto la propiedad HtmlSaveOptions.ExportFrameScriptsAndProperties que se puede utilizar para influir en la creación de scripts adicionales al convertir las hojas de cálculo al formato HTML. Con la configuración predeterminada, las APIs de Aspose.Cells exportan la hoja de cálculo en formato HTML tal como lo hace la aplicación Excel, es decir, el HTML resultante contiene los marcos y comentarios condicionales que detectan el tipo de navegador y ajustan el diseño en consecuencia. El valor predeterminado de la propiedad HtmlSaveOptions.ExportFrameScriptsAndProperties es true, lo que significa que la exportación se realiza según los estándares de Excel. Si la propiedad se establece en false, la API no generará los scripts relacionados con los marcos y comentarios condicionales. En este caso, el HTML resultante se puede ver correctamente en cualquier navegador, sin embargo, no se puede importar nuevamente utilizando las APIs de Aspose.Cells.

A continuación se muestra un escenario de uso simple.

Java

 //Load the spreadsheet

Workbook book = new Workbook(filePath);

//Disable exporting frame scripts and document properties

HtmlSaveOptions options = new HtmlSaveOptions();

options.setExportFrameScriptsAndProperties(false);

//Save spreadsheet as HTML

book.save("output.html", options)

Se agregó la propiedad Shape.MarcoName

Aspose.Cells for Java 8.6.0 ha expuesto la propiedad Shape.MarcoName que se puede utilizar para asignar un módulo VBA a un control de formulario como un botón para proporcionar la interacción. La propiedad es de tipo string, por lo tanto, puede aceptar el nombre del módulo y asignarlo al control.

A continuación se muestra un escenario de uso simple.

Java

 //Create a new Workbook object

Workbook workbook = new Workbook();

//Get the instance of first default worksheet

Worksheet sheet = workbook.getWorksheets().get(0);

//Add a new module to the first worksheet

int moduleIdx = workbook.getVbaProject().getModules().add(sheet);

//Get the instance of newly added module

VbaModule module = workbook.getVbaProject().getModules().get(moduleIdx);

//Add module code

module.setCodes("Sub ShowMessage()" + "\r\n" +

        "    MsgBox \"Welcome to Aspose!\"" + "\r\n" +

        "End Sub");

//Create a new button to the worksheet and set its various properties

Button button = (Button) sheet.getShapes().addShape(MsoDrawingType.BUTTON, 2, 0, 2, 0, 28, 80);

button.setPlacement(PlacementType.FREE_FLOATING);

button.getFont().setName("Tahoma");

button.getFont().setBold(true);

button.getFont().setColor(Color.getBlue());

button.setText("Aspose");

//Assign the newly added module to the button

button.setMacroName(module.getName() + ".ShowMessage" );

//Save the spreadsheet in XLSM format

workbook.save("output.xlsm");

Propiedad OoxmlSaveOptions.UpdateZoom agregada

Con el lanzamiento de v8.6.0, la API Aspose.Cells for Java ha expuesto la propiedad OoxmlSaveOptions.UpdateZoom que se puede usar para actualizar la propiedad PageSetup.Zoom si se han utilizado las propiedades PageSetup.FitToPagesWide y/o PageSetup.FitToPagesTall para controlar el escalado de la hoja de cálculo.