Чтение и сохранение проектов в 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 класс для подключения к Project Server или Project Online. Для аутентификации используйте ProjectServerCredentials класс, который теперь позволяет указывать SiteUrl, Username, и Password напрямую. Ранее разработчикам приходилось использовать Microsoft.SharePoint.Client.Runtime сборку для получения AuthToken, но эта зависимость больше не требуется.

Примечание: В настоящее время Aspose.Tasks for .NET не поддерживает современную аутентификацию для Project Online.
Устаревшая аутентификация должна быть включена в вашем портале Azure и в 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. Это позволяет программно создавать, считывать и обновлять корпоративные проекты, что облегчает поддержание согласованности, автоматизацию рабочих процессов и интеграцию данных проектов в более крупные бизнес-системы. Такая автоматизация помогает сократить ручной труд, повысить точность и обеспечить синхронность и эффективность управления проектами на корпоративном уровне.