ایجاد و تبدیل فایل‌های MS Project با استفاده از API REST پایتون

شروع کار با Aspose.Tasks Cloud Python SDK

روش پیشنهادی برای نصب Aspose.Tasks Cloud Python SDK از طریق PyPI است. لطفاً برای نصب روان از دستورات زیر استفاده کنید.

pip install asposetaskscloud

تبدیل فایل‌های مدیریت پروژه با پایتون

یکی از مفیدترین ویژگی‌های Aspose.Tasks Cloud Python SDK توانایی تبدیل فایل‌های مدیریت پروژه بین فرمت‌های مختلف است. این SDK به توسعه‌دهندگان اجازه می‌دهد فایل‌های Microsoft Project (MPP) را به فرمت‌هایی مانند PDF، XML، XLSX و فرمت‌های Primavera (P6XML و XER) تبدیل کنند، که به‌راحتی امکان اشتراک‌گذاری اطلاعات پروژه را در پلتفرم‌های مختلف فراهم می‌آورد. این نمونه کد نشان می‌دهد چگونه توسعه‌دهندگان می‌توانند یک فایل MPP را به فضای ذخیره‌سازی ابری بارگذاری کرده و با استفاده از SDK آن را به فرمت PDF تبدیل کنند.

	api_client = asposetaskscloud.ApiClient()
	api_client.configuration.host = 'https://api.aspose.cloud'
	api_client.configuration.api_key['api_key'] = 'MY_CLIENT_SECRET'
	api_client.configuration.api_key['app_sid'] = 'MY_CLIENT_ID'
	tasks_api = asposetaskscloud.TasksApi(api_client)

	file_name = 'SomeSeriousPlan.mpp'

	upload_request = asposetaskscloud.models.requests.UploadFileRequest(os.path.join(self.remote_test_folder, file_name), file_name)
	upload_result = self.tasks_api.upload_file(upload_request)

	request = asposetaskscloud.models.requests.GetReportPdfRequest(file_name, ReportType.MILESTONES)
	result = tasks_api.get_report_pdf(request)

مدیریت وظایف پروژه در برنامه‌های ابری

Aspose.Tasks Cloud Python SDK APIهای جامع برای ایجاد و مدیریت وظایف در فایل‌های پروژه داخل برنامه‌های مبتنی بر ابر پایتون فراهم می‌کند. با تنها چند خط کد، توسعه‌دهندگان می‌توانند وظایف را ایجاد، به‌روزرسانی، حذف و اختصاص دهند، وابستگی‌های وظیفه‌ای را تنظیم کنند، محدودیت‌ها را تعریف کنند و مبناهای وظیفه را مدیریت کنند. این ویژگی به شما اجازه می‌دهد برنامه‌ریزی‌های پیچیده پروژه را به‌راحتی خودکار کنید و مدیریت کنید. در مثال زیر، کاربران می‌توانند دو وظیفه ایجاد کرده و با استفاده از لینک «پایان به شروع» یک وابستگی بین آن‌ها تنظیم کنند. وابستگی‌های وظیفه‌ای برای مدیریت مؤثر جریان کار پروژه حیاتی هستند.

# ایجاد یک وظیفه جدید در پروژه
task = models.Task(name="Develop Backend", start="2024-10-23", duration=5)
created_task = api.create_task(file_name, task)

# تنظیم وابستگی وظیفه (پایان به شروع)
dependent_task = models.Task(name="Develop Frontend", start="2024-10-30", duration=5)
created_dependent_task = api.create_task(file_name, dependent_task)
dependency = models.TaskLink(predecessor_uid=created_task.uid, successor_uid=created_dependent_task.uid, link_type="FinishToStart")
api.create_task_link(file_name, dependency)

مدیریت تقویم‌های پروژه با API پایتون

مدیریت برنامه‌ریزی‌های پروژه نیازمند مدیریت صحیح ساعات کاری، تعطیلات و روزهای غیرکاری است. Aspose.Tasks Cloud Python SDK ویژگی‌هایی برای مدیریت تقویم‌های پروژه فراهم می‌کند که به توسعه‌دهندگان اجازه می‌دهد زمان‌های کاری، تعطیلات، برنامه‌های کاری سفارشی و موارد دیگر را در برنامه‌های پایتون مبتنی بر ابر تعریف کنند. مثال زیر نشان می‌دهد چگونه توسعه‌دهندگان می‌توانند یک تقویم به پروژه در برنامه‌های پایتون مبتنی بر ابر اضافه کنند.

filename = 'Home_move_plan.mpp'
self.upload_file(filename)
first_day = WeekDay()
first_day.day_type = DayType.SUNDAY
first_day.day_working = False
second_day = WeekDay()
second_day.day_type = DayType.MONDAY
second_day.day_working = True
second_day.from_date = datetime(2000, 1, 1, 8)
second_day.to_date = datetime(2000, 1, 1, 17)
first_working_time = WorkingTime()
first_working_time.from_time = datetime(2000, 1, 1, 8)
first_working_time.to_time = datetime(2000, 1, 1, 13)
second_working_time = WorkingTime()
second_working_time.from_time = datetime(2000, 1, 1, 14)
second_working_time.to_time = datetime(2000, 1, 1, 17)
second_day.working_times = [first_working_time, second_working_time]
calendar = Calendar()
calendar.name = 'My new calendar'
calendar.days = [first_day, second_day]
calendar.is_base_calendar = False
calendar.is_baseline_calendar = False
request = PostCalendarRequest(filename, calendar)
post_result = self.tasks_api.post_calendar(request)
self.assertIsNotNone(post_result)
self.assertIsInstance(post_result, CalendarItemResponse)
get_result = self.tasks_api.get_calendar(GetCalendarRequest(filename, post_result.calendar_item.uid))
self.assertEqual('My new calendar', get_result.calendar.name)
self.assertEqual(7, len(get_result.calendar.days))
monday = next(d for d in get_result.calendar.days if d.day_type == DayType.MONDAY)
self.assertEqual(2, len(monday.working_times))
self.assertEqual(first_working_time.from_time.strftime("%H:%M:%S"), monday.working_times[0].from_time.strftime("%H:%M:%S"))
self.assertEqual(first_working_time.to_time.strftime("%H:%M:%S"), monday.working_times[0].to_time.strftime("%H:%M:%S"))
self.assertEqual(second_working_time.from_time.strftime("%H:%M:%S"), monday.working_times[1].from_time.strftime("%H:%M:%S"))
self.assertEqual(second_working_time.to_time.strftime("%H:%M:%S"), monday.working_times[1].to_time.strftime("%H:%M:%S"))

افزودن نمودارهای گانت و گزارش‌ها به فایل‌های پروژه

Aspose.Tasks Cloud Python SDK به توسعه‌دهندگان این امکان را می‌دهد که گزارش‌های بصری مانند نمودارهای گانت و گزارش‌های پیشرفت وظایف را با استفاده از API REST پایتون تولید کنند. این نمودارها به مدیران پروژه کمک می‌کند تا زمان‌بندی وظایف، وابستگی‌ها و پیشرفت کلی را به‌صورت تصویری مشاهده کنند، که برای ذینفعان و اعضای تیم بسیار مهم است. در این مثال نحوه خروجی‌گیری یک فایل پروژه به PDF که می‌تواند به‌عنوان نمودار گانت استفاده شود، نشان داده شده است.

# خروجی‌گیری پروژه به PDF برای نمایش به‌عنوان نمودار گانت
response = api.export(file_name, 'pdf')
with open('gantt_chart.pdf', 'wb') as f:
    f.write(response)