Читання та збереження проєктів у Project Server або Project Online

Aspose.Tasks for .NET забезпечує повну підтримку роботи з Project Server (локально) та Project Online (на основі хмари) використовуючи Project Web Access (PWA) API. Це дає змогу розробникам програмно створювати, читати та оновлювати проєкти, які зберігаються в корпоративних системах управління проєктами.

Така інтеграція корисна для організацій, які покладаються на централізовані сховища проєктів і хочуть автоматизувати процеси, такі як масові оновлення, планове звітування або синхронізація проєктів без необхідності ручної взаємодії в Microsoft Project чи Project Web App.

Управління проєктами за допомогою Project Server

Aspose.Tasks for .NET представляє ProjectServerManager class для підключення до Project Server або Project Online. Для автентифікації використовуйте ProjectServerCredentials class, який тепер дозволяє вказувати SiteUrl, Username, та Password безпосередньо. Раніше розробникам доводилося використовувати Microsoft.SharePoint.Client.Runtime assembly для отримання AuthToken, але ця залежність більше не потрібна.

Примітка: Наразі Aspose.Tasks for .NET не підтримує сучасну автентифікацію для Project Online.
Застаріла автентифікація має бути увімкнена у вашому Azure portal та Office 365 Admin Center для успішної інтеграції.

Читання проєкту з Project Server

У наведеному прикладі показано, як підключитися до Project Server і прочитати дані існуючого проєкту:

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
}

Створення проєкту в Project Server

У цьому прикладі показано, як програмно створити новий проєкт у Project Server:

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

Ви також можете створити проєкт у Project Online з попередньо заданими параметрами збереження:

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

Оновлення проєкту в Project Server

У цьому прикладі показано, як оновити існуючий проєкт у Project Server:

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

Ви також можете оновлювати проєкти в Project Online з параметрами збереження, що дає вам більший контроль над тим, як застосовуються зміни:

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

Використовуючи Aspose.Tasks for .NET, розробники можуть безперешкодно інтегруватися з обома Project Server та Project Online. Це дозволяє програмно створювати, читати та оновлювати корпоративні проєкти, що спрощує підтримку послідовності, автоматизацію робочих процесів та інтеграцію даних проєктів у великі бізнес-системи. Така автоматизація допомагає зменшити ручну працю, підвищити точність і забезпечити синхронізацію та ефективність управління проєктами на корпоративному рівні.