Lesen und Speichern von Projekten in Project Server oder Project Online

Aspose.Tasks for .NET bietet vollständige Unterstützung beim Arbeiten mit Project Server (lokal) und Project Online (cloudbasiert) durch Nutzung der Project Web Access (PWA) API. Dadurch können Entwickler Projekte, die in unternehmensweiten Projektmanagementumgebungen gespeichert sind, programmgesteuert erstellen, lesen und aktualisieren.

Eine solche Integration ist nützlich für Organisationen, die auf zentralisierte Projektrepositories angewiesen sind und Prozesse wie Massenaktualisierungen, geplante Berichterstattung oder Projektsynchronisierung automatisieren möchten, ohne manuelle Eingriffe in Microsoft Project oder Project Web App zu benötigen.

Verwaltung von Projekten mit Project Server

Aspose.Tasks for .NET führt die ProjectServerManager -Klasse zum Verbinden mit Project Server oder Project Online. Zur Authentifizierung verwenden Sie die ProjectServerCredentials -Klasse, die jetzt erlaubt, direkt SiteUrl, Username, und Password Früher mussten Entwickler die Microsoft.SharePoint.Client.Runtime assembly verwenden, um ein AuthToken abzurufen, aber diese Abhängigkeit ist nicht mehr erforderlich.

Hinweis: Derzeit unterstützt Aspose.Tasks for .NET keine moderne Authentifizierung für Project Online.
Die Legacy-Authentifizierung muss in Ihrem Azure-Portal und im Office 365 Admin Center aktiviert sein, damit die Integration erfolgreich ist.

Lesen eines Projekts aus Project Server

Das folgende Beispiel zeigt, wie man eine Verbindung zu Project Server herstellt und die Daten eines vorhandenen Projekts liest:

const string SharepointDomainAddress = "https://contoso.sharepoint.com";
const string UserName = "[e-mail]";
const string Password = "MyPassword";

ProjectServerCredentials credentials = new ProjectServerCredentials(SharepointDomainAddress, UserName, Password);
ProjectServerManager manager = new ProjectServerManager(credentials);
IEnumerable<ProjectInfo> list = manager.GetProjectList();

foreach (var info in list)
{
    Project project = manager.GetProject(info.Id);
    Console.WriteLine("{0} - {1} - {2}", info.Name, info.CreatedDate, info.LastSavedDate);
    Console.WriteLine("Resources count: {0}", project.Resources.Count);

    // an user can read the project as raw data stream
    var stream = manager.GetProjectRawData(info.Id);

    // work with raw project data
}

Erstellen eines Projekts in Project Server

Dieses Beispiel zeigt, wie man programmatisch ein neues Projekt in Project Server erstellt:

try
{
    const string SharepointDomainAddress = "https://contoso.sharepoint.com";
    const string UserName = "[e-mail]";
    const string Password = "MyPassword";

    ProjectServerCredentials credentials = new ProjectServerCredentials(SharepointDomainAddress, UserName, Password);

    Project project = new Project("New Project.mpp");

    ProjectServerManager manager = new ProjectServerManager(credentials);
    manager.CreateNewProject(project);
}
catch (ProjectOnlineException ex)
{
    Console.WriteLine(ex.Message);
}

Sie können ein Projekt auch in Project Online mit vordefinierten Speicheroptionen:

Project project = new Project("New Project.mpp");
ProjectServerCredentials credentials = new ProjectServerCredentials("https://contoso.sharepoint.com", "[e-mail]", "MyPassword");
ProjectServerManager manager = new ProjectServerManager(credentials);
ProjectServerSaveOptions options = new ProjectServerSaveOptions
{
    Timeout = TimeSpan.FromSeconds(10)
};
manager.CreateNewProject(project, options);

Aktualisieren eines Projekts in Project Server

Dieses Beispiel zeigt, wie man ein vorhandenes Projekt in Project Server aktualisiert:

const string URL = "https://contoso.sharepoint.com";
const string Domain = "CONTOSO.COM";
const string UserName = "Administrator";
const string Password = "MyPassword";

NetworkCredential windowsCredentials = new NetworkCredential(UserName, Password, Domain);
ProjectServerCredentials projectServerCredentials = new ProjectServerCredentials(URL, windowsCredentials);
try
{
    ProjectServerManager manager = new ProjectServerManager(projectServerCredentials);

    var projectInfo = manager.GetProjectList().FirstOrDefault(p => p.Name == "My project");
    if (projectInfo == null)
    {
        Console.WriteLine("Project 'My project' not found in working store of Project Online account.");
        return;
    }

    Project project = manager.GetProject(projectInfo.Id);
    project.Set(Prj.FinishDate, new DateTime(2020, 03, 01));

    Task task = project.RootTask.Children.Add("New task");
    task.Set(Tsk.Start, new DateTime(2020, 02, 26));
    task.Set(Tsk.Duration, project.GetDuration(2, TimeUnitType.Day));

    manager.UpdateProject(project);
}
catch (ProjectOnlineException ex)
{
    Console.WriteLine("Failed to update the project. Error: " + ex);
}

Sie können Projekte auch in Project Online mit Speicheroptionen aktualisieren, wodurch Sie größere Kontrolle darüber erhalten, wie Änderungen angewendet werden:

const string SharepointDomainAddress = "https://contoso.sharepoint.com";
const string UserName = "[e-mail]";
const string Password = "MyPassword";

ProjectServerCredentials credentials = new ProjectServerCredentials(SharepointDomainAddress, UserName, Password);

try
{
    ProjectServerManager manager = new ProjectServerManager(credentials);

    var projectInfo = manager.GetProjectList().FirstOrDefault(p => p.Name == "My project");
    if (projectInfo == null)
    {
        Console.WriteLine("Project 'My project' not found in working store of Project Online account.");
        return;
    }

    Project project = manager.GetProject(projectInfo.Id);
    project.Set(Prj.FinishDate, new DateTime(2020, 03, 01));

    Task task = project.RootTask.Children.Add("New task");
    task.Set(Tsk.Start, new DateTime(2020, 02, 26));
    task.Set(Tsk.Duration, project.GetDuration(2, TimeUnitType.Day));

    ProjectServerSaveOptions options = new ProjectServerSaveOptions { Timeout = TimeSpan.FromMinutes(5) };

    manager.UpdateProject(project, options);
}
catch (ProjectOnlineException ex)
{
    Console.WriteLine("Failed to update the project. Error: " + ex);
}

Durch die Verwendung von Aspose.Tasks for .NET können Entwickler nahtlos sowohl mit Project Server und Project Online. Dadurch wird das programmatische Erstellen, Lesen und Aktualisieren von Unternehmensprojekten ermöglicht, wodurch die Konsistenz leichter gewahrt, Arbeitsabläufe automatisiert und Projektdaten in größere Geschäftssysteme integriert werden können. Eine solche Automatisierung hilft, manuellen Aufwand zu reduzieren, die Genauigkeit zu verbessern und sicherzustellen, dass das Projektmanagement auf Unternehmensebene synchronisiert und effizient bleibt.