Java를 사용하여 프레젠테이션에서 차트 워크북 관리

이 페이지의 내용

Aspose.Slides for Java를 소개합니다: PowerPoint 및 OpenDocument 형식에서 차트 워크북을 손쉽게 관리하여 프레젠테이션 데이터를 효율화합니다.

개요

이 문서는 Aspose.Slides에서 차트 통합 문서(workbook)를 사용하는 방법을 설명합니다. 통합 문서 스트림을 통해 차트 데이터를 읽고 쓰는 방법, 통합 문서 셀을 차트 데이터 레이블로 사용하는 방법, 워크시트 컬렉션에 접근하는 방법, 차트 값에 대한 데이터 소스 유형을 지정하는 방법을 보여줍니다.

또한 외부 통합 문서를 차트 데이터 소스로 사용하는 방법을 다룹니다. 예제에서는 외부 통합 문서를 생성하고 할당하는 방법, 차트에 연결된 외부 통합 문서의 경로를 가져오는 방법, 통합 문서가 사용 가능할 때 차트 데이터를 편집하는 방법을 시연합니다.

통합 문서에서 차트 데이터 읽기 및 쓰기

Aspose.Slides는 ReadWorkbookStream 및 WriteWorkbookStream 메서드를 제공하여 차트 데이터 통합 문서( Aspose.Cells로 편집된 차트 데이터를 포함)를 읽고 쓸 수 있도록 합니다. 참고 차트 데이터는 동일한 방식으로 구성되어 있거나 소스와 유사한 구조를 가져야 합니다.

다음 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이 ArgumentOutOfRangeException(parameter: index)을 발생시킬 수 있습니다. 예외를 방지하려면 업데이트된 통합 문서를 차트에 다시 쓰기 전에 기존 시리즈와 카테고리를 지우세요.

// 워크북 스트림을 수정한 후 (예: Aspose.Cells 사용)
byte[] updatedWorkbook = baos.toByteArray();

// 기존 데이터 참조를 삭제합니다.
chart.getChartData().getSeries().clear();
chart.getChartData().getCategories().clear();

chart.getChartData().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) 형식을 지원하지 않습니다. IChartData 의 getEmbeddedWorkbookType 메서드와 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 19.4에서 차트용 데이터 소스로 외부 통합 문서 지원을 구현했습니다.

외부 통합 문서 만들기

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

setExternalWorkbook 메서드의 두 번째(boolean) 매개변수는 Excel 통합 문서를 로드할지 여부를 지정합니다.

false 로 설정하면 통합 문서 경로만 업데이트되고 차트 데이터는 대상 통합 문서에서 로드되거나 업데이트되지 않습니다. 대상 통합 문서가 존재하지 않거나 사용할 수 없는 상황에서 이 설정을 사용할 수 있습니다.
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 로 구성하고, 프레젠테이션을 열기 전에 true 로 설정한 ISpreadsheetOptions.setRecoverWorkbookFromChartCache 를 호출합니다.

다음 Java 예제는 사용 불가능한 외부 통합 문서를 참조하는 차트를 열고, IChart.getChartData 및 IChartData.getChartDataWorkbook 를 통해 복구된 데이터를 접근하는 과정을 보여줍니다:

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는 예외를 발생시킵니다. 캐시된 차트 데이터를 사용해도 되는 경우에만 복구를 활성화하세요. 캐시에는 프레젠테이션이 마지막으로 업데이트된 이후 외부 통합 문서에 대한 변경 사항이 포함되지 않을 수 있습니다.

FAQ

특정 차트가 외부 통합 문서에 연결되어 있는지, 임베디드 통합 문서에 연결되어 있는지 확인할 수 있나요?

예. 차트는 데이터 소스 유형 및 외부 통합 문서 경로 를 가지고 있습니다; 소스가 외부 통합 문서인 경우 전체 경로를 읽어 외부 파일이 사용되는지 확인할 수 있습니다.

외부 통합 문서에 대한 상대 경로가 지원되며, 어떻게 저장되나요?

예. 상대 경로를 지정하면 자동으로 절대 경로로 변환됩니다. 이는 프로젝트 이식성을 높여주지만, 프레젠테이션은 PPTX 파일에 절대 경로를 저장한다는 점을 유의하세요.

네트워크 리소스/공유에 위치한 통합 문서를 사용할 수 있나요?

예, 이러한 통합 문서는 외부 데이터 소스로 사용할 수 있습니다. 그러나 Aspose.Slides에서는 원격 통합 문서를 직접 편집하는 것을 지원하지 않으며, 소스 용도로만 사용할 수 있습니다.

프레젠테이션 저장 시 외부 XLSX 파일을 덮어쓰나요?

아니요. 프레젠테이션은 외부 파일에 대한 링크 를 저장하고 데이터를 읽을 때만 사용합니다. 프레젠테이션을 저장해도 외부 파일 자체는 수정되지 않습니다.

외부 파일이 비밀번호로 보호되어 있으면 어떻게 해야 하나요?

Aspose.Slides는 링크 시 비밀번호를 받지 않습니다. 일반적인 해결 방법은 미리 보호를 해제하거나, 예를 들어 Aspose.Cells 로 복호화된 사본을 만든 뒤 해당 사본에 링크하는 것입니다.

여러 차트가 동일한 외부 통합 문서를 참조할 수 있나요?

예. 각 차트는 자체 링크를 저장합니다. 모두 같은 파일을 가리키면 해당 파일을 업데이트할 때마다 다음 데이터 로드 시 모든 차트에 반영됩니다.

Java에서 프레젠테이션 차트 형식 지정 Java에서 PowerPoint 차트 애니메이션 만들기