TypeScript'te PDF Ekleriyle Çalışma

Bu rehber, TypeScript için Aspose.PDF FOSS kullanarak PDF belgelerindeki dosya ekleriyle nasıl çalışılacağını gösterir. Document.AddAttachment(), dosyayı belge düzeyinde gömer; Page.AddFileAttachment(), gömülü bir dosyayı açan tıklanabilir bir zımba iğnesi tarzı ek açıklama yerleştirir. Node.js 22 veya daha yenisi gerekir.

Adım Adım Rehber

Adım 1: Paketi Kurun

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

Kurulumu, yeni bir TypeScript dosyasında Document sınıfını içe aktararak doğrulayın — paket kurulduktan sonra bu satır hata vermeden çözümlenmeli:

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

Adım 2: Gerekli Sınıfları İçe Aktarın

Dosyayı açmak ve aşağıda kullanılan iki ek dosya giriş noktasına ulaşmak için Document içe aktarın:

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

Adım 3: Hedef Belgeyi Aç

Her iki ek dosya yöntemi de açık bir Document üzerinde çağrılır — Page-seviyesindeki ek dosyalar ayrıca hedef Page gerektirir:

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

Adım 4: Belge Düzeyinde Bir Ek Dosyayı Göm

Document.AddAttachment(name, bytes, opts) -> Attachment, dosyayı belgeye gömülü dosyalar koleksiyonuna, name anahtarıyla ekler. Document.GetAttachments() -> Attachment[], şu anda gömülü olan her şeyi listeler ve Document.RemoveAttachment(name) -> boolean, isme göre bir tanesini kaldırır.

Adım 5: Sayfa Düzeyinde Dosya Ek Açıklaması Ekle

Page.AddFileAttachment(opts) -> FileAttachmentAnnotation sayfada tıklanabilir bir simge yerleştirir — sticky-note ve free-text ek açıklamaları gibi, aşağıda ele alınan Ek Açıklamalar kılavuz — bir görüntüleyicinin gömülü dosyayı kaydetmek veya ön izlemek için açtığı. Aksine Document.AddAttachment(), bu, yalnızca belgenin embedded-files koleksiyonunda listelenmek yerine belirli bir sayfa konumuna sabitlenmiştir.

Yaygın Sorunlar ve Çözümler

Şununla eklenen bir ek Document.AddAttachment() herhangi bir sayfada görünür bir simgeye sahip değildir. Bu beklenen bir durum — belge düzeyindeki bir ek, embedded-files koleksiyonunda bulunur, bir sayfada değil. Kullan Page.AddFileAttachment() ek olarak, belirli bir sayfada tıklanabilir bir simge gerektiğinde.

Document.RemoveAttachment() returns false. Döndürür false verilen … altında bir ek kaydedilmediğinde name — mevcut seti şu şekilde listeleyin Document.GetAttachments() ilk olarak kullanılan kesin adı doğrulamak için.

İki ek aynı … altında gömülmüş name. name in Document.AddAttachment() ek’i geri bulmak için kullanılan anahtardır RemoveAttachment() — bir ismi ikinci kez kullanmak, görüntüleyicinin kopyaları nasıl çözdüğüne bağlı olarak birincisini gölgeleme veya çakışma yaratabilir. Her gömülü dosya için ayrı bir isim kullanın.

Sıkça Sorulan Sorular

Belge-düzeyi ek ile sayfa-düzeyi ek arasındaki fark nedir?

Bir belge-düzeyi ek (Document.AddAttachment()), PDF’nin gömülü-dosyalar koleksiyonunda bulunur ve herhangi bir sayfaya bağlı değildir. Bir sayfa-düzeyi ek (Page.AddFileAttachment()) ise belirli bir sayfa konumuna sabitlenmiş bir açıklamadır, yapışkan notaya benzer.

Bir belgede şu anda gömülü olanları nasıl görebilirim?

Çağır Document.GetAttachments(), şu anda gömülü olan tüm Attachment döndürür.

Bir ek, eklendikten sonra kaldırılabilir mi?

Evet — Document.RemoveAttachment(name), belge düzeyindeki bir eki eklendiği adla kaldırır ve birini bulup kaldırdıysa true döndürür.