使用 PHP 在演示文稿中管理图表工作簿

本页内容简介

探索 Aspose.Slides for PHP via Java：轻松管理 PowerPoint 和 OpenDocument 格式中的图表工作簿，以简化您的演示文稿数据。

概览

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

它还涵盖了将外部工作簿用作图表数据源的操作。示例演示了如何创建并分配外部工作簿，检索链接到图表的外部工作簿路径，以及在工作簿可用时编辑图表数据。

有关代表缺失数据的工作簿单元格，请参阅控制空单元格的显示以了解空单元格与零之间的区别，以及线形图中可用显示模式的比较。

包含隐藏行列中的数据

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

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

工作表行	A: 月份	B: 零售	C: 批发（隐藏列）
2	January	10	30
3 (hidden row)	February	40	60
4	March	20	50

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

对于本示例，在更改绘图设置后刷新图表数据：使用readWorkbookStream保留嵌入的工作簿，并使用writeWorkbookStream重新加载。当包含所有单元格时，还需使用setRange恢复完整范围，包括隐藏的 February 类别。仅更改标志不足以刷新此示例缓存的图表数据和类别标签。

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

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

    $shapeCount = java_values($slide->getShapes()->size());
    if ($shapeCount > 0 && java_instanceof($slide->getShapes()->get_Item(0), new JavaClass("com.aspose.slides.IChart"))) {
        $chart = $slide->getShapes()->get_Item(0);
        $workbook = $chart->getChartData()->getChartDataWorkbook();
        echo "B2 hidden: " . (java_values($workbook->getCell(0, "B2")->isHidden()) ? "true" : "false"), PHP_EOL;
        echo "B3 hidden: " . (java_values($workbook->getCell(0, "B3")->isHidden()) ? "true" : "false"), PHP_EOL;
        echo "C2 hidden: " . (java_values($workbook->getCell(0, "C2")->isHidden()) ? "true" : "false"), PHP_EOL;

        $workbookData = $chart->getChartData()->readWorkbookStream();
        foreach ([true, false] as $visibleOnly) {
            $chart->setPlotVisibleCellsOnly($visibleOnly);

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

            $presentation->save("hidden_cells_" . ($visibleOnly ? "true" : "false") . ".pptx", SaveFormat::Pptx);
        }
    } else {
        echo "The first shape is not a chart.", PHP_EOL;
    }
} finally {
    $presentation->dispose();
}

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

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

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

检索图表的数据范围

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

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

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

use aspose\slides\Presentation;

$presentation = new Presentation("presentation.pptx");
try {
    $slideCount = java_values($presentation->getSlides()->size());
    for ($slideIndex = 0; $slideIndex < $slideCount; $slideIndex++) {
        $slide = $presentation->getSlides()->get_Item($slideIndex);
        $shapeCount = java_values($slide->getShapes()->size());
        for ($shapeIndex = 0; $shapeIndex < $shapeCount; $shapeIndex++) {
            $shape = $slide->getShapes()->get_Item($shapeIndex);
            if (java_instanceof($shape, new JavaClass("com.aspose.slides.IChart"))) {
                $chart = $shape;
                try {
                    $range = $chart->getChartData()->getRange();
                    echo $chart->getName() . ": " . $range, PHP_EOL;
                } catch (JavaException $exception) {
                    if (java_instanceof($exception, new JavaClass("com.aspose.slides.exceptions.InvalidOperationException"))) {
                        echo $chart->getName() . ": The chart does not use a workbook as its data source.", PHP_EOL;
                    } else {
                        echo $chart->getName() . ": " . $exception->getMessage(), PHP_EOL;
                    }
                }
            }
        }
    }
} finally {
    $presentation->dispose();
}

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

Aspose.Slides for PHP via Java 提供了readWorkbookStream和writeWorkbookStream 方法，允许读取和写入包含由 Aspose.Cells 编辑的图表数据的工作簿。注意，图表数据必须以相同方式组织，或结构与源相似。

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

use aspose\slides\Presentation;

$presentation = new Presentation("chart.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $shapeCount = java_values($slide->getShapes()->size());
    if ($shapeCount > 0 && java_instanceof($slide->getShapes()->get_Item(0), new JavaClass("com.aspose.slides.IChart"))) {
        $chart = $slide->getShapes()->get_Item(0);
        $chartData = $chart->getChartData();
        $workbookData = $chartData->readWorkbookStream();

        $chartData->getSeries()->clear();
        $chartData->getCategories()->clear();

        $chartData->writeWorkbookStream($workbookData);
    } else {
        echo "The first shape is not a chart.", PHP_EOL;
    }
} finally {
    $presentation->dispose();
}

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

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

use aspose\slides\Presentation;

$presentation = new Presentation("chart.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $shapeCount = java_values($slide->getShapes()->size());
    if ($shapeCount > 0 && java_instanceof($slide->getShapes()->get_Item(0), new JavaClass("com.aspose.slides.IChart"))) {
        $chart = $slide->getShapes()->get_Item(0);
        $chartData = $chart->getChartData();
        $workbookData = $chartData->readWorkbookStream();

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

        $chartData->getSeries()->clear();
        $chartData->getCategories()->clear();

        $chartData->writeWorkbookStream($workbookData);
        $chart->validateChartLayout();
    } else {
        echo "The first shape is not a chart.", PHP_EOL;
    }
} finally {
    $presentation->dispose();
}

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

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

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

数字格式仅改变显示，不改变存储的数值。格式 0.0000% 会将 0.125 显示为 12.5000%；但不会将存储的数字改为 12.5。类似地，0.00000 会将 0.1234567 显示为 0.12346，而不会对存储值进行四舍五入。如果自定义格式为空字符串（""），则使用getPresetNumberFormat 返回的格式。

以下示例创建柱形图并通过getChartDataWorkbook 访问其单元格。工作表 0 的 B2 包含转换率，C2 包含系数，两者均作为图表数值。示例还启用了链接到源格式的数值标签。

use aspose\slides\Presentation;
use aspose\slides\ChartType;
use aspose\slides\SlideSizeScaleType;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $presentation->getSlideSize()->setSize(720, 270, SlideSizeScaleType::DoNotScale);
    $slide = $presentation->getSlides()->get_Item(0);

    $chart = $slide->getShapes()->addChart(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();

    $workbook = $chart->getChartData()->getChartDataWorkbook();
    $workbook->clear(0);

    $categoryCell = $workbook->getCell(0, "A2", "Sample");
    $chart->getChartData()->getCategories()->add($categoryCell);

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

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

    for ($seriesIndex = 0; $seriesIndex < java_values($chart->getChartData()->getSeries()->size()); $seriesIndex++) {
        $series = $chart->getChartData()->getSeries()->get_Item($seriesIndex);
        $labelFormat = $series->getDataPoints()->get_Item(0)->getLabel()->getDataLabelFormat();
        $labelFormat->setShowValue(true);
        $labelFormat->setNumberFormatLinkedToSource(true);
    }

    $presentation->save("CustomCellFormats.pptx", 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 作为第一系列的前三个标签，启用来自单元格的标签，并保存已更新的演示文稿。

use aspose\slides\Presentation;
use aspose\slides\ChartType;
use aspose\slides\SaveFormat;

$presentation = new Presentation("chart2.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $chart = $slide->getShapes()->addChart(ChartType::Bubble, 50, 50, 600, 400, true);
    $series = $chart->getChartData()->getSeries()->get_Item(0);
    $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", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

管理工作表

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

use aspose\slides\Presentation;
use aspose\slides\ChartType;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $chart = $slide->getShapes()->addChart(ChartType::Pie, 50, 50, 400, 500);
    $workbook = $chart->getChartData()->getChartDataWorkbook();

    for ($i = 0; $i < java_values($workbook->getWorksheets()->size()); $i++) {
        echo $workbook->getWorksheets()->get_Item($i)->getName(), PHP_EOL;
    }
} finally {
    $presentation->dispose();
}

指定数据源类型

系列点值也可以直接存储为数值字面量。请参阅使用数值字面量设置系列值获取完整示例，该示例演示了保存和读取它们。点值的数据源类型与图表的内部或外部工作簿配置分离；使用数值字面量本身不会移除嵌入的工作簿。

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

use aspose\slides\Presentation;
use aspose\slides\ChartType;
use aspose\slides\SaveFormat;
use aspose\slides\DataSourceType;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $chart = $slide->getShapes()->addChart(ChartType::Column3D, 50, 50, 600, 400, true);
    $literalName = $chart->getChartData()->getSeries()->get_Item(0)->getName();

    $literalName->setDataSourceType(DataSourceType::StringLiterals);
    $literalName->setData("LiteralString");

    $cellName = $chart->getChartData()->getSeries()->get_Item(1)->getName();
    $nameCell = $chart->getChartData()->getChartDataWorkbook()->getCell(0, "C1", "NewCell");
    $cellName->setDataSourceType(DataSourceType::Worksheet);
    $cellName->setData($nameCell);

    $presentation->save("pres.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

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

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

use aspose\slides\Presentation;
use aspose\slides\ChartDataSourceType;
use aspose\slides\WorkbookType;

$presentation = new Presentation("sample.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $shapeCount = java_values($slide->getShapes()->size());
    for ($shapeIndex = 0; $shapeIndex < $shapeCount; $shapeIndex++) {
        $shape = $slide->getShapes()->get_Item($shapeIndex);
        if (!java_instanceof($shape, new JavaClass("com.aspose.slides.IChart"))) {
            continue;
        }

        $chart = $shape;
        $chartData = $chart->getChartData();
        $isInternalWorkbook = java_values($chartData->getDataSourceType()) == ChartDataSourceType::InternalWorkbook;
        $isBinaryMacro = java_values($chartData->getEmbeddedWorkbookType()) == WorkbookType::WorkbookBinaryMacro;

        if ($isInternalWorkbook && $isBinaryMacro) {
            echo "Skipping a chart with an unsupported .xlsb workbook.", PHP_EOL;
            continue;
        }

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

外部工作簿

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

创建外部工作簿

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

本示例创建默认数据的饼图并导出其工作簿。文件写入完成后再将外部工作簿设为图表的数据源，随后保存链接后的演示文稿。

use aspose\slides\Presentation;
use aspose\slides\ChartType;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $chart = $slide->getShapes()->addChart(ChartType::Pie, 50, 50, 400, 600);
    $workbookPath = new Java("java.io.File", "externalWorkbook1.xlsx");
    $workbookData = $chart->getChartData()->readWorkbookStream();
    try {
        $fileStream = new Java("java.io.FileOutputStream", $workbookPath);
        try {
            $fileStream->write($workbookData);
        } finally {
            $fileStream->close();
        }
        $chart->getChartData()->setExternalWorkbook($workbookPath->getAbsolutePath());
        
        $presentation->save("externalWorkbook.pptx", SaveFormat::Pptx);
    } catch (JavaException $exception) {
        echo "Could not write the external workbook: " . $exception->getMessage(), PHP_EOL;
    }
} finally {
    $presentation->dispose();
}

设置外部工作簿

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

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

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

use aspose\slides\Presentation;
use aspose\slides\ChartType;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $chart = $slide->getShapes()->addChart(ChartType::Pie, 50, 50, 400, 600, true);
    $chartData = $chart->getChartData();
    $workbookFile = new Java("java.io.File", "externalWorkbook.xlsx");
    $workbookPath = $workbookFile->getAbsolutePath();

    $chartData->setExternalWorkbook($workbookPath);
    $chartData->setRange('Sheet1!$A$1:$B$4');

    $presentation->save("Presentation_with_externalWorkbook.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

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

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

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

use aspose\slides\Presentation;
use aspose\slides\ChartType;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

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

    $presentation->save("SetExternalWorkbookWithUpdateChartData.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

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

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

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

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ChartDataSourceType;

$presentation = new Presentation("externalWorkbook.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $shapeCount = java_values($slide->getShapes()->size());
    if ($shapeCount > 0 && java_instanceof($slide->getShapes()->get_Item(0), new JavaClass("com.aspose.slides.IChart"))) {
        $chart = $slide->getShapes()->get_Item(0);
        $chartData = $chart->getChartData();
        if (java_values($chartData->getDataSourceType()) == ChartDataSourceType::ExternalWorkbook) {
            echo $chartData->getExternalWorkbookPath(), PHP_EOL;
        } else {
            echo "The chart does not use an external workbook.", PHP_EOL;
        }
    } else {
        echo "The first shape is not a chart.", PHP_EOL;
    }

    $presentation->save("Result.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

编辑图表数据

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

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

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("presentation.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $shapeCount = java_values($slide->getShapes()->size());
    if ($shapeCount > 0 && java_instanceof($slide->getShapes()->get_Item(0), new JavaClass("com.aspose.slides.IChart"))) {
        $chart = $slide->getShapes()->get_Item(0);
        $series = $chart->getChartData()->getSeries();
        if (java_values($series->size()) > 0 && java_values($series->get_Item(0)->getDataPoints()->size()) > 0) {
            $valueCell = $series->get_Item(0)->getDataPoints()->get_Item(0)->getValue()->getAsCell();
            if (!java_is_null($valueCell)) {
                $valueCell->setValue(100);
                $presentation->save("presentation_out.pptx", SaveFormat::Pptx);
            } else {
                echo "The first data point is not linked to a workbook cell.", PHP_EOL;
            }
        } else {
            echo "The chart has no data points to edit.", PHP_EOL;
        }
    } else {
        echo "The first shape is not a chart.", PHP_EOL;
    }
} finally {
    $presentation->dispose();
}

从图表缓存恢复工作簿

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

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

use aspose\slides\Presentation;
use aspose\slides\SpreadsheetOptions;
use aspose\slides\LoadOptions;

$spreadsheetOptions = new SpreadsheetOptions();
$spreadsheetOptions->setRecoverWorkbookFromChartCache(true);

$loadOptions = new LoadOptions();
$loadOptions->setSpreadsheetOptions($spreadsheetOptions);

$presentation = new Presentation("presentation.pptx", $loadOptions);
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $shapeCount = java_values($slide->getShapes()->size());
    if ($shapeCount > 0 && java_instanceof($slide->getShapes()->get_Item(0), new JavaClass("com.aspose.slides.IChart"))) {
        $chart = $slide->getShapes()->get_Item(0);
        $recoveredWorkbook = $chart->getChartData()->getChartDataWorkbook();

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

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

常见问题解答

我能判断特定图表是链接到外部工作簿还是嵌入工作簿吗？

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

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

支持。若指定相对路径，系统会自动转换为绝对路径。演示文稿在 PPTX 文件中保存绝对路径，移动工作簿可能需要更新链接。

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

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

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

演示文稿仅存储外部文件的链接。编辑基于单元格的图表数据也可能更新链接的本地 XLSX 文件。若原始文件必须保持不变，请使用工作簿的副本。

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

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

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

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