使用 JavaScript 管理演示文稿中的图表工作簿

本页内容简介

发现适用于 Node.js via Java 的 Aspose.Slides：轻松在 PowerPoint 和 OpenDocument 格式中管理图表工作簿，以简化您的演示文稿数据。

概述

本文说明了如何在 Aspose.Slides 中使用图表工作簿。它展示了如何通过工作簿流读取和写入图表数据、将工作簿单元格用作图表数据标签、访问工作表集合以及为图表数值指定数据源类型。

它还涵盖了将外部工作簿用作图表数据源的使用方法。示例演示了如何创建和分配外部工作簿、获取链接到图表的外部工作簿的路径，以及在工作簿可用时编辑图表数据。

对于表示缺失数据的工作簿单元格，请参阅控制空单元格的显示 ，了解空单元格与零的区别，以及可用显示模式的折线图比较。

包含隐藏行和列的数据

使用Chart.setPlotVisibleCellsOnly来控制图表是否绘制隐藏工作表行和列中的数据。将其设为 true 只绘制可见单元格，设为 false 则同时包含可见和隐藏单元格。此设置仅控制图表绘制；它不会隐藏或显示工作表的行或列。

示例演示文稿(sample presentation)的第一张幻灯片第一形状是柱形图。嵌入的工作表 Sheet1 包含以下源范围 A1:C4。第 3 行和 C 列被隐藏，但其单元格仍然包含数值。

工作表行	A: 月份	B: 零售	C: 批发（隐藏列）
2	一月	10	30
3（隐藏行）	二月	40	60
4	三月	20	50

通过ChartData.getChartDataWorkbook访问源单元格，并读取ChartDataCell.isHidden以检查其隐藏状态。此方法报告隐藏状态而不更改它。在此示例中，B2 可见，B3 属于隐藏行，C2 属于隐藏列；示例分别打印 false、true 和 true。

对于本示例，在更改绘图设置后需要刷新图表数据：使用readWorkbookStream保留嵌入的工作簿，并使用writeWorkbookStream重新加载它。要包含所有单元格，还需要使用setRange恢复完整范围，包括隐藏的二月类别。仅更改标志不足以刷新此示例的缓存图表数据和类别标签。示例在传递给写入方法之前，将返回的 Node.js 缓冲区转换为 Java 字节数组。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("hidden-source-data.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);

    const shapeCount = slide.getShapes().size();
    if (shapeCount > 0 && java.instanceOf(slide.getShapes().get_Item(0), "com.aspose.slides.IChart")) {
        const chart = slide.getShapes().get_Item(0);
        const workbook = chart.getChartData().getChartDataWorkbook();
        console.log("B2 hidden: " + workbook.getCell(0, "B2").isHidden());
        console.log("B3 hidden: " + workbook.getCell(0, "B3").isHidden());
        console.log("C2 hidden: " + workbook.getCell(0, "C2").isHidden());

        const workbookBuffer = chart.getChartData().readWorkbookStream();
        const workbookBytes = Array.from(workbookBuffer);
        const workbookData = java.newArray("byte", workbookBytes);
        for (const visibleOnly of [true, false]) {
            chart.setPlotVisibleCellsOnly(visibleOnly);

            // 刷新来自嵌入工作簿的图表数据。
            chart.getChartData().writeWorkbookStream(workbookData);
            if (!visibleOnly) {
                // 恢复完整的源范围，包括隐藏的类别。
                chart.getChartData().setRange("Sheet1!$A$1:$C$4");
            }

            presentation.save("hidden_cells_" + visibleOnly + ".pptx", aspose.slides.SaveFormat.Pptx);
        }
    } else {
        console.log("The first shape is not a chart.");
    }
} finally {
    presentation.dispose();
}

示例保存了演示文稿的两个版本：一个仅包含可见的 Retail 值（10 和 20），另一个包含全部六个值。以下图片展示了两种绘图模式。第 3 行和 C 列在两个嵌入工作簿中仍保持隐藏。

仅可见单元格 (true)	所有单元格 (false)

包含数值的隐藏单元格不同于空单元格。Chart.setDisplayBlanksAs 控制缺失值的显示方式；它并不包含或排除隐藏的源数据。请参阅控制空单元格的显示获取示例。

检索图表的数据范围

在更新现有演示文稿中的工作簿数据之前，先检查源范围，以确定每个图表使用了哪些工作表单元格。ChartData.getRange 方法返回当前数据范围的工作表限定公式，例如 Sheet1!$A$1:$D$5。其中，Sheet1 是工作表名称，! 将其与单元格范围分隔，$A$1:$D$5 标识包括 A1 到 D5 的单元格。美元符号表示绝对行列引用。

该方法读取当前范围且不更改图表或其工作簿。如果图表未使用工作簿作为数据源，它会抛出 InvalidOperationException。欲了解更多信息，请参阅ChartData API 参考。

此示例打开演示文稿并在每张幻灯片上直接检查形状是否为图表。它打印每个图表的名称和源范围。如果图表未使用工作簿，它会打印一条消息并继续处理下一个图表。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    for (let slideIndex = 0; slideIndex < presentation.getSlides().size(); slideIndex++) {
        const slide = presentation.getSlides().get_Item(slideIndex);
        for (let shapeIndex = 0; shapeIndex < slide.getShapes().size(); shapeIndex++) {
            const shape = slide.getShapes().get_Item(shapeIndex);
            if (java.instanceOf(shape, "com.aspose.slides.IChart")) {
                const chart = shape;
                try {
                    const range = chart.getChartData().getRange();
                    console.log(chart.getName() + ": " + range);
                } catch (exception) {
                    if (exception.cause && java.instanceOf(exception.cause, "com.aspose.slides.exceptions.InvalidOperationException")) {
                        console.log(chart.getName() + ": The chart does not use a workbook as its data source.");
                    } else {
                        console.log(chart.getName() + ": Could not retrieve the data range: " + exception.message);
                    }
                }
            }
        }
    }
} finally {
    presentation.dispose();
}

从工作簿读取和写入图表数据

Aspose.Slides for Node.js via Java 提供了readWorkbookStream和writeWorkbookStream方法，允许您读取和写入图表数据工作簿（包含使用 Aspose.Cells 编辑的图表数据）。注意，图表数据必须以相同的方式组织，或具有类似于源的结构。

此示例使用一个演示文稿，其第一张幻灯片的第一形状是图表。它将嵌入的工作簿读取为字节数组，清除已有的系列和类别，然后将同一工作簿写回。更改仅保留在内存中；示例未保存演示文稿。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("chart.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);

    const shapeCount = slide.getShapes().size();
    if (shapeCount > 0 && java.instanceOf(slide.getShapes().get_Item(0), "com.aspose.slides.IChart")) {
        const chart = slide.getShapes().get_Item(0);
        const chartData = chart.getChartData();
        const workbookBuffer = chartData.readWorkbookStream();
        const workbookBytes = Array.from(workbookBuffer);
        const workbookData = java.newArray("byte", workbookBytes);

        chartData.getSeries().clear();
        chartData.getCategories().clear();

        chartData.writeWorkbookStream(workbookData);
    } else {
        console.log("The first shape is not a chart.");
    }
} finally {
    presentation.dispose();
}

在修改工作簿后验证图表布局

当您用已修改的工作簿替换嵌入的工作簿时，图表仍保留原始的系列和类别集合。这种不匹配可能导致Chart.validateChartLayout因索引超出范围错误而失败。在将更新后的工作簿写回图表之前，先清除现有的系列和类别。此示例使用第一张幻灯片的第一形状图表。注释标记了工作簿编辑所在位置；可运行的示例将原始工作簿写回并在内存中验证布局。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("chart.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);

    const shapeCount = slide.getShapes().size();
    if (shapeCount > 0 && java.instanceOf(slide.getShapes().get_Item(0), "com.aspose.slides.IChart")) {
        const chart = slide.getShapes().get_Item(0);
        const chartData = chart.getChartData();
        const workbookBuffer = chartData.readWorkbookStream();
        const workbookBytes = Array.from(workbookBuffer);
        const workbookData = java.newArray("byte", workbookBytes);

        // 在此修改工作簿字节，例如使用 Aspose.Cells.

        chartData.getSeries().clear();
        chartData.getCategories().clear();

        chartData.writeWorkbookStream(workbookData);
        chart.validateChartLayout();
    } else {
        console.log("The first shape is not a chart.");
    }
} finally {
    presentation.dispose();
}

在写回工作簿之前清除集合可移除陈旧的数据引用。使用图表前，请为更新的工作簿重新构建所需的系列和类别映射。

为工作簿单元格设置自定义数字格式

使用ChartDataCell.setCustomNumberFormat来控制数字值在图表嵌入工作簿中的显示方式。例如，报告可能需要将转化率显示为保留四位小数的百分比，将系数显示为保留五位小数。请保持两个值为数值类型，以便进行计算和图表绘制。

数字格式仅改变显示方式，而不改变存储的数值。格式 0.0000% 会把 0.125 显示为 12.5000%；它并不会将存储的数字替换为 12.5。同理，0.00000 会把 0.1234567 显示为 0.12346，但不会对存储的值进行四舍五入。如果自定义格式为空字符串 ("") ，则使用getPresetNumberFormat返回的格式。

下面的示例创建一个柱形图，并通过getChartDataWorkbook访问其单元格。在工作表 0 中，B2 包含转化率，C2 包含系数。这两个单元格提供图表数值。示例还启用了链接到源格式的数值标签。

const aspose = { slides: require("aspose.slides.via.java") };

const presentation = new aspose.slides.Presentation();
try {
    presentation.getSlideSize().setSize(720, 270, aspose.slides.SlideSizeScaleType.DoNotScale);
    const slide = presentation.getSlides().get_Item(0);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 50, 20, 620, 210);
    chart.setTitle(false);

    chart.getAxes().getVerticalAxis().setNumberFormatLinkedToSource(false);
    chart.getAxes().getVerticalAxis().setNumberFormat("0.00");
    chart.getAxes().getVerticalAxis().setAutomaticMinValue(false);
    chart.getAxes().getVerticalAxis().setMinValue(0);

    chart.getChartData().getSeries().clear();
    chart.getChartData().getCategories().clear();

    const workbook = chart.getChartData().getChartDataWorkbook();
    workbook.clear(0);

    const categoryCell = workbook.getCell(0, "A2", "Sample");
    chart.getChartData().getCategories().add(categoryCell);

    const percentageCell = workbook.getCell(0, "B2", 0.125);
    percentageCell.setCustomNumberFormat("0.0000%");
    const percentageName = workbook.getCell(0, "B1", "Conversion rate");
    const percentageSeries = chart.getChartData().getSeries().add(percentageName, chart.getType());
    percentageSeries.getDataPoints().addDataPointForBarSeries(percentageCell);

    const precisionCell = workbook.getCell(0, "C2", 0.1234567);
    precisionCell.setCustomNumberFormat("0.00000");
    const precisionName = workbook.getCell(0, "C1", "Coefficient");
    const precisionSeries = chart.getChartData().getSeries().add(precisionName, chart.getType());
    precisionSeries.getDataPoints().addDataPointForBarSeries(precisionCell);

    for (let seriesIndex = 0; seriesIndex < chart.getChartData().getSeries().size(); seriesIndex++) {
        const series = chart.getChartData().getSeries().get_Item(seriesIndex);
        const labelFormat = series.getDataPoints().get_Item(0).getLabel().getDataLabelFormat();
        labelFormat.setShowValue(true);
        labelFormat.setNumberFormatLinkedToSource(true);
    }

    presentation.save("CustomCellFormats.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

工作簿单元格的格式与直接在图表坐标轴或数据标签上设置的格式相互独立。在本示例中，由于setShowValue 被设为 true，且setNumberFormatLinkedToSource 也设为 true，每个标签均显示其源单元格的数值。保存并重新打开演示文稿后，标签显示为 12.5000% 和 0.12346，如下所示。纵坐标轴使用自身的数字格式，通过setNumberFormat 设置为 0.00，且setNumberFormatLinkedToSource 设为 false。

若要独立地格式化数据标签，将其源链接标志设为 false 并使用setNumberFormat分配格式。这不会更改工作簿单元格的格式。例如，使用 0.00 的独立标签格式会将第一个数值显示为 0.13，而 B2 仍显示 12.5000%。请参阅图表数据标签了解直接标签格式化。

下面的图像是重新打开保存的演示文稿后渲染的：

将工作簿单元格设为图表数据标签

您可以使用工作簿单元格中的文本作为图表数据标签。

此示例向现有演示文稿的第一张幻灯片添加一个默认数据的气泡图。它使用工作表 0 上的单元格 A10:A12 作为第一系列的前三个标签，启用来自单元格的标签，并保存更新后的演示文稿。

const aspose = { slides: require("aspose.slides.via.java") };

const presentation = new aspose.slides.Presentation("chart2.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.Bubble, 50, 50, 600, 400, true);
    const series = chart.getChartData().getSeries().get_Item(0);
    const workbook = chart.getChartData().getChartDataWorkbook();

    series.getLabels().getDefaultDataLabelFormat().setShowLabelValueFromCell(true);
    series.getLabels().get_Item(0).setValueFromCell(workbook.getCell(0, "A10", "Label 0 cell value"));
    series.getLabels().get_Item(1).setValueFromCell(workbook.getCell(0, "A11", "Label 1 cell value"));
    series.getLabels().get_Item(2).setValueFromCell(workbook.getCell(0, "A12", "Label 2 cell value"));

    presentation.save("resultchart.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

管理工作表

ChartDataWorkbook.getWorksheets 方法提供对图表工作簿中工作表的访问。本示例创建一个默认数据的饼图，并将每个工作表名称打印到控制台。

const aspose = { slides: require("aspose.slides.via.java") };

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.Pie, 50, 50, 400, 500);
    const workbook = chart.getChartData().getChartDataWorkbook();

    for (let i = 0; i < workbook.getWorksheets().size(); i++) {
        console.log(workbook.getWorksheets().get_Item(i).getName());
    }
} finally {
    presentation.dispose();
}

指定数据源类型

系列点值也可以直接存储为数值文字。请参阅使用数值文字设置系列值获取完整的保存和读取示例。点值的数据源类型与图表的内部或外部工作簿配置相互独立；仅使用数值文字并不会移除嵌入的工作簿。

此示例创建一个默认数据的 3D 柱形图，并使用不同的数据源为两个系列设置名称。第一个名称使用字符串文字；第二个使用工作表 0 上的单元格 C1。DataSourceType 枚举用于为每个名称选择数据源。示例将演示文稿保存为更新后的系列名称。

const aspose = { slides: require("aspose.slides.via.java") };

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.Column3D, 50, 50, 600, 400, true);
    const literalName = chart.getChartData().getSeries().get_Item(0).getName();

    literalName.setDataSourceType(aspose.slides.DataSourceType.StringLiterals);
    literalName.setData("LiteralString");

    const cellName = chart.getChartData().getSeries().get_Item(1).getName();
    const nameCell = chart.getChartData().getChartDataWorkbook().getCell(0, "C1", "NewCell");
    cellName.setDataSourceType(aspose.slides.DataSourceType.Worksheet);
    cellName.setData(nameCell);

    presentation.save("pres.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

检测不受支持的嵌入工作簿格式

Aspose.Slides 不支持某些图表中可能嵌入的 Excel 二进制工作簿（.xlsb）格式。您可以在ChartData 上使用 getEmbeddedWorkbookType 方法并结合WorkbookType 枚举来检测不受支持的格式并跳过这些图表。此示例检查现有演示文稿第一张幻灯片的形状，跳过非图表形状，并为每个嵌入 .xlsb 工作簿的图表打印诊断信息。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("sample.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);

    for (let shapeIndex = 0; shapeIndex < slide.getShapes().size(); shapeIndex++) {
        const shape = slide.getShapes().get_Item(shapeIndex);
        if (!(java.instanceOf(shape, "com.aspose.slides.IChart"))) {
            continue;
        }

        const chart = shape;
        const chartData = chart.getChartData();
        const isInternalWorkbook = chartData.getDataSourceType() == aspose.slides.ChartDataSourceType.InternalWorkbook;
        const isBinaryMacro = chartData.getEmbeddedWorkbookType() == aspose.slides.WorkbookType.WorkbookBinaryMacro;

        if (isInternalWorkbook && isBinaryMacro) {
            console.log("Skipping a chart with an unsupported .xlsb workbook.");
            continue;
        }

        // 在此读取或修改受支持的图表工作簿数据。
    }
} finally {
    presentation.dispose();
}

外部工作簿

Aspose.Slides 支持使用外部工作簿作为图表的数据源。

创建外部工作簿

使用readWorkbookStream和setExternalWorkbook将嵌入的图表工作簿导出为文件，并将图表链接到该外部工作簿。

此示例创建一个默认数据的饼图并导出其工作簿。它在将外部工作簿指定为图表数据源之前完成文件写入，然后保存已链接的演示文稿。

const aspose = { slides: require("aspose.slides.via.java") };
const path = require("path");
const fileSystem = require("fs");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.Pie, 50, 50, 400, 600);
    const workbookPath = path.resolve("externalWorkbook1.xlsx");
    const workbookData = chart.getChartData().readWorkbookStream();
    try {
        fileSystem.writeFileSync(workbookPath, Buffer.from(workbookData));
        chart.getChartData().setExternalWorkbook(workbookPath);
        
        presentation.save("externalWorkbook.pptx", aspose.slides.SaveFormat.Pptx);
    } catch (exception) {
        console.log("Could not write the external workbook: " + exception.message);
    }
} finally {
    presentation.dispose();
}

设置外部工作簿

使用setExternalWorkbook方法，您可以为图表分配外部工作簿作为数据源。该方法也可用于更新外部工作簿的路径（如果工作簿已移动）。

虽然无法编辑存放在远程位置或资源中的工作簿数据，但仍可将此类工作簿用作外部数据源。如果提供了外部工作簿的相对路径，它会自动转换为完整路径。

此示例使用一个外部工作簿，其名为 Sheet1 的工作表在 B1 中包含系列名称，在 A2:A4 中包含类别名称，在 B2:B4 中包含数值。示例创建一个饼图，链接该工作簿，并使用setRange将 A1:B4 映射为一个系列和三个类别。它将带有链接图表的演示文稿保存。

const aspose = { slides: require("aspose.slides.via.java") };
const path = require("path");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.Pie, 50, 50, 400, 600, true);
    const chartData = chart.getChartData();
    const workbookPath = path.resolve("externalWorkbook.xlsx");

    chartData.setExternalWorkbook(workbookPath);
    chartData.setRange("Sheet1!$A$1:$B$4");

    presentation.save("Presentation_with_externalWorkbook.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

setExternalWorkbook 的 updateChartData 参数控制是否加载工作簿。

• 当 updateChartData 为 false 时，仅更新工作簿路径。图表数据不会从目标工作簿加载或更新，因此工作簿可以不可用。
• 当 updateChartData 为 true 时，图表数据会从目标工作簿更新。

以下示例将占位符 URL 分配给 updateChartData 为 false 的情况。它保留饼图的默认数据，并在不加载不可用工作簿的情况下保存演示文稿。

const aspose = { slides: require("aspose.slides.via.java") };

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.Pie, 50, 50, 400, 600, true);
    chart.getChartData().setExternalWorkbook("https://example.com/unavailable-workbook.xlsx", false);

    presentation.save("SetExternalWorkbookWithUpdateChartData.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

获取图表的外部数据源工作簿路径

要识别链接到图表的工作簿，请检查图表是否使用外部数据源并获取其工作簿路径。

此示例检查包含已链接外部工作簿的演示文稿第一张幻灯片的第一个形状。如果它是链接到外部工作簿的图表，示例会将getExternalWorkbookPath打印到控制台。随后保存演示文稿的副本。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("externalWorkbook.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);

    if (slide.getShapes().size() > 0 && java.instanceOf(slide.getShapes().get_Item(0), "com.aspose.slides.IChart")) {
        const chart = slide.getShapes().get_Item(0);
        const chartData = chart.getChartData();
        if (chartData.getDataSourceType() == aspose.slides.ChartDataSourceType.ExternalWorkbook) {
            console.log(chartData.getExternalWorkbookPath());
        } else {
            console.log("The chart does not use an external workbook.");
        }
    } else {
        console.log("The first shape is not a chart.");
    }

    presentation.save("Result.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

编辑图表数据

您可以像编辑内部工作簿内容一样编辑外部工作簿中的数据。当外部工作簿无法加载时，会抛出异常。

此示例使用第一张幻灯片的第一个形状——一个链接到可访问外部工作簿的图表。它将第一系列第一个数据点的单元格值设为 100，并保存更新后的演示文稿。编辑单元格值可能会更新链接的外部 XLSX 文件，因此如果需要保留原始工作簿，请使用副本。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);

    const shapeCount = slide.getShapes().size();
    if (shapeCount > 0 && java.instanceOf(slide.getShapes().get_Item(0), "com.aspose.slides.IChart")) {
        const chart = slide.getShapes().get_Item(0);
        const series = chart.getChartData().getSeries();
        if (series.size() > 0 && series.get_Item(0).getDataPoints().size() > 0) {
            const valueCell = series.get_Item(0).getDataPoints().get_Item(0).getValue().getAsCell();
            if (valueCell != null) {
                valueCell.setValue(100);
                presentation.save("presentation_out.pptx", aspose.slides.SaveFormat.Pptx);
            } else {
                console.log("The first data point is not linked to a workbook cell.");
            }
        } else {
            console.log("The chart has no data points to edit.");
        }
    } else {
        console.log("The first shape is not a chart.");
    }
} finally {
    presentation.dispose();
}

从图表缓存恢复工作簿

如果图表使用的外部工作簿缺失或不可用，Aspose.Slides 可以从演示文稿中缓存的数据重建图表工作簿。打开演示文稿前，创建LoadOptions，调用LoadOptions.setSpreadsheetOptions，并将SpreadsheetOptions.setRecoverWorkbookFromChartCache 设置为 true。

下面的 JavaScript 示例恢复了第一张幻灯片第一个形状的图表（引用不可用外部工作簿）的工作簿数据。它通过Chart.getChartData和ChartData.getChartDataWorkbook访问恢复的数据：

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const spreadsheetOptions = new aspose.slides.SpreadsheetOptions();
spreadsheetOptions.setRecoverWorkbookFromChartCache(true);

const loadOptions = new aspose.slides.LoadOptions();
loadOptions.setSpreadsheetOptions(spreadsheetOptions);

const presentation = new aspose.slides.Presentation("presentation.pptx", loadOptions);
try {
    const slide = presentation.getSlides().get_Item(0);

    const shapeCount = slide.getShapes().size();
    if (shapeCount > 0 && java.instanceOf(slide.getShapes().get_Item(0), "com.aspose.slides.IChart")) {
        const chart = slide.getShapes().get_Item(0);
        const recoveredWorkbook = chart.getChartData().getChartDataWorkbook();

        // 在此读取或修改恢复的工作簿数据。
    } else {
        console.log("The first shape is not a chart.");
    }
} finally {
    presentation.dispose();
}

如果外部工作簿不可用且未启用恢复，Aspose.Slides 将抛出异常。仅在使用缓存的图表数据是可接受的后备方案时才启用恢复，因为缓存可能不包含演示文稿上次更新后对外部工作簿所做的更改。

常见问题

我能否确定特定图表是链接到外部工作簿还是嵌入工作簿？

可以。图表具有 data source type 和一个指向外部工作簿的 path to an external workbook；如果源是外部工作簿，您可以读取完整路径以确认正在使用外部文件。

是否支持外部工作簿的相对路径？它们如何存储？

是的。如果指定相对路径，系统会自动转换为绝对路径。演示文稿在 PPTX 文件中存储绝对路径，因此移动工作簿可能需要更新链接。

我能使用位于网络资源/共享上的工作簿吗？

可以，这类工作簿可用作外部数据源。但 Aspose.Slides 不支持直接编辑远程工作簿——它们只能作为数据源使用。

保存演示文稿时，Aspose.Slides 会覆盖外部 XLSX 吗？

演示文稿存储了一个指向外部文件的 link to the external file。编辑基于单元格的图表数据也可能会更新链接的本地 XLSX 文件。如果必须保持原始文件不变，请使用工作簿的副本。

如果外部文件受密码保护，我该怎么办？

Aspose.Slides 在链接时不接受密码。常见做法是事先移除保护或准备一个已解密的副本（例如使用 Aspose.Cells），并链接到该副本。

多个图表可以引用同一个外部工作簿吗？

可以。每个图表都存储自己的链接。如果它们都指向同一文件，则更新该文件后，下次加载数据时所有图表都会反映出更改。