Java에서 Office 파일을 변환할 때 저자, 제목 및 사용자 정의 속성 제거

동반 샘플 저장소 (출판 대기 중): remove-office-properties-java

Office 메타데이터 제거는 Java용 GroupDocs.Conversion 워크플로우로, Office 파일을 내보내는 동안 원본 문서 속성을 지웁니다. 이는 문서 전달에서 작지만 놓치기 쉬운 부분을 다룹니다: 파일은 준비된 것처럼 보이지만 저자, 제목 또는 내부 참조가 여전히 초안을 설명하고 있을 수 있습니다. 이 문서는 Word 보고서를 예로 들어 설명한 뒤 동일한 정책을 Excel 및 PowerPoint에 적용합니다. 코드는 버전 26.10에 고정되어 있으며 가상의 입력 파일을 사용합니다.

소개

보고서가 내부 검토 과정을 마치고 나간다고 가정해 보십시오. 눈에 보이는 제목은 올바르고, 도표는 승인되었으며 PDF는 정상적으로 열립니다. 이러한 검토 중 어느 것도 Author 필드에 무엇이 들어 있는지는 알려주지 않습니다. 워크북이나 프레젠테이션에도 팀 내부에서는 의미가 있지만 외부 전달물에는 아무런 도움이 되지 않는 사용자 정의 속성이 포함될 수 있습니다. 이러한 정보를 수신자가 발견하는 놀라움이 아니라 내보내기 결정으로 취급하십시오.

샘플은 각 보고서에 대해 두 가지 버전을 생성합니다. 하나는 원본 속성을 유지하고, 다른 하나는 내장 및 사용자 정의 속성 제거를 요청합니다. 또한 각 실행마다 동일 형식의 Office 복사본을 작성하여 확인된 값을 독립적으로 검사할 수 있게 합니다. 이는 의도적으로 관찰 가능한 예시입니다. 우리는 첫 페이지 모양에 기반한 추정이 아니라 설정이 출력에 변화를 주었다는 증거를 원합니다.

내보내기 시 속성 정리가 중요한 이유

내보내기 단계는 원본 문서가 전달용 아티팩트가 되는 시점입니다. 따라서 내부 속성을 콘텐츠와 함께 전달할지 여부를 결정하기에 유용한 위치가 됩니다. Java용 GroupDocs.Conversion 26.10은 내장 및 사용자 정의 문서 속성에 대한 별도 제어를 제공합니다. Office 소스를 로드하는 동안, PDF를 저장하기 전에 이를 적용할 수 있습니다. 예제에서는 외부 복사본 변형에 대해 두 범주 모두를 활성화합니다.

이는 문서 자체를 검토하는 것을 대체하는 것이 아닙니다. 저자 이름이 단락, 셀, 메모 또는 포함된 파일에 나타날 수도 있습니다. 이러한 위치는 별도의 처리가 필요합니다. 저는 이 기능을 내보내기 파이프라인에서의 속성 정리라고 설명하고 싶습니다. 이는 코드가 실제로 증명하는 내용과 일치하며, 테스트가 다루는 범위보다 더 넓은 프라이버시 결과를 약속하는 것을 피할 수 있습니다.

언제 Office 속성을 지워야 할까요?

내보낸 보고서에서 내부 저작권, 초안 제목 또는 사용자 정의 참조 필드를 제외하는 전달 정책이 있을 경우 원본 속성을 지우십시오. Converter를 생성하기 전에 로드 옵션을 구성하고, 알려진 마커를 사용해 유지된 출력과 정리된 출력을 비교합니다. 예제는 DOCX, XLSX 및 PPTX 소스를 다룹니다. 눈에 보이는 콘텐츠는 별도로 검토하고, 정리 후에도 Producer와 같은 출력 생성 PDF 필드는 남아 있을 수 있음을 허용하십시오.

사전 요구 사항

전체 프로젝트는 JDK 11, Maven 및 Java용 GroupDocs.Conversion 26.10을 사용합니다. documents 디렉터리에는 세 개의 가상 보고서가 포함되어 있습니다. 무제한 검증을 위해 이 릴리스를 포함하는 라이선스가 필요합니다; 평가 제한으로 인해 전체 비교가 완료되지 않을 수 있습니다. 코드는 라이선스 설정을 기능 메서드 외부에 두고 배포된 소스에 자리 표시자를 사용합니다. 프로젝트에 라이선스 파일을 넣지 마십시오.

설치

프로젝트의 pom.xml은 GroupDocs Java 저장소와 아래에 표시된 의존성을 선언합니다. 해당 프로젝트 디렉터리에서 Maven 명령을 실행하십시오. 이 문서의 Java 블록은 검증된 샘플의 메서드 본문이며, 관련 import, 기존 Result 디렉터리 및 clear라는 이름의 boolean 매개변수가 있다고 가정합니다.

<dependency>
  <groupId>com.groupdocs</groupId>
  <artifactId>groupdocs-conversion</artifactId>
  <version>26.10</version>
</dependency>
mvn compile exec:java

단계 1: 속성 정책을 명시적으로 설정하기

세 메서드는 동일한 boolean 정책을 받습니다. false를 전달하면 제어 실행을 위해 원본 설정을 유지하고, true를 전달하면 두 범주의 제거를 요청합니다. WordProcessingLoadOptions에서는 메서드가 setClearBuiltInDocumentProperties와 setClearCustomDocumentProperties입니다. SpreadsheetLoadOptions와 PresentationLoadOptions는 해당 제어를 제공합니다. 이러한 일관성을 통해 각 파일을 여는 로더를 숨기지 않고도 세 가지 서로 다른 입력 패밀리 전반에 걸쳐 하나의 정책을 검토할 수 있습니다.

속성을 유지한 실행은 중요합니다. 원본 마커가 일반 출력에 도달하지 않으면 빈 정리 출력은 약한 증거가 됩니다. 따라서 시연에서는 유지된 Office 복사본에서 각 마커를 확인하고 정리된 복사본에서 그 부재를 확인합니다. 이는 비교에 대한 양성 대조를 제공합니다. 새로운 문서 템플릿을 도입하거나 의존성 버전을 변경할 때 유사한 테스트를 유지하십시오.

단계 2: Word 보고서 내보내기

Word 경로는 documents/report.docx부터 시작합니다. 여기에는 가상의 문서 속성과 짧은 가시 보고서가 포함되어 있습니다. convertWord는 타입이 지정된 옵션을 생성하고 정책을 할당한 뒤 Converter 생성자를 통해 해당 옵션을 제공합니다. 이 메서드는 전달용 PDF와 속성 검사를 위한 DOCX 복사본을 작성합니다. 두 파일 모두 새로운 출력 파일이며, 이 샘플은 원본을 다시 쓰지 않습니다.

WordProcessingLoadOptions options = new WordProcessingLoadOptions();
options.setClearBuiltInDocumentProperties(clear);
options.setClearCustomDocumentProperties(clear);
String target = "Result/docx-" + (clear ? "clean" : "retained");
try (Converter converter = new Converter("documents/report.docx", () -> options)) {
    converter.convert(target + ".pdf", new PdfConvertOptions());
    converter.convert(target + ".docx", new WordProcessingConvertOptions());
}

target 이름은 boolean 인수에 따라 retained 또는 clean으로 끝납니다. 이 구분은 두 실행이 서로 덮어쓰는 것을 방지합니다. 또한 수동 검토를 쉽게 합니다: PDF를 열어 프레젠테이션을 검사하고 해당 Office 파일을 검사해 속성 저장을 확인하십시오. 검증된 실행에서는 Author와 Title이 유지된 PDF에 남아 있었고 정리된 PDF에서는 사라졌습니다. Producer 정보는 남아 있었으며, 이는 별도의 출력 생성 필드입니다.

단계 3: 정책을 Excel 및 PowerPoint에 적용하기

Excel 보고서의 경우 Word 로더를 재사용하는 대신 SpreadsheetLoadOptions를 사용하십시오. 변환 코드는 동일한 속성 플래그를 유지하고 입력 패밀리와 동일 형식 제어 옵션을 변경합니다. 포함된 XLSX는 의도적인 빈 공간을 가지고 있어 페이지 매김이 메타데이터 주장에 포함되지 않습니다. 이를 비즈니스 보고서에 적용할 때 PDF 페이지와 속성 결과를 모두 확인하십시오. 속성 성공이 넓은 시트가 의도대로 인쇄된다는 것을 보장하지는 않습니다.

SpreadsheetLoadOptions options = new SpreadsheetLoadOptions();
options.setClearBuiltInDocumentProperties(clear);
options.setClearCustomDocumentProperties(clear);
String target = "Result/xlsx-" + (clear ? "clean" : "retained");
try (Converter converter = new Converter("documents/report.xlsx", () -> options)) {
    converter.convert(target + ".pdf", new PdfConvertOptions());
    converter.convert(target + ".xlsx", new SpreadsheetConvertOptions());
}

PowerPoint는 PresentationLoadOptions를 사용해 동일한 로딩 정책을 따릅니다. 샘플 슬라이드에는 가상의 보고서 텍스트가 포함되어 있으며, 저자, 제목 및 사용자 정의 참조는 문서 속성 파트에 존재합니다. 이 메서드는 PDF와 PPTX를 저장하여 속성 비교가 슬라이드 렌더링과 독립적으로 유지되도록 합니다. 발표자 메모나 포함된 객체는 검사하지 않습니다. 이러한 요소가 전달 프로세스에 중요하다면, 릴리스 전에 별도의 검토에 포함하십시오.

PresentationLoadOptions options = new PresentationLoadOptions();
options.setClearBuiltInDocumentProperties(clear);
options.setClearCustomDocumentProperties(clear);
String target = "Result/pptx-" + (clear ? "clean" : "retained");
try (Converter converter = new Converter("documents/report.pptx", () -> options)) {
    converter.convert(target + ".pdf", new PdfConvertOptions());
    converter.convert(target + ".pptx", new PresentationConvertOptions());
}

단계 4: 추측 대신 결과 검증하기

PropertyChecks는 여섯 개 Office 제어 파일의 속성 파트를 검사합니다. Internal Review Team, Quarterly Review Draft 및 INTERNAL-REF-2610을 검색합니다. 유지된 복사본은 이러한 알려진 값을 포함해야 하며, 정리된 복사본은 이를 제외해야 합니다. 애플리케이션은 검사된 각 파일에 대해 PASS 라인을 출력하고, 비교가 기대와 일치하지 않으면 실패합니다. 이 검사는 가상의 고정값에 연결된 것이며, 임의의 메타데이터가 발견되고 분류되었다는 주장은 아닙니다.

우리는 또한 Poppler pdfinfo를 사용해 PDF의 Author와 Title을 검사했습니다. 세 가지 Office 소스 모두에서 정리된 내보내기에서는 두 필드가 사라졌습니다. 생성된 Producer 필드는 남아 있었습니다. 이 결과는 주장을 좁혀주기 때문에 유용합니다: 요청된 원본 속성이 제거되었으며, PDF는 여전히 이를 작성한 소프트웨어를 식별할 수 있습니다. 이를 완전히 빈 메타데이터 사전이라는 약속으로 바꾸지 마십시오.

완전한 작동 예제

OfficeMetadataDemo는 동반 Maven 프로젝트의 진입점입니다. Result/ 디렉터리를 생성하고, 세 가지 변환 메서드를 false와 true로 실행한 뒤 PropertyChecks를 호출합니다. 유틸리티는 기능 메서드와 별도로 유지되어 변환 스니펫이 읽기 쉽도록 합니다. RUN.md는 로컬에서 자체 라이선스를 적용하는 방법을 설명합니다. 포함된 문서는 가상이며 고객 데이터 의존성 없이 사용할 수 있습니다.

실제 적용 사례

고객 보고서 전달

내보내기 서비스는 보고서가 승인된 후에만 외부 PDF를 생성할 수 있습니다. 해당 변환 경로에 속성 정책을 적용하고 원본 Office 문서를 기존 내부 위치에 보관하십시오. 유지된 제어를 고객 패키지에 포함하지 마십시오. 여기서는 테스트를 관찰 가능하게 하기 위해 존재합니다.

혼합 Office 제출물

팀은 서술형 보고서, 워크시트 및 프레젠테이션 요약을 받을 수 있습니다. 각 입력 패밀리마다 타입이 지정된 로더를 사용하고 문서화된 정책을 일관되게 적용하십시오. 하나의 성공적인 DOCX 예시에서 지원을 추론하기보다 코드에 파일 패밀리 결정을 명시적으로 유지합니다. 다른 템플릿을 도입할 때는 대표적인 고정값을 추가하십시오.

모범 사례 및 팁

요구 사항에서 정리와 편집을 별도로 유지하십시오. 속성을 지우기 전에 출처 증명을 위해 필요한 속성을 결정하십시오. 전달 출력을 내부 제어와 분리하여 저장하고, 라이선스 설정을 로컬 구성으로 취급하십시오. SDK를 업그레이드할 때는 유지된 변형과 정리된 변형을 모두 다시 실행하여 비교 양쪽에서 예상치 못한 변경이 보이도록 하십시오.

일반적인 문제 해결

전체 시연이 평가 모드에서 중단되면 로컬 복사본에 26.10을 포함하는 라이선스를 적용하고 다시 실행하십시오. 마커가 눈에 보이는 텍스트에 남아 있다면 이는 해당 속성 저장 검사 범위 밖입니다. PDF 입력 정리가 요구 사항이라면 이 샘플에 대체하지 마십시오: 내장 정리가 활성화된 경우 CreationDate 값이 비어 있다는 이유로 별도의 26.10 검사가 실패했습니다. 이 문서에서 테스트된 소스 범위는 Office입니다.

결론

제공된 고정값으로 시작하여 유지된 쌍과 정리된 쌍을 검사하십시오. 지정된 원본 속성을 검증한 후 실제 PDF 내용을 검토하십시오. 비교가 예상대로 동작한 후에만 고정값을 승인된 템플릿으로 교체하십시오. 내보내기 정책을 로드 옵션에 가깝게 유지하여 다음 개발자가 어떤 속성이 시스템을 떠나는지 확인할 수 있도록 하십시오.

추가 자료