Partager via

Élément OutlineCode

  • Article

Définit un code hiérarchique et une liste de valeurs associées dans un projet, ou spécifie la valeur d’un élément de code hiérarchique pour une ressource ou une tâche.

<OutlineCode>
  ComplexTypeValue
</OutlineCode>

Éléments parents

OutlineCodes, Ressource, Tâche

Éléments enfants au niveau du projet

Élément

Requis/Facultatif

Description

Guid

Requis

Nouveautés de Microsoft Office Project 2007. Identificateur global unique (GUID) du code hiérarchique. Correspond à l’élément Ltuid dans les valeurs ExtendedAttribute associées.

FieldID

Facultatif

Numéro d’IDENTIFICATION du champ pour le code hiérarchique. Les numéros de champ correspondent à Code hiérarchique1, Code hiérarchique2, . . . , Code hiérarchique10, pour les ressources et les tâches.

FieldName

Facultatif

Nom du code hiérarchique personnalisé.

Alias

Facultatif

Alias du code hiérarchique.

PhoneticAlias

Facultatif

Contient des informations de prononciation phonétiques en hiragana ou katakana pour un code hiérarchique personnalisé; utilisé uniquement dans la version japonaise de Project.

Valeurs

Facultatif

Collection des définitions de valeur du code hiérarchique.

Enterprise

Facultatif

Indique si le code hiérarchique est un champ personnalisé d’entreprise.

EnterpriseOutlineCodeAlias

Facultatif

Fait référence à un champ personnalisé d’entreprise pour lequel le code hiérarchique est un alias.

ResourceSubstitutionEnabled

Facultatif

Indique si le code hiérarchique est utilisé avec l’Assistant Substitution de ressources dans Project. L’Assistant Substitution de ressources est utilisé uniquement avec les champs personnalisés d’entreprise.

LeafOnly

Facultatif

Indique si la valeur spécifiée pour un code hiérarchique dans une ressource ou une tâche doit être une valeur feuille.

AllLevelsRequired

Facultatif

Indique si tous les niveaux des nouveaux codes doivent être présents. Non utilisé pour les champs personnalisés d’entreprise.

OnlyTableValuesAllowed

Facultatif

Indique si la valeur du code hiérarchique doit provenir de la table de recherche associée.

Masques

Facultatif

Collection de masques de code pour la liste des valeurs de code hiérarchique.

Éléments enfants au niveau de la tâche et de la ressource

Élément

Requis/Facultatif

Description

FieldID

Requis

Numéro d’IDENTIFICATION du champ pour le code hiérarchique. Les numéros de champ correspondent à Code hiérarchique1, Code hiérarchique2, . . . , Code hiérarchique10, pour les ressources et les tâches.

ValueID

Facultatif

Numéro d’identification local dans la liste Valeur associée à la définition du code hiérarchique. Obligatoire pour que Project 2003 lise les fichiers XML enregistrés à partir de Project 2007.

ValueGUID

Facultatif

Nouveautés de Project 2007. GUID de la valeur dans la liste des valeurs du code hiérarchique. ValueGUID correspond au FieldGUID dans l’élément Value.

Occurrences

Minimum : 0

Maximum : pas de limite

Remarques

Un code hiérarchique, avec le masque de code et la table de valeurs correspondants, est défini dans la collection de OutlineCodes dans un projet. Chaque code hiérarchique a un ExtendedAttribute associé qui spécifie le type de champ et l’alias du code hiérarchique.

Les ressources ou tâches qui contiennent des valeurs de code hiérarchique incluent un élément OutlineCode pour chaque valeur. Les deux éléments de données suivants sont nécessaires pour spécifier la valeur d’un élément OutlineCode dans une ressource ou une tâche :

  • Pointeur vers la définition de code hiérarchique spécifiée par l’élément FieldID.

  • Valeur de code hiérarchique, qui est spécifiée par valueID et le pointeur ValueGUID vers l’élément Value dans la liste de valeurs. ValueGUID correspond au FieldGUID dans la liste de valeurs. Project 2007 ignore ValueID et utilise ValueGUID.

Exemple

Dans l’exemple suivant, la valeur Guid dans la définition de code hiérarchique correspond à la valeur Ltuid dans l’attribut ExtendedAttribute associé. L’alias de code hiérarchique est Task Simple OC pour le nom du champ Code hiérarchique6 . Le 188744106 FieldID correspond à la valeur d’énumération pjCustomTaskOutlineCode6 dans l’énumération PjCustomField. Vous pouvez également utiliser l’Explorateur d’objets dans l’éditeur Project Visual Basic (VBE) pour rechercher des valeurs dans l’énumération PjCustomField.

Le masque de code hiérarchique définit un niveau de caractères (Type = 3), de toute longueur (Longueur = 0).

ValueGUID et ValueID pour le code hiérarchique de la tâche correspondent tous deux à la valeur Simple 2 dans le code hiérarchique OC simple de la tâche .

<Project xmlns="http://schemas.microsoft.com/project">
   . . .
   <OutlineCodes>
      <OutlineCode>
         <Guid>26F0CA77-38CC-40C7-933D-15F839F7DB82</Guid>
         <Enterprise>0</Enterprise>
         <ResourceSubstitutionEnabled>0</ResourceSubstitutionEnabled>
         <LeafOnly>0</LeafOnly>
         <AllLevelsRequired>0</AllLevelsRequired>
         <OnlyTableValuesAllowed>0</OnlyTableValuesAllowed>
         <Masks>
            <Mask>
               <Level>1</Level>
               <Type>3</Type>
               <Length>0</Length>
               <Separator>.</Separator>
            </Mask>
         </Masks>
         <Values>
            <Value>
               <ValueID>16</ValueID>
               <FieldGUID>985194AB-77BA-4545-BCE8-99761B5538D9</FieldGUID>
               <ParentValueID>0</ParentValueID>
               <Type>21</Type>
               <Value>Simple 1</Value>
            </Value>
            <Value>
               <ValueID>17</ValueID>
               <FieldGUID>6B0CC455-EE19-416A-8FD9-6209590B3ED7</FieldGUID>
               <ParentValueID>0</ParentValueID>
               <Type>21</Type>
               <Value>Simple 2</Value>
            </Value>
         </Values>
      </OutlineCode>
   </OutlineCodes>
   . . .
   <ExtendedAttributes>
      <ExtendedAttribute>
         <FieldID>188744106</FieldID>
         <FieldName>Outline Code6</FieldName>
         <Alias>Task Simple OC</Alias>
         <Ltuid>26F0CA77-38CC-40C7-933D-15F839F7DB82</Ltuid>
         <SecondaryPID>255869013</SecondaryPID>
      </ExtendedAttribute>
   </ExtendedAttributes>
   . . .
   <Tasks>
      <Task>
         . . .
         <OutlineCode>
            <FieldID>188744106</FieldID>
            <ValueID>17</ValueID>
            <ValueGUID>6B0CC455-EE19-416A-8FD9-6209590B3ED7</ValueGUID>
         </OutlineCode>
         . . .
      </Task>
   </Tasks>
   . . .
</Project>

Voir aussi

Référence

Élément Ltuid

Élément ExtendedAttribute

Concepts

Éléments de Project et structure XML

Schéma XML de l’élément Project

Éléments OutlineCode et structure XML

Schéma XML de l’élément OutlineCodes

Éléments Resource et structure XML

Schéma XML de l’élément Resources

Éléments Task et structure XML

Schéma XML de l’élément Tasks

Autres ressources

PjCustomField, énumération