تحديث عنصر صيغة Power Query في المصنف

مقدمة

إن فهم كيفية إدارة البيانات بكفاءة باستخدام Power Query في Excel أمر بالغ الأهمية لأي محلل بيانات أو متحمس لبرنامج Excel. إذا كنت في حاجة إلى تحديث عناصر الصيغة في مصنف Power Query، فأنت في المكان المناسب. تم تصميم هذا الدليل لمساعدتك على تعلم كيفية استخدام Aspose.Cells for .NET لتحديث صيغ Power Query بسلاسة في مصنف Excel. باتباع بضع خطوات بسيطة، ستتمكن من معالجة بياناتك وتبسيطها، مما يضمن بقاء مصنفاتك ديناميكية ومركزية.

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

قبل أن تبدأ في الغوص في كود المثال والخطوات، دعنا نراجع ما ستحتاج إليه:

  1. الفهم الأساسي لـ C# و.NET: سيكون من المفيد التعرف على مفاهيم البرمجة في C# لأننا سنكتب بعض التعليمات البرمجية.
  2. تثبيت Aspose.Cells لـ .NET: يجب أن يكون لديك مكتبة Aspose.Cells مدمجة في مشروع .NET الخاص بك. يمكنك تنزيلهاهنا.
  3. ملف Excel جاهز للتعديل: تأكد من أن لديك ملف Excel يحتوي على Power Query الذي ترغب في تحديثه. يجب أن يكون لديك مصنف عمل نموذجي مثلSamplePowerQueryFormula.xlsx تحت تصرفكم.

استيراد الحزم

للبدء، تأكد من تضمين المساحات الأسماء التالية في ملف C# الخاص بك:

using Aspose.Cells.DigitalSignatures;
using Aspose.Cells.QueryTables;
using System;
using System.IO;

سيسمح لك هذا بالوصول إلى الوظائف التي توفرها مكتبة Aspose.Cells، وخاصة للعمل مع المصنفات وبيانات Power Query.

الخطوة 1: إعداد أدلة العمل الخاصة بك

أولاً وقبل كل شيء، عليك تحديد مكان وجود ملفات المصدر والملفات الناتجة.

string SourceDir = "Your Document Directory";
string outputDir = "Your Document Directory";

في هذه الخطوة، يمكنك تحديد مسارات الدليل. استبدل"Your Document Directory" مع المسار الفعلي الذي يتم حفظ ملفات Excel فيه. يخبر هذا البرنامج بالمكان الذي يبحث فيه عن ملف المصدر والمكان الذي يحفظ فيه الملف المحدث.

الخطوة 2: تحميل المصنف

الآن بعد أن قمت بتعيين أدلة العمل الخاصة بك، فإن الخطوة التالية هي تحميل ملف Excel إلى البرنامج.

Workbook workbook = new Workbook(SourceDir + "SamplePowerQueryFormula.xlsx");

هنا، يمكنك إنشاءWorkbook الكائن الذي يقوم بتحميل ملف Excel المحدد.Workbookتعتبر الفئة جزءًا من مكتبة Aspose.Cells وهي ضرورية لأي عمليات ستقوم بإجرائها على ملف Excel هذا.

الخطوة 3: الوصول إلى بيانات Power Query

بمجرد تحميل المصنف، حان الوقت للوصول إلى صيغ Power Query المخزنة بداخله.

DataMashup mashupData = workbook.DataMashup;

في هذا الخط،DataMashup تساعد الخاصية في الوصول إلى هياكل بيانات Power Query داخل المصنف. تمنحك هذه الخاصية القدرة على التفاعل مع جوانب مختلفة من بيانات Power Query الموجودة في ملف Excel.

الخطوة 4: تكرار صيغ Power Query

بعد أن أصبحت بيانات Power Query متاحة، فإن الخطوة التالية هي تكرار كل الصيغ الموجودة.

foreach (PowerQueryFormula formula in mashupData.PowerQueryFormulas)
{
    foreach (PowerQueryFormulaItem item in formula.PowerQueryFormulaItems)
    {
        if (item.Name == "Source")
        {
            item.Value = "Excel.Workbook(File.Contents(\"" + SourceDir + "SamplePowerQueryFormulaSource.xlsx\"), null, true)";
        }
    }
}

وهنا يحدث السحر. نمر عبر كل حلقةPowerQueryFormula ومن ثم من خلال كلPowerQueryFormulaItem . الif يبحث البيان عن عنصر الصيغة المسمى “المصدر” ويقوم بتحديث قيمته ليكون مسار ملف المصدر الذي تريد أن يشير إليه Power Query. يتيح لك هذا تغيير الملف الذي يسحب Power Query البيانات منه بشكل ديناميكي.

الخطوة 5: احفظ المصنف المحدث

بعد تحديث عناصر الصيغة الضرورية، فإن خطوتك الأخيرة هي حفظ المصنف.

workbook.Save(outputDir + "SamplePowerQueryFormula_out.xlsx");

يقوم هذا السطر بحفظ المصنف المعدل في ملف جديد، وبالتالي الحفاظ على الأصل مع السماح لك بالعمل مع الإصدار المحدث.

الخطوة 6: رسالة التأكيد

وأخيرًا، من الجيد أن تتأكد من تنفيذ الكود الخاص بك بشكل صحيح.

Console.WriteLine("UpdatePowerQueryFormulaItem executed successfully.");

ستؤكد لك هذه الرسالة البسيطة في وحدة التحكم أن عمليتك كانت ناجحة، مما يوفر نهاية مطمئنة للعملية.

خاتمة

والآن، يمكنك تحديث عناصر صيغة Power Query في Excel باستخدام Aspose.Cells for .NET من خلال بضع خطوات بسيطة. باتباع هذا الدليل، يمكنك إدارة اتصالات بيانات Excel بكفاءة والحفاظ على تشغيل مصنفاتك بسلاسة. سواء كنت محترفًا متمرسًا أو بدأت للتو في معالجة البيانات، فإن Aspose.Cells يوفر طريقة قوية لأتمتة وتحسين سير عمل Excel.

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

هل يمكنني استخدام Aspose.Cells مع أي إصدار من .NET؟

يعد Aspose.Cells متوافقًا مع إصدارات متعددة من .NET، بما في ذلك .NET Framework و.NET Core.

هل استخدام Aspose.Cells مجاني؟

يقدم Aspose.Cells نسخة تجريبية مجانية، ولكن للاستخدام المستمر، يلزم الحصول على ترخيص. يمكنك الحصول على ترخيص مؤقتهنا.

ماذا لو كان ملف Excel الحالي الخاص بي لا يحتوي على Power Query؟

ترتكز العملية الموضحة على تحديث عناصر Power Query، لذا إذا كان ملفك يفتقر إليها، فستحتاج إلى دمج Power Query أولاً.

أين يمكنني العثور على مزيد من المعلومات حول Aspose.Cells؟

راجع الوثائق للحصول على إرشادات شاملة وأمثلة. قم بزيارةالتوثيق.

كيف يمكنني الإبلاغ عن الأخطاء أو المشكلات المتعلقة بـ Aspose.Cells؟

يمكنك التواصل مع المنتدى المدعوم للحصول على المساعدة فيما يتعلق بأي مشكلات تواجهها.

إيقاف التحويل أو التحميل باستخدام مراقبة المقاطعة العمل مع خصائص نوع المحتوى للمصنف