واجهة برمجة تطبيقات إدارة المشاريع بجافا لإنشاء وتحويل ملفات Microsoft Project

بدء الاستخدام مع Aspose.Tasks لـ Java

الطريقة الموصى بها لتثبيت Aspose.Tasks لـ Java هي عبر مستودع Maven. يمكنك بسهولة استخدام Aspose.Words لـ Java مباشرةً في مشاريع Maven الخاصة بك مع إعدادات بسيطة.

 //Define the Aspose.Tasks for Java API dependency in your pom.xml as follows
<dependencies>
	<dependency>
	<groupId>com.aspose</groupId>
	<artifactId>aspose-tasks</artifactId>
	<version>20.10</version>
	<classifier>jdk18</classifier>
	</dependency>
</dependencies>

إنشاء ملف مشروع جديد عبر Java

يمكن لمطوري البرمجيات إنشاء مشاريع فارغة جديدة من الصفر باستخدام Aspose.Tasks لـ Java. هذا مفيد عندما تحتاج إلى توليد ملفات مشروع بشكل ديناميكي. تدعم المكتبة مجموعة واسعة من صيغ ملفات Microsoft Project، بما في ذلك MPP و XML و MPX. في الوقت الحالي، توفر Aspose.Tasks لـ Java إمكانية إنشاء ملفات مشروع بصيغة XML فقط. السطور التالية من الشيفرة توضح كيفية إنشاء ملف مشروع بسيط بصيغة XML.

 
public class CreateEmptyProjectFile {
    public static void main(String[] args) {
        // ExStart: CreateEmptyProjectFile
        // For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Tasks-for-Java
        // The path to the documents directory.
        String dataDir = Utils.getDataDir(CreateEmptyProjectFile.class);

        // Create a project instance
        Project newProject = new Project();

        newProject.save(dataDir + "project1.xml", SaveFileFormat.Xml);

        //Display result of conversion.
        System.out.println("Project file generated Successfully");
        // ExEnd: CreateEmptyProjectFile
    }
}

قراءة ملفات المشروع عبر واجهة برمجة تطبيقات Java

إحدى الميزات الأساسية في Aspose.Tasks لـ Java هي القدرة على قراءة ملفات Microsoft Project. تسمح المكتبة لمطوري البرمجيات بتحميل ملف مشروع موجود ببضع أسطر من الشيفرة واستخراج معلومات قيمة من ملفات المشروع. يمكن استخدام فئة Project لتحقيق هذه المهام؛ عليك فقط توفير مسار ملف MPP أو XML وتُعيد فئة Project كائنًا يمكن استخدامه للتعامل مع بيانات المشروع. المثال التالي يوضح كيفية قراءة ملف مشروع عبر الإنترنت داخل تطبيقات Java.

 
String sharepointDomainAddress = "https://contoso.sharepoint.com";
String userName = "admin@contoso.onmicrosoft.com";
String password = "MyPassword";

ProjectServerCredentials credentials = new ProjectServerCredentials(sharepointDomainAddress, userName, password);
ProjectServerManager reader = new ProjectServerManager(credentials);

for (ProjectInfo p : (Iterable)reader.getProjectList())
{
    System.out.println("Project Name:" + p.getName());
    System.out.println("Project Created Date:" + p.getCreatedDate());
    System.out.println("Project Last Saved Date:" + p.getLastSavedDate());
}

for (ProjectInfo p : (Iterable)reader.getProjectList())
{
    Project project = reader.getProject(p.getId());
    System.out.println("Project " + p.getName() + " loaded.");
    System.out.println("Resources count:" + project.getResources().size());
}

معالجة المهام والجدولة في تطبيقات Java

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

// Create a new project and add a new task
Project project = new Project();
Task task = project.getRootTask().getChildren().add("Task");

// Task duration in days (default time unit)
Duration duration = task.get(Tsk.DURATION);
System.out.println("Duration equals 1 day:" + duration.toString().equals("1 day"));

// Convert to hours time unit
duration = duration.convert(TimeUnitType.Hour);
System.out.println("Duration equals 8 hrs: "+ duration.toString().equals("8 hrs"));

// Increase task duration to 1 week and display if duration is updated successfully
task.set(Tsk.DURATION, project.getDuration(1, TimeUnitType.Week));
System.out.println("Duration equals 1 wk: " + task.get(Tsk.DURATION).toString().equals("1 wk"));

// Decrease task duration and display if duration is updated successfully
task.set(Tsk.DURATION, task.get(Tsk.DURATION).subtract(0.5));
System.out.println("Duration equals 0.5 wks: " + task.get(Tsk.DURATION).toString().equals("0.5 wks"));

تحويل بيانات المشروع إلى PDF عبر واجهة برمجة تطبيقات Java

يسهّل Aspose.Tasks لـ Java على مطوري البرمجيات تحميل وحفظ بيانات المشروع إلى صيغ ملفات مهمة مختلفة داخل تطبيقات Java. تُظهر فئة Project طريقة Save التي يمكن استخدامها لحفظ المشروع بصيغ متعددة. تسمح طريقة Save للمستخدمين بتحميل وعرض بيانات المشروع بصيغة PDF ببضع أسطر من شيفرة جافا. المثال التالي يوضح كيفية عرض بيانات المشروع إلى PDF باستخدام أوامر جافا.

// The path to the documents directory.
String dataDir = Utils.getDataDir(SaveAsPdf.class);

// Read the input Project file
Project project = new Project(dataDir + "project6.mpp");

project.save(dataDir + "Project5.pdf", SaveFileFormat.PDF);

// Fitting contents to cell size
Project project1 = new Project(dataDir + "project6.mpp");
SaveOptions o = new PdfSaveOptions();

// Set the LegendOnEachPage property to false to hide legends

// Set the row height to fit cell content
o.setFitContent(true);
o.setTimescale(Timescale.Months);
o.setPresentationFormat(PresentationFormat.TaskUsage);
project1.save("result_months.pdf", o);
o.setLegendOnEachPage(false);
project1.save(dataDir + "result_months_WithoutLegend.pdf", o);

// Display result of conversion.
System.out.println("Process completed Successfully");