PDF Viewer 사용하기 – ASP.NET 및 .NET Core 앱에서 PDF 파일을 고품질로 렌더링하고 전체 검색 및 상호작용을 제공하는 실용 가이드
ASP.NET 또는 .NET Core 웹 앱에서 픽셀 완벽한 PDF 렌더링, 즉시 검색 가능한 텍스트, 그리고 풍부한 화면 상호작용이 필요하신가요? Doconut의 PDF Viewer는 이러한 모든 기능을 즉시 제공합니다. 서버‑사이드 렌더링 모델은 문서 처리를 애플리케이션 인프라 내에서 유지합니다. 그리고 네—전체 기능을 확인하고 싶다면 오늘 바로 무료 체험을 시작할 수 있습니다.
이 가이드에서는 시니어 개발자와 아키텍트를 대상으로 실용적인 통합 방법을 안내하고, 렌더링 엔진이 일반적인 HTML 기반 접근 방식보다 우수한 이유를 설명하며, 외부 서비스를 사용하지 않고 OCR 기반 검색 및 주석을 추가하는 방법을 보여드립니다.
1. Doconut PDF Viewer를 ASP.NET Core 프로젝트에 연결하기
우선, 뷰어를 ASP.NET Core 요청 파이프라인에 연결합니다. 필요한 패키지를 추가하고 프로젝트에서 사용 중인 SDK 버전에 맞게 애플리케이션 서비스를 구성하세요. 정확한 등록 단계는 현재 Doconut 문서를 참고하십시오.
컨트롤러나 서비스 내부에서 Viewer 클래스를 통해 문서 세션을 조정하고 ASP.NET Core가 제공하는 캐싱 및 HTTP 서비스를 활용합니다. 이렇게 하면 뷰어가 페이지, 썸네일 및 주석 데이터를 요청하는 데 필요한 세션 정보를 프런트엔드에 제공할 수 있습니다. SDK‑특정 세부 사항이 컨트롤러와 UI 코드와 분리되도록 통합을 애플리케이션 서비스 뒤에 두세요.
무거운 작업이 서버에 머무르기 때문에 클라이언트는 가벼운 이미지 스트림만 받으며, 사양이 낮은 브라우저에서도 빠른 로드 시간을 제공합니다.
2. .NET에서 렌더링 정확도 – Doconut의 PDF Viewer가 더 뛰어난 이유
PDF에 복잡한 벡터 그래픽, 내장 폰트 또는 고해상도 이미지가 포함된 경우, 많은 일반 뷰어는 저품질 래스터화로 대체됩니다. 그러나 Doconut의 렌더링 엔진은 전용 래스터라이저를 사용해 각 페이지를 처리하며 원본 PDF의 색 공간, 투명도 그룹 및 폰트 힌팅을 그대로 유지합니다.
- Vector‑to‑pixel fidelity – 엔진은 벡터 객체를 요청된 DPI에서 안티앨리어싱된 비트맵 타일로 변환하여 선 굵기와 곡선 부드러움을 유지합니다.
- Embedded font handling – 폰트를 PDF에서 추출해 로컬에서 렌더링함으로써 HTML 기반 뷰어에서 흔히 발생하는 “대체 폰트” 문제를 없앱니다.
- Colour‑management awareness – CMYK 및 스팟 컬러를 정확히 처리합니다. 이는 정확한 색 재현이 필수인 법률 기술 및 재무 보고 분야에서 특히 중요합니다.
문서 목록에 대한 썸네일이 필요하다면 뷰어의 thumbnail‑dimension API를 호출해 특정 페이지의 너비, 높이 및 줌 설정을 가져올 수 있습니다. 그런 다음 <img> 태그에 해당 차원을 삽입하여 사용자의 디바이스 픽셀 비율에 맞게 확장되는 반응형 갤러리를 만들 수 있습니다. 렌더링 파이프라인이 서버에서 실행되므로 CPU 작업을 백그라운드 작업이나 확장된 서비스에 오프로드하여 프런트엔드 지연을 최소화할 수 있습니다.
3. 즉시 검색 및 OCR – 스캔된 PDF를 검색 가능한 콘텐츠로 전환
검색이 불가능한 PDF는 사실상 숨겨진 것과 같습니다. Doconut의 Search Plugin은 내장 OCR 엔진과 결합되어 원본이 네이티브 PDF이든 스캔 이미지이든 모든 페이지를 검색 가능하게 만듭니다.
3.1 실시간 OCR 활성화
문서를 열 때 PdfConfig 객체에 OCR 플래그를 설정합니다. OCR 엔진은 각 래스터 페이지에서 텍스트 레이어를 추출하고 초고속 검색을 위해 인덱싱합니다. 이 처리는 서버‑사이드에서 이루어지므로 기밀 문서가 인프라를 벗어나지 않아 의료 또는 법률 기술 솔루션에서 큰 컴플라이언스 이점을 제공합니다.
3.2 문서 전체 검색
프런트엔드는 간단한 쿼리 문자열을 전용 엔드포인트로 전송합니다. Doconut은 사전 생성된 텍스트 레이어를 조회해 일치하는 페이지 번호와 하이라이트된 스니펫을 반환합니다. 텍스트가 이미 추출되어 있기 때문에 수백 페이지에 달하는 보고서라도 응답이 밀리초 단위로 돌아옵니다. JSON 페이로드에는 페이지 인덱스, 각 일치 항목의 정확한 좌표 및 주변 컨텍스트가 포함되어 있어 렌더링된 페이지 이미지 위에 하이라이트 박스를 오버레이할 수 있습니다.
3.3 엔터프라이즈 워크플로우에 대한 이점
- Reduced manual effort – 사용자는 별도의 편집기를 열지 않고도 계약서 조항이나 재무제표 항목을 손쉽게 찾을 수 있습니다.
- Compliance audit trails – 모든 검색 요청을 로그로 남겨 사용자가 필요한 정보를 열람했음을 증명할 수 있습니다.
- Scalable architecture – 대량 배치를 위해 OCR을 백그라운드 큐에서 실행함으로써 UI의 반응성을 유지합니다.
4. 인터랙티브 주석: 앱 내에서 PDF 검토, 댓글 및 승인
문서 검토 과정은 종종 PDF를 다운로드하고 오프라인에서 주석을 달은 뒤 수정된 버전을 다시 업로드해야 하는 이유로 지연됩니다. Doconut의 Annotation Plugin은 전체 검토 과정을 브라우저 내로 가져오면서, 무거운 주석 로직은 서버에 두어 신뢰성과 보안을 확보합니다.
4.1 주석 관리자 생성
페이지가 요청될 때 해당 페이지의 차원을 알고 있는 주석 관리자를 가져옵니다. 관리자를 통해 지원되는 모든 주석 유형—하이라이트, 스티키 노트, 드로잉 또는 사용자 정의 스탬프—을 추가할 수 있습니다. 예를 들어 좌표, 크기 및 이미지 경로를 지정하여 특정 위치에 “Approved” 스탬프를 배치할 수 있습니다.
관리자는 주석 컬렉션을 XML로 직렬화하며, 이를 문서와 함께 저장하거나 클라이언트에 즉시 시각적 피드백을 제공하기 위해 반환할 수 있습니다.
4.2 주석 저장 및 로드
주석은 가벼운 XML 형태이므로 버전 관리하거나 데이터베이스 컬럼에 저장하기 쉽습니다. 사용자가 다시 방문하면 저장된 XML을 뷰어에 로드하기만 하면 됩니다. 뷰어는 고품질 페이지 이미지 위에 스탬프, 하이라이트 및 댓글을 렌더링하여 네이티브 PDF 편집기와 같은 느낌을 제공합니다.
4.3 엔터프라이즈 수준 상호작용
- Role‑based visibility – 주석이 별도로 저장되므로 사용자 역할에 따라 필터링할 수 있습니다(예: 검토자는 댓글을, 승인자는 스탬프를 확인).
- Auditability – 모든 주석 작업을 사용자의 ID와 타임스탬프와 함께 로그로 남겨 SOX 또는 GDPR 감사 요구사항을 충족합니다.
- No client‑side plugins – 모든 상호작용은 표준 HTTP 호출을 통해 이루어지며 ActiveX, Flash 또는 독점 브라우저 확장 기능이 필요하지 않습니다.
5. 제어된 인쇄 및 안전한 전달 (지원 컨텍스트)
많은 기업이 기밀 계약서나 규제 의료 기록과 같이 PDF 인쇄 방식을 제한해야 합니다. Doconut의 Controlled Printing 기능은 PDF Viewer와 직접 연동되어 인쇄 할당량을 정의하거나 페이지에 워터마크를 삽입하고, 뷰어 UI에서 인쇄 자체를 비활성화할 수 있습니다.
PrintConfig 객체에 원하는 옵션(인쇄 활성화/비활성화, 워터마크 텍스트, 작업당 최대 페이지 수)을 설정하고 이를 문서 토큰에 연결합니다. 사용자가 인쇄 버튼을 클릭하면 서버가 설정된 제한을 적용한 인쇄 준비 PDF를 생성합니다. 처리가 서버‑사이드에서 이루어지므로 출력에 대한 완전한 제어권을 유지하며, 클라이언트는 원본 무제한 파일을 절대 보지 못합니다.
핵심 요약
- ASP.NET Core integration – PDF 뷰어를 애플리케이션 요청 파이프라인에 연결하면서 SDK‑특정 설정을 분리합니다.
- High‑fidelity rendering – 벡터 그래픽, 내장 폰트 및 색 정확성을 유지하여 전문적인 뷰어 경험을 제공합니다.
- Built‑in OCR – 스캔된 PDF를 검색 가능한 텍스트로 변환하여 타사 서비스 필요성을 없앱니다.
- Annotation manager – 하이라이트, 스탬프 및 댓글을 서버에서 완전히 추가, 저장 및 재로드할 수 있어 데이터 무결성과 감사 가능성을 보장합니다.
- Controlled printing – 문서가 브라우저를 떠나는 방식을 세밀하게 제어하여 컴플라이언스 요구사항을 지원합니다.
- 모든 작업은 스트림, 백그라운드 작업 및 웹 API와 함께 작동하므로 대규모 문서 중심 애플리케이션에 적합합니다.
ASP.NET/.NET Core 앱을 업그레이드할 준비가 되셨나요?
Doconut의 PDF Viewer가 제공하는 고품질 렌더링, 즉시 OCR 검색, 서버‑사이드 주석 및 안전한 인쇄 등 모든 기능을 하나의 손쉬운 통합 패키지에서 경험해 보세요. 공식 Doconut 사이트에서 오늘 바로 무료 체험을 시작하고 사용자에게 전문적인 문서 경험을 얼마나 빠르게 제공할 수 있는지 확인하십시오.