Données de champ personnalisées dans XML

Article
04/04/2023

Le schéma d’échange de données XML de Microsoft Office Project 2007 (mspdi_pj12.xsd) modifie la façon dont certaines informations de champ personnalisé sont représentées dans XML. Cet article décrit comment Office Project 2007 représente les définitions de champs personnalisés et les valeurs de champs personnalisés au format XML.

Données de champ personnalisées

Project stocke des informations sur les champs personnalisés comme l’un des deux types suivants :

Définition de champ personnalisé Une définition de champ personnalisé se compose de données requises pour définir un champ personnalisé local ou d’entreprise. Project pour le web champs personnalisés locaux sont présentés en tant que champs personnalisés d’entreprise. Ces données incluent des informations telles que le nom du champ personnalisé, l’ID de champ personnalisé et le type de champ personnalisé.

Les éléments XML utilisés pour stocker les définitions de champs personnalisés sont définis dans la section Schéma XML de l’élément ExtendedAttributes du schéma d’échange de données XML project.
Valeur du champ personnalisé Une valeur de champ personnalisé est des données requises pour définir une valeur particulière pour un champ personnalisé et l’associer à un projet, une tâche, une ressource ou une affectation. Par exemple, vous pouvez configurer le champ personnalisé d’entreprise Intégrité sur la valeur Late pour une tâche particulière.

Le présent article contient les sections suivantes :

Définitions de champs personnalisés au format XML
Valeurs de champ personnalisées au format XML

Définitions de champs personnalisés au format XML

Project 2007 représente toutes les définitions de champs personnalisés d’entreprise et locales dans la collection d’attributs étendue, qui est contenue dans l’élément ExtendedAttributes dans le fichier de sortie XML. Chaque définition de champ personnalisé est représentée par un seul élément ExtendedAttribute et ses enfants.

L’exemple suivant montre la représentation XML d’une collection d’attributs étendue qui définit deux champs personnalisés. Text1 est un champ personnalisé local, tandis que Intégrité est un champ personnalisé d’entreprise préconfiguré dans Project 2007.

<ExtendedAttributes>
    <ExtendedAttribute>
        <FieldID>188743731</FieldID>
        <FieldName>Text1</FieldName>
        <Alias>MyLocalCustomField</Alias>
        <SecondaryPID>255869028</SecondaryPID>
    </ExtendedAttribute>
    <ExtendedAttribute>
        <FieldID>188776449</FieldID>
        <FieldName>Health</FieldName>
        <CFType>7</CFType>
        <Guid>0000E8D9-65F1-4769-9BD2-819D38036FCC</Guid>
        <ElemType>20</ElemType>
        <MaxMultiValues>1</MaxMultiValues>
        <UserDef>1</UserDef>
        <SecondaryPID>255885314</SecondaryPID>
        <DefaultGuid>000079D2-4A43-41FC-B264-98D23FADD84B</DefaultGuid>
    </ExtendedAttribute>
</ExtendedAttributes>

Lorsque vous enregistrez un projet au format XML, toutes les définitions de champs personnalisés locaux sont écrites dans la collection d’attributs étendus. Toutefois, vous pouvez choisir d’inclure uniquement les champs personnalisés d’entreprise actuellement chargés dans la sortie XML. Choisir d’enregistrer uniquement les éléments globaux d’entreprise actuellement chargés peut entraîner un fichier XML plus petit et plus facile à gérer.

Pour plus d’informations sur l’enregistrement de projets au format XML, consultez Enregistrement et ouverture de projets au format XML.

Valeurs de champ personnalisées au format XML

Lorsque vous configurez une valeur spécifique pour un champ personnalisé au niveau du projet, de la tâche, de la ressource ou de l’affectation, Project 2007 écrit des informations sur cette valeur dans la section récapitulative de la tâche, de la tâche, de la ressource ou de l’affectation de la sortie XML, respectivement.

Pour représenter une valeur de champ personnalisé au format XML, vous devez répondre aux trois exigences suivantes :

Associez la valeur du champ personnalisé à l’entité Project (projet, tâche, ressource ou affectation) pour laquelle elle est configurée.
Associez la valeur du champ personnalisé à la définition de champ personnalisé à laquelle elle appartient.
Spécifiez la valeur du champ personnalisé.

Les sections suivantes décrivent comment Project 2007 représente des valeurs de champ personnalisées au format XML :

Valeurs des champs personnalisés d’entreprise
Valeurs des champs personnalisés locaux

Valeurs des champs personnalisés d’entreprise

Dans Project 2007, vous pouvez configurer un nombre illimité de champs personnalisés d’entreprise. Cette amélioration modifie la façon dont Project 2007 stocke les valeurs des champs personnalisés d’entreprise au format XML.

L’exemple suivant montre la sortie XML appropriée pour une tâche dont le champ personnalisé d’entreprise d’intégrité est configuré sur la valeur de la table de recherche Sur la planification.

    <Task>
        ...
        <b408001>0000BB21-B2AE-410A-88B6-82C108903823</b408001>
        ...
    </Task>

Ce code XML répond aux trois conditions requises pour le stockage d’une valeur de champ personnalisé dans XML, comme suit :

La valeur du champ personnalisé est écrite dans la section récapitulative de la tâche, tâche, ressource ou affectation de la sortie XML pour laquelle la valeur est configurée. Cela associe la valeur du champ personnalisé à l’entité Project correcte, dans ce cas une tâche particulière.
L’ID de champ personnalisé est utilisé pour lier la valeur du champ personnalisé à la définition de champ personnalisé. L’ID de champ personnalisé est stocké dans l’élément FieldID de la définition de champ personnalisé. Pour le champ personnalisé Entreprise intégrité, l’ID de champ personnalisé est 188776449.

Le nom de l’élément XML qui stocke la valeur du champ personnalisé, dans ce cas l’élément b408001, correspond à la représentation hexadécimale de l’ID de champ personnalisé. Pour le champ personnalisé d’entreprise Intégrité, la valeur hexadécimale 0xb408001 est égale à la valeur binaire 188776449.
La valeur du champ personnalisé est stockée dans l’élément b408001. Étant donné que le champ personnalisé d’entreprise d’intégrité est une table de choix, la valeur de champ personnalisé pour On Schedule est le GUID de cette valeur de table de recherche, 0000BB21-B2AE-410A-88B6-82C108903823.

Le tableau 1 présente les plages valides d’ID de champ personnalisé pour chaque type de champ personnalisé d’entreprise.

Tableau 1. ID de champ personnalisé d’entreprise

Configuration de la valeur du champ personnalisé d’entreprise	Plage d’ID de champ personnalisé (décimal)	Plage d’ID de champ personnalisé (hexadécimal)
Niveau du projet	190873600 – 190939135	b608000 – b617fff
Niveau de tâche	188776448 – 188841983	b408000 – b417fff
Niveau de ressource	205553664 – 205619199	c408000 – c417fff
Niveau d’affectation	255885312 – 255950847	f408000 – f417fff

Étant donné qu’il existe 262 140 ID de champ personnalisé d’entreprise possibles, il existe 262 140 noms d’éléments XML possibles pour les valeurs de champs personnalisés. Pour des raisons de performances, les éléments XML que Project 2007 utilise pour stocker les valeurs des champs personnalisés d’entreprise ne sont pas définis dans le schéma d’échange de données XML de project (mspdi_pj12.xsd). Au lieu de cela, ces éléments sont définis dans les fichiers de schéma supplémentaires inclus dans le téléchargement du Kit de développement logiciel (SDK) Project 2007. Pour obtenir un lien vers le téléchargement du Kit de développement logiciel (SDK) Project 2007, voir Bienvenue dans le Kit de développement logiciel (SDK) Microsoft Office Project 2007.

Le schéma de base comprend des annotations avec la chaîne « ## » pouvant faire l’objet d’une recherche pour indiquer l’emplacement dans lequel Project 2007 écrit les éléments de valeur de champ personnalisé d’entreprise qui ne sont pas définis dans mspdi_pj12.xsd.

Valeurs des champs personnalisés locaux

Project 2007 représente les valeurs de champs personnalisés locaux en XML de deux manières. Les valeurs des champs personnalisés locaux d’affectation sont écrites en XML dans le même format que celui utilisé pour les valeurs de champs personnalisés d’entreprise, tandis que les valeurs de champ personnalisé local de projet, de tâche et de ressource sont écrites dans le code XML dans le même format que celui utilisé par Microsoft Office Project 2003.

Les sections suivantes contiennent des informations plus détaillées sur la façon dont les valeurs des champs personnalisés locaux sont représentées dans XML par Project 2007 :

Affectation de valeurs de champs personnalisés locaux au format XML
Project, Task, and Resource Local Custom Field Values in XML

Affectation de valeurs de champs personnalisés locaux au format XML

Project 2007 écrit les valeurs de champ personnalisé local d’affectation en utilisant le même format que les valeurs de champ personnalisé d’entreprise, et répond aux trois conditions requises pour stocker une valeur de champ personnalisé dans XML de la même façon.

Le tableau 2 présente la plage valide d’ID de champ personnalisé pour les champs personnalisés locaux d’affectation. Le schéma de base mspdi_pj12.xsd définit les 200 éléments XML possibles pour les valeurs de champ personnalisé local.

Tableau 2. ID de champ personnalisé local d’affectation

Configuration de la valeur du champ personnalisé local	Plage d’ID de champ personnalisé (décimal)	Plage d’ID de champ personnalisé (hexadécimal)
Niveau d’affectation	255868928 – 255869128	f404000 – f4040c8

Project, Task, and Resource Local Custom Field Values in XML

Project 2007 écrit des valeurs de champ personnalisé local de projet, de tâche et de ressource au format indiqué dans l’exemple suivant. Il s’agit du même format que celui utilisé par Project 2003 pour toutes les valeurs de champs personnalisés.

    <Task>
        ...
        <ExtendedAttribute>
          <FieldID>188743731</FieldID>
          <Value>This is the value of Text1</Value>
        </ExtendedAttribute>
        ...
    </Task>

Ce code XML répond aux trois conditions requises pour le stockage d’une valeur de champ personnalisé dans XML, comme suit :

La valeur du champ personnalisé est écrite dans la section récapitulative de la tâche, tâche, ressource ou affectation de la sortie XML pour laquelle la valeur est configurée. Cela associe la valeur du champ personnalisé à l’entité Project correcte, dans ce cas une tâche particulière.
L’ID de champ personnalisé est utilisé pour lier la valeur du champ personnalisé à la définition de champ personnalisé. L’ID de champ personnalisé est stocké dans l’élément FieldID dans le code XML représentant à la fois la définition de champ personnalisé et la valeur du champ personnalisé.
La valeur du champ personnalisé est stockée dans l’élément Value.

Voir aussi

Concepts

Introduction aux Données XML de Project

Éléments d’Echange de Données de Project

Partager via

Données de champ personnalisées dans XML