כיצד לעבוד עם קבצי PDF מצורפים ב-TypeScript

מדריך זה מציג כיצד לעבוד עם קבצים מצורפים במסמכי PDF עם Aspose.PDF FOSS עבור TypeScript. Document.AddAttachment() משלב קובץ ברמת המסמך; Page.AddFileAttachment() מציב חיווי לחיצה בסגנון מהדק נייר על דף הפותח קובץ משולב. נדרש Node.js 22 או גרסה מאוחרת יותר.

מדריך שלב אחר שלב

שלב 1: התקנת החבילה

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

אמת את ההתקנה על ידי ייבוא המחלקה Document בקובץ TypeScript חדש — שורה זו צריכה להתבצע ללא שגיאה לאחר שהחבילה מותקנת:

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

שלב 2: ייבא מחלקות נדרשות

ייבא Document כדי לפתוח את הקובץ ולהגיע לשתי נקודות הכניסה של ההצמדה המשמשות למטה:

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

שלב 3: פתח את המסמך היעד

שתי שיטות ההצמדה מתבצעות על Document פתוח — קבצים מצורפים ברמת Page additionally need the target Page:

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

שלב 4: הטמע קובץ מצורף ברמת המסמך

Document.AddAttachment(name, bytes, opts) -> Attachment משלב קובץ באוסף הקבצים המוטמעים של המסמך, עם מפתח name. Document.GetAttachments() -> Attachment[] מציג את כל הקבצים המוטמעים כעת, ו-Document.RemoveAttachment(name) -> boolean מסיר קובץ לפי שם.

שלב 5: הוסף הערת קובץ מצורף ברמת העמוד

Page.AddFileAttachment(opts) -> FileAttachmentAnnotation ממקם סמל ניתן ללחיצה על הדף — דומה להערות הפתק הדביק והטקסט החופשי שנכנסו ב- הערות מדריך — שהקורא פותח כדי לשמור או לתצוגה מקדימה של הקובץ המוטמע. בניגוד ל- Document.AddAttachment(), הוא מעוגן במיקום ספציפי בדף במקום להיות רשום רק באוסף הקבצים המוטמעים של המסמך.

בעיות נפוצות ותיקונים

קובץ מצורף שנוסף עם Document.AddAttachment() אין לו סמל גלוי על אף דף. זה מצופה — קובץ מצורף ברמת המסמך נמצא באוסף הקבצים המוטמעים, לא על דף. השתמש Page.AddFileAttachment() בנוסף אם נדרש סמל ניתן ללחיצה על דף ספציפי.

Document.RemoveAttachment() returns false. זה מחזיר false כאשר אין קובץ מצורף רשום תחת ה- name — רשום את המערך הנוכחי עם Document.GetAttachments() ראשון כדי לאשר את השם המדויק שבשימוש.

שני קבצים מצורפים הוטמעו תחת אותו name. name in Document.AddAttachment() הוא המפתח המשמש לחיפוש הקובץ המצורף בחזרה עם RemoveAttachment() — שימוש חוזר בשם לשיחה שנייה יכול להצליב או להתנגש עם הראשונה, תלוי באופן שבו הצופה פותר כפילויות. השתמש בשם ייחודי לכל קובץ מוטמע.

שאלות נפוצות

מה ההבדל בין קובץ מצורף ברמת מסמך לקובץ מצורף ברמת דף?

קובץ מצורף ברמת מסמך (Document.AddAttachment()) נמצא באוסף embedded-files של ה-PDF ואינו קשור לאף דף. קובץ מצורף ברמת דף (Page.AddFileAttachment()) הוא אנוטציה המחוברת למיקום ספציפי בדף, בדומה להערת דביק.

איך אני רואה מה כרגע מוטמע במסמך?

קרא ל-Document.GetAttachments(), שמחזיר כל Attachment מוטמע כרגע.

האם ניתן להסיר קובץ מצורף לאחר שהתווסף?

כן — Document.RemoveAttachment(name) מסיר קובץ מצורף ברמת המסמך לפי השם שבו נוסף, ומחזיר true אם הוא מצא והסיר אחד.