Cara Bekerja dengan Lampiran PDF di TypeScript

Panduan ini menunjukkan cara bekerja dengan lampiran file dalam dokumen PDF menggunakan Aspose.PDF FOSS untuk TypeScript. Document.AddAttachment() menyematkan file pada tingkat dokumen; Page.AddFileAttachment() menempatkan anotasi bergaya penjepit kertas yang dapat diklik pada halaman yang membuka file yang disematkan. Diperlukan Node.js 22 atau yang lebih baru.

Panduan Langkah demi Langkah

Langkah 1: Instal Paket

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

Verifikasi instalasi dengan mengimpor kelas Document dalam file TypeScript baru — baris ini harus berhasil tanpa error setelah paket diinstal:

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

Langkah 2: Impor Kelas yang Diperlukan

Impor Document untuk membuka file dan mengakses kedua titik masuk lampiran yang digunakan di bawah ini:

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

Langkah 3: Buka Dokumen Target

Kedua metode lampiran dipanggil pada Document yang terbuka — lampiran tingkat Page tambahan memerlukan Page target:

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

Langkah 4: Sematkan Lampiran Tingkat Dokumen

Document.AddAttachment(name, bytes, opts) -> Attachment menyematkan file ke dalam koleksi file tersemat dokumen, diidentifikasi dengan name. Document.GetAttachments() -> Attachment[] menampilkan semua yang saat ini tersemat, dan Document.RemoveAttachment(name) -> boolean menghapus satu berdasarkan nama.

Langkah 5: Tambahkan Anotasi Lampiran File Tingkat Halaman

Page.AddFileAttachment(opts) -> FileAttachmentAnnotation menempatkan ikon yang dapat diklik pada halaman — mirip dengan anotasi catatan tempel dan teks bebas yang dibahas dalam Anotasi panduan — yang dibuka oleh penampil untuk menyimpan atau meninjau file tersemat. Tidak seperti Document.AddAttachment(), ikon ini ditempatkan pada lokasi halaman tertentu alih-alih hanya tercantum dalam koleksi embedded-files dokumen.

Masalah Umum dan Solusi

Sebuah lampiran yang ditambahkan dengan Document.AddAttachment() tidak memiliki ikon yang terlihat pada halaman mana pun. Ini memang diharapkan — sebuah lampiran tingkat dokumen berada di dalam koleksi embedded-files, bukan pada halaman. Gunakan Page.AddFileAttachment() sebagai tambahan jika diperlukan ikon yang dapat diklik pada halaman tertentu.

Document.RemoveAttachment() returns false. Mengembalikan false ketika tidak ada lampiran yang terdaftar dengan nama yang diberikan name — daftar set saat ini dengan Document.GetAttachments() pertama untuk mengonfirmasi nama tepat yang sedang digunakan.

Dua lampiran disematkan di bawah yang sama name. name in Document.AddAttachment() adalah kunci yang digunakan untuk mencari kembali lampiran dengan RemoveAttachment() — menggunakan kembali nama untuk panggilan kedua dapat menutupi atau bertentangan dengan yang pertama, tergantung pada cara penampil menyelesaikan duplikat. Gunakan nama yang berbeda untuk setiap file yang disematkan.

Pertanyaan yang Sering Diajukan

Apa perbedaan antara lampiran tingkat dokumen dan lampiran tingkat halaman?

Sebuah lampiran tingkat dokumen (Document.AddAttachment()) berada dalam koleksi embedded-files PDF dan tidak terikat pada halaman manapun. Sebuah lampiran tingkat halaman (Page.AddFileAttachment()) adalah anotasi yang beranchored pada lokasi halaman tertentu, mirip dengan catatan tempel.

Bagaimana cara saya melihat apa yang saat ini disematkan dalam dokumen?

Panggil Document.GetAttachments(), yang mengembalikan setiap Attachment yang saat ini tertanam.

Apakah lampiran dapat dihapus setelah ditambahkan?

Ya — Document.RemoveAttachment(name) menghapus lampiran tingkat dokumen berdasarkan nama yang digunakan saat menambahkannya, dan mengembalikan true jika menemukan dan menghapus satu.