Attributs prolongés d'un projet

Microsoft Project dispose d’un vaste schéma d’interchange de données XML qui facilite l’échange d’informations entre les applications et la programmation avec des fichiers de projet. Le schéma vous permet d’ajouter des attributs étendus aux tâches, aux ressources et aux affectations. Cet article montre comment travailler avec des attributs étendus en utilisant Aspose.Tasks.

Travailler avec des champs personnalisés à l’aide du projet Microsoft

Dans cet exemple, nous montrerons comment travailler avec Text1 Extended Attribut d’un projet pour associer les informations à une tâche.

1. Dans MSP, accédez à Project-> Fields personnalisés.
2. De là, sélectionnez la tâche.
3. Sélectionnez le texte en tant que type de champ personnalisé dans la boîte combinée de type.
4. Sélectionnez Text1 comme champ personnalisé avec lequel vous souhaitez travailler
5. Utilisez le bouton “Renommer” pour renommer l’alias du champ si elle est souhaitée et appuyez sur le bouton OK
6. Ajoutez une nouvelle tâche et insérez une nouvelle colonne à la ligne de tâche avec le champ personnalisé que vous avez utilisé dans l’étape ci-dessus

Travailler avec des champs personnalisés / attributs étendus en utilisant Aspose.Tasks pour l’API C ++

Aspose.Tasks pour l’API C ++ offre la capacité de créer de nouveaux attributs étendus ainsi que de travailler avec des attributs étendus déjà présents dans un document. Les champs personnalisés ou les attributs étendus sont représentés par la collection ExtendAttributes d’un projet dans Aspose.Tasks. Il contient toute la définition des attributs étendus d’un document de projet. Certains des mappages de la définition du champ personnalisé MSP sont comme indiqué dans l’image ci-dessous.

Création d’un nouvel attribut étendu et l’ajout à la tâche

Pour ajouter un nouvel attribut étendu pour la tâche ou la ressource, nous devons d’abord définir et ajouter la définition d’attribut étendu à la collection ExtendAttributes. La classe EXTENDATTRIBLIBEDEFINITION est utilisée pour définir un nouveau protedAttribute dans un projet. Le FieldID doit être défini pour la définition appropriée d’un attribut étendu qui est lié à ExtendedAttributeTask (en cas de tâche) ou ExtendedAttributeResource (en cas de ressource). L’exemple de code suivant montre comment définir un nouvel attribut étendu pour le champ de projet text1. Une fois la définition d’attribut étendue terminée, vous pouvez désormais créer un nouvel attribut étendu et l’attribuer à une tâche.

System::SharedPtr<Project> project1 = System::MakeObject<Project>(dataDir + u"Blank2010.mpp");
        
System::SharedPtr<ExtendedAttributeDefinition> myTextAttributeDefinition = project1->get_ExtendedAttributes()->GetById((int32_t)Aspose::Tasks::ExtendedAttributeTask::Text1);
        
// If the Custom field doesn't exist in Project, create it
if (myTextAttributeDefinition == nullptr)
{
    myTextAttributeDefinition = ExtendedAttributeDefinition::CreateTaskDefinition(Aspose::Tasks::ExtendedAttributeTask::Text1, u"My text field");
    project1->get_ExtendedAttributes()->Add(myTextAttributeDefinition);
}
        
// Generate Extended Attribute from definition
System::SharedPtr<ExtendedAttribute> text1TaskAttribute = myTextAttributeDefinition->CreateExtendedAttribute();
        
text1TaskAttribute->set_TextValue(u"Text attribute value");
        
// Add extended attribute to task
System::SharedPtr<Task> tsk = project1->get_RootTask()->get_Children()->Add(u"Task 1");
tsk->get_ExtendedAttributes()->Add(text1TaskAttribute);
        
project1->Save(dataDir + u"CreateExtendedAttributes_out.mpp", Aspose::Tasks::Saving::SaveFileFormat::MPP);

Writing Updated Extended Attribute Definitions and Values to MPP

Aspose.Tasks for C++ API supports updating extended attribute data in a Microsoft Project MPP file and save it back.

The code example given below demonstrates how to add new extended attributes of the Resource and Task types to the source MPP file. The steps involved in this activity are:

1. Create an instance of Project Reader.
2. Read the source MPP file.
3. Define a new extended attribute and update its values.
4. Save the project using the Project Writer.

The following example shows setting the extended attributes of a resource.

System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"WriteUpdatedExtendedAttributeDefinitions.mpp");
        
        
// C# preprocessor directive: #region task attributes
        
        
// Add new text3 extended attribute with lookup and one lookup value
System::SharedPtr<ExtendedAttributeDefinition> taskTextAttributeDefinition = ExtendedAttributeDefinition::CreateLookupTaskDefinition(Aspose::Tasks::ExtendedAttributeTask::Text3, u"New text3 attribute");
taskTextAttributeDefinition->set_ElementType(Aspose::Tasks::ElementType::Task);
project->get_ExtendedAttributes()->Add(taskTextAttributeDefinition);
        
System::SharedPtr<Value> textVal = System::MakeObject<Value>();
textVal->set_Id(1);
textVal->set_Description(u"Text value descr");
textVal->set_Val(u"Text value1");
        
taskTextAttributeDefinition->AddLookupValue(textVal);
        
// Add new cost1 extended attribute with lookup and two cost values
System::SharedPtr<ExtendedAttributeDefinition> taskCostAttributeDefinition = ExtendedAttributeDefinition::CreateLookupTaskDefinition(Aspose::Tasks::ExtendedAttributeTask::Cost1, u"New cost1 attribute");
project->get_ExtendedAttributes()->Add(taskCostAttributeDefinition);
        
System::SharedPtr<Value> costVal1 = System::MakeObject<Value>();
costVal1->set_Id(2);
costVal1->set_Description(u"Cost value 1 descr");
costVal1->set_Val(u"99900");
        
System::SharedPtr<Value> costVal2 = System::MakeObject<Value>();
costVal2->set_Id(3);
costVal2->set_Description(u"Cost value 2 descr");
costVal2->set_Val(u"11100");
        
taskCostAttributeDefinition->AddLookupValue(costVal1);
taskCostAttributeDefinition->AddLookupValue(costVal2);
        
// Add new task and assign attribute lookup value.
System::SharedPtr<Task> task = project->get_RootTask()->get_Children()->Add(u"New task");
        
System::SharedPtr<ExtendedAttribute> taskAttr = taskCostAttributeDefinition->CreateExtendedAttribute(costVal1);
task->get_ExtendedAttributes()->Add(taskAttr);
        
System::SharedPtr<ExtendedAttributeDefinition> taskStartAttributeDefinition = ExtendedAttributeDefinition::CreateLookupTaskDefinition(Aspose::Tasks::ExtendedAttributeTask::Start7, u"New start 7 attribute");
        
System::SharedPtr<Value> startVal = System::MakeObject<Value>();
startVal->set_Id(4);
startVal->set_DateTimeValue(System::DateTime::get_Now());
startVal->set_Description(u"Start 7 value description");
        
taskStartAttributeDefinition->AddLookupValue(startVal);
        
project->get_ExtendedAttributes()->Add(taskStartAttributeDefinition);
        
System::SharedPtr<ExtendedAttributeDefinition> taskFinishAttributeDefinition = ExtendedAttributeDefinition::CreateLookupTaskDefinition(Aspose::Tasks::ExtendedAttributeTask::Finish4, u"New finish 4 attribute");
        
System::SharedPtr<Value> finishVal = System::MakeObject<Value>();
finishVal->set_Id(5);
finishVal->set_DateTimeValue(System::DateTime::get_Now());
finishVal->set_Description(u"Finish 4 value description");
        
taskFinishAttributeDefinition->get_ValueList()->Add(finishVal);
        
project->get_ExtendedAttributes()->Add(taskFinishAttributeDefinition);
        
System::SharedPtr<ExtendedAttributeDefinition> numberAttributeDefinition = ExtendedAttributeDefinition::CreateLookupTaskDefinition(Aspose::Tasks::ExtendedAttributeTask::Number20, u"New number attribute");
        
System::SharedPtr<Value> val1 = System::MakeObject<Value>();
val1->set_Id(6);
val1->set_Val(u"1");
val1->set_Description(u"Number 1 value");
System::SharedPtr<Value> val2 = System::MakeObject<Value>();
val2->set_Id(7);
val2->set_Val(u"2");
val2->set_Description(u"Number 2 value");
System::SharedPtr<Value> val3 = System::MakeObject<Value>();
val2->set_Id(8);
val3->set_Val(u"3");
val3->set_Description(u"Number 3 value");
        
numberAttributeDefinition->AddLookupValue(val1);
numberAttributeDefinition->AddLookupValue(val2);
numberAttributeDefinition->AddLookupValue(val3);
        
project->get_ExtendedAttributes()->Add(numberAttributeDefinition);
        
        
// C# preprocessor directive: #endregion
        
        
System::SharedPtr<ExtendedAttributeDefinition> rscStartAttributeDefinition = ExtendedAttributeDefinition::CreateLookupResourceDefinition(Aspose::Tasks::ExtendedAttributeResource::Start5, u"New start5 attribute");
        
System::SharedPtr<Value> startVal2 = System::MakeObject<Value>();
startVal2->set_Id(9);
startVal2->set_DateTimeValue(System::DateTime::get_Now());
startVal2->set_Description(u"this is start5 value descr");
        
rscStartAttributeDefinition->AddLookupValue(startVal2);
        
project->get_ExtendedAttributes()->Add(rscStartAttributeDefinition);
        
// Define a duration attribute without lookup.
System::SharedPtr<ExtendedAttributeDefinition> taskDurationAttributeDefinition = ExtendedAttributeDefinition::CreateTaskDefinition(Aspose::Tasks::ExtendedAttributeTask::Duration1, u"New Duration");
project->get_ExtendedAttributes()->Add(taskDurationAttributeDefinition);
        
// Add new task and assign duration value to the previously defined duration attribute.
System::SharedPtr<Task> timeTask = project->get_RootTask()->get_Children()->Add(u"New task");
        
System::SharedPtr<ExtendedAttribute> durationExtendedAttribute = taskDurationAttributeDefinition->CreateExtendedAttribute();
        
durationExtendedAttribute->set_DurationValue(project->GetDuration(3.0, Aspose::Tasks::TimeUnitType::Hour));
timeTask->get_ExtendedAttributes()->Add(durationExtendedAttribute);
        
System::SharedPtr<MPPSaveOptions> mppSaveOptions = System::MakeObject<MPPSaveOptions>();
mppSaveOptions->set_WriteViewData(true);
        
// Save the project as MPP project file
project->Save(dataDir + u"WriteUpdatedExtendedAttributeDefinitions_out.mpp", mppSaveOptions);