Hogyan dolgozzunk PDF mellékletekkel TypeScriptben

Ez az útmutató bemutatja, hogyan dolgozzunk fájl mellékletekkel PDF dokumentumokban a Aspose.PDF FOSS a TypeScript számára. A Document.AddAttachment() fájlt ágyaz be a dokumentumszinten; a Page.AddFileAttachment() kattintható, papírzseb stílusú annotációt helyez el egy oldalon, amely megnyitja a beágyazott fájlt. Node.js 22 vagy újabb szükséges.

Lépésről lépésre útmutató

1. lépés: A csomag telepítése

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

Ellenőrizze a telepítést úgy, hogy importálja a Document osztályt egy új TypeScript fájlban — ennek a sornak hibamentesen kell feloldódnia a csomag telepítése után:

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

2. lépés: A szükséges osztályok importálása

Importálja a(z) Document elemet a fájl megnyitásához, és érje el az alább használt két csatolási belépési pontot:

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

3. lépés: A cél dokumentum megnyitása

Mindkét csatolási módszer egy nyitott Document objektumon hívható – a Page-szintű csatolásokhoz továbbá a cél Page szükséges:

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

4. lépés: Dokumentumszintű csatolás beágyazása

Document.AddAttachment(name, bytes, opts) -> Attachment egy fájlt ágyaz be a dokumentum beágyazott fájlok gyűjteményébe, amelyet a name kulcs azonosít. A Document.GetAttachments() -> Attachment[] felsorolja az aktuálisan beágyazott elemeket, a Document.RemoveAttachment(name) -> boolean pedig név szerint eltávolít egyet.

5. lépés: Oldalszintű fájlcsatolás-annotáció hozzáadása

Page.AddFileAttachment(opts) -> FileAttachmentAnnotation helyez egy kattintható ikont az oldalra — hasonlóan a ragadósjegy és szabad szöveges megjegyzésekhez, amelyeket a Megjegyzések útmutató — amelyet a néző megnyit a beágyazott fájl mentéséhez vagy előnézetéhez. Ellentétben Document.AddAttachment(), ez egy adott oldalhelyhez van rögzítve, nem csak a dokumentum beágyazott-fájlok gyűjteményében szerepel.

Gyakori problémák és megoldások

Egy csatolás, amelyet a Document.AddAttachment() nem jelenik meg látható ikon egyetlen oldalon sem. Ez várható — a dokumentumszintű csatolás a beágyazott-fájlok gyűjteményében él, nem egy oldalon. Használja Page.AddFileAttachment() továbbá, ha egy adott oldalon kattintható ikonra van szükség.

Document.RemoveAttachment() returns false. Visszaadja false ha nincs csatolmány regisztrálva a megadott name — listázza a jelenlegi halmazt a Document.GetAttachments() először a pontosan használt név megerősítéséhez.

Két csatolmány lett beágyazva ugyanazon name. name in Document.AddAttachment() a kulcs, amellyel a csatolmányt visszakereshet RemoveAttachment() — egy név újrahasználata a második hívásnál árnyékolhatja vagy ütközhet az elsővel, attól függően, hogy a néző hogyan oldja fel a duplikátumokat. Használjon egyedi nevet minden beágyazott fájlhoz.

Gyakran ismételt kérdések

Mi a különbség a dokumentumszintű és az oldalszintű melléklet között?

A dokumentumszintű melléklet (Document.AddAttachment()) a PDF beágyazott fájlok (embedded-files) gyűjteményében él, és nincs semmilyen oldalhoz kötve. Az oldalszintű melléklet (Page.AddFileAttachment()) egy annotáció, amely egy adott oldal helyzetéhez van rögzítve, hasonlóan a post-it feljegyzéshez.

Hogyan tekinthetem meg, hogy mi van jelenleg beágyazva egy dokumentumban?

Hívja meg a Document.GetAttachments() függvényt, amely visszaadja az összes jelenleg beágyazott Attachment.

Eltávolítható egy melléklet, miután hozzá lett adva?

Igen — Document.RemoveAttachment(name) eltávolít egy dokumentumszintű mellékletet a hozzáadott név alapján, és visszaad true, ha megtalálta és eltávolította.