Робота з проєктами

Aspose.Tasks for .NET дозволяє працювати з Microsoft Project (MPP/XML) файлами без встановлення Microsoft Project або залежності від Microsoft Office Automation. Він надає потужний та гнучкий API який допомагає розробникам заощаджувати час та зусилля, пропонуючи послідовний спосіб оперувати даними проєкту в різних форматах.

З Aspose.Tasks ви можете:

• Створювати нові файли проєктів з нуля або на основі шаблонів
• Відкривати існуючі файли у різних форматах (MPP, MPT, MPX, XML, XER, P6 XML)
• Зберігати проєкти в кількох форматах, включаючи MPP, XML, PDF, HTML та інші

У цій статті пояснюється, як створювати, читати та зберігати файли проєктів використовуючи Project class.

Створення порожнього файлу проєкту

Клас Project class є основним класом в Aspose.Tasks, який використовується для встановлення та отримання властивостей, пов’язаних із проєктом, а також для керування його поведінкою. Метод Save цього класу дозволяє вивести Project у різні вихідні формати, такі як XML, MPP, PDF, HTML тощо, одним викликом API. Цей метод приймає файловий потік або ім’я файлу, а також одне зі значень, які надає SaveFileFormat enumeration type.

Наступні рядки коду створюють простий файл проєкту у форматі XML.

Створення порожнього проєкту та збереження у форматі XML

У цьому прикладі показано, як створити новий проєкт і зберегти його як XML-файл, який можна відкрити в Microsoft Project.

Project project = new Project();
project.Save("EmptyProjectSaveXML_out.xml", SaveFileFormat.XML);

Отриманий XML-файл проєкту можна відкрити в Microsoft Project, виконавши такі кроки:

1. У меню ‘Файл’ виберіть ‘Відкрити’.
2. Виберіть формат XML (*.xml) із списку типів файлів і знайдіть вихідний XML-файл.
3. У меню ‘Проєкт’ виберіть ‘Відомості про проєкт’

Створення порожнього проєкту та збереження в потік

Якщо вам потрібно працювати з проєктами в пам’яті (наприклад, у веб-застосунках або хмарних середовищах), ви можете зберегти безпосередньо в потік MemoryStream замість запису у файл.

// Create a project instance
Project newProject = new Project();

// Create a file stream
using (FileStream stream = new FileStream("EmptyProjectSaveStream_out.xml", FileMode.Create, FileAccess.Write))
{
    // Write the stream into XML format
    newProject.Save(stream, SaveFileFormat.XML);
}

Створення порожнього проєкту та збереження у форматі MPP

У цьому прикладі показано, як згенерувати рідний Microsoft Project MPP файл програмно.

// there is no more need to load MPP template to save it into MPP
// add tasks, resources, etc.
Project project = new Project();

// !The project will be saved into MPP by using internal MPP template.
project.Save("New Project.mpp", SaveFileFormat.MPP);

Читання файлу проєкту

Aspose.Tasks for .NET дозволяє читати існуючі проєкти у різних форматах: XML, MPP, MPT, MPX, XER, Primavera P6 XML тощо та зберегти їх назад у MPP або інший формат після оновлення. Наведені нижче фрагменти коду показують, як файл проєкту можна прочитати за допомогою конструктора класу Project.

Читання файлів проєкту як шаблону

У цьому прикладі показано, як завантажити проєкт, використовуючи Project конструктор і використовувати його як шаблон для подальшої роботи.

// Read existing project template file
Project project = new Project("New Project.mpp");

Читання файлу проєкту з потоку

У випадках, коли проєкти завантажуються або зберігаються в потоках, їх можна завантажувати безпосередньо з відповідних об’єктів Stream objects.

// Read the project xml into file stream
using (FileStream stream = new FileStream("ReadProjectFileFromStream.xml", FileMode.Open))
{
    // Create project using file stream
    Project project = new Project(stream);
}

Імпорт даних проєкту з бази даних Microsoft Project Server

Ми плануємо припинити підтримку імпорту даних проєкту з бази даних Microsoft Project Server у майбутньому випуску. Натомість ви можете використовувати імпорт/експорт даних проєкту за допомогою PWA API Microsoft Project Server.

Дивіться документацію для ProjectServerManager класу для детальнішої інформації.

    // Create connection string
    SqlConnectionStringBuilder sqlConnectionString = new SqlConnectionStringBuilder();
    sqlConnectionString.DataSource = "192.168.56.2,1433";
    sqlConnectionString.Encrypt = true;
    sqlConnectionString.TrustServerCertificate = true;
    sqlConnectionString.InitialCatalog = "ProjectServer_Published";
    sqlConnectionString.NetworkLibrary = "DBMSSOCN";
    sqlConnectionString.UserID = "sa";
    sqlConnectionString.Password = "*****";

    // Use Aspose.Tasks.Connectivity namespace
    MspDbSettings settings = new MspDbSettings(sqlConnectionString.ConnectionString, new Guid("E6426C44-D6CB-4B9C-AF16-48910ACE0F54"));
    Project project = new Project(settings);

Імпорт даних проєкту з файлу MPD (Microsoft Project Database)

Старіші бази даних проєктів, збережені у форматі .mpd MPD, також можна прочитати.

    DbSettings settings = new MpdSettings("Provider=Microsoft.Jet.OLEDB.4.0; Data Source=" + "MpdFileToRead.mpd", 1);
    Project project = new Project(settings);

Ігнорування недійсних символів під час завантаження проєкту

У деяких файлах у користувацьких полях можуть бути недійсні символи. Microsoft Project не дозволяє недійсні символи, тож файли могли бути створені або змінені за допомогою автоматизації чи інших інструментів. Якщо ці файли завантажити за допомогою API, це може призвести до винятку. Щоб ігнорувати такі недійсні символи, можна використовувати перевантажений конструктор класу Project з делегатом ParseErrorCallBack.

static void Run()
{
    // Open modified xml stream
    using (MemoryStream stream = new MemoryStream(Encoding.UTF8.GetBytes(GetModifiedXml())))
    {
        Project project = new Project(stream, new ParseErrorCallback(CustomDurationHandler));
    }
}

static string GetModifiedXml()
{
    // Open valid xml file and modify it
    using (TextReader reader = new StreamReader("IgnoreInvalidCharacters.xml"))
    {
        string xml = reader.ReadToEnd();
        Regex regex = new Regex("PT(\\d+)H(\\d+)M(\\d+)S");
        return regex.Replace(xml, "**$1Hrs$2Mins$3Secs**");
    }
}

static object CustomDurationHandler(object sender, ParseErrorArgs args)
{
    Regex regex = new Regex("[*]{2}(\\d+)Hrs(\\d+)Mins(\\d+)Secs[*]{2}");
    if (args.FieldType == typeof(TimeSpan))
    {
        Debug.Print("Object field : {0}, Invalid value : {1}", args.FieldName, args.InvalidValue);
        string duration = regex.Replace(args.InvalidValue, "PT$1H$2M$3S");
        TimeSpan newValue = Duration.ParseTimeSpan(duration);
        Debug.Print("New value : {0}", newValue);
        return newValue;
    }
    // Here we handle only TimeSpan instances, so rethrow original exception with other types
    throw args.Exception;
}

Робота з кодуваннями

При роботі з файлами MPX може знадобитися вказати правильне кодування файлу. Це гарантує, що текстові дані будуть правильно прочитані та відображені. Aspose.Tasks for .NET підтримує кодування файлів MPX. Наведений нижче приклад коду показує налаштування кодування.

// Specify Encodings
using (StreamReader streamReader = new StreamReader("Project.mpx", System.Text.Encoding.GetEncoding("ISO-8859-1")))
{
    Project project = new Project(streamReader.BaseStream);
}

Aspose.Tasks for .NET дає розробникам повний контроль над файлами Microsoft Project без необхідності в самому MS Project.
За допомогою Project class, ви можете:

• Створювати нові проєкти (XML, MPP) та зберігати їх у файл або потік
• Читати існуючі проєкти у кількох форматах
• Працювати з Project Server та інтеграціями баз даних (підтримка застарілих функцій)
• Обробляти проблеми кодування та недійсні символи коректно

Незалежно від того, чи створюєте ви настільне рішення чи веб-застосунок, Aspose.Tasks надає послідовний та надійний API для програмного керування даними проєкту.