개요
개요
PDF 라이브러리에서 제공하는 기능을 이용해 PDF 문서를 제어할 수 있습니다. PDF 라이브러리에서 사용할 수 있는 기능은 다음과 같습니다.
PDF 내 문자열 가져오기: ExtractTextFromPdf
PDF 내 이미지 가져오기: ExtractImageFromPdf
PDF 내 문서를 이미지로 변환하기: ExportPdfToImage
PDF 내 문자열을 검색하기: SearchTextFromPdf
PDF 내 전체 페이지 수 반환하기: GetPdfPageCount
PDF 문서 병합하기: MergePdf
PDF 문서를 여러개의 파일로 분리하기 : SplitPdf
PDF 라이브러리 기능의 샘플은 디자이너 혹은 윈도우 탐색기를 이용하여 참조할 수 있습니다.
• 디자이너 경로: 메뉴 > 도움말 > 샘플 > Sample > PDF
• 윈도우 탐색기 경로: C:\Users\user\AppData\Roaming\Brity RPA Designer\samples\PDF
공통 속성
공통 속성
MORE OPTIONS
속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|
On Error | 콤보박스 | N | - | N | 오류 발생 시 수행할 동작을 지정합니다. - 미지정: 오류를 출력하고, 작업을 종료합니다. - Ignore: 해당 오류를 무시합니다. - Retry: 해당 액티비티를 1회 재시도합니다. - Goto: 해당 액티비티가 실패한 경우 지정한 액티비티로 이동하여 시나리오를 수행합니다. - Event: 프로젝트에 등록된 이벤트를 호출합니다. |
GotoStep Relative Position | 숫자 | N | - | N | 해당 액티비티를 기준으로 이동할 액티비티를 선택합니다. Ctrl + F 를 통해 액티비티 번호를 확인 후 [해당 액티비티 번호] - [대상 액티비티 번호] 값을 입력합니다. (기본값: 0) |
GotoStep Retry Count | 콤보박스 | N | - | N | 해당 액티비티가 실패한 경우 지정된 횟수만큼 이동을 반복합니다. (기본값: 1) |
DESCRIPTION
속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|
DESCRIPTION | 문자 | N | - | N | 해당 액티비티 카드에 대한 설명을 추가합니다. Description이 입력되면 플로차트의 해당 액티비티 설명에 표시되고, Description이 없는 경우에는 대푯값이 해당 액티비티 설명에 표시됩니다. |
ExportPdfToImage
ExportPdfToImage
개요
지정한 PDF 문서를 이미지 파일로 저장합니다.
사용 절차
PDF File에 이미지 파일로 저장할 대상 PDF 파일의 경로와 파일명을 입력하세요.
Target Directory에 변환된 이미지를 저장할 경로와 파일명을 입력하세요.
Password에 PDF 문서의 암호를 입력하세요.
Range에 이미지로 변환할 PDF 문서의 페이지 범위를 입력하세요.
Image Format에 저장할 이미지 포맷을 선택하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | PDF File | 문자열 | Y | - | N | 변환할 대상 PDF 파일의 경로와 파일명을 입력합니다. (ex. 'C:\\ak\\Test.PDF') |
N | Target Directory | 문자열 | Y | - | N | 변환된 이미지 파일의 경로를 입력합니다. (ex. 'C:\\ak') |
N | Image Format | Y | - | Y | 변환 할 이미지 포맷을 선택합니다. (ex. png, gif, tiff, bmp, jpeg) | |
N | Range | 문자열 | Y | - | Y | PDF 문서의 범위를 입력합니다. (ex. '1', '2-4', 'All', '3-End') |
N | DPI | 정수 | Y | - | Y | PDF 문서의 DPI를 입력합니다. |
활용 예시
대상 문서가 6 페이지인 경우 아래 그림과 같이 3개의 png파일이 생성됩니다.
AddDateTime1
사용된 속성
PDF File = 'c:\\ak\\ak_PDF.pdf'
Target Directory = 'c:\\ak'
Password = ''
Range = '4-end'
Image Format = Png
DPI = 96
연관/유사 액티비티
ExtractImageFromPdfSearchTextFromPdfExtractTextFromPdfGetPdfPageCount
ExtractImageFromPdf
ExtractImageFromPdf
개요
지정한 PDF 문서에서 이미지를 추출하여 리스트로 반환합니다.
사용 절차
[Output] Images에 추출한 이미지 객체 리스트를 저장할 변수를 입력하세요.
PDF File에 이미지 객체 리스트를 추출할 대상 PDF 파일의 경로와 파일명을 입력하세요.
Password에 PDF 문서의 암호를 입력하세요.
Range에 이미지 객체 리스트를 추출할 PDF 문서의 페이지 범위를 입력하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Images | 1차원 배열 | Bitmap | 지정한 PDF File에서 추출한 이미지(Bitmap)의 배열을 반환합니다. | 0: Page1 Image 1: Page2 Image |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | PDF File | 문자열 | Y | - | N | 추출할 대상 PDF 파일의 경로와 파일명을 입력합니다. (ex. 'C:\\ak\\Test.PDF') |
N | Range | 문자열 | Y | - | Y | PDF 문서의 범위를 입력합니다. (ex. '1', '2-4', 'All', '3-End') |
활용 예시
대상 문서의 11~20 페이지에 있는 이미지를 추출하여 이미지 객체 리스트를 반환합니다.
사용된 변수
RESULT : 이미지 객체 리스트를 저장할 변수
사용된 속성
PDF File = 'D:\\Documents\\HMM.pdf'
Password = ''
Range = '11-20'
AddDateTime1
연관/유사 액티비티
ExportPdfToImageSearchTextFromPdfExtractTextFromPdfGetPdfPageCount
SearchTextFromPdf
SearchTextFromPdf
개요
지정한 PDF 문서에서 특정 문자열이 속한 페이지 번호를 반환합니다.
사용 절차
[Output] Page Info에 검색된 페이지를 저장할 변수를 입력하세요.
PDF File에 문자열을 검색할 대상 PDF 파일의 경로와 파일명을 입력하세요.
Password에 PDF 문서의 암호를 입력하세요.
Match Optin에서 검색 옵션을 선택하세요.
Range에 문자열을 검색할 PDF 문서의 페이지 범위를 입력하세요.
Text For Search에 검색할 문자열을 입력하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Images | 1차원 배열 | int | 지정한 PDF File에서 특정 문자열(Text For Search)이 속한 페이지 번호를 반환합니다. | 0: 1 1: 4 2: 5 |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | PDF File | 문자열 | Y | - | N | 반환할 대상 PDF 파일의 경로와 파일명을 입력합니다. (ex. 'C:\\ak\\Test.PDF') |
N | Match Case | 토글 버튼 | N | - | Y | 문자열 검색에 대소문자를 구분할 지 여부를 설정합니다. ( 기본값: 대소문자 구분 안 함 ) |
N | Match Whole Word | 토글 버튼 | N | - | Y | 최종 결과에 검색할 문자열 전체가 일치해야 하는 지 여부를 설정합니다.( 기본값: 문자열 부분 일치 ) |
N | Range | 문자열 | Y | - | Y | PDF 문서의 범위를 입력합니다. (ex. '1', '2-4', 'All', '3-End') |
N | Text For Search | 문자열 | Y | - | N | 검색할 문자열을 입력합니다. (ex. 'NoteBook') |
활용 예시
대상 문서의 2~10 페이지 내에서 검색할 문자열이 포함된 페이지의 번호를 리스트로 반환합니다.
AddDateTime1
사용된 변수
RESULT : 검색된 페이지의 번호를 리스트로 저장할 변수
사용된 속성
PDF File = 'c:\\ak\\ak_PDF.pdf'
Password = ''
Range = '2-10'
Text For Search = 'NoteBook'
연관/유사 액티비티
ExportPdfToImageExtractImageFromPdfExtractTextFromPdfGetPdfPageCount
ExtractTextFromPdf
ExtractTextFromPdf
개요
지정한 PDF 문서에서 문자열을 추출하여 반환합니다.
사용 절차
[Output] Text에 추출한 문자열을 저장할 변수를 입력하세요.
PDF File에 문자열을 추출할 대상 PDF 파일의 경로와 파일명을 입력하세요.
Password에 PDF 문서의 암호를 입력하세요.
Range에 문자열을 검색할 PDF 문서의 페이지 범위를 입력하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Text | 1차원 배열 | string | 지정한 PDF File에서 추출한 문자열을 반환합니다. | 0: 'Page1 Contents' 1: 'Page2 Contents' |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | PDF File | 문자열 | Y | - | N | 추출할 대상 PDF 파일의 경로와 파일명을 입력합니다. (ex. 'C:\\ak\\Test.PDF') |
N | Range | 문자열 | Y | - | Y | PDF 문서의 범위를 입력합니다. (ex. '1', '2-4', 'All', '3-End') |
N | Skip Empty Value | 토글 버튼 | N | - | Y | 결과 문자열 목록에서 빈 문자열 항목을 제거할 지 여부를 설정합니다. |
활용 예시
대상 문서의 모든 페이지에서 문자를 추출하여 반환합니다.
AddDateTime1
사용된 변수
RESULT : 추출한 문자열을 저장할 변수
사용된 속성
PDF File = 'D:\\Documents\\HMM.pdf'
Password = ''
Range = 'All'
Skip Empty Value = off
연관/유사 액티비티
ExportPdfToImageExtractImageFromPdfSearchTextFromPdfGetPdfPageCount
GetPdfPageCount
GetPdfPageCount
개요
지정한 PDF 문서의 전체 페이지 수를 반환합니다.
사용 절차
[Output] Page Numbers에 PDF 문서의 전체 페이지 수를 저장할 변수를 입력하세요.
PDF File에 검색할 대상 PDF 파일의 경로와 파일명을 입력하세요.
Password에 PDF 문서의 암호를 입력하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Page Numbers | int | - | 지정한 PDF File의 전체 페이지 수를 반환합니다. | 3 |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | PDF File | 문자열 | Y | - | N | 추출할 대상 PDF 파일의 경로와 파일명을 입력합니다. (ex. 'C:\\ak\\Test.PDF') |
활용 예시
지정한 PDF 문서의 전체 페이지 수를 반환합니다.
AddDateTime1
사용된 변수
RESULT : 페이지 수를 저장할 변수
사용된 속성
PDF File = 'Global.ResourcesDir + 'Docs\\OCR_TEST.pdf'
Password = ''
연관/유사 액티비티
ExportPdfToImageExtractImageFromPdfSearchTextFromPdfExtractTextFromPdf
MergePdf
MergePdf
개요
지정한 폴더의 모든 PDF문서를 병합하여 지정한 이름의 PDF 문서로 저장합니다.
사용 절차
Source Directory에 병합 대상 PDF가 존재하는 디렉토리 경로를 입력하세요.
병합 방법은 아래 3가지 규칙을 따릅니다.
디렉토리 내에 하위 디렉토리로 페이지 순서를 지정할 수 있습니다. 아래와 같이 페이지 순서를 폴더명으로 하여 폴더 내부에 PDF 삽입하여 사용하세요..
AddDateTime1
N/A
만약 하위 폴더가 없으면 이름 순서로 페이지 할당하세요.
하위폴더와 PDF가 혼재할 때는 폴더를 먼저 처리하고 나머지 PDF는 이름 순서로 페이지 할당하세요.
Merged Pdf Path에 병합된 결과 PDF의 파일 경로를 입력하세요.
Overwrite에 병합된 PDF 가 이미 있을 때 덮어쓸지 여부를 입력하세요
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Source Directory | 문자열 | Y | - | N | 병합할 대상 PDF가 존재하는 디렉토리 경로를 입력합니다. (ex. 'C:\\ak') |
N | Merged Pdf Path | 문자열 | Y | - | N | 병합된 결과 PDF의 파일 경로를 입력합니다. (ex. 'C:\\Src\\Test.PDF') |
N | Overwrite | 토글 버튼 | Y | - | Y | 병합된 PDF 가 이미 있을 때 덮어쓸지 여부를 입력합니다. |
활용 예시
대상 폴더의 모든 PDF문서를 병합하여 지정한 이름의 PDF 문서로 저장합니다.
AddDateTime1
사용된 변수
없음
사용된 속성
Source Directory = 'D:\\merge'
Merged Pdf Path = 'D:\\merged.pdf'
Overwrite = true
연관/유사 액티비티
SplitPdf
SplitPdf
개요
지정한 PDF 문서를 여러개의 파일로 분할합니다.
사용 절차
PDF File에 분리할 PDF 파일의 경로와 파일명을 입력하세요.
Target Directory에 분리된 파일을 저장할 경로를 입력하세요.
Equal Division에 PDF 문서의 균등 분할 여부를 선택하세요.
Page Count Or Ranges에 파일당 저장할 페이수(Equal Division이 활성화된 경우) 또는 페이지 범위(Equal Division이 비활성화된 경우)를 입력하세요.
Overwrite에 분리된 PDF가 이미 있을 때 덮어쓸지 여부를 입력하세요
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | PDF File | 문자열 | Y | - | N | 분할할 대상 PDF 파일의 경로와 파일명을 입력합니다. (ex. 'C:\\ak\\Test.PDF') |
N | Target Directory | 문자열 | Y | - | N | 분할된 결과 파일을 저장할 경로를 입력합니다. (ex. 'C:\\ak') |
N | Equal Division | 토글버튼 | Y | - | Y | PDF 문서의 균등 분할 여부를 선택합니다. |
N | Page Count Or Ranges | 문자열 | Y | - | N | 파일당 저장할 페이지 수(Equal Division이 활성화된 경우) 또는 페이지 범위(Equal Division이 비활성화된 경우)를 입력합니다. (ex. 3(균등 분할인 경우) or '1-4, 5-End') |
N | Overwrite | 토글버튼 | Y | - | Y | 분리된 PDF 문서가 이미 있을 때 덮어쓸지 여부를 입력합니다. |
활용 예시
6페이지로 작성된 PDF문서를 2장씩 균등분할 하면 아래와 같이 3개의 파일이 생성 됩니다.
AddDateTime1
사용된 변수
없음
사용된 속성
PDF File = 'c:\\ak\\ak_PDF.pdf'
Target Directory = 'c:\\ak'
Equal Division= true
Page Count Or Ranges = 2
Overwrite = true
연관/유사 액티비티