Lectura y guardado de proyectos en Project Server o Project Online

Aspose.Tasks for .NET proporciona compatibilidad total para trabajar con Project Server (en las instalaciones) y Project Online (basado en la nube) aprovechando el Project Web Access (PWA) API. Esto permite a los desarrolladores crear, leer y actualizar proyectos de forma programática almacenados en entornos empresariales de gestión de proyectos.

Esta integración es útil para organizaciones que dependen de repositorios de proyectos centralizados y desean automatizar procesos como actualizaciones masivas, informes programados o sincronización de proyectos sin requerir interacción manual en Microsoft Project o Project Web App.

Gestión de proyectos con Project Server

Aspose.Tasks for .NET introduce la ProjectServerManager clase para conectarse a Project Server o Project Online. Para la autenticación, utilice la ProjectServerCredentials , SiteUrl, Username, Password directamente. Anteriormente, los desarrolladores tenían que usar el Microsoft.SharePoint.Client.Runtime assembly para obtener un AuthToken, pero esta dependencia ya no es necesaria.

Nota: Actualmente, Aspose.Tasks for .NET no admite autenticación moderna para Project Online.
La autenticación heredada debe estar habilitada en su Azure portal y Office 365 Admin Center para una integración exitosa.

Lectura de un proyecto desde Project Server

El siguiente ejemplo muestra cómo conectarse a Project Server y leer los datos de un proyecto existente:

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
}

Creación de un proyecto en Project Server

Este ejemplo demuestra cómo crear programáticamente un nuevo proyecto en 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);
}

También puede crear un proyecto en Project Online con opciones de guardado predefinidas:

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

Actualización de un proyecto en Project Server

Este ejemplo muestra cómo actualizar un proyecto existente en 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);
}

También puede actualizar proyectos en Project Online con opciones de guardado, lo que le brinda mayor control sobre cómo se aplican los cambios:

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

Al usar Aspose.Tasks for .NET, los desarrolladores pueden integrarse sin problemas con ambos Project Server y Project Online. Esto permite crear, leer y actualizar proyectos empresariales de forma programática, facilitando mantener la coherencia, automatizar flujos de trabajo e integrar los datos de los proyectos en sistemas empresariales más amplios. Dicha automatización ayuda a reducir el esfuerzo manual, mejorar la precisión y garantizar que la gestión de proyectos a nivel empresarial permanezca sincronizada y eficiente.