Aspose.PDF FOSS
TypeScript
TypeScript에서 PDF 첨부 파일 작업하기

TypeScript에서 PDF 첨부 파일 작업하기

이 가이드는 TypeScript용 Aspose.PDF FOSS와 함께 PDF 문서의 파일 첨부 작업 방법을 보여줍니다. Document.AddAttachment()은 문서 수준에서 파일을 삽입하고; Page.AddFileAttachment()은 페이지에 클릭 가능한 클립 모양 주석을 배치하여 삽입된 파일을 엽니다. Node.js 22 이상이 필요합니다.

단계별 가이드

1단계: 패키지 설치 

git clone https://github.com/aspose-pdf-foss/Aspose.PDF-FOSS-for-TypeScript.git
cd Aspose.PDF-FOSS-for-TypeScript
npm install
npm run build

패키지를 설치한 후, 새로운 TypeScript 파일에서 Document 클래스를 가져와 설치를 확인하세요 — 이 줄은 패키지가 설치되면 오류 없이 해결되어야 합니다:

import { Document } from '@asposefoss/pdf';

2단계: 필요한 클래스 가져오기

Document를 가져와 파일을 열고 아래에서 사용되는 두 개의 첨부 진입점에 도달합니다:

import { Document } from '@asposefoss/pdf';

3단계: 대상 문서 열기

두 첨부 방법 모두 열려 있는 Document에서 호출됩니다 — Page 수준 첨부는 추가로 대상 Page가 필요합니다:

const doc = Document.OpenFile('input.pdf');
const page = doc.Pages[0];

4단계: 문서 수준 첨부 삽입

Document.AddAttachment(name, bytes, opts) -> Attachment는 파일을 name을 키로 하여 문서의 내장 파일 컬렉션에 삽입합니다. Document.GetAttachments() -> Attachment[]는 현재 삽입된 모든 항목을 나열하고, Document.RemoveAttachment(name) -> boolean는 이름으로 하나를 제거합니다.

5단계: 페이지 수준 파일 첨부 주석 추가

Page.AddFileAttachment(opts) -> FileAttachmentAnnotation 페이지에 클릭 가능한 아이콘을 배치합니다 — 스티키 노트와 자유 텍스트 주석에 대해 다룬 주석 가이드 — 뷰어가 임베드된 파일을 저장하거나 미리 보기 위해 여는 것입니다. 와 달리 Document.AddAttachment(),특정 페이지 위치에 고정되며, 문서의 embedded-files 컬렉션에만 나열되는 것이 아닙니다.

일반적인 문제 및 해결책

에 추가된 첨부 파일은 Document.AddAttachment() 페이지에 보이는 아이콘이 없습니다. 이는 예상된 동작입니다 — 문서 수준의 첨부 파일은 페이지가 아니라 embedded-files 컬렉션에 존재합니다. Use Page.AddFileAttachment() 특정 페이지에 클릭 가능한 아이콘이 필요할 경우 추가로 사용하십시오.

Document.RemoveAttachment() returns false. 반환합니다 false 주어진 항목에 첨부 파일이 등록되지 않은 경우 name — 현재 집합을 다음으로 나열하십시오 Document.GetAttachments() 먼저 사용 중인 정확한 이름을 확인하십시오.

두 개의 첨부 파일이 동일한 항목에 포함되었습니다 name. name in Document.AddAttachment() 는 첨부 파일을 다시 찾아보는 데 사용되는 키입니다 RemoveAttachment() — 두 번째 호출에 같은 이름을 재사용하면 뷰어가 중복을 어떻게 처리하느냐에 따라 첫 번째를 가리키거나 충돌할 수 있습니다. 각 포함된 파일마다 고유한 이름을 사용하십시오.

자주 묻는 질문

문서 수준 첨부 파일과 페이지 수준 첨부 파일의 차이점은 무엇인가요?

문서 수준 첨부 파일 (Document.AddAttachment())은 PDF의 embedded-files 컬렉션에 존재하며 어떤 페이지에도 연결되지 않습니다. 페이지 수준 첨부 파일 (Page.AddFileAttachment())은 특정 페이지 위치에 고정된 주석으로, 포스트잇과 유사합니다.

문서에 현재 삽입된 내용을 어떻게 확인할 수 있나요?

Call Document.GetAttachments()를 호출하면 현재 삽입된 모든 Attachment을 반환합니다.

첨부 파일을 추가한 후에 제거할 수 있나요?

예 — Document.RemoveAttachment(name)는 문서 수준의 첨부 파일을 추가된 이름으로 제거하며, 찾고 제거했을 경우 true를 반환합니다.

참조

 한국어