Java Project Management API to Create & Convert Microsoft Project Files

شروع کار با Aspose.Tasks for Java

روش پیشنهادی برای نصب Aspose.Tasks for Java از طریق مخزن Maven است. می‌توانید به راحتی API Aspose.Words for 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>

ایجاد یک فایل پروژه جدید با جاوا

توسعه‌دهندگان نرم‌افزار می‌توانند پروژه‌های خالی جدید را از صفر با استفاده از Aspose.Tasks for Java ایجاد کنند. این قابلیت زمانی مفید است که نیاز به تولید دینامیک فایل‌های پروژه داشته باشید. کتابخانه از طیف وسیعی از فرمت‌های فایل Microsoft Project از جمله MPP، XML و MPX پشتیبانی می‌کند. در حال حاضر، Aspose.Tasks for 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
    }
}

خواندن فایل‌های پروژه با API جاوا

یکی از ویژگی‌های اساسی Aspose.Tasks for Java توانایی خواندن فایل‌های Microsoft Project است. این کتابخانه به توسعه‌دهندگان امکان بارگذاری یک فایل پروژه موجود را تنها با چند خط کد می‌دهد و اطلاعات ارزشمندی را از فایل‌های پروژه استخراج می‌کند. کلاس Project می‌تواند برای انجام این کارها استفاده شود؛ شما باید مسیر فایل MPP یا XML را فراهم کنید و یک شیء Project دریافت می‌کنید که می‌تواند برای دستکاری داده‌های پروژه به کار رود. مثال زیر نشان می‌دهد چگونه توسعه‌دهندگان می‌توانند یک فایل پروژه را به‌صورت آنلاین در برنامه‌های جاوا بخوانند.

 
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());
}

مدیریت وظیفه و زمان‌بندی در برنامه‌های جاوا

Aspose.Tasks for 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 با API جاوا

Aspose.Tasks for Java به توسعه‌دهندگان امکان می‌دهد داده‌های پروژه را به‌صورت آسان به فرمت‌های مهم مختلف ذخیره کنند. کلاس Project متد 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");