Java를 사용하여 Word 문서에 차트를 삽입하는 전체 작업 예제

이 예제는 5개의 데이터 시리즈가 있는 열 차트를 만들고 이를 Word 문서에 삽입하는 방법을 보여줍니다.

import com.aspose.words.Document;
import com.aspose.words.DocumentBuilder;
import com.aspose.words.Shape;
import com.aspose.words.ChartType;
import com.aspose.words.Chart;
import com.aspose.words.ChartSeriesCollection;

public class CreateChartInWord {
    public static void main(String[] args) {
        // Create a document
        Document doc = new Document();
        DocumentBuilder builder = new DocumentBuilder(doc);

// Add chart with default data. You can specify different chart types and sizes.
        Shape shape = builder.insertChart(ChartType.COLUMN, 432, 252);

// Chart property of Shape contains all chart related options.
        Chart chart = shape.getChart();

// Get chart series collection.
        ChartSeriesCollection seriesColl = chart.getSeries();
        // Check series count.
        System.out.println(seriesColl.getCount());

// Delete default generated series.
        seriesColl.clear();

// Create category names array, in this example we have two categories.
        String[] categories = new String[] { "AW Category 1", "AW Category 2" };

// Adding new series. Please note, data arrays must not be empty and arrays must be the same size.
        seriesColl.add("AW Series 1", categories, new double[] { 1, 2 });
        seriesColl.add("AW Series 2", categories, new double[] { 3, 4 });
        seriesColl.add("AW Series 3", categories, new double[] { 5, 6 });
        seriesColl.add("AW Series 4", categories, new double[] { 7, 8 });
        seriesColl.add("AW Series 5", categories, new double[] { 9, 10 });

// Save the document
        doc.save("ColumnsChart.docx");
    }
}

참고: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에서 사용하기 전에 출력 경로(ColumnsChart.docx)가 쓰기 가능한 디렉터리를 가리키는지 확인하고, 모든 필수 종속성이 올바르게 설치되었는지 확인하며, 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서를 참조하거나 지원 팀에 문의하십시오.

Java를 사용하여 Word 문서에 차트를 만드는 방법

워크플로는 다섯 가지 명확한 단계로 나눌 수 있습니다:

1. 문서 및 DocumentBuilder 만들기 - Document 클래스는 메모리 내의 Word 파일을 나타내며, DocumentBuilder는 차트를 포함한 콘텐츠 삽입을 위한 유창한 API를 제공합니다.

   Document doc = new Document();
   DocumentBuilder builder = new DocumentBuilder(doc);
   

2. 차트 모양 삽입 - insertChart는 ChartType(예: COLUMN)과 포인트 단위의 너비와 높이를 받아 페이지에 차트를 표시하는 Shape를 반환합니다.

   Shape shape = builder.insertChart(ChartType.COLUMN, 432, 252);
   

3. Chart 개체에 액세스 - Shape의 Chart 속성은 시리즈 컬렉션을 포함한 차트 관련 모든 옵션을 노출합니다.

   Chart chart = shape.getChart();
   ChartSeriesCollection seriesColl = chart.getSeries();
   System.out.println(seriesColl.getCount());
   

   전체 Chart, ChartSeriesCollection 및 관련 열거형에 대한 자세한 내용은 API reference를 참조하십시오.

4. 기본 시리즈를 지우고 직접 추가하기 - 새로 삽입된 차트에는 이미 자리 표시자 시리즈가 포함되어 있으므로 clear()를 사용해 이를 제거한 후 add()로 카테고리와 데이터를 추가합니다. 동일한 add() 호출에 전달되는 카테고리와 값 배열은 길이가 동일해야 합니다.

   seriesColl.clear();
   

String[] categories = new String[] { “AW Category 1”, “AW Category 2” };

seriesColl.add(“AW Series 1”, categories, new double[] { 1, 2 }); seriesColl.add(“AW Series 2”, categories, new double[] { 3, 4 });

<!--[CODE_SNIPPET_END]-->

5. **문서 저장** - 마지막으로, `doc.save()`는 DOCX를 디스크에 저장합니다.
<!--[CODE_SNIPPET_START]-->
```java
doc.save("ColumnsChart.docx");

각 단계에 대한 이해는 다양한 차트 유형, 데이터 소스 또는 문서 템플릿에 예제를 쉽게 적용할 수 있게 합니다.

환경 준비

Conholdate Maven 저장소와 SDK 종속성을 pom.xml에 추가하십시오:

<repositories>
    <repository>
        <id>conholdate-repo</id>
        <name>Conholdate Maven Repository</name>
        <url>https://repository.conholdate.com/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.conholdate</groupId>
    <artifactId>conholdate-total</artifactId>
    <version>24.9</version>
    <type>pom</type>
</dependency>

최신 SDK 패키지를 다운로드 페이지에서 다운로드하십시오. 이 라이브러리는 Java 8 이상이 필요하며 표준 JVM에서 실행됩니다. 추가 서버 구성 요소가 필요하지 않습니다.

세부 조정 차트 생성

시각 스타일에 맞게 여러 속성을 조정할 수 있습니다:

• Chart Type - ChartType.COLUMN을 ChartType.BAR, ChartType.LINE, ChartType.PIE, ChartType.SCATTER 및 기타 지원되는 유형으로 변경합니다.

  Shape shape = builder.insertChart(ChartType.BAR, 432, 252);
  

• Chart Size - insertChart의 두 번째와 세 번째 인수는 차트 도형의 너비와 높이를 포인트 단위로 제어합니다.

  Shape shape = builder.insertChart(ChartType.COLUMN, 500, 300);
  

• 카테고리 (축 레이블) - 카테고리 이름의 String[]을 만들고 동일한 카테고리를 공유하는 모든 시리즈에서 재사용합니다.

  String[] categories = new String[] { "Jan", "Feb", "Mar" };
  

• Data Series - 시리즈 이름, 카테고리 배열 및 값들의 double[]을 사용하여 seriesColl.add()를 호출하면 필요한 만큼 비교 시리즈를 추가할 수 있습니다.

  seriesColl.add("2021", categories, new double[] { 200, 220, 250 });
  

이 옵션을 사용하면 코드를 간결하게 유지하면서 차트를 모든 보고 요구 사항에 맞게 조정할 수 있습니다.

Java를 사용하여 Word 문서에 산점도 차트 삽입

Scatter 차트는 범주 대신 숫자 X 및 Y 값 쌍을 플롯하므로 상관관계 또는 분포를 시각화하는 데 유용합니다. ChartSeriesCollection은 이 목적을 위해 특별히 add()의 오버로드를 제공합니다: 범주 배열 대신 X 값용 double[] 배열 하나와 Y 값용 double[] 배열 하나, 두 개의 배열을 전달합니다.

import com.aspose.words.Document;
import com.aspose.words.DocumentBuilder;
import com.aspose.words.Shape;
import com.aspose.words.ChartType;
import com.aspose.words.Chart;

public class InsertScatterChart {
    public static void main(String[] args) {
        // Create a new document
        Document doc = new Document();
        DocumentBuilder builder = new DocumentBuilder(doc);

// Insert Scatter chart.
        Shape shape = builder.insertChart(ChartType.SCATTER, 432, 252);
        Chart chart = shape.getChart();

// Use this overload to add series to any type of Scatter charts.
        chart.getSeries().add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });

// Save the document
        doc.save("ScatterChart.docx");
    }
}

전체 흐름은 열 차트 예제와 동일합니다: Document와 DocumentBuilder를 생성하고, ChartType.SCATTER로 차트 모양을 삽입한 다음, 모양에서 Chart를 가져와 하나 이상의 시리즈를 추가합니다. 산점도 차트는 X/Y 좌표 쌍을 플롯하므로 별도의 카테고리 배열이 없으며, 각 포인트는 X 및 Y 값 배열의 일치하는 항목으로 정의됩니다. 모든 시리즈를 추가한 후 doc.save()로 저장합니다.

결론

시각 데이터를 DOCX 파일에 직접 삽입하는 것은 자동 보고서를 강화하는 강력한 방법입니다. Conholdate.Total for Java 를 사용하면 Java로 몇 줄의 코드만으로 Word 문서에 차트를 만들 수 있습니다 — 열, 막대, 선, 원형 및 산점도 차트를 포함하여 — 카테고리와 시리즈를 사용자 정의하고 서버 측에서 전문적인 문서를 생성합니다. 프로덕션 사용을 위해 적절한 라이선스를 획득해야 함을 기억하세요; 임시 라이선스는 임시 라이선스 페이지에서 제공되며, 전체 가격 정보는 가격 페이지에서 확인할 수 있습니다. 오늘 차트 생성 통합을 시작하고 사용자가 돋보이는 데이터 기반 문서를 제공하세요.

자주 묻는 질문

• Java와 Conholdate.Total을 사용하여 Word 문서에서 차트를 만들려면 어떻게 해야 하나요? DocumentBuilder에서 원하는 ChartType을 사용하여 insertChart를 호출하고, 반환된 Shape에서 Chart를 가져온 다음 기본 시리즈를 지우고 seriesColl.add()로 자체 카테고리와 데이터를 추가한 후 문서를 저장합니다. 전체 코드는 위 예제에 표시되어 있습니다.

• 지원되는 차트 유형은 무엇인가요? SDK는 ChartType 열거형을 통해 column, bar, line, pie, scatter 및 기타 많은 표준 차트 유형을 지원합니다. 차트 유형을 전환하려면 insertChart에 전달되는 열거형 값을 변경하십시오.

• 산점도가 열 차트 또는 막대 차트와 다른 점은 무엇인가요? 산점도는 명명된 카테고리 대신 숫자 X 및 Y 값 쌍을 플롯하므로, 카테고리 배열을 전달하는 대신 ChartSeriesCollection의 add(name, xValues, yValues) 오버로드를 사용합니다.

• 차트 생성을 위해 라이선스를 설정해야 하나요? 예. 임시 라이선스는 임시 라이선스 페이지에서 얻을 수 있습니다. 장기 프로젝트의 경우, 가격 페이지를 통해 전체 라이선스를 구매하십시오.

• SDK가 Maven 및 Gradle 빌드와 호환되나요? 물론입니다. Setup 섹션에 표시된 대로 Conholdate Maven 저장소와 conholdate-total 종속성을 빌드 파일에 추가하면 라이브러리가 Maven과 Gradle 모두에서 작동합니다.

더 읽기

• Java에서 Excel을 이미지로 변환
• Java에서 Word 문서에 서명
• Java에서 Word를 이미지로 변환