|
| 1 | +# Manipulate MS Project Files in Java via Cloud REST API |
| 2 | + |
| 3 | +Aspose.Tasks for Cloud offers the ability to manipulate and convert Microsoft Project MPT, MPP, MPX & Oracle Primavera XER, XML, and PrimaveraP6XML files in Java. [Aspose.Tasks Cloud SDK for Java](https://products.aspose.cloud/tasks/java) wraps the REST API to make it easier for the developers to integrate MS Project Task Management features in their own cloud-based Java applications on Linux, MacOS, Windows or Android. |
| 4 | + |
| 5 | +Feel free to explore the [Developer's Guide](https://docs.aspose.cloud/display/taskscloud/Developer+Guide) & [API Reference](https://apireference.aspose.cloud/tasks/) to know all about Aspose.Tasks Cloud API. |
| 6 | + |
| 7 | +## MS Project Processing Features |
| 8 | +- Add project assignments or delete project assignments along with their references. |
| 9 | +- Get the project's outline codes by index & get links to all project tasks. |
| 10 | +- Import projects from Primavera DB formats or from databases with the specified connection string. |
| 11 | +- Get UIDs of all projects contained in the file & fetch the required assignment with the project based on UID. |
| 12 | +- Manage project tasks, resource data, calendars & Work Breakdown Structure (WBS). |
| 13 | +- Perform risk analysis using Monte Carlo simulation and create a report. |
| 14 | +- Create and set project document properties & fetch all or specific existing properties. |
| 15 | +- Get a project's extended attributes, time-scaled data, or recurring info of a specific task. |
| 16 | +- Reschedule project tasks, dates, and other settings. |
| 17 | +- Calculate slacks & recalculate project completion or incompletion work. |
| 18 | +- Fetch a project document in the desired format. |
| 19 | +- Delete project task with its related references & rebuild the task tree. |
| 20 | +- [Convert project documents](https://docs.aspose.cloud/tasks/convert-project-document-to-the-specified-format/) to other formats. |
| 21 | +- Manipulate task data. |
| 22 | +- [Manage project's resources](https://docs.aspose.cloud/tasks/working-with-resources/). |
| 23 | +- Handle task links & task assignments. |
| 24 | +- Work with project's extended attributes. |
| 25 | +- [Read Microsoft Project’s document properties](https://docs.aspose.cloud/tasks/working-with-calendars/) such as start and finish date, tasks scheduling types and so on. |
| 26 | +- [Read Microsoft Project’s Calendars](https://docs.aspose.cloud/tasks/working-with-calendars/) and Calendar Exceptions information. |
| 27 | + |
| 28 | +## Read & Write Project Data |
| 29 | +**Microsoft Project** MPP, XML, MPT **Primavera** MPX |
| 30 | + |
| 31 | +## Save Project Data As |
| 32 | +XER, XLSX, HTML, XML, TXT, TIF, SVG, PNG, JPEG |
| 33 | + |
| 34 | + |
| 35 | +## Enhancements in Version 20.11 |
| 36 | +- Support for the batch creation of tasks (i.e. the ability to create multiple tasks in a single *API* call). |
| 37 | + |
| 38 | +## Enhancements in Version 20.8 |
| 39 | +- Ability to specify the non-default path for Project Server's *PWA* URL. |
| 40 | +- Ability to modify *timephasedData* collection in assignments. |
| 41 | + |
| 42 | +## Enhancements in Version 20.6 |
| 43 | +- Possibility to render comments when saving as image, HTML or PDF. |
| 44 | +- Option to use username and password to connect Project Online (Server) instead of auth token, incase you don't have it. |
| 45 | +- Ability to add assignments to your project file along with specifying its cost. |
| 46 | +- Quickly adding new tasks to project, when calculation mode is set to automatic. |
| 47 | +- Ability to add project in Microsoft Project Server. |
| 48 | +- Added support of reading shared resource assignments. |
| 49 | + |
| 50 | + |
| 51 | +## How to use the SDK? |
| 52 | +The complete source code is available in this repository folder. You can either directly use it in your project via source code or get [Maven](https://repository.aspose.cloud/webapp/#/artifacts/browse/tree/General/repo/com/aspose/aspose-tasks-cloud) (recommended). For more details, please visit our [documentation website](https://docs.aspose.cloud/display/taskscloud/Available+SDKs). |
| 53 | + |
| 54 | +### Prerequisites |
| 55 | + |
| 56 | +To use Aspose Tasks Cloud SDK for Java you need to register an account with [Aspose Cloud](https://www.aspose.cloud/) and lookup/create App Key and SID at [Cloud Dashboard](https://dashboard.aspose.cloud/#/apps). There is free quota available. For more details, see [Aspose Cloud Pricing](https://purchase.aspose.cloud/pricing). |
| 57 | + |
| 58 | +## Installation & Usage |
| 59 | +Add this dependency to your project's POM: |
| 60 | + |
| 61 | +```xml |
| 62 | +<repositories> |
| 63 | + <repository> |
| 64 | + <id>aspose-cloud</id> |
| 65 | + <name>artifact.aspose-cloud-releases</name> |
| 66 | + <url>http://artifact.aspose.cloud/repo</url> |
| 67 | + </repository> |
| 68 | +</repositories> |
| 69 | + |
| 70 | +<dependencies> |
| 71 | + <dependency> |
| 72 | + <groupId>com.aspose</groupId> |
| 73 | + <artifactId>aspose-Tasks-cloud</artifactId> |
| 74 | + <version>21.2.0</version> |
| 75 | + </dependency> |
| 76 | +</dependencies> |
| 77 | +``` |
| 78 | + |
| 79 | +## Convert MS Project MPP to PDF in Java |
| 80 | + |
| 81 | +```java |
| 82 | + // Start README example |
| 83 | + |
| 84 | + // if baseUrl is null, TasksApi uses default https://api.aspose.cloud |
| 85 | + TasksApi tasksApi = new TasksApi(clientId, clientSecret, baseUrl); |
| 86 | + |
| 87 | + String localPath = PathUtil.get(localFolder, fileName); |
| 88 | + String remotePath = PathUtil.get(remoteFolder, remoteName); |
| 89 | + |
| 90 | + UploadFileRequest uploadRequest = new UploadFileRequest(Files.readAllBytes(Paths.get(localPath)), remotePath, null); |
| 91 | + tasksApi.uploadFile(uploadRequest); |
| 92 | + |
| 93 | + GetReportPdfRequest request = new GetReportPdfRequest(remoteFileName, ReportType.MILESTONES.getValue(), null, null); |
| 94 | + File result = tasksApi.getReportPdf(request); |
| 95 | + |
| 96 | + |
| 97 | + // End README example |
| 98 | +``` |
| 99 | + |
| 100 | +[Test](src/test/java/com/aspose/tasks/cloud) contain various examples of using the SDK. |
| 101 | + |
| 102 | +## Dependencies |
| 103 | +- Java 1.7+ |
| 104 | +- referenced packages (see [here](pom.xml) for more details) |
| 105 | + |
| 106 | +## Licensing |
| 107 | + |
| 108 | +All Aspose.Tasks Cloud SDKs, helper scripts and templates are licensed under [MIT License](https://github.com/aspose-tasks-cloud/aspose-tasks-cloud-java/blob/master/LICENSE). |
| 109 | + |
| 110 | +## Contact Us |
| 111 | +Your feedback is very important to us. Please feel free to contact us using our [Support Forums](https://forum.aspose.cloud/c/tasks). |
| 112 | + |
| 113 | +## Resources |
| 114 | + |
| 115 | +[Website](https://www.aspose.cloud/) |
| 116 | +[Product Home](https://products.aspose.cloud/tasks/family) |
| 117 | +[API Reference](https://apireference.aspose.cloud/tasks/) |
| 118 | +[Documentation](https://docs.aspose.cloud/display/taskscloud/Home) |
| 119 | +[Blog](https://blog.aspose.cloud/category/tasks/) |
| 120 | + |
| 121 | +## Aspose.Tasks Cloud SDKs in Popular Languages |
| 122 | + |
| 123 | +| .NET | PHP | Python| Node.js | Go | |
| 124 | +|---|---|---|---|---| |
| 125 | +| [GitHub](https://github.com/aspose-tasks-cloud/aspose-tasks-cloud-dotnet) |[GitHub](https://github.com/aspose-tasks-cloud/aspose-tasks-cloud-php) | [GitHub](https://github.com/aspose-tasks-cloud/aspose-tasks-cloud-python) | [GitHub](https://github.com/aspose-tasks-cloud/aspose-tasks-cloud-node) |[GitHub](https://github.com/aspose-tasks-cloud/aspose-tasks-cloud-go)| |
| 126 | +| [NuGet](https://www.nuget.org/packages/Aspose.tasks-Cloud/)| [Composer](https://packagist.org/packages/aspose/tasks-cloud-php) | [PIP](https://pypi.org/project/aspose-tasks-cloud/) | [NPM](https://www.npmjs.com/package/@asposecloud/aspose-tasks-cloud) | [Go.Dev](https://pkg.go.dev/github.com/aspose-tasks-cloud/aspose-tasks-cloud-go/) | |
| 127 | + |
| 128 | +[Product Page](https://products.aspose.cloud/tasks/python) | [Documentation](https://docs.aspose.cloud/display/taskscloud/Home) | [API Reference](https://apireference.aspose.cloud/tasks/) | [Code Samples](https://github.com/aspose-tasks-cloud/aspose-tasks-cloud-python) | [Blog](https://blog.aspose.cloud/category/tasks/) | [Free Support](https://forum.aspose.cloud/c/tasks) | [Free Trial](https://dashboard.aspose.cloud/#/apps) |
0 commit comments