SDK لإدارة المشاريع السحابية بلغة C# .NET للمطورين

البدء مع Aspose.Tasks Cloud .NET SDK

للبدء باستخدام Aspose.Tasks Cloud .NET SDK، قم أولاً بتسجيل حساب مجاني في لوحة تحكم Aspose Cloud للحصول على معرف التطبيق (App SID) ومفتاح التطبيق (App Key). ثم، قم بتثبيت SDK باستخدام مدير حزم NuGet في Visual Studio عن طريق تشغيل `Install-Package Aspose.Tasks-Cloud`، أو استخدم الأمر `nuget install Aspose.Tasks-Cloud` من سطر الأوامر. تم بناء SDK على .NET Standard 2.0 ويعمل عبر Windows وLinux وmacOS. بمجرد التثبيت، قم بتهيئة كائن `Configuration` باستخدام بيانات الاعتماد الخاصة بك وابدأ في استخدام الفئة `TasksApi` لإدارة ملفات المشروع في السحابة. لمزيد من المعلومات، قم بزيارة [Aspose.Tasks Cloud .NET SDK](https://products.aspose.cloud/tasks/net/) صفحة المنتج.

Install-Package Aspose.Tasks-Cloud

تحويل ملفات MS Project إلى PDF و XLSX والصور

يتيح Aspose.Tasks Cloud .NET SDK للمطورين تحويل ملفات المشاريع إلى مجموعة واسعة من صيغ الإخراج بما في ذلك PDF و XLSX و HTML و CSV ومختلف صيغ الصور مثل PNG و JPEG و TIFF و SVG. هذا مفيد بشكل خاص لإنشاء التقارير، ومشاركة حالة المشروع مع أصحاب المصلحة، أو دمج بيانات المشروع في أنظمة أخرى. تدعم عملية التحويل خيارات عرض مخصصة مثل تحديد أنواع التقارير (مثل المعالم، المهام الحرجة)، وتطبيق إعدادات العرض، وإدراج التعليقات. يمكن للمطورين تحميل ملفات MPP/MPT إلى التخزين السحابي ثم طلب التحويل باستخدام استدعاءات API غير متزامنة أو متزامنة، مما يضمن معالجة فعّالة للمشاريع الكبيرة أو المعقدة.

var config = new Configuration
{
    AppSid = "MY_CLIENT_ID",
    AppKey = "MY_CLIENT_SECRET"
};
var tasksApi = new TasksApi(config);
using (var inputStream = new FileStream("input.mpp", FileMode.Open))
{
    var uploadFileRequest = new PostCreateRequest("input.mpp", inputStream);
    tasksApi.UploadFile(uploadFileRequest);
}
var request = new GetReportPdfRequest { Name = "input.mpp", Type = ReportType.Milestones };
Stream response = await tasksApi.GetReportPdfAsync(request);

إدارة مهام المشروع والموارد والتقويمات

يوفر SDK واجهات برمجة تطبيقات شاملة لإدارة عناصر المشروع الأساسية: المهام والموارد والتعيينات والتقويمات. يمكن للمطورين إضافة المهام وتحديثها وحذفها ونقلها ضمن هيكل المشروع، وإدارة روابط المهام واعتمادياتها، والتلاعب بتعيينات الموارد — بما في ذلك تكلفة البيانات والعمل. تشمل إدارة التقويم إنشاء تقويمات جديدة، وإضافة استثناءات، واسترجاع معلومات التقويم حسب المعرف الفريد (UID)، وإدارة أسابيع العمل. كما يتم دعم السمات الموسعة، وأكواد المخطط، وتعريفات هيكل تقسيم العمل (WBS) بالكامل. تتيح هذه القدرات للمطورين بناء تطبيقات إدارة مشاريع ديناميكية تتزامن مع بيانات المشروع المستندة إلى السحابة في الوقت الفعلي.

var request = new PostTaskRequest("project.mpp", new TaskItem { Name = "New Task" });
var response = await tasksApi.PostTaskAsync(request);
// Update the task
response.TaskItem.Name = "Updated Task";
var updateRequest = new PutTaskRequest("project.mpp", response.TaskItem.Uid, response.TaskItem);
await tasksApi.PutTaskAsync(updateRequest);

إجراء تحليل المخاطر بطريقة مونت كارلو وإنشاء التقارير

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

var riskOptions = new RiskAnalysisSettings
{
    ConfidenceLevel = ConfidenceLevel.CL75,
    IterationsCount = 200,
    Distribution = DistributionType.Normal
};
var request = new PostProjectRiskAnalysisRequest("project.mpp", riskOptions);
var response = await tasksApi.PostProjectRiskAnalysisAsync(request);
// Save the report as PDF
var reportRequest = new GetReportPdfRequest { Name = "project.mpp", Type = ReportType.RiskAnalysis };
Stream report = await tasksApi.GetReportPdfAsync(reportRequest);

استيراد مشاريع Primavera وإدارة وحدات VBA

يدعم SDK استيراد المشاريع من صيغ Primavera P6 XML و XER، وكذلك من قواعد البيانات باستخدام سلاسل اتصال مخصصة. يتيح ذلك ترحيل بيانات Primavera بسلاسة إلى هياكل متوافقة مع Microsoft Project للتحليل وإعداد التقارير. بالإضافة إلى ذلك، يوفر Aspose.Tasks Cloud .NET SDK تحكمًا كاملاً في وحدات VBA (Visual Basic for Applications) — يمكن للمطورين قراءة وإنشاء وتحديث وحذف وحدات VBA ومكوناتها برمجيًا. هذا أمر أساسي لأتمتة قوالب المشاريع التي تدعم الماكرو وضمان التناسق عبر محافظ المشاريع المؤسسية دون تدخل يدوي.

// Import Primavera XER
var importRequest = new PostProjectFromDatabaseRequest("primavera.xer", "connection_string");
var importedProject = await tasksApi.PostProjectFromDatabaseAsync(importRequest);

// Add a new VBA module
var vbaModule = new VbaModule { Name = "MyModule", Type = VbaModuleType.ProceduralModule };
var vbaRequest = new PostVbaModuleRequest("project.mpp", vbaModule);
await tasksApi.PostVbaModuleAsync(vbaRequest);