Libro de Gráficos

Establecer Datos de Gráfico desde el Libro

Aspose.Slides proporciona los métodos ReadWorkbookStream y WriteWorkbookStream que te permiten leer y escribir libros de trabajo de datos de gráficos (que contienen datos de gráfico editados con Aspose.Cells). Nota que los datos del gráfico deben estar organizados de la misma manera o deben tener una estructura similar a la fuente.

Este código Java demuestra una operación de ejemplo:

Presentation pres = new Presentation("chart.pptx");
try {
    Chart chart = (Chart) pres.getSlides().get_Item(0).getShapes().get_Item(0);
    IChartData data = chart.getChartData();

    byte[] stream = data.readWorkbookStream();

    data.getSeries().clear();
    data.getCategories().clear();

    data.writeWorkbookStream(stream);
} finally {
    if (pres != null) pres.dispose();
}

Establecer la Celda del Libro como Etiqueta de Datos del Gráfico

Crea una instancia de la Presentation clase.
Obtén la referencia de una diapositiva a través de su índice.
Agrega un gráfico de Burbuja con algunos datos.
Accede a la serie del gráfico.
Establece la celda del libro como una etiqueta de datos.
Guarda la presentación.

Este código Java te muestra cómo establecer una celda del libro como una etiqueta de datos del gráfico:

String lbl0 = "Valor de la celda Etiqueta 0";
String lbl1 = "Valor de la celda Etiqueta 1";
String lbl2 = "Valor de la celda Etiqueta 2";

// Instancia una clase de presentación que representa un archivo de presentación
Presentation pres = new Presentation("chart2.pptx");
try {
    ISlide slide = pres.getSlides().get_Item(0);
    IChart chart = slide.getShapes().addChart(ChartType.Bubble, 50, 50, 600, 400, true);
    IChartSeriesCollection series = chart.getChartData().getSeries();
    
    IDataLabelCollection dataLabelCollection = series.get_Item(0).getLabels();
    dataLabelCollection.getDefaultDataLabelFormat().setShowLabelValueFromCell(true);

    IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook();

    dataLabelCollection.get_Item(0).setValueFromCell(wb.getCell(0, "A10", lbl0));
    dataLabelCollection.get_Item(1).setValueFromCell(wb.getCell(0, "A11", lbl1));
    dataLabelCollection.get_Item(2).setValueFromCell(wb.getCell(0, "A12", lbl2));

    pres.save("resultchart.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Gestionar Hojas de Cálculo

Este código Java demuestra una operación donde se utiliza el método IChartDataWorkbook.Worksheets para acceder a una colección de hojas de cálculo:

Presentation pres = new Presentation();
try {
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.Pie, 50, 50, 400, 500);
    IChartDataWorkbook wb =  chart.getChartData().getChartDataWorkbook();
    for (int i = 0; i < wb.getWorksheets().size(); i++)
        System.out.println(wb.getWorksheets().get_Item(i).getName());
} finally {
    if (pres != null) pres.dispose();
}

Especificar Tipo de Fuente de Datos

Este código Java te muestra cómo especificar un tipo para una fuente de datos:

Presentation pres = new Presentation();
try {
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.Column3D, 50, 50, 600, 400, true);
    IStringChartValue val = chart.getChartData().getSeries().get_Item(0).getName();

    val.setDataSourceType(DataSourceType.StringLiterals);
    val.setData("CadenaLiteral");

    val = chart.getChartData().getSeries().get_Item(1).getName();
    val.setData(chart.getChartData().getChartDataWorkbook().getCell(0, "B1", "NuevaCelda"));

    pres.save("pres.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Libro Externo

En Aspose.Slides 19.4, implementamos soporte para libros externos como fuente de datos para gráficos.

Crear Libro Externo

Usando los métodos readWorkbookStream y setExternalWorkbook, puedes crear un libro externo desde cero o hacer que un libro interno sea externo.

Este código Java demuestra el proceso de creación de un libro externo:

Presentation pres = new Presentation();
try {
    final String workbookPath = "externalWorkbook1.xlsx";

    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.Pie, 50, 50, 400, 600);
    FileOutputStream fileStream = new FileOutputStream(workbookPath);
    try {
        byte[] workbookData = chart.getChartData().readWorkbookStream();
        fileStream.write(workbookData, 0, workbookData.length);
    } finally {
        if (fileStream != null) fileStream.close();
    }

    chart.getChartData().setExternalWorkbook(workbookPath);

    pres.save("externalWorkbook.pptx", SaveFormat.Pptx);
} catch (IOException e) {    
} finally {
    if (pres != null) pres.dispose();
}

Establecer Libro Externo

Usando el método setExternalWorkbook, puedes asignar un libro externo a un gráfico como su fuente de datos. Este método también se puede utilizar para actualizar una ruta al libro externo (si este ha sido trasladado).

Mientras no puedes editar los datos en libros almacenados en ubicaciones o recursos remotos, aún puedes usar tales libros como fuente de datos externa. Si se proporciona una ruta relativa para un libro externo, se convierte automáticamente en una ruta completa.

Este código Java te muestra cómo establecer un libro externo:

// Crea una instancia de la clase Presentation
Presentation pres = new Presentation("chart.pptx");
try {
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.Pie, 50, 50, 400, 600, false);
    IChartData chartData = chart.getChartData();

    chartData.setExternalWorkbook("externalWorkbook.xlsx");

    chartData.getSeries().add(chartData.getChartDataWorkbook().getCell(0, "B1"), ChartType.Pie);
    chartData.getSeries().get_Item(0).getDataPoints().addDataPointForPieSeries(chartData.getChartDataWorkbook().getCell(0, "B2"));
    chartData.getSeries().get_Item(0).getDataPoints().addDataPointForPieSeries(chartData.getChartDataWorkbook().getCell(0, "B3"));
    chartData.getSeries().get_Item(0).getDataPoints().addDataPointForPieSeries(chartData.getChartDataWorkbook().getCell(0, "B4"));

    chartData.getCategories().add(chartData.getChartDataWorkbook().getCell(0, "A2"));
    chartData.getCategories().add(chartData.getChartDataWorkbook().getCell(0, "A3"));
    chartData.getCategories().add(chartData.getChartDataWorkbook().getCell(0, "A4"));
    
    pres.save("Presentation_with_externalWorkbook.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

El parámetro ChartData (bajo el método setExternalWorkbook) se usa para especificar si se cargará o no un libro de Excel.

Cuando el valor de ChartData se establece en false, solo se actualiza la ruta del libro—los datos del gráfico no se cargarán ni se actualizarán desde el libro de destino. Puede querer usar esta configuración cuando se encuentra en una situación donde el libro de destino no existe o no está disponible.
Cuando el valor de ChartData se establece en true, los datos del gráfico se actualizan desde el libro de destino.

// Crea una instancia de la clase Presentation
Presentation pres = new Presentation("chart.pptx");
try {
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.Pie, 50, 50, 400, 600, true);
    IChartData chartData = chart.getChartData();

    ((ChartData)chartData).setExternalWorkbook("http://path/doesnt/exists", false);

    pres.save("Presentation_with_externalWorkbookWithUpdateChartData.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Obtener Ruta del Libro de Datos Externo del Gráfico

Crea una instancia de la Presentation clase.
Obtén la referencia de una diapositiva a través de su índice.
Crea un objeto para la forma del gráfico.
Crea un objeto para el tipo de fuente (ChartDataSourceType) que representa la fuente de datos del gráfico.
Especifica la condición relevante basándote en que el tipo de fuente sea el mismo que el tipo de fuente de datos del libro externo.

Este código Java demuestra la operación:

// Crea una instancia de la clase Presentation
Presentation pres = new Presentation("chart.pptx");
try {
    ISlide slide = pres.getSlides().get_Item(1);
    IChart chart = (IChart)slide.getShapes().get_Item(0);
    int sourceType = chart.getChartData().getDataSourceType();
    
    if (sourceType == ChartDataSourceType.ExternalWorkbook)
    {
        String path = chart.getChartData().getExternalWorkbookPath();
    }
	
	// Guarda la presentación
    pres.save("result.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Editar Datos del Gráfico

Puedes editar los datos en libros externos de la misma manera que haces cambios en el contenido de libros internos. Cuando un libro externo no puede ser cargado, se lanza una excepción.

Este código Java es una implementación del proceso descrito:

// Crea una instancia de la clase Presentation
Presentation pres = new Presentation("chart.pptx");
try {
    IChart chart = (IChart)pres.getSlides().get_Item(0).getShapes().get_Item(0);
    ChartData chartData = (ChartData)chart.getChartData();
    
    chartData.getSeries().get_Item(0).getDataPoints().get_Item(0).getValue().getAsCell().setValue(100);
    
    pres.save("presentation_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Formato de Gráficos Gráficos Animados