JPG إلى كلمة

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

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

REST API لإنشاء مستندات Word

أطلق العنان لإمكانات تحويل “JPG إلى Word” بطريقة بسيطة للغاية باستخدام Aspose.Words Cloud SDK for .NET. لا تعمل واجهة REST API متعددة الاستخدامات على تبسيط عملية التحويل فحسب، بل توفر أيضًا عددًا لا يحصى من المزايا الأخرى التي تعمل على رفع مستوى التجربة الكاملة لإنشاء مستندات Word ومعالجتها.

لإضافة مرجع .NET REST في المشروع، يرجى البحث عن “Aspose.Words-Cloud” في مدير حزم NuGet والنقر فوق الزر “إضافة حزمة”. علاوة على ذلك، يرجى زيارة لوحة التحكم السحابية والحصول على بيانات اعتماد العميل المخصصة الخاصة بك.

تحويل JPG إلى مستند Word في C# .NET

يشرح هذا القسم تفاصيل كيفية تحويل JPG إلى Word C# .NET.

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

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

// إنشاء كائن تكوين باستخدام تفاصيل ClientID وClientSecret
var config = new Aspose.Words.Cloud.Sdk.Configuration { ClientId = clientID, ClientSecret = clientSecret };
// تهيئة مثيل WordsApi
var wordsApi = new WordsApi(config);

// إنشاء مثيل لمستند 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 المدخلة
using var sourceImage = File.OpenRead("Landscape.jpg");

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

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

الآن، دعنا نستكشف بعض التفاصيل المتعلقة بمقتطف الشفرة المذكور أعلاه.

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

أولاً، قمنا بإنشاء مثيل لفئة WordsApi أثناء تمرير بيانات اعتماد العميل كوسائط.

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

لقد قمنا الآن بإنشاء مستند Word فارغ باسم input.docx.

DrawingObjectInsert requestDrawingObject = new DrawingObjectInsert();

قم بإنشاء كائن رسم واضبط الهامش العلوي والأيسر على 0. وأيضًا، لكي يغطي JPG أبعاد الصفحة بالكامل، اضبط قيمة الارتفاع والعرض على 0.

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

قم بإنشاء كائن طلب InsertDrawingObject حيث نمرر اسم مستند Word الفارغ للإدخال، ودفق صور JPG المدخل، ومعلومات قسم مستند Word كـ 0 واسم مستند Word الناتج.

wordsApi.InsertDrawingObject(request);

أخيرًا، اتصل بواجهة برمجة التطبيقات (API) لوضع الصورة داخل مستند Word وحفظ ملف الإخراج في وحدة التخزين السحابية.

JPG إلى DOC باستخدام أوامر cURL

وكبديل، قد تواجه التحويل السلس لصور JPG إلى ملفات Word DOC باستخدام التركيبة الديناميكية لأوامر Aspose.Words Cloud وcURL. نظرًا لأن أوامر cURL توفر طريقة سهلة الاستخدام وقابلة للبرمجة لبدء التحويل، فإن Aspose.Words Cloud يضيف طبقة من التطور إلى العملية. لذلك، لا يعمل هذا التكامل على تبسيط تحويل “الصورة إلى Word” فحسب، بل يوفر أيضًا مجموعة من المزايا الأخرى لتحسين عملية إدارة مستندات Word.

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

curl -v "https://api.aspose.cloud/connect/token" \
 -X POST \
 -d "grant_type=client_credentials&client_id=bb959721-5780-4be6-be35-ff5c3a6aa4a2&client_secret=4d84d5f6584160cbd91dba1fe145db14" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Accept: application/json"

بمجرد حصولنا على رمز JWT، يرجى تنفيذ الأمر التالي لإنشاء مستند 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/{sourceFile}/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":{"Tulips.jpg"}}

ما عليك سوى استبدال “sourceFile” باسم مستند Word الفارغ الذي تم إنشاؤه في الخطوة السابقة. أيضًا، استبدل “outputFile” باسم مستند Word الناتج الذي سيتم إنشاؤه.

خاتمة

لقد تعلمنا أن التحويل من صور JPG إلى مستندات Word يعد قدرة أساسية في عصرنا الرقمي. فهو يفتح عالمًا من الإمكانيات لإدارة المحتوى وتحريره. في هذه المقالة، اكتشفنا طريقتين ديناميكيتين لتحقيق هذا التحول: أحدهما يستخدم Aspose.Words Cloud SDK لـ .NET، والآخر يستفيد من قوة Aspose.Words Cloud باستخدام أوامر cURL.

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

روابط مفيدة

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

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