
Aspose.Tasks Cloud .NET SDK
SDK مدیریت پروژه C# .NET مبتنی بر ابر برای توسعهدهندگان
خواندن، نوشتن، تبدیل و دستکاری فایلهای MS Project و Primavera از طریق REST API در ابر.
Aspose.Tasks Cloud .NET SDK چیست؟
Aspose.Tasks Cloud .NET SDK یک کیت توسعه نرمافزار قدرتمند مبتنی بر ابر است که به توسعهدهندگان .NET امکان میدهد بهصورت برنامهنویسی فایلهای Microsoft Project (MPP، MPT، MPX) و Primavera (XER، XML، PrimaveraP6XML) را بدون نیاز به نصب Microsoft Office یا Project مدیریت کنند. این SDK، API REST Aspose.Tasks Cloud را در بر میگیرد تا ادغام ویژگیهای پیشرفته مدیریت پروژه—مانند دستکاری کارها، زمانبندی منابع، مدیریت تقویم و تحلیل ریسک—را در برنامههای .NET مبتنی بر ابر که بر روی Windows، Linux یا macOS اجرا میشوند، سادهسازی کند. این SDK از عملیاتهایی مانند خواندن ویژگیهای گسترشیافته، وارد کردن از پایگاههای داده، باززمانبندی کارها، انجام شبیهسازیهای مونت کارلو و تبدیل فایلهای پروژه به فرمتهای PDF، XLSX، HTML و تصویر پشتیبانی میکند.
طراحی شده برای مقیاسپذیری و امنیت، Aspose.Tasks Cloud .NET SDK به توسعهدهندگان امکان میدهد برنامههای قدرتمند و سطح سازمانی برای ردیابی پروژه، گزارشگیری و همکاری بسازند. با پشتیبانی از ساختارهای شکست کار (WBS)، لینکهای وظیفه، تخصیصها، تعادل منابع و دادههای مقیاسزمانی، این SDK کنترل جامع بر دادههای پروژه فراهم میکند. توسعهدهندگان میتوانند بهسرعت با ثبتنام یک حساب رایگان در Aspose Cloud، دریافت App SID و کلید، و نصب SDK از طریق NuGet شروع کنند. این SDK همچنین شامل مستندات دقیق، مراجع API، نمونههای کد و پشتیبانی فنی رایگان است تا توسعه را تسریع کرده و اطمینان از قابلیت اطمینان در محیطهای تولیدی را فراهم کند.
شروع کار با Aspose.Tasks Cloud .NET SDK
برای شروع کار با Aspose.Tasks Cloud .NET SDK، ابتدا یک حساب کاربری رایگان در داشبورد Aspose Cloud ثبت کنید تا SID برنامه و کلید برنامه خود را دریافت کنید. سپس، SDK را با استفاده از NuGet Package Manager در 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/) مراجعه کنید.
نصب Aspose.Tasks Cloud .NET SDK از طریق NuGet
Install-Package Aspose.Tasks-Cloudتبدیل فایلهای MS Project به PDF، XLSX و تصاویر
SDK .NET ابری Aspose.Tasks به توسعهدهندگان امکان تبدیل فایلهای پروژه به طیف گستردهای از فرمتهای خروجی از جمله PDF، XLSX، HTML، CSV و انواع فرمتهای تصویری مانند PNG، JPEG، TIFF و SVG را میدهد. این ویژگی بهویژه برای تولید گزارشها، به اشتراکگذاری وضعیت پروژه با ذینفعان یا یکپارچهسازی دادههای پروژه در سیستمهای دیگر مفید است. فرآیند تبدیل از گزینههای رندر سفارشی مانند تعیین نوع گزارش (مثلاً نقاط عطف، وظایف بحرانی)، اعمال تنظیمات نمایشی و گنجاندن نظرات پشتیبانی میکند. توسعهدهندگان میتوانند فایلهای MPP/MPT را به فضای ذخیرهسازی ابری بارگذاری کرده و سپس با استفاده از فراخوانیهای API همزمان یا ناهمزمان، درخواست تبدیل کنند تا مدیریت مؤثر پروژههای بزرگ یا پیچیده تضمین شود.
تبدیل MPP به PDF در C#
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 مجموعهای کامل از APIها را برای مدیریت عناصر اصلی پروژه فراهم میکند: وظایف، منابع، تخصیصها و تقویمها. توسعهدهندگان میتوانند وظایف را در سلسلهمراتب پروژه اضافه، بهروزرسانی، حذف و جابجا کنند، پیوندها و وابستگیهای وظیفه را مدیریت کنند و تخصیصهای منابع را—از جمله هزینه و دادههای کاری—دستکاری کنند. مدیریت تقویم شامل ایجاد تقویمهای جدید، افزودن استثناها، بازیابی اطلاعات تقویم بر اساس 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 از وارد کردن پروژهها از فرمتهای XML و XER Primavera P6، همچنین از پایگاههای داده با استفاده از رشتههای اتصال سفارشی پشتیبانی میکند. این امکان را فراهم میآورد تا دادههای Primavera بهصورت یکپارچه به ساختارهای سازگار با Microsoft Project برای تجزیه و تحلیل و گزارشگیری منتقل شوند. علاوه بر این، Aspose.Tasks Cloud .NET SDK کنترل کامل بر ماژولهای VBA (Visual Basic for Applications) را فراهم میکند—توسعهدهندگان میتوانند ماژولها و اجزای VBA را بهصورت برنامهنویسی خوانده، ایجاد، بهروزرسانی و حذف کنند. این برای خودکارسازی قالبهای پروژه دارای ماکرو و اطمینان از سازگاری در سبدهای پروژهای سازمانی بدون دخالت دستی ضروری است.
فایل XER Primavera را وارد کنید و ماژول 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);
