This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
PDFIA 통합 MANUALPdfia 라이브러리 사용법 (공통)...........................................................................................................2
Pdfia Component 구성................................................................................................................ 2[필독] 기본절차 안내
C# (ASP.NET, WinForm, WPF) 프로그램에서 Pdfia 를 사용하는 예제..............................................41. 참조(Reference)에 Pdfia 추가.....................................................................................................4
2, 프로젝트 속성 화면에서 빌드탭을 선택한 후 아래와 같이 설정............................................................43. C# Code 예제........................................................................................................................... 5
ASP 에서 Pdfia 를 사용하는 예제.........................................................................................................5COM+ 및 분산 환경 설정.....................................................................................................................6HTML jQuery.getJSON 에서 Pdfia 를 사용하는 예제.......................................................................11Windows Server IIS 설정 방법......................................................................................................14
포트 사용 셋팅 시........................................................................................................................... 16
필독 : 기본적인 Com+방식은 윈도우서버 환경에서만 서비스구성이 가능합니다. 리눅스 등의 타환경의 서버와 서비스 구성을 하시는 경우 기본적으로 pdfia 가 설치된 윈도우서버가 별도로 필요합니다.
윈도우서버 서비스 구성후 (별도 DLL 제공 – 평가판 다운로드는 std 만 가능하며, 별도 dll 은 PRO 에 포함되어 있으며, 별도문의가 필요합니다.
Pdfia 라이브러리 사용법 (공통)Pdfia Component 구성
파일명 Component
Interface 설명
PdfiaCore.exe 실제 변환 작업을 담당하는 핵심 모듈
Pdfia.dll PdfiaProxy IPdfiaProxy
PdfiaCore 의 핵심 기능을 호출하는 라이브러 리로써 COM+ 서비스를 통해서 별도의 서버 에서 동작하도록 구성할 수 있음
margin unsigned short - 여백설정 0 : 기본값 1 : 여백없음 2 : 최소
scale unsigned short - 확대 축소 비율 - 백분율로 설정(기본값 : 100)
delaySecond double - HTML 로딩 완료를 위한 대기 시간(초 단위) (이미지가 제대로 표시되지 않는 경우 대기 시간을 설정할 필요 가 있음)
pageWidth unsigned short - HTML 또는 사이트를 불러올 페이지 너비
pageHeight unsigned short - HTML 또는 사이트를 불러올 페이지 높이
paperType unsigned short - 만들어질 PDF 의 용지 유형0 : Letter (21.59 cm * 27.94 cm)1 : Legal (21.59 cm * 35.56 cm)2 : Executive (18.41 cm * 26.67 cm)3 : A2 (42 cm * 594 cm)4 : A3 (29.7 cm * 42 cm)5 : A4 (21 cm * 29.7 cm) 기본값6 : A5 (14.8 cm * 21 cm)7 : B5 (18.2 cm * 25.7 cm)8 : Envelope #10 (10.48 cm * 24.13 cm)9 : Envelope DL (11 cm * 22 cm)10 : Envelope C5 (16.2 cm * 22.9 cm)11 : Envelope B5 (17.6 cm * 25 cm)12 : Envelope Monarch (9.84 cm * 19.05 cm)13 : A6 (10.5 cm * 14.8 cm)14 : Double Japan Postcard Rotated (14.8 cm * 20 cm)15 : B6 (12.8 cm * 18.2 cm)16 : 16K (19.68 cm * 27.3 cm)
C# (ASP.NET, WinForm, WPF) 프로그램에서 Pdfia 를 사용하는 예제
1. 참조(Reference)에 Pdfia 추가
2, 프로젝트 속성 화면에서 빌드탭을 선택한 후 아래와 같이 설정
3. C# Code 예제
IPdfiaProxy pdfia = new PdfiaProxy();bool success = pdfia.CovertUrl(“http://www.naver.com”, “E:\Temp\naver.pdf”);
ASP 에서 Pdfia 를 사용하는 예제 dim pdfiaObj, success Set pdfiaObj = Server.CreateObject(“Pdfia.PdfiaProxy.1”) success = pdf.ConvertUrl("http://www.naver.com", "E:\Temp\naver.pdf") if success = false then
Response.Write pdfiaObj.GetLastError() else
Response.Write “success” end if
※ 주의할 점
• ASP 또는 ASP.NET 같은 웹 응용프로그램에서 사용되는 경우 반드시 COM+(구성 요소 서비스)에 등록하여 사용해야함.(아래의 COM+ 및 분산 환경 설정 참조)
[기본 install 절차 안내]1. 평가판 zip 압축프로그램을 다운로드받습니다.2. PdfiaSetup(x64)_1.2.0.22 압축해제
3. 해당 PC 또는 서버에 PdfiaSetup(x64)_1.5.0.22.msi 를 설치합니다.
*정식라이센스 신청 및 전환방법은 PDFIA README.201905.docx 를 참고하세요.
COM+ 및 분산 환경 설정 [필수]* 1. 구성 요소 서비스 실행 후 COM+ 응용 프로그램 생성
* 2. 응용 프로그램을 실행할 권한이 있는 사용자 설정 (administrator 권한이나 그에 준한 관리자를 설정)
* 3. 응용 프로그램 등록 후 속성의 보안 탭을 선택한 후 아래와 같이 설정
* 4. 응용 프로그램 생성 후 구성 요소 등록
* 5. 추가 버튼을 누른 후 Pdfia.dll 을 선택한 후 다음을 누르고 설치를 완료
<아래 COM+ 6 번,7 번 절차는 윈도우 서버를 각각 물리적으로 구분하여 구성할 경우 필요한 절차입니다.>
<Json 으로 구성하거나, 윈도우서버가 아닌 타 OS 서버와의 구성에는 아래 절차를 생략해도 됩니다.>
* 6. 다른 서버에서 현재 서버에 설치된 Pdfia 를 호출할 수 있도록 하려면 아래와 같이 응용 프로그램 프록시를 생성됩니다.
* 7. 응용 프로그램 프록시를 생성할 경로 및 파일명을 지정한 후 다음을 눌러 완료
* 생성된 msi 파일과 cab 파일을 다른 서버에 복사한 후 설치 * 설치된 서버에서 Pdfia 라이브러리를 호출하면 리모트 서버의 Pdfia 가 동작하게됨.
주) COM+ 설정까지 완료된 후에 평가판 install 시 설치되는 테스트용 프로그램으로 구동을 꼭 확인하시기 바랍니다.
HTML jQuery.getJSON 에서 Pdfia 를 사용하는 예제
* asp 또는 asp.Net 이 아닌 경우 웹 응용프로그램에서 사용하기 위해 JSON Response 제너릭 핸들러 구성
* Java 또는 PHP 에서 구동 시 Pdfia 가 실행 될 Windows 서버가 필요 . * JavaScript 예제<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
}</script>* JavaScript 예제 (FileName, FolderName 추가 시)<script src="https://code.jquery.com/jquery-1.10.2.js"></script><script type="text/javascript">
function CallPDFIA(RequestURL, RequestFileName, RequestFolderName) {// Get 방식은 URL 인코딩이 없으면 특수문자가 반영이 안 됩니다.var pdf_url = encodeURIComponent(RequestURL);var pdf_name = encodeURIComponent(RequestFileName);var pdf_folder = encodeURIComponent(RequestFolderName);
// 아래 주소창에 PDFIA 가 설치되어 있는 URL 정보 또는 Domain 을 입력 하세요.// 파일명과 폴더명은 javascript 를 이용하여 따로 만드셔도 됩니다. 다만 폴더명은 URL Encoding 이 반드시