使用 JavaScript 管理簡報中的圖表工作簿

本頁內容簡介

探索 Aspose.Slides for Node.js 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 類別。僅變更旗標不足以重新整理此範例快取的圖表資料與類別標籤。範例在傳遞給寫入方法前，先將 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();
}

此範例會儲存兩個版本的簡報：一個僅保留可見的零售值 (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%。請參閱圖表資料標籤以取得直接標籤格式化的說明。

下圖為重新開啟簡報後的渲染結果：

具有來源連結標籤（顯示 12.5000% 與 0.12346）以及獨立格式化數值坐標軸的直條圖。

將工作簿儲存格作為圖表資料標籤

您可以使用工作簿儲存格中的文字作為圖表資料標籤。

此範例在現有簡報的第一張投影片加入一個預設資料的氣泡圖，使用工作表 0 的儲存格 A10:A12 作為第一系列前 3 個標籤，啟用來自儲存格的標籤，並儲存更新後的簡報。

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 時，圖表資料會從目標工作簿更新。

以下範例將 updateChartData 設為 false，指派一個佔位 URL。它保留圓餅圖的預設資料，且在未載入無法取得的工作簿時仍能儲存簡報。

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 會拋出例外。僅在接受使用快取圖表資料作為可接受的退回方案時才啟用還原，因為快取可能不包含外部工作簿在最後一次更新簡報後所做的變更。

常見問題集

我能否判斷特定圖表是連結至外部工作簿還是內嵌工作簿？

可以。圖表具有資料來源類型與外部工作簿路徑。若來源是外部工作簿，您可以讀取完整路徑以確認使用的是外部檔案。

是否支援外部工作簿的相對路徑？它們如何儲存？

支援。若您指定相對路徑，系統會自動轉換為絕對路徑。簡報會在 PPTX 檔案中儲存絕對路徑，因而搬移工作簿時可能需要更新連結。

我可以使用位於網路資源或共用資料夾的工作簿嗎？

可以，這類工作簿可作為外部資料來源使用。但 Aspose.Slides 不支援直接編輯遠端工作簿——它們只能作為來源使用。

儲存簡報時，Aspose.Slides 會覆寫外部 XLSX 嗎？

簡報會儲存對外部檔案的連結。編輯基於儲存格的圖表資料也可能會更新已連結的本機 XLSX 檔案。如需保護原始工作簿，請使用其副本。

如果外部檔案受密碼保護，我該怎麼辦？

Aspose.Slides 在連結時不接受密碼。常見做法是事先移除保護，或先使用 Aspose.Cells 產生已解密的副本，再連結至該副本。

多個圖表可以參考同一個外部工作簿嗎？

可以。每個圖表都會儲存自己的連結。若它們皆指向相同檔案，更新該檔案後，下次載入資料時所有圖表皆會反映變更。

在 JavaScript 中格式化簡報圖表動畫化 PowerPoint 圖表於 JavaScript