ProjectServerManager

Inheritance: java.lang.Object

public final class ProjectServerManager

The class which provides the methods to read and to perform operations on projects in the specified Project Online account or in the specified on-premise Project Server instance (Project Server’s versions 2016 and 2019 are supported).

Constructors

ConstructorDescription
ProjectServerManager(ProjectServerCredentials credentials)Initializes a new instance of the ProjectServerManager class.

Methods

MethodDescription
createNewProject(Project project)Creates new project in Project Server\Project Online instance using default save options.
createNewProject(Project project, ProjectServerSaveOptions saveOptions)Creates new project in Project Server\Project Online instance using the specified save options.
getExecutingWebRequest()Gets an event that is raised when the web request is sent to Project Server’s web API.
getProject(UUID projectGuid)Gets the project with the specified guid from the Project Online account \ Project Server instance.
getProjectList()Gets the list of projects from ‘Working’ store of the current Project Online account \ Project Server instance.
getProjectRawData(UUID projectGuid)Gets the project’s binary data for troubleshooting purposes.
setExecutingWebRequest(Event<WebRequestEventArgs> value)Sets an event that is raised when the web request is sent to Project Server’s web API.
updateProject(Project project)Updates existing project in Project Server\Project Online instance using default save options.
updateProject(Project project, ProjectServerSaveOptions saveOptions)Updates existing project in Project Server\Project Online instance using the specified save options.

ProjectServerManager(ProjectServerCredentials credentials)

public ProjectServerManager(ProjectServerCredentials credentials)

Initializes a new instance of the ProjectServerManager class.


This example shows how to create instance of ProjectServerManager to access on-premise instance of Project Server.


 [C#]
 string site = "http://project_server_instance.local/";
 var windowsCredentials = new NetworkCredential("Administrator", "my_password", "DOMAIN");
 var projectServerCredentials = new ProjectServerCredentials(site, windowsCredentials);
 ProjectServerManager manager = new ProjectServerManager(projectServerCredentials);
 

This example shows how to create instance of ProjectServerManager to access account in Project Online service.


 [C#]
 var credentials = new ProjectServerCredentials("https://xxxxxx.sharepoint.com", "yyyyy@xxxxxxx.onmicrosoft.com", "password");
 ProjectServerManager manager = new ProjectServerManager(projectServerCredentials);
 

Parameters:

ParameterTypeDescription
credentialsProjectServerCredentialsCredentials used to connect to Project Online account.

createNewProject(Project project)

public final void createNewProject(Project project)

Creates new project in Project Server\Project Online instance using default save options.


In this example the project is loaded from .mpp file and saved to Project Online account.


 [C#]
 var credentials = new ProjectServerCredentials("https://xxxxxx.sharepoint.com", "yyyyy@xxxxxxx.onmicrosoft.com", "password");
 var project = new Project(@"sample.mpp");
 ProjectServerManager manager = new ProjectServerManager(credentials);
 manager.CreateNewProject(project);
 

Parameters:

ParameterTypeDescription
projectProjectThe project to save to Project Server\Project Online instance.

createNewProject(Project project, ProjectServerSaveOptions saveOptions)

public final void createNewProject(Project project, ProjectServerSaveOptions saveOptions)

Creates new project in Project Server\Project Online instance using the specified save options.


In this example the project is loaded from .mpp file and saved to Project Online account.


 [C#]
 var credentials = new ProjectServerCredentials("https://xxxxxx.sharepoint.com", "yyyyy@xxxxxxx.onmicrosoft.com", "password");
 var project = new Project(@"sample.mpp");
 ProjectServerManager manager = new ProjectServerManager(credentials);
 manager.CreateNewProject(project, new ProjectServerSaveOptions
 {
     ProjectName = "My new project"
 });
 

Parameters:

ParameterTypeDescription
projectProjectThe project to save to Project Server\Project Online instance.
saveOptionsProjectServerSaveOptionsInstance of ProjectServerSaveOptions class.

getExecutingWebRequest()

public final Event<WebRequestEventArgs> getExecutingWebRequest()

Gets an event that is raised when the web request is sent to Project Server’s web API.

Returns: Event - an event that is raised when the web request is sent to Project Server’s web API.

getProject(UUID projectGuid)

public final Project getProject(UUID projectGuid)

Gets the project with the specified guid from the Project Online account \ Project Server instance.

Parameters:

ParameterTypeDescription
projectGuidjava.util.UUIDThe Guid of the project to read.

Returns: Project - Instance of Project class which represents project read from Project Online \ Project Server.

getProjectList()

public final Iterable<ProjectInfo> getProjectList()

Gets the list of projects from ‘Working’ store of the current Project Online account \ Project Server instance.

Returns: java.lang.Iterable<com.aspose.tasks.ProjectInfo> - An enumeration of projects in the current Project Online account \ Project Server instance.

getProjectRawData(UUID projectGuid)

public final InputStream getProjectRawData(UUID projectGuid)

Gets the project’s binary data for troubleshooting purposes.



 In this example the debug info for the specific project is retrieved. You can pass the resulting "debug.zip" to the support team for troubleshooting purposes.
 [C#]
 var credentials = new ProjectServerCredentials("https://xxxxxx.sharepoint.com", "yyyyy@xxxxxxx.onmicrosoft.com", "password");
 // Guid of project you are trying to get.
 var projectGuid = new Guid("e0294bfb-5657-45c8-9cc5-82169fb95d69");
 ProjectServerManager manager = new ProjectServerManager(credentials);
 using (var fileStream = File.OpenWrite(@"c:\debug.zip"))
 {
     using (var stream = manager.GetProjectRawData(projectGuid))
     {
         stream.CopyTo(fileStream);
     }
 }
 

Parameters:

ParameterTypeDescription
projectGuidjava.util.UUIDThe Guid of the project to read.

Returns: java.io.InputStream - Stream containing raw project’s data.

setExecutingWebRequest(Event<WebRequestEventArgs> value)

public final void setExecutingWebRequest(Event<WebRequestEventArgs> value)

Sets an event that is raised when the web request is sent to Project Server’s web API.

Parameters:

ParameterTypeDescription
valuecom.aspose.tasks.Event<com.aspose.tasks.WebRequestEventArgs>an event that is raised when the web request is sent to Project Server’s web API.

updateProject(Project project)

public final void updateProject(Project project)

Updates existing project in Project Server\Project Online instance using default save options. The existing project will be overwritten.


In this example the project is loaded from Project Online account, modified and saved back to Project Online account.


 [C#]
 var credentials = new ProjectServerCredentials("https://xxxxxx.sharepoint.com", "yyyyy@xxxxxxx.onmicrosoft.com", "password");
 ProjectServerManager manager = new ProjectServerManager(credentials);
 var projectList = manager.GetProjectList();
 var projectGuid = projectList.First().Id;
 var project = manager.GetProject(projectGuid);
 var task = project.RootTask.Children.Add("New task");
 manager.UpdateProject(project);
 

Parameters:

ParameterTypeDescription
projectProjectThe project to save to Project Server\Project Online instance.

Project’s property ‘project.Get(Prj.Guid)’ should be a valid guid of a project which exists in Project Server account \ Project Online instance. |

updateProject(Project project, ProjectServerSaveOptions saveOptions)

public final void updateProject(Project project, ProjectServerSaveOptions saveOptions)

Updates existing project in Project Server\Project Online instance using the specified save options. The existing project will be overwritten.


In this example the project is loaded from Project Online account, modified and saved back to Project Online account.


 [C#]
 var credentials = new ProjectServerCredentials("https://xxxxxx.sharepoint.com", "yyyyy@xxxxxxx.onmicrosoft.com", "password");
 ProjectServerManager manager = new ProjectServerManager(credentials);
 var projectList = manager.GetProjectList();
 var projectGuid = projectList.First().Id;
 var project = manager.GetProject(projectGuid);
 var task = project.RootTask.Children.Add("New task");
 manager.UpdateProject(project, new ProjectServerSaveOptions
 {
     ProjectGuid = projectGuid
 });
 

Parameters:

ParameterTypeDescription
projectProjectThe project to save to Project Server\Project Online instance.
saveOptionsProjectServerSaveOptionsInstance of ProjectServerSaveOptions class.

saveOptions.ProjectGuid should be set to a guid of a project which exists on Project Server\ Project Online instance. |