Document Viewer Library 사용하기 – PDF, Office 및 CAD 형식을 지원하고 내장 주석, 검색 및 인쇄 기능 제공: 실용 가이드
← Back to Blog6 min read

Document Viewer Library 사용하기 – PDF, Office 및 CAD 형식을 지원하고 내장 주석, 검색 및 인쇄 기능 제공: 실용 가이드

Doconut의 Document Viewer Library를 사용하면 PDF, Office 및 CAD 파일을 렌더링하고, 주석을 달며, 내용 검색 및 인쇄를 단일 .NET 구성 요소만으로 수행할 수 있습니다. 문서 중심 포털, 법률 기술 케이스 관리 시스템, 혹은 엔지니어링 도면 검토 도구를 구축하고 있다면, 사용자와 동일하게 즉시, 안전하게, 외부 서비스 없이 작동하는 뷰어가 필요합니다. Doconut은 이러한 경험을 온프레미스로 제공하며, ASP.NET 또는 .NET Core 애플리케이션 내부에서 코드베이스를 깔끔하게 유지하고 배포 footprint를 최소화합니다.

이 실용 가이드에서는 Document Viewer Library의 핵심 워크플로를 살펴보고, 임베드 방법을 보여주며, 필수적인 세 가지 핵심 요소—주석, 검색(OCR 포함), 그리고 제어된 인쇄—를 시연합니다. 끝까지 읽으면 바로 실행 가능한 프로토타입과 Doconut이 문서 중심 엔터프라이즈 솔루션의 핵심이 될 수 있는 명확한 그림을 얻게 됩니다.

주석 및 인쇄 도구와 함께 PDF, Office 및 CAD 파일을 표시하는 보안 엔터프라이즈 문서 뷰어
주석 및 인쇄 도구와 함께 PDF, Office 및 CAD 파일을 표시하는 보안 엔터프라이즈 문서 뷰어

Windows 배포 및 무료 체험 옵션

Doconut의 라이브러리는 .NET 6에서 실행되며 Windows 환경에서 완전히 지원됩니다. Azure, AWS 또는 온프레미스에 앱을 호스팅하든 일관된 렌더링 및 주석 성능을 제공합니다.

빠르게 시작하려면 Doconut이 무료 체험을 제공하며, 여기에는 주석 엔진, OCR 기반 검색 및 제어된 인쇄 기능에 대한 전체 접근 권한이 포함됩니다. 공식 사이트에서 가입하고 체험 라이선스를 다운로드한 뒤 아래 통합 단계를 따라 몇 분 안에 라이브러리를 직접 확인해 보세요.


.NET 엔터프라이즈를 위한 Document Viewer Library가 게임 체인저인 이유

계약서, 엔지니어링 설계도, 직원 기록을 관리하는 기업은 세 가지 반복적인 과제에 직면합니다:

  1. 형식 다양성 – PDF, Word 문서, Excel 스프레드시트 및 CAD 도면이 동일 저장소에 공존합니다.
  2. 협업 검토 – 비즈니스 사용자는 애플리케이션을 떠나지 않고 문서를 강조 표시, 댓글 달기 또는 스탬프를 찍을 수 있어야 합니다.
  3. 규제된 접근 – 인쇄는 감사 가능해야 하며, 스캔된 이미지에도 검색 가능한 텍스트가 제공되어야 합니다.

Doconut의 Document Viewer Library는 단일 서버‑사이드 .NET 구성 요소로 이 세 가지 문제를 모두 해결하며, 기본적으로 DOCX, XLSX, PPTX, DWG, DXF 등을 포함한 33가지 이상의 파일 형식을 지원합니다. 라이브러리는 각 형식을 네이티브하게 렌더링하여 Microsoft Office, Acrobat 또는 외부 변환 서비스가 필요 없게 합니다. 렌더링이 서버에서 이루어지기 때문에 민감한 데이터를 방화벽 뒤에 보관할 수 있어 의료, 법률 및 금융 분야에 필수적입니다.

내장 주석 엔진을 사용하면 하이라이트, 자유형 손그림 또는 스탬프 승인 등을 뷰어 캔버스에 직접 추가할 수 있습니다. 주석은 가벼운 XML 형태로 저장되어 데이터베이스나 버전 관리 시스템에 쉽게 보관할 수 있습니다. 검색 플러그인은 열려 있는 모든 문서에서 즉시 텍스트를 조회할 수 있게 하며, 소스가 스캔 이미지인 경우 OCR 엔진이 실시간으로 검색 가능한 문자열을 추출합니다. 마지막으로 제어된 인쇄 기능을 통해 페이지 범위 제한, 워터마크 적용 또는 인쇄 감사 로그를 단일 API 호출로 구현할 수 있습니다.

이러한 기능을 결합하면 서드파티 뷰어, JavaScript 플러그인 및 외부 변환 서비스로 얽힌 스택을 단일 유지 보수 가능한 라이브러리로 대체할 수 있으며, 소수 사용자부터 엔터프라이즈 전체 배포까지 확장 가능합니다.


뷰어 임베드: ASP.NET Core 단계별 통합

다음은 Doconut의 Document Viewer Library를 ASP.NET Core 애플리케이션에 통합하기 위해 필요한 단계에 대한 간략한 설명입니다:

  1. Doconut 미들웨어 등록 – 내부 이미지‑타일 엔드포인트(DocImage.axd)를 처리하도록 UseDoconut 미들웨어를 구성합니다. 이 엔드포인트는 렌더링된 페이지를 PNG 타일로 스트리밍하여 대형 CAD 파일에서도 UI가 반응성을 유지합니다.
  2. 라이선스 로드 – Doconut 라이선스 파일(예: DoconutLicense.xml)을 디스크 파일이나 스트림으로 제공하십시오. 라이브러리는 첫 번째 뷰어 인스턴스 생성 시 자동으로 라이선스를 읽습니다.
  3. 뷰어 인스턴스 생성Viewer 클래스를 인스턴스화하고, 분산 캐시나 HTTP 컨텍스트 액세서와 같은 필요한 서비스를 전달합니다.
  4. 렌더링 옵션 구성 – 기본 렌더링 동작, 하이퍼링크 추출 및 CAD 도면의 래스터 해상도를 제어하기 위해 구성 객체(예: PdfConfig)를 설정합니다.
  5. 문서 열기 – 파일 경로(또는 스트림)와 앞서 정의한 구성을 사용해 OpenDocument 메서드를 호출합니다. 이 메서드는 JavaScript 프런트엔드가 페이지 이미지, 주석 및 검색 결과를 요청하는 데 사용하는 보안 토큰을 반환합니다.

이 단계들을 수행하면 .NET 6을 실행하는 Windows 환경에서 서버‑사이드 뷰어가 구축됩니다. 토큰 기반 접근 방식으로 클라이언트는 가볍게 유지되며, 프런트엔드는 https://doconut.app에 호스팅된 Doconut 뷰어 구성 요소만 참조하면 됩니다.


실시간 검토 워크플로를 위한 내장 주석

주석은 수동 뷰어를 협업 작업 공간으로 변환합니다. Doconut의 주석 관리자는 페이지 단위로 작동하며 모든 데이터를 XML로 저장하므로 데이터베이스에서 버전 관리, 감사 또는 변경 병합을 쉽게 할 수 있습니다.

일반적인 주석 워크플로

  1. 뷰어의 GetAnnotationManager 메서드를 호출하고 페이지 차원을 제공하여 현재 페이지의 주석 관리자를 가져옵니다.
  2. 주석 객체(예: 이미지 스탬프, 하이라이트 또는 자유형 손그림)를 생성하고 위치, 크기 및 시각적 속성을 설정합니다.
  3. 주석을 관리자에 추가합니다.
  4. GetAnnotationXml을 사용해 주석 XML을 영구 저장하고 데이터 저장소에 보관합니다.
  5. 문서를 다시 열 때 LoadAnnotationXML을 사용해 저장된 XML을 뷰어에 로드합니다.

엔터프라이즈 시나리오

  • Legal Tech – 변호사가 계약서에 “Signature” 스탬프를 찍고, XML을 케이스 관리 서비스에 제출하여 감사를 수행합니다.
  • Engineering Review – 설계자가 DWG 페이지에 직접 레드라인 도면을 추가하고, 주석 XML을 리비전 히스토리와 함께 저장합니다.
  • HR & Recruitment – 채용 담당자가 이력서의 핵심 섹션을 하이라이트하고, 댓글을 추가한 뒤 주석이 달린 버전을 후보자 프로필에 업로드합니다.

주석 데이터가 서버에 존재하기 때문에 편집, 조회 및 인쇄 권한을 완전하게 제어할 수 있습니다. API는 의도적으로 간결하여 관리자를 가져오고, 추가하고, 로드하는 메서드만 필요하고, 추가 UI 기능(undo/redo, 커스텀 툴)을 별도 의존성 없이 구축할 수 있습니다.


즉시 검색 및 OCR: 모든 문서를 찾을 수 있게 만들기

문서 저장소는 사용자가 필요한 정보를 몇 초 안에 찾을 수 있을 때만 가치가 있습니다. Doconut의 검색 플러그인은 열려 있는 모든 파일에 대해 즉시 전체 텍스트 검색을 제공합니다. 래스터 전용 PDF나 스캔된 CAD 도면의 경우, 내장 OCR 엔진이 필요 시 텍스트를 추출하여 별도의 전처리 없이 이미지를 검색 가능한 콘텐츠로 변환합니다.

일반적인 검색 워크플로

  1. 원하는 키워드와 함께 뷰어의 검색 메서드(검색 플러그인에서 노출)를 호출합니다.
  2. 일치하는 페이지 번호와 각 매치의 좌표 목록을 받습니다.
  3. 각 매치에 대해 페이지의 주석 관리자를 얻고, 해당 용어가 나타나는 위치를 표시하기 위해 임시 하이라이트 주석을 추가합니다.

사용자가 청구서의 스캔된 PDF를 열면 뷰어는 렌더링되는 각 페이지에 대해 자동으로 OCR을 실행합니다. 추출된 텍스트는 메모리에 인덱싱되어 이후 검색이 즉시 이루어집니다. 이 접근 방식은 별도 OCR 서비스 필요성을 없애고 지연 시간을 줄이며, 검색 가능한 텍스트가 보안 환경을 벗어나지 않도록 보장합니다.

엔터프라이즈 혜택

  • 고객 포털은 계약서에서 관련 조항을 한 번의 키 입력으로 표시할 수 있습니다.
  • 재무 보고 도구는 분석가가 수십 개의 스캔된 명세서에서 특정 항목을 찾아낼 수 있게 합니다.
  • 헬스케어 기록 시스템은 스캔된 의사 메모 내 약물명을 검색 가능하게 하여 환자 안전을 향상시킵니다.

이 모든 기능은 서드파티 의존성 없이 구현되어 스택을 가볍게 유지하고 컴플라이언스 범위를 최소화합니다.


뷰어에서 제어된 인쇄 – 보안과 편리함의 결합

인쇄는 종종 문서 보안의 가장 취약한 고리입니다. Doconut의 제어된 인쇄 기능을 사용하면 무엇을, 언제, 어떻게 인쇄할지 결정할 수 있으며, 익숙한 브라우저 기반 인쇄 대화 상자를 제공합니다.

일반적인 인쇄 워크플로

  1. PrintConfig 객체를 정의하여 페이지 범위 제한, 워터마크 및 각 인쇄 요청을 로그할지 여부와 같은 옵션을 지정합니다.
  2. 구성 객체와 문서 토큰을 함께 뷰어의 Print 메서드에 전달합니다.
  3. 뷰어는 선택된 페이지를 서버에서 렌더링하고, 워터마크를 적용한 뒤 인쇄 가능한 PDF를 클라이언트 브라우저로 스트리밍합니다.
  4. 감사 항목이 자동으로 생성되어 관리자가 누가 언제 무엇을 인쇄했는지 추적할 수 있습니다.

인쇄를 서버에서 처리함으로써 Doconut은 원본 문서가 보호된 환경을 벗어나지 않도록 보장하고, 인쇄 활동에 대한 완전한 가시성을 유지합니다—규제 산업에 필수적인 요구 사항입니다.


결론

Doconut의 Document Viewer Library는 .NET 팀에게 PDF, Office 파일 및 CAD 도면을 렌더링하고, 주석, OCR 기반 검색 및 제어된 인쇄 기능을 제공하는 단일, 안전하고 기능이 풍부한 구성 요소를 제공합니다. 서버‑사이드 처리, 내장 변환 및 33가지 이상의 파일 형식 지원을 통해 비용이 많이 드는 서드파티 의존성을 제거하고 민감한 데이터를 직접 제어할 수 있습니다.

엔터프라이즈 문서 워크플로를 현대화할 준비가 되셨나요? 오늘 Doconut의 무료 체험을 시작하고, 라이브러리를 다운로드한 뒤 위에 제시된 통합 단계를 따라 몇 분 안에 .NET 애플리케이션에 강력한 뷰잉, 주석 및 검색 기능을 도입하세요.

#Doconut#.NET#Document Viewer#Enterprise Development#PDF#CAD#Annotation#문서 뷰어#엔터프라이즈 개발#주석