JPG إلى كلمة

كيفية تحويل JPG إلى مستند Word باستخدام .NET REST API.

في عالم تأتي فيه المعلومات بجميع أشكالها، من المستندات الممسوحة ضوئيًا إلى الصور، هناك حاجة إلى تحويل JPG إلى Word ([DOC](https:// docs.fileformat.com/word-processing/doc/)، DOCX) ينشأ كحل رئيسي لجعل المحتوى أكثر سهولة وقابلية للتحرير. تخيل أن لديك صورة تحتوي على نص تريد تعديله أو مشاركته - وهنا تكمن خطوات تحويل JPG إلى Word. فلنبدأ رحلة لتطوير محول صورة JPG إلى Word باستخدام .NET REST API.

REST API لتحويل الصورة إلى كلمة

Aspose.Words Cloud SDK for .NET هو حل قوي وسهل الاستخدام للمطورين يوفر إمكانيات تحويل JPG إلى تنسيق Word. توفر SDK وثائق شاملة، مما يسهل عليك دمج الوظائف الضرورية في تطبيقاتك.

من أجل استخدام SDK، الخطوة الأولى هي إضافة مرجعها في المشروع. لذا يرجى البحث عن “Aspose.Words-Cloud” في مدير حزم NuGet والنقر فوق الزر “إضافة حزمة”. سيؤدي هذا إلى إضافة مرجع SDK في مشروعك. ثانيًا، احصل على بيانات اعتماد العميل الخاصة بك من cloud Dashboard. إذا لم يكن لديك حساب حالي، فما عليك سوى إنشاء حساب مجاني باتباع الإرشادات المحددة في مقالة البدء السريع.

تحويل JPG إلى Word في C# .NET

الرجاء اتباع الإرشادات الواردة أدناه لتحقيق تحويل سلس باستخدام C# .NET.

WordsApi wordsApi = new WordsApi(new Configuration()
{
    ClientId = clientID,
    ClientSecret = clientSecret
});

قم بإنشاء كائن من فئة WordsApi حيث نقوم بتمرير كائن التكوين كوسيطة.

CreateDocumentRequest createRequest = new CreateDocumentRequest("input.docx", null, null);
wordsApi.CreateDocument(createRequest);

قم بإنشاء مستند Word فارغ جديد.

DrawingObjectInsert requestDrawingObject = new DrawingObjectInsert();

قم بإنشاء كائن رسومي ثم قم بتحديد هامشه بالإضافة إلى تفاصيل محاذاة المحتوى.

InsertDrawingObjectRequest request = new InsertDrawingObjectRequest("input.docx", requestDrawingObject,
            requestImageFile, "sections/0", null, null, null, null, null, "Resultant.docx", null, null);

قم بإنشاء مثيل لـ InsertDrawingObject لتحديد العقدة التي سيتم وضع كائن الرسم فيها.

wordsApi.InsertDrawingObject(request);

أخيرًا، قم باستدعاء الطريقة لإدراج الكائن الرسومي داخل مستند Word وحفظ الإخراج في Cloud Storage.

// للحصول على أمثلة كاملة وملفات البيانات، يرجى الذهاب إلى 
https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet

// احصل على بيانات اعتماد العميل من https://dashboard.aspose.cloud/
string clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
string clientID = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";

// إنشاء مثيل لمستند Word جديد
CreateDocumentRequest createRequest = new CreateDocumentRequest("input.docx", null, null);

// إنشاء مستند Word فارغ وحفظه في التخزين السحابي
wordsApi.CreateDocument(createRequest);

// إنشاء كائن رسم
DrawingObjectInsert requestDrawingObject = new DrawingObjectInsert();

// تعيين معلومات الارتفاع للكائن الرسومي
requestDrawingObject.Height = 0;
// تعيين تفاصيل الهامش الأيسر للكائن الرسومي
requestDrawingObject.Left = 0;
// تعيين تفاصيل الهامش العلوي للكائن الرسومي
requestDrawingObject.Top = 0;
// تعيين معلومات العرض للكائن الرسومي
requestDrawingObject.Width = 0;

// ضبط المحاذاة الأفقية لمثيل الرسم
requestDrawingObject.RelativeHorizontalPosition = DrawingObjectInsert.RelativeHorizontalPositionEnum.Margin;
// ضبط المحاذاة العمودية لمثيل الرسم
requestDrawingObject.RelativeVerticalPosition = DrawingObjectInsert.RelativeVerticalPositionEnum.Margin;

// قم بتعيين تفاصيل نوع الالتفاف على أنها مضمنة
requestDrawingObject.WrapType = DrawingObjectInsert.WrapTypeEnum.Inline;

// تحميل محتوى صورة JPG المدخلة
var requestImageFile = System.IO.File.OpenRead("Map.jpeg");

// إنشاء مثيل لعقدة تعريف InsertDrawingObject حيث سيتم وضع كائن الرسم
InsertDrawingObjectRequest request = new InsertDrawingObjectRequest("input.docx", requestDrawingObject,
            requestImageFile, "sections/0", null, null, null, null, null, "Resultant.docx", null, null);

// قم بإدراج كائن رسومي يحمل صورة JPG داخل مستند Word
wordsApi.InsertDrawingObject(request);

تحويل الصورة إلى Word باستخدام أوامر cURL

يوفر تحقيق التحويل من JPG إلى Word باستخدام أوامر cURL مع واجهة برمجة التطبيقات Aspose.Words Cloud أسلوبًا مباشرًا يعتمد على سطر الأوامر. يتيح لك استخدام أوامر cURL التفاعل مع Aspose.Words Cloud API لهذا التحويل المحدد بسلاسة.

الخطوة الأولى في هذا الأسلوب هي إنشاء رمز وصول JWT باستخدام الأمر التالي:

curl -v "https://api.aspose.cloud/connect/token" \
 -X POST \
 -d "grant_type=client_credentials&client_id=163c02a1-fcaa-4f79-be54-33012487e783&client_secret=c71cfe618cc6c0944f8f96bdef9813ac" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Accept: application/json"

الآن، يرجى تنفيذ الأمر التالي لإنشاء مستند Word فارغ.

curl -v -X PUT "https://api.aspose.cloud/v4.0/words/create?fileName=input.docx" \
-H  "accept: application/json" \
-H  "Authorization: Bearer <JWT Token>"

وأخيراً، قم باستدعاء الأمر التالي لإدراج الكائن الرسومي في مستند Word المنشأ حديثاً.

curl -v -X POST "https://api.aspose.cloud/v4.0/words/input.docx/sections/0/drawingObjects?destFileName={outputFile}" \
-H  "accept: application/json" \
-H  "Authorization: Bearer <JWT Token>" \
-H  "Content-Type: multipart/form-data" \
-d {"drawingObject":"{  \"RelativeHorizontalPosition\": \"Margin\",  \"Left\": 0,  \"RelativeVerticalPosition\": \"Margin\",  \"Top\": 0,  \"Width\": 0,  \"Height\": 0,  \"WrapType\": \"Inline\"}","imageFile":{"source.jpg"}}

استبدل “outputFile” باسم مستند Word الناتج، و"accessToken" برمز وصول JWT الذي تم إنشاؤه أعلاه.

خاتمة

في هذه المقالة، اكتشفنا طريقتين سلستين لتحويل صور JPG إلى تنسيقات مستندات Word. لقد تعلمنا أنه باستخدام SDK، فأنت مزود بمجموعة أدوات قوية وغنية بالميزات، مما يتيح التكامل السلس في تطبيقات .NET. من ناحية أخرى، يوفر استخدام أوامر cURL بديلاً سريعًا وسهل الوصول إليه يعتمد على سطر الأوامر، وهو مناسب للمستخدمين ذوي الخلفيات التقنية المتنوعة. لذلك، من خلال تعدد استخدامات SDK أو راحة سطر الأوامر لـ cURL، يمكنك تطوير سير عمل أكثر كفاءة ومخصصًا لمعالجة المستندات.

روابط مفيدة

مقالات ذات صلة

نوصي بشدة بزيارة المدونات التالية: