إنشاء سطر توقيع جديد وتعيين معرف المزود

مقدمة

مرحبًا بكم، أيها المتحمسون للتكنولوجيا! هل تساءلتم يومًا عن كيفية إضافة سطر توقيع في مستندات Word برمجيًا؟ حسنًا، سنتعرف اليوم على ذلك باستخدام Aspose.Words for .NET. سيرشدك هذا الدليل خلال كل خطوة، مما يجعل إنشاء سطر توقيع جديد وتعيين معرف المزود في مستندات Word أمرًا سهلاً للغاية. سواء كنت تقوم بأتمتة معالجة المستندات أو كنت تبحث فقط عن تبسيط سير عملك، فإن هذا البرنامج التعليمي سيغطيك.

المتطلبات الأساسية

قبل أن نبدأ في العمل، دعونا نتأكد من أننا حصلنا على كل ما نحتاجه:

  1. Aspose.Words for .NET: إذا لم تقم بتنزيله بالفعل، قم بتنزيلههنا.
  2. بيئة التطوير: Visual Studio أو أي بيئة تطوير C# أخرى.
  3. .NET Framework: تأكد من تثبيت .NET Framework.
  4. شهادة PFX: لتوقيع المستندات، ستحتاج إلى شهادة PFX. يمكنك الحصول عليها من جهة إصدار شهادات موثوقة.

استيراد مساحات الأسماء

أولاً وقبل كل شيء، دعنا نستورد المساحات الأساسية الضرورية في مشروع C# الخاص بك:

using Aspose.Words;
using Aspose.Words.Drawing;
using Aspose.Words.Signing;
using System;

حسنًا، لننتقل إلى صلب الموضوع. فيما يلي شرح تفصيلي لكل خطوة لإنشاء سطر توقيع جديد وتعيين معرف مقدم الخدمة.

الخطوة 1: إنشاء مستند جديد

للبدء، نحتاج إلى إنشاء مستند Word جديد. سيكون هذا هو القماش الذي سنستخدمه في خط توقيعنا.

// المسار إلى دليل المستندات.
string dataDir = "YOUR DOCUMENT DIRECTORY";
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

في هذا المقطع، نقوم بتهيئة ملف جديدDocument و أDocumentBuilder . الDocumentBuilder يساعدنا على إضافة عناصر إلى مستندنا.

الخطوة 2: تحديد خيارات سطر التوقيع

بعد ذلك، نقوم بتحديد الخيارات الخاصة بسطر التوقيع الخاص بنا. ويتضمن ذلك اسم المُوقِّع ولقبه وعنوان بريده الإلكتروني وغير ذلك من التفاصيل.

SignatureLineOptions signatureLineOptions = new SignatureLineOptions
{
    Signer = "vderyushev",
    SignerTitle = "QA",
    Email = "vderyushev@aspose.com",
    ShowDate = true,
    DefaultInstructions = false,
    Instructions = "Please sign here.",
    AllowComments = true
};

تعمل هذه الخيارات على تخصيص خط التوقيع، مما يجعله واضحًا واحترافيًا.

الخطوة 3: أدخل سطر التوقيع

بعد تعيين خياراتنا، يمكننا الآن إدراج سطر التوقيع في المستند.

SignatureLine signatureLine = builder.InsertSignatureLine(signatureLineOptions).SignatureLine;
signatureLine.ProviderId = Guid.Parse("CF5A7BB4-8F3C-4756-9DF6-BEF7F13259A2");

هنا،InsertSignatureLine تضيف الطريقة سطر التوقيع، ونقوم بتعيين معرف مزود فريد له.

الخطوة 4: حفظ المستند

بعد إدراج سطر التوقيع، دعونا نحفظ المستند.

doc.Save(dataDir + "SignDocuments.SignatureLineProviderId.docx");

سيؤدي هذا إلى حفظ مستندك بسطر التوقيع المضاف حديثًا.

الخطوة 5: إعداد خيارات التوقيع

الآن، نحتاج إلى إعداد الخيارات الخاصة بتوقيع المستند. ويتضمن ذلك معرف سطر التوقيع، ومعرف المزود، والتعليقات، ووقت التوقيع.

SignOptions signOptions = new SignOptions
{
    SignatureLineId = signatureLine.Id,
    ProviderId = signatureLine.ProviderId,
    Comments = "Document was signed by vderyushev",
    SignTime = DateTime.Now
};

تضمن هذه الخيارات توقيع المستند بالتفاصيل الصحيحة.

الخطوة 6: إنشاء حامل الشهادة

لتوقيع المستند، سنستخدم شهادة PFX. لنقم بإنشاء حامل شهادة لها.

CertificateHolder certHolder = CertificateHolder.Create(dataDir + "morzal.pfx", "aw");

تأكد من الاستبدال"morzal.pfx" مع ملف الشهادة الفعلي الخاص بك و"aw" مع كلمة المرور الخاصة بشهادتك.

الخطوة 7: توقيع الوثيقة

وأخيرًا، نقوم بتوقيع المستند باستخدام أداة التوقيع الرقمي.

DigitalSignatureUtil.Sign(dataDir + "SignDocuments.SignatureLineProviderId.docx", 
    dataDir + "SignDocuments.CreateNewSignatureLineAndSetProviderId.docx", certHolder, signOptions);

يؤدي هذا إلى توقيع المستند وحفظه كملف جديد.

خاتمة

وها أنت ذا! لقد نجحت في إنشاء سطر توقيع جديد وتعيين معرف الموفر في مستند Word باستخدام Aspose.Words for .NET. تجعل هذه المكتبة القوية إدارة مهام معالجة المستندات وأتمتتها أمرًا سهلاً بشكل لا يصدق. جرّبها وشاهد كيف يمكنها تبسيط سير عملك.

الأسئلة الشائعة

هل يمكنني تخصيص مظهر خط التوقيع؟

بالتأكيد! يمكنك تعديل خيارات مختلفة فيSignatureLineOptions لتناسب احتياجاتك.

ماذا لو لم يكن لدي شهادة PFX؟

سوف تحتاج إلى الحصول على شهادة من جهة إصدار شهادات موثوقة. فهي ضرورية للتوقيع الرقمي على المستندات.

هل يمكنني إضافة أسطر توقيع متعددة إلى مستند؟

نعم، يمكنك إضافة عدد كبير من أسطر التوقيع حسب الحاجة عن طريق تكرار عملية الإدراج باستخدام خيارات مختلفة.

هل Aspose.Words for .NET متوافق مع .NET Core؟

نعم، يدعم Aspose.Words for .NET .NET Core، مما يجعله متعدد الاستخدامات لبيئات التطوير المختلفة.

ما مدى أمان التوقيعات الرقمية؟

التوقيعات الرقمية التي تم إنشاؤها باستخدام Aspose.Words آمنة للغاية، بشرط استخدام شهادة صالحة وموثوقة.