GroupDocs.Redaction을 사용한 .NET 문서 관리 마스터하기
소개
오늘날 디지털 환경에서 효율적인 문서 관리는 데이터 프라이버시를 유지하고 검색 기능을 향상시키는 데 필수적입니다. 개발자이든 문서 처리 능력을 향상시키려는 기업이든 Aspose와 GroupDocs와 같은 강력한 라이브러리를 통합하면 큰 변화를 가져올 수 있습니다. 이 튜토리얼에서는 이러한 라이브러리의 라이선스를 설정하고 GroupDocs.Redaction .NET 라이브러리를 사용해 HTML 형식으로 검색 결과를 강조 표시하는 방법을 안내합니다.
배우게 될 내용:
- Aspose 및 GroupDocs 라이브러리 라이선스 설정 방법
- GroupDocs.Search를 사용한 경로 설정 및 검색 수행
- GroupDocs.Viewer를 사용하여 HTML 문서에서 검색어 강조
- 이 기능들을 실제 .NET 애플리케이션에 구현하기
실용적인 예제와 단계별 안내를 통해 문서 관리 프로세스를 효율화할 수 있습니다.
빠른 답변
- GroupDocs.Redaction 라이선스를 어떻게 설정하나요? API 호출 전에
License클래스를 사용해.lic파일을 로드합니다. - HTML 콘텐츠를 검색하고 강조 표시할 수 있나요? 예, GroupDocs.Search와 GroupDocs.Viewer를 결합하면 용어를 찾고 강조된 HTML을 렌더링할 수 있습니다.
- Aspose 라이선스도 필요합니까? 추가 렌더링을 위해 Aspose.HTML을 사용하는 경우에만 필요합니다; 그렇지 않으면 GroupDocs.Redaction만으로 충분합니다.
- 지원되는 .NET 버전은 무엇인가요? .NET Framework 4.5+, .NET Core 3.1+, .NET 5/6/7.
- 테스트용으로 체험 라이선스면 충분한가요? 임시 라이선스를 사용하면 시간 제한 없이 모든 기능을 평가할 수 있습니다.
GroupDocs.Redaction 라이선스를 설정하는 방법?
License 클래스는 GroupDocs SDK에 라이선스 파일을 등록합니다. License 클래스로 라이선스 파일을 로드하고 다른 SDK 호출 전에 SetLicense를 호출하십시오. 이렇게 하면 전체 기능이 활성화되고 평가용 워터마크가 제거되며 성능 최적화가 적용됩니다. 라이선스를 미리 로드하면 SDK가 이후 모든 작업에 대해 권한 검사를 수행하여 모든 Redaction, Search 및 Rendering 기능이 제한 없이 작동하도록 보장합니다.
dotnet add package GroupDocs.Redaction
Aspose.HTML 라이선스 설정 방법?
Aspose.HTML의 License 클래스는 제품 라이선스를 등록하고 체험 제한을 해제합니다. Aspose의 License 객체를 인스턴스화하고 .lic 파일을 지정하십시오. 이렇게 하면 모든 Aspose.HTML 렌더링 기능이 체험 경고 없이 실행되고 CSS 지원 및 고급 레이아웃 엔진과 같은 프리미엄 렌더링 옵션을 사용할 수 있습니다.
using Aspose.Html;
string licensePath = @"YOUR_DOCUMENT_DIRECTORY/Conholdate.Total.Product.Family.lic";
new License().SetLicense(licensePath);
- 설명:
License.SetLicense가 라이선스 파일을 로드하여 모든 기능을 활성화합니다.
GroupDocs.Viewer 라이선스 설정 방법?
GroupDocs.Viewer용 License 클래스는 뷰어 라이선스를 등록하여 PDF, DOCX 등 다양한 형식을 HTML로 고품질 렌더링하면서 워터마크를 제거합니다. GroupDocs.Viewer용 License 인스턴스를 생성하고 SetLicense를 호출하십시오. HTML로 문서를 완전한 품질로 렌더링하려는 경우 반드시 필요한 단계입니다.
using GroupDocs.Viewer;
new License().SetLicense(licensePath);
GroupDocs로 HTML 검색 및 강조 표시를 사용하는 이유?
GroupDocs.Search는 가볍고 읽기 전용 구조로 문서를 인덱싱하여 수백만 레코드를 밀리초 단위로 조회할 수 있습니다. GroupDocs.Viewer와 결합하면 지원되는 모든 문서를 HTML로 렌더링하고 CSS 스타일 강조를 통해 일치하는 용어를 오버레이할 수 있습니다. 정량적 주장: 일반적인 2 GHz 서버에서 500페이지 PDF를 2초 미만에 처리하고, 뷰어는 동일 파일을 1초 미만에 HTML로 렌더링합니다.
GroupDocs.Redaction을 .NET에서 설정하기
설치
프로젝트에서 GroupDocs.Redaction을 사용하려면 다양한 패키지 관리자를 통해 설치할 수 있습니다:
.NET CLI:
Install-Package GroupDocs.Redaction
Package Manager Console:
// Set your license path
string redactionLicensePath = @"YOUR_DOCUMENT_DIRECTORY/Conholdate.Total.Product.Family.lic";
// Initialize the Redaction API with the license
new GroupDocs.Redaction.License().SetLicense(redactionLicensePath);
NuGet 패키지 관리자 UI:
“GroupDocs.Redaction"을 검색하고 최신 버전을 설치합니다.
라이선스 획득
GroupDocs.Redaction의 전체 기능을 사용하려면 라이선스를 획득해야 합니다. 다음 옵션 중 선택할 수 있습니다:
- 무료 체험: 기능을 테스트하기 위해 체험 라이선스를 다운로드합니다.
- 임시 라이선스: GroupDocs Temporary License를 통해 획득합니다.
- 구매: 운영 환경에서 사용할 영구 라이선스를 구매합니다.
자세한 라이선스 조건은 GroupDocs Documentation을 참조하십시오.
기본 초기화 및 설정
string basePath = @"./HighlightInHtml/HighlightExample";
string viewerCacheFolderPath = basePath + @"/ViewerCache";
string indexFolder = basePath + @"/Index";
string documentsFolder = @"YOUR_DOCUMENT_DIRECTORY/DocumentsPath";
string query = "\"dapibus diam\" OR lorem";
구현 가이드
Aspose 및 GroupDocs 라이브러리 라이선스 설정
개요
라이선스를 설정하면 Aspose.HTML 및 GroupDocs.Viewer의 모든 기능을 제한 없이 활용할 수 있습니다.
단계
1. Aspose.HTML 라이선스 설정
using GroupDocs.Search;
Index index = new Index(indexFolder); // Initialize index at specified path
index.Add(documentsFolder); // Add documents from directory to index
2. GroupDocs.Viewer 라이선스 설정
using GroupDocs.Search.Results;
SearchResult result = index.Search(query); // Execute the search
FoundDocument foundDocument = result.GetFoundDocument(0); // Retrieve first document
경로 및 쿼리 설정
개요
문서 경로를 정의하고 특정 콘텐츠를 찾기 위한 검색 쿼리를 준비합니다.
단계
1. 기본 경로 정의
using GroupDocs.Search.Highlighters;
using GroupDocs.Viewer.Options;
IndexedFileInfo fileInfo = new IndexedFileInfo(viewerCacheFolderPath, foundDocument.DocumentInfo.FilePath);
HighlightService highlightService = new HighlightService(fileInfo, null); // Prepare for highlighting
highlightService.Highlight(foundDocument, index.Dictionaries.Alphabet); // Perform highlighting
- 설명: 경로를 체계적으로 구성하면 검색 및 강조 기능을 원활하게 통합할 수 있습니다.
인덱스 생성 및 추가
개요
효율적인 문서 검색을 위해 인덱스를 생성합니다.
단계
1. 인덱스 생성
CODE_BLOCK_PLACEHOLDER_9_END
- 설명:
Index객체가 인덱스된 데이터를 관리하여 빠른 검색을 가능하게 합니다.
인덱스 검색
개요
생성된 인덱스에 검색 쿼리를 실행하고 결과를 가져옵니다.
단계
1. 검색 수행
CODE_BLOCK_PLACEHOLDER_10_END
- 설명:
index.Search가 쿼리를 실행하고 일치하는 문서를 반환합니다.
HTML에서 검색 결과 강조
개요
GroupDocs.Viewer를 사용해 문서의 HTML 표현 내에서 용어를 강조합니다.
단계
1. Highlight 서비스 초기화
CODE_BLOCK_PLACEHOLDER_11_END
- 설명:
HighlightService가 문서 내 검색어를 처리하고 강조합니다.
실용적인 적용 사례
- 법률 문서 분석: 핵심 법률 용어를 빠르게 찾아 강조합니다.
- 고객 지원: 지원 티켓에서 관련 고객 피드백을 강조합니다.
- 연구 논문: 특정 과학 용어를 강조하여 연구를 촉진합니다.
- 재무 보고서: 중요한 재무 지표를 식별하고 강조합니다.
- 콘텐츠 관리: 키워드 강조를 통해 콘텐츠 검색성을 향상합니다.
성능 고려 사항
- 인덱스 최적화: 효율적인 검색을 위해 인덱스를 정기적으로 업데이트합니다.
- 메모리 관리: 가능한 경우 비동기 처리를 사용해 메모리 사용량을 관리합니다.
- 리소스 사용량: 애플리케이션 성능을 모니터링하고 리소스 할당을 조정합니다.
일반적인 문제 및 해결 방법
- License not recognized –
.lic파일 경로가 절대 경로이거나 실행 어셈블리 기준으로 올바르게 상대 경로인지 확인합니다. - Search returns no results – 새 문서를 추가한 후 인덱스를 재구성해야 합니다; 인덱스는 파일 변경을 자동으로 감지하지 않습니다.
- HTML highlights missing CSS – GroupDocs.Viewer에서 제공하는 기본 스타일시트를 포함하거나
<mark>태그 스타일링을 위한 사용자 정의 CSS를 추가합니다. - Large PDFs cause timeouts –
SearchOptions.MaxDegreeOfParallelism설정을 늘려 다중 코어 프로세서를 활용합니다.
자주 묻는 질문
Q: GroupDocs 라이선스를 어떻게 얻나요?
A: 자세한 내용은 GroupDocs Temporary License를 방문하십시오.
Q: GroupDocs를 상업 프로젝트에 사용할 수 있나요?
A: 예, 적절한 라이선스를 획득하면 사용할 수 있습니다.
Q: 문서 경로 관리를 위한 최선의 방법은 무엇인가요?
A: 일관된 디렉터리 구조와 환경 변수를 활용해 유연성을 확보합니다.
Q: 검색 성능을 어떻게 향상시킬 수 있나요?
A: 인덱스를 정기적으로 업데이트하고 쿼리 매개변수를 최적화합니다.
Q: GroupDocs에서 영어 외 다른 언어를 지원하나요?
A: 예, 다수의 언어 사전이 지원됩니다.
리소스
결론
GroupDocs.Redaction을 사용해 라이선스를 설정하고, 검색 경로를 구성하며, 인덱스를 생성하고, 검색을 수행하고, 결과를 HTML에서 강조하는 방법을 배웠습니다. 이러한 기능을 애플리케이션에 통합하면서 고급 기능에 대한 추가 문서를 탐색해 보세요.
다음 단계:
- 더 깊이 파고들려면 GroupDocs 문서를 살펴보세요.
- Redaction 및 Annotation과 같은 추가 기능을 실험해 보세요.
Last Updated: 2026-08-15
Tested With: GroupDocs.Redaction 23.10 for .NET
Author: GroupDocs
