필드, 교차 참조 및 TOC

그 Aspose.Words LINQ Reporting Engine for .NET 개발자가 만들 수 있게 합니다 풍부하고 데이터 기반의 보고서 플레인 텍스트 태그 구문과 LINQ 쿼리를 결합함으로써. 보고서는 컬렉션, 데이터베이스, JSON, XML 또는 사용자 정의 객체에 바인딩할 수 있으며, 필터링, 그룹화 및 집계가 템플릿 내부에서 직접 수행됩니다. 결과는 완전히 채워진 보고서가 in Word 형식.

설치 및 설정

  1. NuGet 패키지를 설치합니다 Aspose.Words.
  2. 라이선스를 적용하세요 ( Metered Licensing ).
  3. 참조를 추가합니다 Aspose.Words 그리고 종속성이 포함되었는지 확인합니다.
  4. 전체 단계는 다음을 참조하십시오 설치 가이드 .

지원되는 플랫폼: Windows, Linux, 및 macOS와 .NET Framework, .NET, 또는 Mono. IDE: Visual Studio 2017–2026, JetBrains Rider, MonoDevelop.

지원되는 템플릿 / 출력 형식: DOC, DOCX, RTF, DOT, DOTX, DOTM, DOCM, Word 2003 XML, 및 Word 2007 XML.

빠른 시작

XML에서 보고서 만들기:

using Aspose.Words;
using Aspose.Words.Reporting;

var doc = new Document("ReportTemplate.docx");
var dataSource = new XmlDataSource("Data.xml");

var engine = new ReportingEngine();
engine.BuildReport(doc, dataSource, "data");

doc.Save("Report.Output.docx");

기능 및 작동 방식

템플릿 구문

  • 태그와 같은 <<Name>>, <<foreach:Orders>>, <<if:Condition>> 인간이 읽을 수 있습니다.
  • 단락, 표, 머리글 및 바닥글에서 지원됩니다.

LINQ 데이터 바인딩

  • 바인드 대상 컬렉션, DataTables, EF 쿼리, JSON, XML, 또는 사용자 정의 객체.
  • 인라인 LINQ: Where, OrderBy, GroupBy, 프로젝션.

필터링, 그룹화 및 정렬

  • 조건부 블록 with <<if:…>> / <<endif>>.
  • 데이터 그룹화 with <<groupby:Property>>.
  • 인라인 정렬 with orderby 조항.

집계 함수

  • 내장 태그: <<sum:>>, <<avg:>>, <<count>>, <<min:>>, <<max:>>.
  • 데이터셋이 변경될 때 자동 업데이트.

조건부 및 스위치 로직

  • 사용 <<switch:Expression>>, <<case:Value>>, <<default>> 다양한 시나리오에 대해.
  • 다양한 레이아웃을 가진 템플릿을 간소화합니다.

중첩 및 계층형 데이터

  • 객체 그래프 탐색 (예:., <<foreach:Order.Items>>).
  • 그룹화 + 조건을 포함한 중첩 테이블/리스트 구축.

사용자 정의 함수 및 확장성

  • 사용자 정의 로직을 위한 확장 메서드 또는 핸들러를 등록.
  • 특수 포맷팅 및 변환 수행.

템플릿 상속

  • 기본 템플릿을 정의하고 자식 템플릿에서 재사용.
  • 일관된 브랜딩 및 스타일을 유지합니다.

이벤트 및 콜백

  • 연동 ReportBuildStarted, TagProcessed, ReportBuildFinished.
  • 로깅을 추가하고, 차트/이미지를 삽입하거나, 출력을 동적으로 수정합니다.

현지화 및 국제화

  • 문화권에 따라 날짜, 숫자, 통화를 형식화합니다.
  • 다국어 보고서를 위해 리소스 파일을 통합합니다.

FAQ

  1. Mail Merge와는 어떻게 다릅니까? LINQ Reporting은 텍스트 태그를 사용하고 전통적인 mail merge fields와 달리 LINQ 식을 지원합니다.
  2. 어떤 데이터 소스를 지원합니까? XML, JSON, CSV, DataTables, Entity Framework, 및 맞춤형 .NET 객체.
  3. 차트와 이미지를 삽입할 수 있나요? 예. 템플릿에는 데이터에서 채워지는 차트, 바코드 및 이미지가 포함될 수 있습니다.
  4. 어떤 형식들을 출력할 수 있나요? DOC, DOCX, RTF, DOT, DOTX, DOTM, DOCM, Word 2003 XML, 및 Word 2007 XML.
  5. 현지화를 지원하나요? 예. 문화 인식 포맷팅 및 리소스 통합이 지원됩니다.
 한국어