在 Android 上管理簡報中的圖表工作簿

本頁內容簡介

透過 Java 探索適用於 Android 的 Aspose.Slides：輕鬆管理 PowerPoint 與 OpenDocument 格式的圖表工作簿，簡化您的簡報資料。

概觀

本文說明如何在 Aspose.Slides 中使用圖表工作簿。它展示了如何透過工作簿串流讀寫圖表資料、將工作簿儲存格作為圖表資料標籤、存取工作表集合，以及為圖表值指定資料來源類型。

此外，本文亦涵蓋使用外部工作簿作為圖表資料來源的情況。範例示範了如何建立與指派外部工作簿、取得連結至圖表的外部工作簿路徑，以及在工作簿可用時編輯圖表資料。

從工作簿讀寫圖表資料

Aspose.Slides 提供 ReadWorkbookStream 與 WriteWorkbookStream 方法，讓您能讀寫圖表資料工作簿（包含使用 Aspose.Cells 編輯的圖表資料）。Note 圖表資料必須以相同方式組織，或具有與來源相似的結構。

此 Java 程式碼示範一個範例操作：

import com.aspose.slides.*;

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();
}

在工作簿修改後驗證圖表版面配置

當您以已修改的工作簿取代嵌入式工作簿時，圖表仍保留原始的系列與類別集合。此不匹配可能導致 IChart.validateChartLayout 因索引超出範圍錯誤而失敗。在將更新的工作簿寫回圖表之前，請先清除現有的系列與類別。

// 在修改工作簿串流後（例如使用 Aspose.Cells）
byte[] updatedWorkbook = chartData.readWorkbookStream();

// 清除現有的資料參考。
chartData.getSeries().clear();
chartData.getCategories().clear();

chartData.writeWorkbookStream(updatedWorkbook);

chart.validateChartLayout();

清除集合可確保圖表資料結構與新工作簿一致，讓 validateChartLayout 能順利完成，且不會產生錯誤。

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

建立 Presentation 類別的實例。
透過索引取得投影片的參考。
加入一個含有資料的氣泡圖表。
存取圖表系列。
將工作簿儲存格設定為資料標籤。
儲存簡報。

此 Java 程式碼說明如何將工作簿儲存格設定為圖表資料標籤：

import com.aspose.slides.*;

String lbl0 = "Label 0 cell value";
String lbl1 = "Label 1 cell value";
String lbl2 = "Label 2 cell value";

// 實例化一個代表簡報檔案的簡報類別
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();
}

管理工作表

此 Java 程式碼示範使用 IChartDataWorkbook.Worksheets 方法存取工作表集合的操作：

import com.aspose.slides.*;

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();
}

指定資料來源類型

此 Java 程式碼說明如何為資料來源指定類型：

import com.aspose.slides.*;

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("LiteralString");

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

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

偵測不受支援的嵌入式工作簿格式

Aspose.Slides 不支援某些圖表可能嵌入的 Excel 二進位工作簿（.xlsb）格式。您可以使用 getEmbeddedWorkbookType 方法於 IChartData 搭配 WorkbookType 列舉，偵測不受支援的格式並跳過這些圖表。

import com.aspose.slides.*;

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

    for (IShape shape : slide.getShapes()) {
        if (!(shape instanceof IChart)) continue;

        IChart chart = (IChart)shape;
        IChartData chartData = chart.getChartData();

        if (chartData.getDataSourceType() == ChartDataSourceType.InternalWorkbook &&
                chartData.getEmbeddedWorkbookType() == WorkbookType.WorkbookBinaryMacro) {
            // 嵌入式工作簿為 .xlsb 格式，該格式不受支援。
            continue;
        }

        // 在此讀取或修改圖表工作簿資料。
    }
} finally {
    presentation.dispose();
}

外部工作簿

Aspose.Slides 支援將外部工作簿作為圖表的資料來源。

建立外部工作簿

使用 readWorkbookStream 與 setExternalWorkbook 方法，您可以從頭建立外部工作簿，或將內部工作簿轉為外部工作簿。

此 Java 程式碼示範外部工作簿的建立流程：

import com.aspose.slides.*;
import java.io.FileOutputStream;
import java.io.IOException;

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();
}

設定外部工作簿

使用 setExternalWorkbook 方法，您可以將外部工作簿指派給圖表作為資料來源。此方法亦可用於更新外部工作簿的路徑（若其已被移動）。

雖然無法編輯儲存在遠端位置或資源中的工作簿資料，但仍可將此類工作簿作為外部資料來源使用。若提供相對路徑，系統會自動轉換為完整路徑。

此 Java 程式碼說明如何設定外部工作簿：

import com.aspose.slides.*;

// 建立 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();
}

updateChartData 參數（位於 setExternalWorkbook 方法下）用於指定是否載入 Excel 工作簿。

當 updateChartData 值設為 false 時，僅會更新工作簿路徑——圖表資料不會從目標工作簿載入或更新。若目標工作簿不存在或無法取得，您可使用此設定。
當 updateChartData 值設為 true 時，圖表資料會從目標工作簿更新。

import com.aspose.slides.*;

// 建立 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();
}

取得圖表外部資料來源工作簿路徑

建立 Presentation 類別的實例。
透過索引取得投影片的參考。
建立圖表形狀的物件。
建立表示圖表資料來源的來源類型（ChartDataSourceType）物件。
依據來源類型與外部工作簿資料來源類型相同的條件，指定相關條件。

此 Java 程式碼示範此操作：

import com.aspose.slides.*;

// 建立 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();
    }
    
    // 儲存簡報
    pres.save("result.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

編輯圖表資料

您可以像編輯內部工作簿內容一樣編輯外部工作簿的資料。若無法載入外部工作簿，將拋出例外。

此 Java 程式碼實作上述流程：

import com.aspose.slides.*;

// 建立 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();
}

從圖表快取還原工作簿

若圖表使用的外部工作簿遺失或無法取得，Aspose.Slides 可從簡報中快取的資料重建圖表工作簿。建立 LoadOptions，以 SpreadsheetOptions 進行設定，然後在開啟簡報前呼叫 ISpreadsheetOptions.setRecoverWorkbookFromChartCache 並傳入 true。

以下 Java 範例開啟一個圖表參照不可用外部工作簿的簡報，並透過 IChart.getChartData 與 IChartData.getChartDataWorkbook 取得復原的資料：

import com.aspose.slides.*;

SpreadsheetOptions spreadsheetOptions = new SpreadsheetOptions();
spreadsheetOptions.setRecoverWorkbookFromChartCache(true);

LoadOptions loadOptions = new LoadOptions();
loadOptions.setSpreadsheetOptions(spreadsheetOptions);

Presentation presentation = new Presentation("presentation.pptx", loadOptions);
try {
    IChart chart = (IChart)presentation.getSlides().get_Item(0).getShapes().get_Item(0);
    IChartDataWorkbook recoveredWorkbook = chart.getChartData().getChartDataWorkbook();

    // 在此讀取或修改已復原的工作簿資料。
} finally {
    presentation.dispose();
}

如果外部工作簿不可用且未啟用復原，Aspose.Slides 會拋出例外。僅在接受使用快取圖表資料作為可行備援時才啟用復原，因為快取可能不包含簡報最後一次更新後對外部工作簿所做的變更。

常見問題

我可以判斷特定圖表是連結至外部工作簿還是嵌入式工作簿嗎？

可以。圖表具有 data source type 與 path to an external workbook；若來源是外部工作簿，您可以讀取完整路徑以確認使用的是外部檔案。

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

支援。若指定相對路徑，系統會自動轉換為絕對路徑。這對專案可移植性很方便；但請注意，簡報會在 PPTX 檔案中儲存絕對路徑。

我可以使用位於網路資源/共享的工作簿嗎？

可以，此類工作簿可作為外部資料來源使用。然而，直接從 Aspose.Slides 編輯遠端工作簿並未受支援——只能用作來源。

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

不會。簡報僅儲存指向外部檔案的連結，並在讀取資料時使用該連結。外部檔案本身在儲存簡報時不會被修改。

若外部檔案受密碼保護，我該怎麼做？

Aspose.Slides 在連結時不接受密碼。常見的做法是事先移除保護或先準備一個已解密的副本（例如使用 Aspose.Cells），再連結至該副本。

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

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

在 Android 上格式化簡報圖表在 Android 上為 PowerPoint 圖表製作動畫