Cum să lucraţi cu atașamente PDF în TypeScript

Acest ghid arată cum să lucrați cu atașamente de fișiere în documente PDF cu Aspose.PDF FOSS pentru TypeScript. Document.AddAttachment() încorporează un fișier la nivelul documentului; Page.AddFileAttachment() plasează o adnotare tip agrafă, clicabilă, pe o pagină care deschide fișierul încorporat. Necesită Node.js 22 sau o versiune ulterioară.

Ghid pas cu pas

Pasul 1: Instalați pachetul

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

Verificați instalarea importând clasa Document într-un nou fișier TypeScript — această linie ar trebui să se rezolve fără eroare odată ce pachetul este instalat:

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

Pasul 2: Importați clasele necesare

Importați Document pentru a deschide fișierul și a accesa ambele puncte de intrare pentru atașamente utilizate mai jos:

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

Pasul 3: Deschideți documentul țintă

Ambele metode de atașare sunt apelate pe un Document deschis — atașamentele la nivel de Page necesită în plus Page țintă:

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

Pasul 4: Încorporați un atașament la nivel de document

Document.AddAttachment(name, bytes, opts) -> Attachment încorporează un fișier în colecția de fișiere încorporate a documentului, indexată prin name. Document.GetAttachments() -> Attachment[] afișează tot ce este în prezent încorporat, iar Document.RemoveAttachment(name) -> boolean elimină unul după nume.

Pasul 5: Adăugați o adnotare de atașament de fișier la nivel de pagină

Page.AddFileAttachment(opts) -> FileAttachmentAnnotation plasează o pictogramă clicabilă pe pagină — similară cu adnotările sticky-note și free-text acoperite în Adnotări ghidul — pe care un vizualizator îl deschide pentru a salva sau previzualiza fișierul încorporat. În contrast cu Document.AddAttachment(), este ancorat la o locație specifică a paginii, în loc să fie listat doar în colecția de embedded-files a documentului.

Probleme comune și remedieri

Un atașament adăugat cu Document.AddAttachment() nu are nicio pictogramă vizibilă pe nicio pagină. Acest lucru este de așteptat — un atașament la nivel de document trăiește în colecția de embedded-files, nu pe o pagină. Folosiți Page.AddFileAttachment() în plus dacă este necesară o pictogramă clicabilă pe o pagină specifică.

Document.RemoveAttachment() returns false. Returnează false când nu există niciun atașament înregistrat sub cel specificat name — afișează setul curent cu Document.GetAttachments() mai întâi pentru a confirma numele exact în uz.

Două atașamente au fost încorporate sub același name. name in Document.AddAttachment() este cheia folosită pentru a căuta înapoi atașamentul cu RemoveAttachment() — reutilizarea unui nume pentru un al doilea apel poate umbri sau intra în conflict cu primul, în funcție de modul în care vizualizatorul rezolvă duplicatele. Folosiți un nume distinct pentru fiecare fișier încorporat.

Întrebări frecvente

Care este diferența dintre un atașament la nivel de document și unul la nivel de pagină?

Un atașament la nivel de document (Document.AddAttachment()) trăiește în colecția embedded-files a PDF-ului și nu este legat de nicio pagină. Un atașament la nivel de pagină (Page.AddFileAttachment()) este o adnotare ancorată la o locație specifică a paginii, similară cu o notiță adezivă.

Cum pot vedea ce este în prezent încorporat într-un document?

Apelă Document.GetAttachments(), care returnează fiecare Attachment încorporat în prezent.

Poate fi eliminat un atașament după ce a fost adăugat?

Da — Document.RemoveAttachment(name) elimină un atașament la nivel de document după numele sub care a fost adăugat și returnează true dacă a găsit și a eliminat unul.