Робота з контурними кодами у проєкті

Контурні коди в Microsoft Project — це власні мітки, що дозволяють визначати альтернативну структуру проєкту, відмінну від WBS codes або контурних номерів. Вони особливо корисні, коли потрібно категоризувати завдання або ресурси відповідно до організаційних або корпоративних стандартів. За допомогою Aspose.Tasks for .NET, ви можете отримувати, аналізувати та керувати контурними кодами та їхніми властивостями, такими як Alias, AllLevelsRequired, Enterprise, EnterpriseOutlineCodeAlias, FieldId, FieldName, PhoneticAlias, Guid, Masks, і Values.

Читання контурних кодів

Клас Project надає доступ до OutlineCodes колекції, яка містить OutlineCodeDefinition об’єкти.
Ці визначення надають докладну інформацію про кожен контурний код.

Наведений нижче приклад демонструє, як зчитати інформацію про контурні коди з проєкту:

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

Перевірка унікальності ідентифікаторів контурних кодів

Під час роботи з контурними кодами, Aspose.Tasks for .NET автоматично перевіряє унікальність ідентифікаторів контурних кодів. Якщо виявлено дублікати, вони замінюються на унікальні значення для збереження цілісності даних.

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

Контурні коди забезпечують потужний спосіб додати власну категоризацію та структуру до даних Microsoft Project.
Використовуючи Aspose.Tasks for .NET, ви можете програмно отримувати доступ до цих кодів і керувати ними, забезпечуючи послідовність і усуваючи помилки, такі як дублювання ідентифікаторів.
Це полегшує впровадження корпоративних стандартів і покращує звітність та аналіз проєктів.