저희는 GroupDocs.Assembly for Java 26.11의 출시를 기쁘게 발표합니다. 2026년 11월부터 이용 가능합니다. 이 릴리스는 GroupDocs.Assembly for .NET 26.11의 기능 및 수정 사항을 Java에 제공합니다:

  • 템플릿을 JSON 스키마에 대해 검증할 수 있습니다;
  • 템플릿 및 보고서의 페이지를 이미지로 렌더링할 수 있습니다;
  • 외부 리소스 로딩을 애플리케이션이 제어합니다;
  • REMOVE_EMPTY_PARAGRAPHS가 스프레드시트 및 일반 텍스트 템플릿에서도 작동합니다;
  • <<image>> 태그가 프레젠테이션의 테이블 셀에서 작동하며 상대 경로를 템플릿 폴더를 기준으로 해석합니다;
  • 색상 태그가 16진수 문자열을 허용합니다.

번들된 Aspose 엔진이 초기 2026 버전에서 26.10으로 업데이트되었으며, 라이선스, 보고서 인코딩, 바코드 및 HTML 콘텐츠와 관련된 여러 수정 사항이 포함되었습니다. Java 8은 여전히 기준 버전입니다.

이번 릴리스의 새로운 기능

키 요약 카테고리
ASSEMBLYNET-145 JsonDataSource가 JSON 스키마를 허용합니다: 스키마에 선언된 멤버는 데이터에서 null이거나 비어 있거나 누락된 경우에도 참조할 수 있으며, 값 유형은 스키마에서 가져옵니다 기능
ASSEMBLYNET-8 DocumentAssembler.generatePreview가 템플릿, 조립된 보고서 및 기타 문서의 페이지를 PNG, JPEG 또는 BMP 이미지로 렌더링합니다 기능
ASSEMBLYNET-36, ASSEMBLYNET-37 DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS가 스프레드시트 템플릿 및 일반 텍스트 문서에서도 작동합니다 기능
ASSEMBLYNET-140 템플릿 및 데이터가 참조하는 외부 리소스는 애플리케이션이 제어합니다; 데이터에서 참조가 오는 리소스는 기본적으로 건너뛰어집니다 보안
ASSEMBLYJAVA-353 Aspose.Words 26.10.1, Aspose.Cells 26.10, Aspose.Slides 26.10, Aspose.Email 26.9 및 Aspose.BarCode 26.10이 번들에 포함됩니다 업데이트
ASSEMBLYJAVA-353 GS1 바코드(EAN-14, SCC-14, SSCC-18 및 DataBar)는 Aspose.BarCode 26.10을 사용하여 코드 텍스트 자동 보정을 유지합니다 수정
ASSEMBLYNET-52 <<image>> 태그가 프레젠테이션의 테이블 셀에서 작동하며, 그룹 도형의 도형에 있는 태그도 처리됩니다 향상
ASSEMBLYNET-62 데이터에서 제공된 상대 이미지 경로가 템플릿 폴더를 기준으로 해석됩니다 향상
ASSEMBLYNET-25 문자열로 제공된 색상이 backColor 및 차트 색상 태그에서 16진수 값이 될 수 있습니다 향상
ASSEMBLYNET-155 JSON, XML 또는 CSV 데이터에서 누락된 Boolean 값은 실패 대신 ?: 연산자와 where, count, any, all, first에서 false로 간주됩니다 수정
ASSEMBLYNET-157 중첩 객체에 대한 groupBy와 distinct가 동일한 객체를 병합합니다; JSON 데이터의 $id/$ref 참조가 지원됩니다 수정
ASSEMBLYNET-142 License.setLicense(InputStream)이 이미 처음부터 읽힌 스트림을 읽습니다 수정
ASSEMBLYNET-143 작업이 완료될 때 메터링된 라이선스 사용량이 보고됩니다 수정
ASSEMBLYNET-158 ASCII 전용 템플릿의 텍스트 및 HTML 보고서가 UTF-8로 작성되어 비라틴 데이터가 손실되지 않습니다 수정
ASSEMBLYNET-160 바코드의 텍스트 박스 폰트가 설치되지 않아도 NullPointerException이 발생하지 않습니다 수정
ASSEMBLYNET-159 MSG 템플릿의 대화 주제에 있는 태그가 해당 제목의 태그와 같이 조립됩니다 수정
ASSEMBLYNET-152 스프레드시트, 프레젠테이션 또는 텍스트 템플릿에서 <<doc>> 태그가 명확한 메시지와 함께 실패합니다; 실패한 assembleDocument는 빈 출력 파일을 남기지 않습니다 수정
ASSEMBLYJAVA-354 -html 표현식 태그가 단락을 종료할 때 블록 요소로 끝나는 HTML 뒤에 빈 단락이 남지 않습니다 수정

업그레이드 전 확인해야 할 동작 변경 사항

  1. 데이터에서 오는 외부 리소스는 기본적으로 건너뛰어집니다. 예를 들어, PhotoUrl이 http 또는 https URI인 경우 <<image [item.PhotoUrl]>>는 이제 빈 이미지를 반환합니다. 호스트를 LoadSaveOptions.getWhitelistedResources()에 추가하거나 LoadSaveOptions.setSkipExternalResources(false)를 호출하여 이전 동작을 유지하십시오. 템플릿 자체가 참조하는 리소스와 로컬 파일 경로는 이전과 같이 작동합니다.
  2. 모호한 JsonDataSource 호출. 두 번째 인자로 리터럴 null을 사용한 new JsonDataSource(path, null)은 더 이상 컴파일되지 않습니다. 인자를 캐스팅하십시오: new JsonDataSource(path, (JsonDataLoadOptions) null). 이미 컴파일된 애플리케이션에는 영향을 주지 않습니다.
  3. UTF-8 텍스트 및 HTML 보고서. 바이트 순서 표시가 없는 ASCII 전용 텍스트 및 HTML 템플릿의 보고서는 이제 windows-1252 대신 UTF-8로 작성됩니다. 단일 바이트 코드 페이지를 유지하려면 템플릿에 선언하십시오(HTML의 <meta charset>).
  4. **JSON, XML 및 DataSet 데이터의 중첩 객체에 대한 groupBy와 distinct**가 이제 행당 하나의 그룹을 만들지 않고 동일한 객체를 병합합니다.
  5. HTML 뒤에 추가 단락이 없습니다. 단락을 종료하는 -html 태그가 블록 요소로 끝나는 HTML 뒤에 빈 단락을 남기지 않습니다. 빈 줄을 유지하려면 HTML을 <p>&nbsp;</p>로 종료하십시오.
  6. DataBar Expanded 바코드. 숫자만 포함된 코드 텍스트를 가진 DataBar Expanded 또는 DataBar Expanded Stacked 바코드는 이제 다른 DataBar 유형과 마찬가지로 (01) 애플리케이션 식별자를 가진 GTIN으로 인코딩됩니다.
  7. 예외 텍스트 변경: 스프레드시트, 프레젠테이션 및 텍스트 템플릿에서 <<doc>> 태그에 대한 예외 메시지가 변경되었습니다; 예외 유형은 동일합니다.
  8. 제거된 API. ICustomFontsHandler.resetFontSources()가 제거되었습니다; 대신 FontSettings.resetFontSources()를 호출하십시오.

새로운 기능

JsonDataSource에 대한 JSON 스키마 지원

템플릿은 <<if>>가 평가되기 전에 데이터 구조에 대해 검증됩니다. JSON의 경우, 해당 구조가 데이터 자체에서 추출되었기 때문에, 렌더링되지 않는 분기 내부의 참조는 해당 데이터가 null이거나 빈 배열이거나 누락된 경우 실패했습니다.

JsonDataSource는 이제 JSON 스키마를 허용합니다. 이는 XmlDataSource가 XML 스키마를 허용하는 방식과 동일하며, 템플릿은 스키마에 대해 검증됩니다:

  • 스키마에 선언된 멤버는 데이터에서 null이거나 비어 있거나 존재하지 않아도 참조할 수 있습니다;
  • 스키마에 선언되지 않은 멤버는 여전히 실패하므로, 오타가 이전과 같이 감지됩니다;
  • 값 유형은 스키마에서 가져오므로, Boolean은 Boolean이며 숫자를 포함한 문자열은 문자열로 유지됩니다.

다음과 같은 고객이 있다고 가정합니다: 결제 카드와 로열티 데이터가 없으며, 계좌 번호가 숫자 문자열인 경우:

{ "Name": "Quayside Bistro", "Account": "00042", "Cards": [], "Loyalty": null }
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "Name": { "type": "string" },
    "Account": { "type": "string" },
    "Cards": {
      "type": "array",
      "items": { "type": "object", "properties": { "Type": { "type": "string" }, "Last4": { "type": "string" } } }
    },
    "Loyalty": { "type": ["object", "null"], "properties": { "Level": { "type": "string" } } }
  }
}

그리고 이 템플릿:

Customer: <<[customer.Name]>>
Account number: <<[customer.Account]>>
<<if [customer.Cards.count() > 0]>>Payment card: <<[customer.Cards.first().Type]>> ending in <<[customer.Cards.first().Last4]>><<else>>No payment card on file.<</if>>
Loyalty program: <<[customer.Loyalty?.Level]>>

데이터 옆에 스키마를 전달합니다:

JsonDataSource dataSource = new JsonDataSource("Customer.json", "Customer.schema.json");

DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument("Json schema.docx", "output.docx", new DataSourceInfo(dataSource, "customer"));

결과는 계좌 번호 00042와 함께 No payment card on file.입니다. 스키마 없이 동일한 템플릿은 customer.Cards.first().Type에서 실패하고, 계좌 번호는 숫자 42로 읽힙니다.

스키마는 파일 경로나 InputStream으로 제공될 수 있으며, JsonDataLoadOptions 유무와 관계없이 사용할 수 있습니다. 지원되는 키워드는 type(nullable 유형 포함), properties, items, format(date-time 및 date), enum, const, allOf 및 로컬 $ref 포인터입니다. oneOf, anyOf, not, 원격 또는 재귀 $ref, 튜플 형태 items 및 배열의 배열은 지원되지 않습니다.

문서 미리보기

DocumentAssembler.generatePreview는 문서의 페이지를 PNG, JPEG 또는 BMP 이미지로 렌더링합니다: 템플릿, GroupDocs.Assembly가 조립한 문서, 또는 지원되는 형식의 다른 문서를 파일이나 스트림에서. 워드 프로세싱, 텍스트 및 HTML 문서의 페이지, 스프레드시트의 인쇄 페이지, 프레젠테이션 슬라이드 및 헤더가 포함된 이메일 메시지가 렌더링됩니다.

DocumentAssembler assembler = new DocumentAssembler();

ByteArrayOutputStream report = new ByteArrayOutputStream();
try (InputStream template = new FileInputStream("Customer orders.docx"))
{
    assembler.assembleDocument(template, report,
        new DataSourceInfo(new JsonDataSource("Customers.json"), "customers"));
}

// A stream is created for every page and released when the page is written.
PreviewOptions options = new PreviewOptions(
    pageNumber -> new FileOutputStream("page" + pageNumber + ".png"),
    (pageNumber, pageStream) -> pageStream.close());
options.setPreviewFormat(PreviewFormats.PNG);
options.setResolution(120);                    // dots per inch; 96 by default
// options.setPageNumbers(new int[] { 1, 2 }); // all pages by default

assembler.generatePreview(new ByteArrayInputStream(report.toByteArray()), options);

setWidth와 setHeight가 모두 설정되면, 페이지는 비율을 유지하면서 해당 크기에 맞게 스케일됩니다. 미리보기는 외부 리소스를 로드하지 않고 생성되며, 생성된 이미지는 조립된 문서와 마찬가지로 메터링된 라이선스로 계산됩니다.

스프레드시트 및 일반 텍스트 템플릿에 대한 REMOVE_EMPTY_PARAGRAPHS

DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS가 이제 스프레드시트 템플릿 및 일반 텍스트 문서에서도 작동합니다. 여기서 단락은 텍스트 한 줄을 의미합니다: 셀 텍스트의 한 줄 또는 텍스트 문서의 한 줄이 템플릿 태그 처리 후 빈 줄이 되면 줄 바꿈과 함께 제거됩니다. <<if>> 및 <<foreach>>와 같이 자체 라인에 작성된 태그는 더 이상 빈 라인을 남기지 않습니다.

DocumentAssembler assembler = new DocumentAssembler();
assembler.setOptions(DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS);
assembler.assembleDocument("Empty paragraph.txt", "result.txt", new DataSourceInfo("dummy", "dummy"));

템플릿:

Prefix
<<if [false]>>
Text to be removed
<</if>>
Suffix

결과:

Prefix
Suffix

스프레드시트 셀에 동일한 템플릿 텍스트를 넣어도 셀 내에서 동일한 결과가 나타납니다. HTML 및 XML 문서는 그대로 유지됩니다.

보안: 외부 리소스 제어

<<image>> 또는 <<doc>> 태그는 데이터에서 가져온 URI로 평가될 수 있으며, GroupDocs.Assembly는 이를 방지할 방법 없이 가져왔습니다. 다른 사람이 제공한 데이터로 문서를 조립하는 서버는 내부 주소를 요청하도록 유도될 수 있습니다.

GroupDocs.Assembly는 이제 각 외부 리소스 참조가 어디에서 오는지(ExternalResourceOrigin)를 알려줍니다:

  • TEMPLATE — 템플릿 문서 자체가 리소스를 참조합니다. 예: <<image ["https://example.com/logo.png"]>>와 같은 태그에 리터럴 URI가 포함됩니다;
  • DATA — 참조가 데이터에서 옵니다. 예: 태그 표현식이 평가한 URI.

기본적으로 템플릿이 참조하는 리소스는 이전과 같이 로드되고, 데이터에서 오는 리소스는 건너뛰어집니다. LoadSaveOptions의 네 멤버가 이를 제어합니다:

  • setSkipExternalResources (true가 기본값) — 외부 리소스를 로드하지 않습니다;
  • setTrustTemplateResources (true가 기본값) — 건너뛰기가 활성화된 경우에도 템플릿이 참조하는 리소스를 로드합니다; 템플릿이 신뢰할 수 없는 경우 false로 설정하십시오;
  • getWhitelistedResources — 건너뛰기가 활성화된 경우에도 허용되는 호스트 이름 또는 절대 URI 접두사;
  • setExternalResourceHandler — 요청되기 전에 모든 외부 리소스에 대해 호출되는 ExternalResourceHandler로, 허용, 건너뛰기 또는 콘텐츠 제공을 할 수 있습니다.
final String photoUri = "https://images.example.com/photos/no-photo.jpg";
DocumentAssembler assembler = new DocumentAssembler();

// Default options: the URI comes from data, so the image is skipped and left empty.
assembler.assembleDocument("Inserting image.docx", "Skipped.docx", new DataSourceInfo(photoUri, "expression"));

// Allow a trusted host and see every decision. The handler can also provide the content itself.
LoadSaveOptions options = new LoadSaveOptions();
options.getWhitelistedResources().add("images.example.com");
options.setExternalResourceHandler(new LocalImageHandler("no-photo.jpg"));

assembler.assembleDocument("Inserting image.docx", "Provided.docx", options, new DataSourceInfo(photoUri, "expression"));
public class LocalImageHandler extends ExternalResourceHandler
{
    private final String mImagePath;

    public LocalImageHandler(String imagePath) { mImagePath = imagePath; }

    @Override
    public void onLoading(ExternalResourceLoadingArgs args)
    {
        System.out.println(ExternalResourceOrigin.toString(args.getOrigin()) + " resource " + args.getUri() + ": "
            + (args.isSkipped() ? "skipped" : "allowed"));

        // Provide the content instead of requesting it.
        if (!args.isSkipped() && args.getUri().toLowerCase().startsWith("https://images.example.com/"))
        {
            try
            {
                args.setData(Files.readAllBytes(Paths.get(mImagePath)));
            }
            catch (IOException e)
            {
                throw new UncheckedIOException(e);
            }
        }
    }
}

외부 리소스는 네트워크에 도달하는 리소스로, http, https 및 ftp URI, UNC 경로 및 원격 호스트가 있는 파일 URI를 포함합니다. 로컬 파일 경로는 영향을 받지 않습니다. 문서의 건너뛴 이미지는 투명 이미지로 대체되며, 건너뛴 <<image>> 또는 <<doc>> 값은 빈 값으로 처리됩니다.

향상

프레젠테이션의 테이블 셀 및 그룹 도형에 이미지

프레젠테이션 템플릿에서 <<image>> 태그는 텍스트 상자에만 배치할 수 있었습니다. 이제 테이블 셀도 이미지 컨테이너가 되어, 이미지가 셀의 그림 채우기로 적용됩니다. <<foreach>>로 반복되는 행의 셀도 포함되므로, 아이템과 사진을 나열하는 테이블을 만들 수 있습니다. -fitHeight를 사용하면 행이 이미지의 비율에 맞게 확대됩니다. 그룹 도형의 도형에 있는 태그(중첩 그룹 포함)는 이제 다른 도형과 같이 처리됩니다.

템플릿 폴더를 기준으로 상대 이미지 경로 해석

<<image>> 태그가 데이터에서 상대 파일 경로(Images/photo.png 등)를 받을 경우, 이제 Microsoft Office 문서의 연결 리소스와 유사하게 먼저 템플릿 폴더를 기준으로 해석합니다. 스트림에서 로드된 템플릿의 경우 LoadSaveOptions.setResourceLoadBaseUri로 폴더를 설정하십시오:

DocumentAssembler assembler = new DocumentAssembler();

// A template loaded from a stream has no folder: set it with setResourceLoadBaseUri.
LoadSaveOptions options = new LoadSaveOptions();
options.setResourceLoadBaseUri("C:\\Reports\\Templates");

try (InputStream template = new FileInputStream("C:\\Reports\\Templates\\Inserting image.docx");
     OutputStream report = new FileOutputStream("output-from-stream.docx"))
{
    assembler.assembleDocument(template, report, options, new DataSourceInfo("../Images/no-photo.jpg", "expression"));
}

해당 위치에 파일이 없으면 이전과 같이 현재 디렉터리가 사용됩니다.

16진수 색상 문자열

문자열로 제공된 색상은 이제 색상 이름이나 ARGB 정수 외에 16진수 값("#RRGGBB", "#RGB" 또는 "#AARRGGBB")도 될 수 있습니다. 이는 backColor 및 차트 색상 태그에서 적용됩니다. 예를 들어, 데이터에서 온 "#FF0000"을 가진 <<backColor [item.Color]>>는 빨간색을 적용합니다.

수정

  • JSON, XML 및 CSV 데이터의 누락된 Boolean은 이제 ?: 조건 연산자와 where, count, any, all, first에서 false로 간주되며, NullPointerException으로 실패하지 않습니다.
  • **JSON 및 XML 데이터의 중첩 객체에 대한 groupBy와 distinct**는 객체를 값으로 비교하여 동일한 고객이 하나의 그룹이 됩니다. 보존된 참조($id/$ref)를 포함한 JSON이 이제 지원됩니다.
  • **License.setLicense(InputStream)**은 마크 위치에서 ByteArrayInputStream을, 0 위치에서 FileInputStream을 읽어, 다른 GroupDocs 제품에 라이선스를 적용하기 위해 이미 사용된 스트림이 “Unexpected EOF in prolog” 오류 없이 작동합니다.
  • 메터링 사용량은 문서를 조립하거나 미리보기를 생성 완료 시 보고되며, 백그라운드 스레드에서 나중에 보고되지 않습니다.
  • ASCII 전용 템플릿의 텍스트 및 HTML 보고서는 UTF-8로 작성되어 Café 또는 Привет와 같은 데이터가 windows-1252로 손실되지 않습니다.
  • **엔진이 그리는 코드 텍스트를 가진 바코드(QR, DataMatrix, Aztec 등)**는 텍스트 박스 폰트가 설치되지 않아도 더 이상 실패하지 않습니다(예: Linux의 Calibri). 대신 대체 폰트가 사용됩니다.
  • MSG 템플릿: 대화 주제의 태그가 제목의 태그와 같이 처리되어 Outlook이 메시지를 올바르게 스레드합니다.
  • **스프레드시트, 프레젠테이션 및 텍스트 템플릿에서 <<doc>>**는 해당 형식에서 지원되지 않는다는 메시지와 함께 실패하며, 실패한 assembleDocument는 빈 출력 파일을 남기지 않습니다.
  • HTML 콘텐츠: 단락을 종료하는 -html 표현식 태그가 블록 요소로 끝나는 HTML 뒤에 추가 빈 단락을 남기지 않습니다 (ASSEMBLYJAVA-354).
  • GS1 바코드: GroupDocs.Assembly는 이제 EAN-14, SCC-14, SSCC-18 및 DataBar 바코드의 숫자 전용 코드 텍스트를 자체적으로 수정합니다. 이는 Aspose.BarCode 26.10이 이를 중단했기 때문이며, 이 바코드들은 26.10.1과 동일하게 유지됩니다.

Aspose 엔진이 26.10으로 업그레이드됨

GroupDocs.Assembly for Java 26.10.1은 초기 2026의 Aspose 라이브러리를 번들에 포함했으며, 이후 수정된 취약점이 보안 스캐너에 의해 보고되었습니다. 현재 번들된 엔진은 다음과 같습니다:

엔진 26.10.1 26.11
Aspose.Words for Java 26.3 26.10.1
Aspose.Cells for Java 26.3 26.10
Aspose.Slides for Java 26.2 26.10
Aspose.Email for Java 26.1 26.9
Aspose.BarCode for Java 26.6 26.10

게시된 POM은 여전히 의존성을 선언하지 않습니다. 엔진이 새로 고쳐졌기 때문에 재생성된 문서는 바이트 수준에서 차이가 있을 수 있지만 시각적·기능적으로는 동일합니다. 생성된 출력물을 저장된 기준과 바이트 비교한다면, 업그레이드 후 기준을 새로 고치십시오.

Java 사용자 참고 사항

  • JSON 또는 CSV 데이터의 Z 또는 오프셋이 있는 날짜는 정확한 순간을 나타내는 java.util.Date 값이며, 포맷 패턴은 JVM 기본 시간대에 따라 출력합니다. 서버에 의존하지 않는 출력을 위해서는 예를 들어 -Duser.timezone=UTC와 같이 고정 시간대로 JVM을 실행하십시오.
  • ExternalResourceOrigin와 PreviewFormats는 다른 Java API 열거형과 마찬가지로 int 상수 클래스입니다. CreatePageStream와 ReleasePageStream은 함수형 인터페이스이므로 람다식을 사용할 수 있습니다.

업데이트 받는 방법

Maven

pom.xml에 GroupDocs 저장소와 의존성을 추가하십시오:

<repositories>
    <repository>
        <id>groupdocs-artifacts-repository</id>
        <name>GroupDocs Artifacts Repository</name>
        <url>https://releases.groupdocs.com/java/repo/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-assembly</artifactId>
        <version>26.11</version>
    </dependency>
</dependencies>

직접 다운로드

다음 GroupDocs.Assembly for Java 26.11 다운로드 페이지에서 JAR를 다운로드하십시오.

리소스