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 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これにより、企業のプロジェクトをプログラムで作成、読み取り、更新できるようになり、一貫性の維持、ワークフローの自動化、プロジェクトデータの大規模な業務システムへの統合が容易になります。このような自動化は手作業を減らし、精度を高め、企業レベルのプロジェクト管理を同期され効率的に保つのに役立ちます。