Πώς να εργαστείτε με συνημμένα PDF σε TypeScript

Αυτός ο οδηγός δείχνει πώς να εργάζεστε με συνημμένα αρχεία σε έγγραφα PDF με το Aspose.PDF FOSS για TypeScript. Το 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

Επαληθεύστε την εγκατάσταση εισάγοντας την κλάση Document σε ένα νέο αρχείο TypeScript — αυτή η γραμμή πρέπει να λυθεί χωρίς σφάλμα μόλις το πακέτο εγκατασταθεί:

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(), είναι αγκυροβολημένο σε συγκεκριμένη θέση στη σελίδα αντί να καταγράφεται μόνο στη συλλογή ενσωματωμένων αρχείων του εγγράφου.

Κοινά Προβλήματα και Διορθώσεις

Ένα συνημμένο που προστέθηκε με Document.AddAttachment() δεν έχει ορατό εικονίδιο σε καμία σελίδα. Αυτό είναι αναμενόμενο — ένα συνημμένο επιπέδου εγγράφου βρίσκεται στη συλλογή ενσωματωμένων αρχείων, όχι σε σελίδα. Χρησιμοποιήστε Page.AddFileAttachment() επιπλέον εάν απαιτείται εικονίδιο με δυνατότητα κλικ σε συγκεκριμένη σελίδα.

Document.RemoveAttachment() returns false. Επιστρέφει false όταν δεν υπάρχει συνημμένο καταχωρημένο κάτω από το δεδομένο name — απαριθμήστε το τρέχον σύνολο με Document.GetAttachments() πρώτα για να επιβεβαιώσετε το ακριβές όνομα σε χρήση.

Δύο συνημμένα ενσωματώθηκαν κάτω από το ίδιο name. name in Document.AddAttachment() είναι το κλειδί που χρησιμοποιείται για την ανάκτηση του συνημμένου με RemoveAttachment() — η επαναχρήση ενός ονόματος για δεύτερη κλήση μπορεί να σκιάσει ή να συγκρουστεί με το πρώτο, ανάλογα με το πώς ο προβολέας επιλύει τα διπλότυπα. Χρησιμοποιήστε ένα διαφορετικό όνομα για κάθε ενσωματωμένο αρχείο.

Συχνές Ερωτήσεις

Ποια είναι η διαφορά μεταξύ ενός συνημμένου επιπέδου εγγράφου και ενός συνημμένου επιπέδου σελίδας;

Ένα συνημμένο επιπέδου εγγράφου (Document.AddAttachment()) βρίσκεται στη συλλογή embedded-files του PDF και δεν συνδέεται με καμία σελίδα. Ένα συνημμένο επιπέδου σελίδας (Page.AddFileAttachment()) είναι μια σημείωση που αγκιστρώνεται σε συγκεκριμένη θέση σελίδας, παρόμοια με μια αυτοκόλλητη σημείωση.

Πώς μπορώ να δω τι είναι αυτή τη στιγμή ενσωματωμένο σε ένα έγγραφο;

Καλέστε Document.GetAttachments(), που επιστρέφει κάθε τρέχουσα ενσωματωμένη Attachment.

Μπορεί να αφαιρεθεί ένα συνημμένο μετά την προσθήκη του;

Ναι — Document.RemoveAttachment(name) αφαιρεί ένα συνημμένο επιπέδου εγγράφου με το όνομα υπό το οποίο προστέθηκε, και επιστρέφει true εάν βρήκε και αφαίρεσε ένα.