Работа с Outline Codes в проекте

Outline codes в Microsoft Project — это пользовательские метки, которые позволяют определить альтернативную структуру проекта, отличную от WBS codes или outline numbers. Они особенно полезны, когда необходимо классифицировать задачи или ресурсы в соответствии с организационными или корпоративными стандартами. С помощью Aspose.Tasks for .NET, вы можете извлекать, анализировать и управлять Outline codes и их свойствами, такими как Alias, AllLevelsRequired, Enterprise, EnterpriseOutlineCodeAlias, FieldId, FieldName, PhoneticAlias, Guid, Masks, и Values.

Чтение Outline Codes

Класс Project предоставляет коллекцию OutlineCodes , которая содержит объекты OutlineCodeDefinition .
Эти определения содержат подробную информацию о каждом Outline code.

Следующий пример демонстрирует, как прочитать информацию об outline code из проекта:

Project project = new Project("New Project.mpp");

foreach (OutlineCodeDefinition ocd in project.OutlineCodes)
{
    Console.WriteLine("Alias = " + ocd.Alias);
    if (ocd.AllLevelsRequired)
        Console.WriteLine("It contains property: must have all levels");
    else
        Console.WriteLine("It does not contain property: must have all levels");
    if (ocd.Enterprise)
        Console.WriteLine("It is an enterprise custom outline code.");
    else
        Console.WriteLine("It is not an enterprise custom outline code.");

    Console.WriteLine("Reference to another custom field for which this outline code definition is an alias is = " + ocd.EnterpriseOutlineCodeAlias);
    Console.WriteLine("Field Id = " + ocd.FieldId);
    Console.WriteLine("Field Name = " + ocd.FieldName);
    Console.WriteLine("Phonetic Alias = " + ocd.PhoneticAlias);
    Console.WriteLine("Guid = " + ocd.Guid);

    // Display outline code masks
    foreach (OutlineMask outlineMask in ocd.Masks)
    {
        Console.WriteLine("Level of a mask = " + outlineMask.Level);
        Console.WriteLine("Mask = " + outlineMask.ToString());
    }

    // Display out line code values
    foreach (OutlineValue outlineMask1 in ocd.Values)
    {
        Console.WriteLine("Description of outline value = " + outlineMask1.Description);
        Console.WriteLine("Value Id = " + outlineMask1.ValueId);
        Console.WriteLine("Value = " + outlineMask1.Value);
        Console.WriteLine("Type = " + outlineMask1.Type);
    }
}

Проверка уникальности Outline Code Id

При работе с outline codes, Aspose.Tasks for .NET автоматически проверяет уникальность Outline Code IDs. Если обнаруживаются дублирующиеся ID, они заменяются уникальными значениями для поддержания целостности данных.

Project project = new Project("New Project.mpp");

OutlineCodeDefinition textOutline = new OutlineCodeDefinition();
textOutline.FieldId = ExtendedAttributeTask.OutlineCode7.ToString("D");
textOutline.Alias = "My Outline Code";

project.OutlineCodes.Add(textOutline);

OutlineMask mask = new OutlineMask();
mask.Type = MaskType.Characters;
textOutline.Masks.Add(mask);

OutlineValue textValue = new OutlineValue();
textValue.Value = "Text value 1";
textValue.ValueId = 1;
textValue.Type = OutlineValueType.Text;
textValue.Description = "Text value descr 1";
textOutline.Values.Add(textValue);

project.Save("MultipleOutlineValues.mpp", SaveFileFormat.MPP);

Outline codes предоставляют мощный способ добавить пользовательскую категоризацию и структуру к данным Microsoft Project.
Используя Aspose.Tasks for .NET, вы можете программно получать доступ к этим кодам и управлять ими, обеспечивая согласованность и устраняя ошибки, такие как дублирующиеся идентификаторы.
Это облегчает обеспечение соблюдения корпоративных стандартов и улучшает отчетность и анализ проекта.