Hoe te werken met PDF-bijlagen in TypeScript

Deze gids toont hoe je met bestandsbijlagen in PDF-documenten werkt met Aspose.PDF FOSS voor TypeScript. Document.AddAttachment() embedt een bestand op documentniveau; Page.AddFileAttachment() plaatst een klikbare paperclip-achtige annotatie op een pagina die een ingebed bestand opent. Het vereist Node.js 22 of later.

Stapsgewijze gids

Stap 1: Installeer het pakket

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

Verifieer de installatie door de Document klasse te importeren in een nieuw TypeScript bestand — deze regel moet zonder fout worden opgelost zodra het pakket is geïnstalleerd:

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

Stap 2: Importeer vereiste klassen

Importeer Document om het bestand te openen en beide bijlage-ingangspunten te bereiken die hieronder worden gebruikt:

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

Stap 3: Open het Doeldocument

Beide bijlagemethoden worden aangeroepen op een geopende Document — Page-niveau bijlagen hebben bovendien de doel-Page nodig:

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

Stap 4: Een document-niveau-bijlage insluiten

Document.AddAttachment(name, bytes, opts) -> Attachment voegt een bestand toe aan de collectie van ingesloten bestanden van het document, geïdentificeerd door name. Document.GetAttachments() -> Attachment[] geeft alles weer wat momenteel is ingesloten, en Document.RemoveAttachment(name) -> boolean verwijdert er één op naam.

Stap 5: Een paginaniveau-bestandsbijlage-annotatie toevoegen

Page.AddFileAttachment(opts) -> FileAttachmentAnnotation plaatst een klikbaar pictogram op de pagina — vergelijkbaar met de sticky-note en free-text annotaties die behandeld worden in de Annotaties handleiding — die een viewer opent om het embedded file op te slaan of te bekijken. In tegenstelling tot Document.AddAttachment(), het is verankerd op een specifieke paginalocatie in plaats van alleen te worden vermeld in de embedded-files collectie van het document.

Veelvoorkomende problemen en oplossingen

Een bijlage toegevoegd met Document.AddAttachment() heeft geen zichtbaar pictogram op een pagina. Dit is verwacht — een document-level bijlage bevindt zich in de embedded-files collectie, niet op een pagina. Gebruik Page.AddFileAttachment() aanvullend als een klikbaar pictogram op een specifieke pagina vereist is.

Document.RemoveAttachment() returns false. Het retourneert false wanneer er geen bijlage is geregistreerd onder de opgegeven name — lijst de huidige set met Document.GetAttachments() eerst om de exacte naam in gebruik te bevestigen.

Twee bijlagen werden ingebed onder dezelfde name. name in Document.AddAttachment() is de sleutel die wordt gebruikt om de bijlage terug op te zoeken met RemoveAttachment() — het hergebruiken van een naam voor een tweede oproep kan de eerste overschaduwen of conflicteren, afhankelijk van hoe de viewer duplicaten oplost. Gebruik een unieke naam per ingebedde bestand.

Veelgestelde vragen

Wat is het verschil tussen een document-niveau bijlage en een pagina-niveau bijlage?

Een document-niveau bijlage (Document.AddAttachment()) bevindt zich in de embedded-files collectie van de PDF en is niet gekoppeld aan een pagina. Een pagina-niveau bijlage (Page.AddFileAttachment()) is een annotatie verankerd op een specifieke paginalocatie, vergelijkbaar met een plaknotitie.

Hoe kan ik zien wat er momenteel in een document is ingebed?

Roep Document.GetAttachments() aan, die alle momenteel ingebedde Attachment retourneert.

Kan een bijlage worden verwijderd nadat deze is toegevoegd?

Ja — Document.RemoveAttachment(name) verwijdert een bijlage op documentniveau op basis van de naam waaronder deze is toegevoegd, en retourneert true als er een is gevonden en verwijderd.