Wie man mit PDF-Anhängen in TypeScript arbeitet

Dieser Leitfaden zeigt, wie man mit Dateianhängen in PDF-Dokumenten mit Aspose.PDF FOSS für TypeScript arbeitet. Document.AddAttachment() bettet eine Datei auf Dokumentebene ein; Page.AddFileAttachment() platziert eine anklickbare, heftenähnliche Annotation auf einer Seite, die eine eingebettete Datei öffnet. Es erfordert Node.js 22 oder höher.

Schritt-für-Schritt-Anleitung

Schritt 1: Paket installieren

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

Überprüfen Sie die Installation, indem Sie die Document-Klasse in einer neuen TypeScript-Datei importieren — diese Zeile sollte ohne Fehler aufgelöst werden, sobald das Paket installiert ist:

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

Schritt 2: Erforderliche Klassen importieren

Importieren Sie Document, um die Datei zu öffnen und beide unten verwendeten Anhangseinstiegspunkte zu erreichen:

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

Schritt 3: Ziel-Dokument öffnen

Beide Anhangsmethoden werden bei einem offenen Document aufgerufen — Page-Ebene-Anhänge benötigen zusätzlich das Ziel-Page:

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

Schritt 4: Anhang auf Dokumentebene einbetten

Document.AddAttachment(name, bytes, opts) -> Attachment bettet eine Datei in die Sammlung eingebetteter Dateien des Dokuments ein, indiziert nach name. Document.GetAttachments() -> Attachment[] listet alles derzeit Eingebettete auf, und Document.RemoveAttachment(name) -> boolean entfernt eines nach Namen.

Schritt 5: Anmerkung für Dateianhang auf Seitenebene hinzufügen

Page.AddFileAttachment(opts) -> FileAttachmentAnnotation platziert ein anklickbares Symbol auf der Seite – ähnlich den Sticky-Note- und Freitext-Anmerkungen, die im Anmerkungen Leitfaden – den ein Betrachter öffnet, um die eingebettete Datei zu speichern oder vorzuschauen. Im Gegensatz zu Document.AddAttachment(), ist es an einem bestimmten Seitenort verankert, anstatt nur in der Sammlung eingebetteter Dateien des Dokuments aufgelistet zu werden.

Häufige Probleme und Lösungen

Ein Anhang, der mit Document.AddAttachment() hat kein sichtbares Symbol auf irgendeiner Seite. Das ist erwartungsgemäß – ein Dokument-Ebene-Anhang befindet sich in der Sammlung eingebetteter Dateien, nicht auf einer Seite. Verwenden Sie Page.AddFileAttachment() zusätzlich, falls ein anklickbares Symbol auf einer bestimmten Seite erforderlich ist.

Document.RemoveAttachment() returns false. Es gibt zurück false wenn kein Anhang unter dem angegebenen name — listen Sie das aktuelle Set mit Document.GetAttachments() zuerst, um den genauen verwendeten Namen zu bestätigen.

Zwei Anhänge wurden unter demselben name. name in Document.AddAttachment() ist der Schlüssel, mit dem der Anhang wieder nachgeschlagen wird RemoveAttachment() — die Wiederverwendung eines Namens für einen zweiten Aufruf kann den ersten überschreiben oder mit ihm in Konflikt geraten, je nachdem, wie der Betrachter Duplikate auflöst. Verwenden Sie für jede eingebettete Datei einen eindeutigen Namen.

Häufig gestellte Fragen

Was ist der Unterschied zwischen einem dokumentenweiten und einem seitenspezifischen Anhang?

Ein dokumentenweiter Anhang (Document.AddAttachment()) befindet sich in der embedded-files-Sammlung des PDFs und ist keiner Seite zugeordnet. Ein seitenspezifischer Anhang (Page.AddFileAttachment()) ist eine Anmerkung, die an einer bestimmten Seitenposition verankert ist, ähnlich einer Notiz.

Wie kann ich sehen, was derzeit in einem Dokument eingebettet ist?

Rufen Sie Document.GetAttachments() auf, das alle derzeit eingebetteten Attachment zurückgibt.

Kann ein Anhang entfernt werden, nachdem er hinzugefügt wurde?

Ja — Document.RemoveAttachment(name) entfernt einen Dokumenten-Anhang anhand des Namens, unter dem er hinzugefügt wurde, und gibt true zurück, wenn er einen gefunden und entfernt hat.