TypeScript में PDF अटैचमेंट्स के साथ कैसे काम करें
यह गाइड दिखाता है कि Aspose.PDF FOSS for TypeScript के साथ PDF दस्तावेज़ों में फ़ाइल अटैचमेंट्स के साथ कैसे काम किया जाए। 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पैकेज स्थापित होने के बाद, एक नई TypeScript फ़ाइल में Document क्लास को इम्पोर्ट करके इंस्टॉलेशन की जाँच करें — यह लाइन बिना त्रुटि के हल हो जानी चाहिए।
import { Document } from '@asposefoss/pdf';चरण 2: आवश्यक क्लासेस इम्पोर्ट करें
Import Document फ़ाइल खोलने और नीचे उपयोग किए गए दोनों अटैचमेंट एंट्री पॉइंट्स तक पहुँचने के लिए:
import { Document } from '@asposefoss/pdf';चरण 3: लक्ष्य दस्तावेज़ खोलें
दोनों अटैचमेंट विधियों को खुले Document पर बुलाया जाता है — Page-स्तर के अटैचमेंट को अतिरिक्त रूप से लक्ष्य 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 पृष्ठ पर एक क्लिक करने योग्य आइकन रखता है — जैसा कि sticky-note और free-text annotations में कवर किया गया है एनोटेशन गाइड — जिसे व्यूअर एम्बेडेड फ़ाइल को सहेजने या पूर्वावलोकन करने के लिए खोलता है। इसके विपरीत Document.AddAttachment(), यह एक विशिष्ट पृष्ठ स्थान पर एंकर किया गया है, न कि केवल दस्तावेज़ की embedded-files संग्रह में सूचीबद्ध।
आम समस्याएँ और समाधान
के साथ जोड़ा गया अटैचमेंट Document.AddAttachment() के पास किसी भी पृष्ठ पर कोई दृश्य आइकन नहीं होता। यह अपेक्षित है — एक दस्तावेज़-स्तरीय अटैचमेंट embedded-files संग्रह में रहता है, पृष्ठ पर नहीं। उपयोग करें Page.AddFileAttachment() अतिरिक्त रूप से, यदि किसी विशिष्ट पृष्ठ पर क्लिक करने योग्य आइकन आवश्यक हो।
Document.RemoveAttachment() returns false. यह लौटाता है false जब दिए गए के तहत कोई अटैचमेंट पंजीकृत नहीं होता है name — वर्तमान सेट को सूचीबद्ध करें Document.GetAttachments() पहले उपयोग में सटीक नाम की पुष्टि करने के लिए।
दो अटैचमेंट एक ही के तहत एम्बेड किए गए थे name. name in Document.AddAttachment() अटैचमेंट को पुनः खोजने के लिए उपयोग की जाने वाली कुंजी है RemoveAttachment() — दूसरे कॉल के लिए नाम को पुन: उपयोग करने से पहला नाम छाया या टकराव कर सकता है, यह इस पर निर्भर करता है कि व्यूअर डुप्लिकेट्स को कैसे हल करता है। प्रत्येक एम्बेडेड फ़ाइल के लिए एक अलग नाम प्रयोग करें।
अक्सर पूछे जाने वाले प्रश्न
एक दस्तावेज़-स्तर और पृष्ठ-स्तर अटैचमेंट में क्या अंतर है?
एक दस्तावेज़-स्तर अटैचमेंट (Document.AddAttachment()) PDF की एंबेडेड-फ़ाइल्स संग्रह में रहता है और किसी भी पृष्ठ से जुड़ा नहीं होता। एक पृष्ठ-स्तर अटैचमेंट (Page.AddFileAttachment()) एक एनोटेशन है जो विशिष्ट पृष्ठ स्थान पर एंकर किया जाता है, जैसे स्टिकी नोट।
मैं कैसे देखूं कि वर्तमान में किसी दस्तावेज़ में क्या एंबेडेड है?
कॉल Document.GetAttachments(), जो वर्तमान में एम्बेड किए गए सभी Attachment को लौटाता है।
क्या एक अटैचमेंट को जोड़ने के बाद हटाया जा सकता है?
हाँ — Document.RemoveAttachment(name) दस्तावेज़-स्तर के अटैचमेंट को उस नाम से हटाता है जिसके तहत इसे जोड़ा गया था, और यदि यह एक को पाया और हटाया तो true लौटाता है।
